event.acknowledge

Descripción

object event.acknowledge(object/array parameters)

Este método permite actualizar eventos. Se pueden realizar las siguientes acciones de actualización:

Cerrar evento. Si el evento ya está resuelto, esta acción se omitirá.
Reconocer evento. Si el evento ya está reconocido, esta acción se omitirá.
Quitar reconocimiento del evento. Si el evento no está reconocido, esta acción se omitirá.
Añadir mensaje.
Cambiar la severidad del evento. Si el evento ya tiene la misma severidad, esta acción se omitirá.
Suprimir evento. Si el evento ya está suprimido, esta acción se omitirá.
Quitar la supresión del evento. Si el evento no está suprimido, esta acción se omitirá.
Cambiar el rango del evento a causa. Si el evento ya está clasificado como causa, esta acción se omitirá.
Cambiar el rango del evento a síntoma. Si el evento ya está clasificado como síntoma, esta acción se omitirá.

Solo se pueden actualizar eventos de trigger.
Solo se pueden actualizar eventos de problema.
Se requieren permisos de lectura/escritura para el trigger para cerrar el evento o cambiar la severidad del evento.
Para cerrar un evento, debe permitirse el cierre manual en el trigger.

Este método está disponible para usuarios de cualquier tipo. Los permisos para llamar al método pueden ser revocados en la configuración del rol de usuario. Consulte Roles de usuario para obtener más información.

Parámetros

(objeto/array) Parámetros que contienen los IDs de los eventos y las operaciones de actualización que deben realizarse.

Parámetro	Tipo	Descripción
eventids	ID/array	IDs de los eventos a reconocer. Comportamiento del parámetro: - obligatorio
action	entero	Acción(es) de actualización de evento. Valores posibles de la máscara de bits: 1 - cerrar problema; 2 - reconocer evento; 4 - añadir mensaje; 8 - cambiar severidad; 16 - desreconocer evento; 32 - suprimir evento; 64 - anular supresión de evento; 128 - cambiar el rango del evento a causa; 256 - cambiar el rango del evento a síntoma. Este es un campo de máscara de bits; cualquier suma de los valores posibles es aceptable (por ejemplo, 34 para reconocer y suprimir evento). Comportamiento del parámetro: - obligatorio
cause_eventid	ID	ID del evento causa. Comportamiento del parámetro: - obligatorio si `action` contiene el bit "cambiar el rango del evento a síntoma"
message	string	Texto del mensaje. Comportamiento del parámetro: - obligatorio si `action` contiene el bit "añadir mensaje"
severity	entero	Nueva severidad para los eventos. Valores posibles: 0 - no clasificado; 1 - información; 2 - advertencia; 3 - media; 4 - alta; 5 - desastre. Comportamiento del parámetro: - obligatorio si `action` contiene el bit "cambiar severidad"
suppress_until	entero	Marca de tiempo Unix hasta la que el evento debe ser suprimido. Si se establece en "0", la supresión será indefinida. Comportamiento del parámetro: - obligatorio si `action` contiene el bit "suprimir evento"

Valores de retorno

(objeto) Devuelve un objeto que contiene los ID de los eventos actualizados bajo la propiedad eventids.

Ejemplos

Reconocer un evento

Reconocer un solo evento y dejar un mensaje.

Solicitud:

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

Respuesta:

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

Cambiar la gravedad del evento

Cambie la gravedad de varios eventos y deje un mensaje.