[comment]: # translation:outdated

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

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

[comment]: # ({3cf9db19-eed7fdda})
### Description

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

Cette méthode permet de mettre à jour des événements. Les actions de mise à jour suivantes peuvent être effectuées :

-   Fermer l'événement. Si l'événement est déjà résolu, cette action sera ignorée.
-   Acquitter l'événement. Si l'événement est déjà acquitté, cette action sera ignorée.
-   Supprimé l'acquittement de l'événement. Si l'événement n'est pas acquitté, cette action sera ignorée.
-   Ajouter un message.
-   Changer la sévérité de l'événement. Si l'événement a déjà la même sévérité, cette action sera ignorée.

::: noteimportant
Seuls les événements de déclencheurs peuvent être mis à jour.\
Seuls les événements problématiques peuvent être mis à jour.\
Des droits en lecture/écriture pour le déclencheur sont nécessaires pour fermer l'événement ou pour modifier sa sévérité.\
Pour fermer un événement, cela doit être autorisé dans le déclencheur.
:::

::: noteclassic
Cette méthode est disponible pour tous les types d'utilisateurs. Les autorisations d'appeler la méthode peuvent être révoquées dans les paramètres du le rôle d'utilisateur. Voir [Rôles Utilisateur](/manual/web_interface/frontend_sections/administration/user_roles) pour plus d'informations.
:::

[comment]: # ({/3cf9db19-eed7fdda})

[comment]: # ({4f7f6cc3-32560b88})
### Paramètres

`(object/array)` Paramètres contenant les identifiants des événements et les opérations de mise à jour à effectuer.

|Paramètre|Type|Description|
|----------|----|-----------|
|**eventids**<br>(obligatoire)|string/object|ID des événements à acquitter.|
|**action**<br>(obligatoire)|integer|Action(s) de mise à jour des événements. Ce champ est un masque de bits, toute combinaison de valeurs est acceptable.<br><br>Valeurs possibles :<br>1 - fermer le problème ;<br>2 - acquitter l'événement ;<br>4 - ajouter un message ;<br>8 - changer la sévérité ;<br>16 - désacquitter l'évènement.|
|message|string|Texte du message.<br>**Obligatoire**, si l'action contient 'ajouter un message'.|
|severity|integer|Nouvelle sévérité des événements.<br>**Obligatoire**, si l'action contient 'changer la sévérité'.<br><br>Valeurs possibles :<br>0 - non classé ;<br>1 - information ;<br>2 - avertissement ;<br>3 - moyen ;<br>4 - haut ;<br>5 - désastre.|

[comment]: # ({/4f7f6cc3-32560b88})

[comment]: # ({94f3ab84-94f3ab84})
### Valeurs retournées

`(object)` Retourne un objet contenant les identifiants des événements mis à jour sous la propriété `eventids`.

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

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

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

[comment]: # ({2a20eeea-9e923e4c})
#### Acquittement d'un événement

Acquitter un événement et ajouter un message.

Requête :

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

Réponse :

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

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

[comment]: # ({7d16988e-94e25d7e})
#### Changement de sévérité d'un événement

Modifier la sévérité de plusieurs événements et ajouter un message.

Requête :

```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
}
```

Réponse :

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

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

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

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

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