event.acknowledge

Descripción

object event.acknowledge(object/array parameters)

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 se omitirá.
  • Reconocer evento. Si el evento ya está reconocido, esta acción se omitirá.
  • Anular reconocimiento del evento. Si el evento no está reconocido, esta acción se omitirá.
  • Agregar mensaje.
  • Cambiar la severidad del evento. Si el evento ya tiene la misma severidad, esta acción se omitirá.
  • Suprimir evento. Si el evento ya está suprimido, esta acción se omitirá.
  • Anular supresión del evento. Si el evento no está suprimido, esta acción se omitirá.
  • Cambiar la clasificación del evento a causa. Si el evento ya está clasificado como causa, esta acción se omitirá.
  • Cambiar la clasificación del evento a síntoma. Si el evento ya está clasificado como síntoma, esta acción se omitirá.

Solo se pueden actualizar eventos de trigger.
Solo se pueden actualizar eventos de problema.
Se requieren permisos de lectura/escritura para el trigger para cerrar el evento o cambiar la severidad del evento.
Para cerrar un evento, el cierre manual debe estar permitido en el trigger.

Este método está disponible para usuarios de cualquier tipo. Los permisos para llamar al método pueden revocarse en la configuración del rol de usuario. Consulte User roles para obtener más información.

Parámetros

(object/array) Parámetros que contienen los IDs de los eventos y las operaciones de actualización que deben realizarse.

Parameter Type Description
eventids ID/array IDs de los events que se deben reconocer.

Parameter behavior:
- required
action integer Acción(es) de actualización del event.

Valores posibles de bitmap:
1 - cerrar problema;
2 - reconocer event;
4 - añadir mensaje;
8 - cambiar severidad;
16 - anular reconocimiento del event;
32 - suprimir event;
64 - anular supresión del event;
128 - cambiar la clasificación del event a causa;
256 - cambiar la clasificación del event a síntoma.

Este es un campo de máscara de bits; se acepta cualquier suma de los valores posibles de bitmap (por ejemplo, 34 para reconocer y suprimir el event).

Parameter behavior:
- required
cause_eventid ID ID del event causa.

Parameter behavior:
- required si action contiene el bit "change event rank to symptom"
message string Texto del mensaje.

Parameter behavior:
- required si action contiene el bit "add message"
severity integer Nueva severidad para los events.

Valores posibles:
0 - no clasificado;
1 - información;
2 - advertencia;
3 - promedio;
4 - alto;
5 - desastre.

Parameter behavior:
- required si action contiene el bit "change severity"
suppress_until integer Marca de tiempo Unix hasta la cual el event debe permanecer suprimido.

Si se establece en "0", la supresión será indefinida.

Parameter behavior:
- required si action contiene el bit "suppress event"

Valores de retorno

(object) Devuelve un objeto que contiene los IDs de los eventos actualizados en la propiedad eventids.

Ejemplos

Reconociendo un evento

Reconocer un solo evento y dejar un mensaje.

Solicitud:

{
    "jsonrpc": "2.0",
    "method": "event.acknowledge",
    "params": {
        "eventids": "20427",
        "action": 6,
        "message": "Problema resuelto."
    },
    "id": 1
}

Respuesta:

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

Cambiar la gravedad del evento

Cambiar la gravedad de varios eventos y dejar un mensaje.

Solicitud:

{
    "jsonrpc": "2.0",
    "method": "event.acknowledge",
    "params": {
        "eventids": ["20427", "20428"],
        "action": 12,
        "message": "Se requiere mantenimiento para solucionarlo.",
        "severity": 4
    },
    "id": 1
}

Respuesta:

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

Suprimir un evento indefinidamente

Suprime un único evento sin tiempo de expiración.

Request:

{
    "jsonrpc": "2.0",
    "method": "event.acknowledge",
    "params": {
        "eventids": "20427",
        "action": 32,
        "suppress_until": 0
    },
    "id": 1
}

Response:

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

Anular la supresión de un evento

Anule la supresión de un único evento previamente suprimido.

Solicitud:

{
    "jsonrpc": "2.0",
    "method": "event.acknowledge",
    "params": {
        "eventids": "20427",
        "action": 64
    },
    "id": 1
}

Respuesta:

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

Reconocer y suprimir un evento

Reconozca uno o más eventos, agregue un mensaje y suprímalos en la misma solicitud.

Solicitud:

{
    "jsonrpc": "2.0",
    "method": "event.acknowledge",
    "params": {
        "eventids": [
            "20427",
            "20428"
        ],
        "action": 38,
        "message": "Suppressing during planned maintenance.",
        "suppress_until": 0
    },
    "id": 1
}

Respuesta:

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

Fuente

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