event.acknowledge

Descripció

object event.acknowledge(object/array parameters)

Aquest mètode s'empra per actualitzar esdeveniments. Es poden realitzar les següents accions d'actualització:

Tancar l'esdeveniment. Si l'esdeveniment ja és resolt, aquesta acció s'ignorarà.
Reconeixement de l'esdeveniment. Si ja s'ha reconegut l'esdeveniment, aquesta acció s'ignorarà.
S'ha eliminat el reconeixement de l'esdeveniment. Si no es reconeix l'esdeveniment, aquesta acció s'ignorarà.
Afegir missatge.
Canviar la gravetat de l'esdeveniment. Si l'esdeveniment ja té la mateixa gravetat, aquesta acció s'ignorarà.
Esborrar un esdeveniment. Si l'esdeveniment ja ha estat esborrat, l'acció es saltarà.
recuperar un esdeveniment esborrat. Si l'esdeveniment no és esborrat, l'acció es saltarà.

::: nota important Només es poden actualitzar els esdeveniments triggers.
Només es poden actualitzar els esdeveniments problemàtics.
Es necessiten permisos de lectura/escriptura per al trigger per tancar l'esdeveniment o canviar-ne la gravetat.
Per tancar un esdeveniment, s'ha de permetre al trigger. :::

Aquest mètode és disponible per a tot tipus d'usuaris. Els permisos per invocar el mètode es poden revocar a la configuració del rol d'usuari. Consulteu Rols d'usuari per obtenir més informació.

Paramètres

(object/array) Paràmetres que contenen identificadors d'esdeveniments i operacions d'actualització a realitzar.

Paràmetre	Tipus	Descripció
eventids	ID/array	ID dels esdeveniments a reconèixer. Comportament de la propietat: - obligatori
action	integer	Accions d'actualització d'esdeveniments. Aquest camp és una màscara de bits, qualsevol combinació de valors és acceptable. Valors possibles: 1 - tanqueu el problema; 2 - reconeixeu l'esdeveniment; 4 - afegiu un missatge ; 8 - canviar la gravetat; 16 - no reconèixer l'esdeveniment. 32 - esborrar esdeveniment; 64 - recuperar esdeveniment esborrat; 128 - canviar la classificació d'esdeveniment a causa; 256 - canviar la classificació de l'esdeveniment a símptoma. És un camp de màscara de bit; s'admet qualsevol suma de possibles valors de mapa de bits (per exemple, 34 per reconeixer i esborrar un esdeveniment). Comportament de la propietat: - obligatori
cause_eventid	ID	ID de l'esdeveniment causa. Comportament de la propietat: - obligatori si `action`conté el bit "canviar la categoria de l'element a símptoma"
message	string	Text del missatge. Comportament de la propietat: - obligatori si `action`conté el bit "afegir missatge"
severity	integer	Gravetat de l'esdeveniment nou. Obligatori, si l'acció conté 'canviar la gravetat'. Valors possibles: 0 - sense classificar; 1 - informació;< br>2 - avís; 3 - mitjà; 4 - alt; 5 - desastre. Comportament de la propietat: - obligatori si `action`conté el bit "canviar gravetat"
supress_until	integer	La marca de temps d'Unix fins quan l'esdeveniment s'ha d'esborrar. Si s'estableix a "0", l'esborrar serà indefinit. Comportament de la propietat: - obligatori si `action`conté el bit "esborrar esdeveniment"

Valors de retorn

(object) Retorna un objecte contingut als IDs dels esdeveniments actualitzats sota la propietat eventids.

Exemples

Reconèixer un esdeveniment

Reconèixer un esdeveniment i afegir-hi un missatge.

Petició](/manual/api#performing-requests): [

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

Resposta:

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

Canviar la gravetat d'un esdeveniment

Canviar la gravetat de múltiples esdeveniments i afegir-hi un missatge.

Petició:

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