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

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

[comment]: # ({2224f5b5-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.
-   Accuser réception de l'événement.
Si l'événement est déjà accusé de réception, cette action sera ignorée.
-   Annuler l'accusé de réception de l'événement.
Si l'événement n'est pas accusé de réception, cette action sera ignorée.
-   Ajouter un message.
-   Modifier la gravité de l'événement.
Si l'événement a déjà la même gravité, cette action sera ignorée.
-   Supprimer la suppression de 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.
-   Modifier le rang de l'événement en cause.
Si l'événement est déjà classé comme cause, cette action sera ignorée.
-   Modifier 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 gravité.<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 du rôle utilisateur.
Consultez [Rôles utilisateur](/manual/web_interface/frontend_sections/users/user_roles) pour plus d'informations.
:::

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

[comment]: # ({2559b8ef-32560b88})
### Paramètres

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

|Parameter|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|eventids|ID/array|IDs des [événements](/manual/api/reference/event/object#event) à acquitter.<br><br>[Comportement du paramètre](/manual/api/reference_commentary#parameter-behavior):<br>- *required*|
|action|integer|Action(s) de mise à jour de l'é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 gravité ;<br>16 - annuler l'acquittement de 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 binaire ; toute somme des valeurs bitmap possibles est acceptable (par exemple, 34 pour acquitter et supprimer l'événement).<br><br>[Comportement du paramètre](/manual/api/reference_commentary#parameter-behavior):<br>- *required*|
|cause_eventid|ID|ID de l'événement en cause.<br><br>[Comportement du paramètre](/manual/api/reference_commentary#parameter-behavior):<br>- *required* 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>- *required* si `action` contient le bit "ajouter un message"|
|severity|integer|Nouvelle gravité 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 - catastrophe.<br><br>[Comportement du paramètre](/manual/api/reference_commentary#parameter-behavior):<br>- *required* si `action` contient le bit "modifier la gravité"|
|suppress_until|integer|Horodatage Unix jusqu'auquel l'événement doit être supprimé.<br><br>Si défini à "0", la suppression sera indéfinie.<br><br>[Comportement du paramètre](/manual/api/reference_commentary#parameter-behavior):<br>- *required* si `action` contient le bit "supprimer l'événement"|

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

[comment]: # ({2974bd26-94f3ab84})
### Valeurs de retour

`(object)` Renvoie un objet contenant les ID des événements mis à jour dans la propriété `eventids`.

[comment]: # ({/2974bd26-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})