trigger.create

Description

object trigger.create(object/array triggers)

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

Cette méthode est uniquement disponible pour les types d’utilisateurs Admin et Super admin. Les autorisations permettant d’appeler cette méthode peuvent être révoquées dans les paramètres des rôles utilisateur. Consultez la page 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 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.