event.acknowledge

Descrição

object event.acknowledge (parâmetros de objeto/array)

Este método permite atualizar eventos. As seguintes ações de atualização podem ser realizado:

  • Fechar evento. Se o evento já foi resolvido, esta ação será ignorado.
  • Reconhecer evento. Se o evento já foi reconhecido, esta ação será ignorado.
  • Adicionar mensagem.
  • Alterar a gravidade do evento. Se o evento já tiver a mesma gravidade, este ação será ignorada.

::: não importante Somente eventos de gatilho podem ser atualizados.
Somente eventos de problema podem ser atualizados.
Os direitos de leitura/gravação para o gatilho são necessários para fechar o evento ou para alterar a gravidade do evento.
Para fechar um evento, o fechamento manual deve ser permitido no acionar. :::

Este método está disponível para usuários de qualquer tipo. Permissões para chamar o método pode ser revogado nas configurações de função do usuário. Veja Usuário funções Para maiores informações.

Parâmetros

(object/array) Parâmetros contendo os IDs dos eventos e atualização operações que devem ser realizadas.

Parâmetro Tipo Descrição
eventids
(obrigatório)		 string/object IDs dos eventos a serem reconhecidos.
ação
(obrigatório)		 inteiro Ação(ões) de atualização do evento. Este é um campo de máscara de bits, qualquer combinação de valores é aceitável.

Valores possíveis:
1 - fechar problema;
2 - reconhecer evento;
4 - adicionar mensagem;
8 - alterar a gravidade;
16 - evento de não confirmação.
message string Texto da mensagem.
Requerido, se a ação contiver o sinalizador 'adicionar mensagem'.
severity integer Nova gravidade para eventos.
Obrigatório, se a ação contiver o sinalizador 'alterar gravidade'.

Valores possíveis:
0 - não classificado;
1 - informações;
2 - aviso;
3 - média;
4 - alta;
5 - desastre.

Valores de retorno

(object) Retorna um objeto contendo os IDs dos eventos atualizados sob a propriedade eventids.

Exemplos

Reconhecendo um evento

Reconheça um único evento e deixe uma mensagem.

Solicitação:

{
    "jsonrpc": "2.0",
    "método": "evento.reconhecimento",
    "parâmetros": {
        "eventos": "20427",
        "ação": 6,
        "message": "Problema resolvido."
    },
    "auth": "038e1d7b1735c6a5436ee9eae095879e",
    "id": 1
}

Resposta:

{
    "jsonrpc": "2.0",
    "resultado": {
        "eventos": [
            "20427"
        ]
    },
    "id": 1
}

Alterando a gravidade do evento

Altere a gravidade de vários eventos e deixe uma mensagem.

Solicitação:

{
    "jsonrpc": "2.0",
    "método": "evento.reconhecimento",
    "parâmetros": {
        "eventos": ["20427", "20428"],
        "ação": 12,
        "message": "Manutenção necessária para corrigi-lo.",
        "gravidade": 4
    },
    "auth": "038e1d7b1735c6a5436ee9eae095879e",
    "id": 1
}

Resposta:

{
    "jsonrpc": "2.0",
    "resultado": {
        "eventos": [
            "20427",
            "20428"
        ]
    },
    "id": 1
}

Fonte

CEvent::acknowledge() em ui/include/classes/api/services/CEvent.php.