trigger.create

Description

object trigger.create(object/array triggers)

Cette méthode permet de créer de nouveaux déclencheurs.

Cette méthode est disponible uniquement pour les types d'utilisateurs Admin et Super admin. Les autorisations d'appeler la méthode peuvent être révoquées dans les paramètres de rôles utilisateur. Voir Rôles Utilisateur pour plus d'informations.

Paramètres

(object/array) Déclencheurs à créer.

En plus des propriétés standard du déclencheur, la méthode accepte les paramètres suivants.

Paramètre	Type	Description
dependencies	array	Déclencheurs dont le déclencheur dépend. Les déclencheurs doivent avoir la propriété `triggerid` définie.
tags	array	Tags de déclencheur.

L'expression du déclencheur doit être donnée sous sa forme développée.

Valeurs retournées

(object) Retourne un objet contenant les identifiants des déclencheurs créés sous la propriété triggerids. L'ordre des ID retournés correspond à l'ordre des déclencheurs transmis.

Exemples

Création d'un déclencheur

Créez un déclencheur avec une seule dépendance de déclencheur.

Requête :

{
           "jsonrpc": "2.0",
           "method": "trigger.create",
           "params": [
               {
                   "description": "Processor load is too high on {HOST.NAME}",
                   "expression": "last(/Linux server/system.cpu.load[percpu,avg1])>5",
                   "dependencies": [
                       {
                           "triggerid": "17367"
                       }
                   ]
               },
               {
                   "description": "Service status",
                   "expression": "length(last(/Linux server/log[/var/log/system,Service .* has stopped]))<>0",
                   "dependencies": [
                       {
                           "triggerid": "17368"
                       }
                   ],
                   "tags": [
                       {
                           "tag": "service",
                           "value": "{{ITEM.VALUE}.regsub(\"Service (.*) has stopped\", \"\\1\")}"
                       },
                       {
                           "tag": "error",
                           "value": ""
                       }
                   ]
               }
           ],
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Réponse :

{
           "jsonrpc": "2.0",
           "result": {
               "triggerids": [
                   "17369",
                   "17370"
               ]
           },
           "id": 1
       }

Source

CTrigger::create() dans ui/include/classes/api/services/CTrigger.php.

Documentation