[comment]: # translation:outdated [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. - Reconnaître l'événement. Si l'événement est déjà reconnu, cette action sera ignorée. - Annuler la reconnaissance de l'événement. Si l'événement n'est pas reconnu, 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.
Seuls les événements de problème peuvent être mis à jour.
Des droits de lecture/écriture sur le déclencheur sont requis pour fermer l'événement ou modifier sa gravité.
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. Voir [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 [events](/manual/api/reference/event/object#event) à acquitter.

[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):
- *required*| |action|integer|Action(s) de mise à jour de l'événement.

Valeurs bitmap possibles :
1 - fermer le problème;
2 - acquitter l'événement;
4 - ajouter un message;
8 - changer la gravité;
16 - annuler l'acquittement de l'événement;
32 - supprimer l'événement;
64 - annuler la suppression de l'événement;
128 - changer le rang de l'événement en cause;
256 - changer le rang de l'événement en symptôme.

Ce champ est un masque de bits ; toute somme des valeurs bitmap possibles est acceptable (par exemple, 34 pour acquitter et supprimer l'événement).

[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):
- *required*| |cause_eventid|ID|ID de l'événement cause.

[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):
- *required* si `action` contient le bit "changer le rang de l'événement en symptôme"| |message|string|Texte du message.

[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):
- *required* si `action` contient le bit "ajouter un message"| |severity|integer|Nouvelle gravité pour les événements.

Valeurs possibles :
0 - non classé;
1 - information;
2 - avertissement;
3 - moyen;
4 - élevé;
5 - catastrophe.

[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):
- *required* si `action` contient le bit "changer la gravité"| |suppress_until|integer|Horodatage Unix jusqu'auquel l'événement doit être supprimé.

Si défini à "0", la suppression sera indéfinie.

[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):
- *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]: # ({9a2accef-0282adaa}) #### Suppression d'un événement indéfiniment Supprimer la suppression d'un seul événement sans date d'expiration. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "event.acknowledge", "params": { "eventids": "20427", "action": 32, "suppress_until": 0 }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "eventids": [ 20427 ] }, "id": 1 } ``` [comment]: # ({/9a2accef-0282adaa}) [comment]: # ({dcf1d864-92dd2ab3}) #### Annulation de la suppression d'un événement Annulez la suppression d'un seul événement précédemment supprimé. [Requête](/manual/api#performing-requests) : ```json { "jsonrpc": "2.0", "method": "event.acknowledge", "params": { "eventids": "20427", "action": 64 }, "id": 1 } ``` Réponse : ```json { "jsonrpc": "2.0", "result": { "eventids": [ 20427 ] }, "id": 1 } ``` [comment]: # ({/dcf1d864-92dd2ab3}) [comment]: # ({b088ad43-7c63815d}) #### Reconnaître et supprimer un déclencheur Reconnaître un ou plusieurs événements, ajouter un message et les supprimer dans la même requête. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "event.acknowledge", "params": { "eventids": [ "20427", "20428" ], "action": 38, "message": "Suppressing during planned maintenance.", "suppress_until": 0 }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "eventids": [ 20427, 20428 ] }, "id": 1 } ``` [comment]: # ({/b088ad43-7c63815d}) [comment]: # ({aadd99f7-aadd99f7}) ### Source CEvent::acknowledge() dans *ui/include/classes/api/services/CEvent.php*. [comment]: # ({/aadd99f7-aadd99f7})