Esta página fue traducida automáticamente. Si detectas un error, selecciónalo y presiona Ctrl+Enter para informarlo a los editores.

event.acknowledge

Descripción

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 acción será omitida.
  • Reconocer evento. Si el evento ya ha sido reconocido, esta acción será omitida.
  • Evento sin reconocimiento. Si no se reconoce el evento, se omitirá esta acción.
  • Agregar mensaje.
  • Cambiar la gravedad del evento. Si el evento ya tiene la misma gravedad, se omitirá la acción.
  • Suprimir evento. Si el evento ya está suprimido, se omitirá esta acción.
  • Desactivar evento. Si el evento no está suprimido, esta acción 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.

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.

Solicitud:

{
           "jsonrpc": "2.0",
           "method": "event.acknowledge",
           "params": {
               "eventids": ["20427", "20428"],
               "action": 12,
               "message": "Maintenance required to fix it.",
               "severity": 4
           },
           "id": 1
       }

Respuesta:

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

Fuente

CEvent::acknowledge() en ui/include/classes/api/services/CEvent.php.