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’appel de la méthode peuvent être révoquées dans les paramètres des rôles utilisateur. Voir User roles pour plus d’informations.

Paramètres

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

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

Paramètre Type Description
dependencies array Déclencheurs dont dépend le déclencheur.

Les déclencheurs doivent avoir uniquement la propriété triggerid définie.
tags array Tags de déclencheur.

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 deux déclencheurs, chacun dépendant d’un autre déclencheur.

Requête :

{
    "jsonrpc": "2.0",
    "method": "trigger.create",
    "params": [
        {
            "description": "La charge du processeur est trop élevée sur {HOST.NAME}",
            "expression": "last(/Linux server/system.cpu.load[percpu,avg1])>5",
            "dependencies": [
                {
                    "triggerid": "17367"
                }
            ]
        },
        {
            "description": "Le service s’est arrêté",
            "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": ""
                }
            ]
        }
    ],
    "id": 1
}

Réponse :

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

Source

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