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.
  • 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.

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é.
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 frontends/php/include/classes/api/services/CEvent.php.