Sidebar

Zabbix Summit 2022
Register for Zabbix Summit 2022

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.