event.acknowledge

Descripción

objeto event.acknowledge(objeto/parámetros de matriz)

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 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.

Sólo se pueden actualizar los eventos de inniciadores.
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 puede revocar en la configuración de roles de usuario. Ver roles de usuario para más información.

Parámetros

(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 (obligatorio)	cadena/objeto	ID de los eventos a reconocer.
action (obligatorio)	entero	Acciones de actualización de eventos. Este es el campo de máscara de bits, cualquier combinación de valores es aceptable. Valores posibles: 1 - cerrar problema; 2 - confirmar evento; 4 - agregar mensaje; 8 - cambiar la gravedad; 16 - evento sin reconocimiento.
message	cadena	Texto del mensaje. Obligatorio, si la acción contiene el indicador "agregar mensaje".
severity	entero	Nueva gravedad para eventos. Obligatorio, si la acción contiene el indicador 'cambiar gravedad'. Valores posibles: 0 - no clasificado; 1 - información; 2 - advertencia; 3 - promedio; 4 - alto; 5 - desastre.

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."
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "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.