[comment]: # ({2ccfd922-2ccfd922})
# event.acknowledge

[comment]: # ({/2ccfd922-2ccfd922})

[comment]: # ({6bcb499e-eed7fdda})
### 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à.

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

:::noteclassic
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](/manual/web_interface/frontend_sections/administration/user_roles) per obtenir més informació.
:::

[comment]: # ({/6bcb499e-eed7fdda})

[comment]: # ({01c3ba61-32560b88})
### Paramètres

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

|Paràmetre|Tipus|Descripció|
|----------|----|-----------|
|**eventids**<br>(obligatori)|string/object|ID dels esdeveniments a reconèixer.|
|**action**<br>(obligatori)|integer|Accions d'actualització d'esdeveniments. Aquest camp és una màscara de bits, qualsevol combinació de valors és acceptable.<br><br>Valors possibles:<br>1 - tanqueu el problema;<br>2 - reconeixeu l'esdeveniment;<br>4 - afegiu un missatge ;<br>8 - canviar la gravetat;<br>16 - no reconèixer l'esdeveniment.<br><br>És un camp de màscara de bit; s'admet qualsevol suma de possibles valors de mapa de bits (per exemple, 6 per reconèixer un esdeveniment i afegir un missatge).|
|message|string|Text del missatge.<br>**Obligatori**, si l'acció conté 'afegir missatge'.|
|severity|integer|Gravetat de l'esdeveniment nou.<br>**Obligatori**, si l'acció conté 'canviar la gravetat'.<br><br>Valors possibles:<br>0 - sense classificar;<br> 1 - informació;< br>2 - avís;<br>3 - mitjà;<br>4 - alt;<br>5 - desastre.|

[comment]: # ({/01c3ba61-32560b88})

[comment]: # ({94f3ab84-94f3ab84})
### Valors de retorn

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

[comment]: # ({/94f3ab84-94f3ab84})

[comment]: # ({b41637d2-b41637d2})
### Exemples

[comment]: # ({/b41637d2-b41637d2})

[comment]: # ({2a20eeea-9e923e4c})
#### Reconèixer un esdeveniment

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

Petició:

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

Resposta:

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

[comment]: # ({/2a20eeea-9e923e4c})

[comment]: # ({7d16988e-94e25d7e})
#### Canviar la gravetat d'un esdeveniment

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

Petició:

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

Resposta:

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

[comment]: # ({/7d16988e-94e25d7e})

[comment]: # ({aadd99f7-aadd99f7})
### Font
CEvent::acknowledge() in *ui/include/classes/api/services/CEvent.php*.

[comment]: # ({/aadd99f7-aadd99f7})