Sidebar

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.