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

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

[comment]: # ({2224f5b5-eed7fdda})
### Descrizione

`object event.acknowledge(object/array parameters)`

Questo metodo consente di aggiornare gli eventi.
È possibile eseguire le seguenti azioni di aggiornamento:

-   Chiudere l'evento.
Se l'evento è già risolto, questa azione verrà ignorata.
-   Acknowledge dell'evento.
Se l'evento è già acknowledged, questa azione verrà ignorata.
-   Rimuovere l'acknowledge dell'evento.
Se l'evento non è acknowledged, questa azione verrà ignorata.
-   Aggiungere un messaggio.
-   Modificare la severità dell'evento.
Se l'evento ha già la stessa severità, questa azione verrà ignorata.
-   Sopprimere l'evento.
Se l'evento è già soppresso, questa azione verrà ignorata.
-   Rimuovere la soppressione dell'evento.
Se l'evento non è soppresso, questa azione verrà ignorata.
-   Modificare il rank dell'evento in causa.
Se l'evento è già classificato come causa, questa azione verrà ignorata.
-   Modificare il rank dell'evento in sintomo.
Se l'evento è già classificato come sintomo, questa azione verrà ignorata.

::: noteimportant
Possono essere aggiornati solo gli eventi di trigger.<br>
Possono essere aggiornati solo gli eventi di problema.<br>
Per chiudere l'evento o modificarne la severità sono necessari i diritti di lettura/scrittura per il trigger.<br>
Per chiudere un evento, la chiusura manuale deve essere consentita nel trigger.
:::

::: noteclassic
Questo metodo è disponibile per utenti di qualsiasi tipo.
Le autorizzazioni per chiamare il metodo possono essere revocate nelle impostazioni del ruolo utente.
Per ulteriori informazioni, vedere [Ruoli utente](/manual/web_interface/frontend_sections/users/user_roles).
:::

[comment]: # ({/2224f5b5-eed7fdda})

[comment]: # ({2559b8ef-32560b88})
### Parametri

`(object/array)` Parametri contenenti gli ID degli eventi e le operazioni di aggiornamento che devono essere eseguite.

|Parameter|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|eventids|ID/array|ID degli [eventi](/manual/api/reference/event/object#event) da confermare.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required*|
|action|integer|Azione o azioni di aggiornamento dell'evento.<br><br>Possibili valori bitmap:<br>1 - chiudi il problema;<br>2 - conferma evento;<br>4 - aggiungi messaggio;<br>8 - cambia gravità;<br>16 - annulla conferma evento;<br>32 - sopprimi evento;<br>64 - rimuovi soppressione evento;<br>128 - cambia il rango dell'evento in causa;<br>256 - cambia il rango dell'evento in sintomo.<br><br>Questo è un campo bitmask; è accettabile qualsiasi somma dei possibili valori bitmap (ad esempio, 34 per confermare e sopprimere l'evento).<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required*|
|cause_eventid|ID|ID dell'evento causa.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* se `action` contiene il bit "change event rank to symptom"|
|message|string|Testo del messaggio.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* se `action` contiene il bit "add message"|
|severity|integer|Nuova gravità per gli eventi.<br><br>Valori possibili:<br>0 - non classificato;<br>1 - informazione;<br>2 - avviso;<br>3 - medio;<br>4 - alto;<br>5 - disastro.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* se `action` contiene il bit "change severity"|
|suppress_until|integer|Timestamp Unix fino al quale l'evento deve essere soppresso.<br><br>Se impostato a "0", la soppressione sarà indefinita.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* se `action` contiene il bit "suppress event"|

[comment]: # ({/2559b8ef-32560b88})

[comment]: # ({2974bd26-94f3ab84})
### Valori restituiti

`(object)` Restituisce un oggetto contenente gli ID degli eventi aggiornati nella proprietà `eventids`.

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

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

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

[comment]: # ({2aa7a118-9e923e4c})
#### Riconoscimento di un evento

Riconosci un singolo evento e lascia un messaggio.

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

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

Risposta:

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

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

[comment]: # ({63d8190d-94e25d7e})
#### Modifica della gravità dell'evento

Modificare la gravità per più eventi e lasciare un messaggio.

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

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

Risposta:

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

[comment]: # ({/63d8190d-94e25d7e})

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

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

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