object event.acknowledge(object/array parameters)
Este método permite actualizar eventos. Las siguientes acciones de actualización pueden ser realizadas:
Sólo se pueden actualizar los eventos de iniciador.
Sólo se pueden actualizar los eventos de problemas.
Se requieren derechos de lectura/escritura para el iniciador para cerrar el evento o para cambiar la gravedad del evento.
Para cerrar un evento, se debe permitir el cierre manual en el iniciador.
Este método está disponible para usuarios de cualquier tipo. Los permisos para llamar al método se pueden revocar en la configuración de roles de usuario. Ver Roles de usuario para más información.
(objeto/matriz)
Parámetros que contienen los ID de los eventos y las operaciones de actualización que se deben realizar.
Parámetro | Tipo | Descripción |
---|---|---|
eventids | ID/matriz | ID de los eventos a reconocer. Comportamiento del parámetro: - obligatorio |
action | entero | Acciones de actualización de evento. Este es un campo de máscara de bits, cualquier combinación de posibles valores de mapa de bits es aceptable. Posibles valores de mapa de bits: 1 - cerrar problema;<br >2 - reconocer evento; 4 - agregar mensaje; 8 - cambiar gravedad; 16 - cancelar evento; 32 - suprimir evento; 64 - cancelar evento; 128 - cambiar el rango del evento a causa; 256 - cambiar el rango del evento a síntoma. Comportamiento del parámetro: - obligatorio |
cause_eventid | ID | ID del evento de causa. Comportamiento del parámetro: - obligatorio si acción contiene "cambiar el rango del evento a bit de síntoma" |
message | cadena | Texto del mensaje. Comportamiento del parámetro: - obligatorio si acción contiene "agregar mensaje" poco |
severity | entero | Nueva gravedad para eventos. Valores posibles: 0 - no clasificado; 1 - información; 2 - advertencia; 3 - promedio;<br >4 - alto; 5 - desastre. Comportamiento del parámetro: - obligatorio si acción contiene el "cambio bit de gravedad" |
suppress_until | entero | Marca de tiempo de Unix hasta la cual se debe suprimir el evento. Si se establece en "0", la supresión será indefinida. Comportamiento del parámetro: - obligatorio si acción contiene el bit "suprimir evento" |
(objeto)
Devuelve un objeto que contiene los ID 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": "Problem resolved."
},
"id": 1
}
Respuesta:
Cambie la gravedad de varios eventos y deje un mensaje.
{
"jsonrpc": "2.0",
"method": "event.acknowledge",
"params": {
"eventids": ["20427", "20428"],
"action": 12,
"message": "Maintenance required to fix it.",
"severity": 4
},
"id": 1
}
Respuesta:
CEvent::acknowledge() en ui/include/classes/api/services/CEvent.php.