event.acknowledge

Descrição

object event.acknowledge(object/array parameters)

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

Fechar evento. Se o evento já estiver resolvido, esta ação será ignorada.
Reconhecer evento. Se o evento já estiver reconhecido, esta ação será ignorada.
Desmarcar reconhecimento do evento. Se o evento não estiver reconhecido, esta ação será ignorada.
Adicionar mensagem.
Alterar a severidade do evento. Se o evento já tiver a mesma severidade, esta ação será ignorada.
Suprimir evento. Se o evento já estiver suprimido, esta ação será ignorada.
Remover supressão do evento. Se o evento não estiver suprimido, esta ação será ignorada.

Apenas eventos de trigger podem ser atualizados.
Apenas eventos de problema podem ser atualizados.
Permissões de leitura/gravação para trigger são necessárias para fechar o evento ou alterar a severidade do evento.
Para fechar um evento, o fechamento manual deve ser permitido na trigger.

Este método está disponível para usuários de qualquer tipo. As permissões para chamar o método podem ser revogadas nas configurações de função de usuário. Consulte Funções de usuário para mais 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	ID/array	IDs dos eventos a serem reconhecidos. Comportamento do parâmetro: - obrigatório
action	integer	Ação(ões) de atualização do evento. Valores possíveis do bitmap: 1 - fechar problema; 2 - reconhecer evento; 4 - adicionar mensagem; 8 - alterar severidade; 16 - desmarcar reconhecimento do evento; 32 - suprimir evento; 64 - remover supressão do evento; 128 - alterar classificação do evento para causa; 256 - alterar classificação do evento para sintoma. Este é um campo de máscara de bits; qualquer soma dos valores possíveis é aceitável (por exemplo, 34 para reconhecer e suprimir evento). Comportamento do parâmetro: - obrigatório
cause_eventid	ID	ID do evento causa. Comportamento do parâmetro: - obrigatório se `action` contiver o bit "alterar classificação do evento para sintoma"
message	string	Texto da mensagem. Comportamento do parâmetro: - obrigatório se `action` contiver o bit "adicionar mensagem"
severity	integer	Nova severidade para os eventos. Valores possíveis: 0 - não classificado; 1 - informação; 2 - aviso; 3 - médio; 4 - alto; 5 - desastre. Comportamento do parâmetro: - obrigatório se `action` contiver o bit "alterar severidade"
suppress_until	integer	Timestamp Unix até o qual o evento deve ser suprimido. Se definido como "0", a supressão será indefinida. Comportamento do parâmetro: - obrigatório se `action` contiver o bit "suprimir evento"

Valores de retorno

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

Exemplos

Reconhecendo um evento

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

Requisição:

{
           "jsonrpc": "2.0",
           "method": "event.acknowledge",
           "params": {
               "eventids": "20427",
               "action": 6,
               "message": "Problem resolved."
           },
           "id": 1
       }

Resposta:

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

Alterando a gravidade do evento

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