Sidebar

Zabbix Summit 2022
Register for Zabbix Summit 2022

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.

Requête :

{
           "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 :

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

Source

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