object event.acknowledge(object/array parameters)
Este método permite actualizar eventos. Se pueden realizar las siguientes acciones de actualización:
Solo se pueden actualizar eventos de disparadores.
Solo se pueden actualizar eventos de problema.
Se requieren permisos de lectura/escritura para el disparador para cerrar el evento o cambiar la severidad del evento.
Para cerrar un evento, debe permitirse el cierre manual en el disparador.
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 más información.
(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 | integer | Acción(es) de actualización de evento. Valores posibles de bitmap: 1 - cerrar problema; 2 - reconocer evento; 4 - añadir mensaje; 8 - cambiar severidad; 16 - des-reconocer evento; 32 - suprimir evento; 64 - des-suprmir 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 de bitmap 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 | integer | 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 | integer | 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" |
(object)
Devuelve un objeto que contiene los IDs de los eventos actualizados bajo la propiedad eventids
.
Reconocer un solo evento y dejar un mensaje.
{
"jsonrpc": "2.0",
"method": "event.acknowledge",
"params": {
"eventids": "20427",
"action": 6,
"message": "Problema resuelto."
},
"id": 1
}
Respuesta:
Cambiar la gravedad de varios eventos y dejar un mensaje.
{
"jsonrpc": "2.0",
"method": "event.acknowledge",
"params": {
"eventids": ["20427", "20428"],
"action": 12,
"message": "Se requiere mantenimiento para solucionarlo.",
"severity": 4
},
"id": 1
}
Respuesta:
CEvent::acknowledge() en ui/include/classes/api/services/CEvent.php.