Documentation
Table of Contents
event.acknowledge
¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®²Ô
object event.acknowledge(object/array parameters)
Este m¨¦todo permite actualizar eventos. Las siguientes acciones de actualizaci¨®n pueden ser realizadas:
- Cerrar evento. Si el evento ya est¨¢ resuelto, esta ²¹³¦³¦¾±¨®²Ô ser¨¢ omitida.
- Reconocer evento. Si el evento ya ha sido reconocido, esta ²¹³¦³¦¾±¨®²Ô ser¨¢ omitida.
- Evento sin reconocimiento. Si no se reconoce el evento, se omitir¨¢ esta ²¹³¦³¦¾±¨®²Ô.
- Agregar mensaje.
- Cambiar la gravedad del evento. Si el evento ya tiene la misma gravedad, se omitir¨¢ la ²¹³¦³¦¾±¨®²Ô.
- Suprimir evento. Si el evento ya est¨¢ suprimido, se omitir¨¢ esta ²¹³¦³¦¾±¨®²Ô.
- Desactivar evento. Si el evento no est¨¢ suprimido, esta ²¹³¦³¦¾±¨®²Ô se omitir¨¢.
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) ±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç²õ que contienen los ID de los eventos y las operaciones de actualizaci¨®n que se deben realizar.
| ±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç | Tipo | ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®²Ô |
|---|---|---|
| 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 ²¹³¦³¦¾±¨®²Ô contiene "cambiar el rango del evento a bit de s¨ªntoma" |
| message | cadena | Texto del mensaje. Comportamiento del par¨¢metro: - obligatorio si ²¹³¦³¦¾±¨®²Ô 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 ²¹³¦³¦¾±¨®²Ô 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 ²¹³¦³¦¾±¨®²Ô 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.
{
"jsonrpc": "2.0",
"method": "event.acknowledge",
"params": {
"eventids": "20427",
"action": 6,
"message": "Problem resolved."
},
"id": 1
}Respuesta:
Cambiar la gravedad del evento
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:
Fuente
CEvent::acknowledge() en ui/include/classes/api/services/CEvent.php.