event.acknowledge

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.

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.

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 pour plus d'informations.

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

Valeurs retournées

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

Exemples

Acquittement d'un événement

Acquitter un événement et ajouter un message.

Requête :

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

Réponse :

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

Changement de sévérité d'un événement

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