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

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

[comment]: # ({07725e16-eed7fdda})
### Description

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

Cette méthode vous 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.
-   Annuler l'acquittement de l'événement. Si l'événement n'est pas acquitté, cette action sera ignorée.
-   Ajouter un message.
-   Modifier 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.
-   Supprimer l'événement. Si l'événement est déjà supprimé, cette action sera ignorée.
-   Annuler la suppression de l'événement. Si l'événement n'est pas supprimé, cette action sera ignorée.
-   Changer le rang de l'événement en cause. Si l'événement est déjà classé comme cause, cette action sera ignorée.
-   Changer le rang de l'événement en symptôme. Si l'événement est déjà classé comme symptôme, cette action sera ignorée.

::: noteimportant
Seuls les événements de déclencheur peuvent être mis à jour.<br>
Seuls les événements de problème peuvent être mis à jour.<br>
Des droits de lecture/écriture sur le déclencheur sont requis pour fermer l'événement ou modifier sa sévérité.<br>
Pour fermer un événement, la fermeture manuelle doit être autorisée dans le déclencheur.
:::

::: noteclassic
Cette méthode est disponible pour les utilisateurs de tout type. Les autorisations d'appel de la méthode peuvent être révoquées dans les paramètres des rôles utilisateur. Voir [User
roles](/manual/web_interface/frontend_sections/users/user_roles)
pour plus d'informations.
:::

[comment]: # ({/07725e16-eed7fdda})

[comment]: # ({813f39be-32560b88})
### Paramètres

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

|Paramètre|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|eventids|ID/array|ID des [événements](/manual/api/reference/event/object#event) à acquitter.<br><br>[Comportement du paramètre](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatoire*|
|action|integer|Action(s) de mise à jour d'événement.<br><br>Valeurs bitmap possibles :<br>1 - fermer le problème ;<br>2 - acquitter l'événement ;<br>4 - ajouter un message ;<br>8 - modifier la sévérité ;<br>16 - désacquitter l'événement ;<br>32 - supprimer l'événement ;<br>64 - annuler la suppression de l'événement ;<br>128 - changer le rang de l'événement en cause ;<br>256 - changer le rang de l'événement en symptôme.<br><br>Il s'agit d'un champ de masque de bits ; toute somme des valeurs bitmap possibles est acceptée (par exemple, 34 pour acquitter et supprimer l'événement).<br><br>[Comportement du paramètre](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatoire*|
|cause_eventid|ID|ID de l'événement cause.<br><br>[Comportement du paramètre](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatoire* si `action` contient le bit "changer le rang de l'événement en symptôme"|
|message|string|Texte du message.<br><br>[Comportement du paramètre](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatoire* si `action` contient le bit "ajouter un message"|
|severity|integer|Nouvelle sévérité pour les événements.<br><br>Valeurs possibles :<br>0 - non classé ;<br>1 - information ;<br>2 - avertissement ;<br>3 - moyen ;<br>4 - élevé ;<br>5 - désastre.<br><br>[Comportement du paramètre](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatoire* si `action` contient le bit "modifier la sévérité"|
|suppress_until|integer|Horodatage Unix jusqu'auquel l'événement doit être supprimé.<br><br>Si défini sur "0", la suppression sera indéfinie.<br><br>[Comportement du paramètre](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatoire* si `action` contient le bit "supprimer l'événement"|

[comment]: # ({/813f39be-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]: # ({2aa7a118-9e923e4c})
#### Accusé de réception d'un événement

Accusez réception d'un événement unique et laissez un message.

[Requête](/manual/api#performing-requests):

```json
{
    "jsonrpc": "2.0",
    "method": "event.acknowledge",
    "params": {
        "eventids": "20427",
        "action": 6,
        "message": "Problème résolu."
    },
    "id": 1
}
```

Réponse :

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

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

[comment]: # ({63d8190d-94e25d7e})
#### Modification de la sévérité d'un événement

Modifiez la sévérité de plusieurs événements et laissez un message.

[Requête](/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
}
```

Réponse :

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

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

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

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

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