Documentation

Table of Contents

event.acknowledge

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 as operações de atualização que devem ser realizadas.

Parâmetro	Tipo	Descrição
eventids (obrigatório)	string/object	IDs dos eventos a serem reconhecidos.
action (obrigatório)	inteiro	Ação(s) de atualização do evento. Valores possíveis de bitmap são: 1 - fechar problema; 2 - reconhecer evento; 4 - adicionar mensagem; 8 - alterar severidade; 16 - desmarcar evento. Este é um campo de máscara de bits; qualquer soma dos valores possíveis de bitmap é aceitável (por exemplo, 6 para reconhecer evento e adicionar mensagem).
message	string	Texto da mensagem. Required, se a ação contiver o sinalizador 'adicionar mensagem'.
severity	inteiro	Nova severidade para os eventos. Required, se a ação contiver o sinalizador 'alterar severidade'. Valores possíveis: 0 - não classificado; 1 - informação; 2 - aviso; 3 - médio; 4 - alto; 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 severidade do evento

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

Solicitação:

{
           "jsonrpc": "2.0",
           "method": "event.acknowledge",
           "params": {
               "eventids": ["20427", "20428"],
               "action": 12,
               "message": "Maintenance required to fix it.",
               "severity": 4
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Resposta:

{
           "jsonrpc": "2.0",
           "result": {
               "eventids": [
                   "20427",
                   "20428"
               ]
           },
           "id": 1
       }

Fonte

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