Sidebar

fr:manual:api:reference:trigger:create

trigger.create

Description

object trigger.create(object/array triggers)

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

Paramètres

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

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

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

La propriété triggerid doit être définie pour les déclencheurs.
tags array Tags des déclencheurs.
L'expression de déclenchement 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éer un déclencheur

Créer un déclencheur avec une dépendance de déclencheur unique.

Requête :

{
    "jsonrpc": "2.0",
    "method": "trigger.create",
    "params": {
        {
            "description": "Processor load is too high on {HOST.NAME}",
            "expression": "{Linux server:system.cpu.load[percpu,avg1].last()}>5",
            "dependencies": [
                {
                    "triggerid": "17367"
                }
            ]
        },
        {
            "description": "Service status",
            "expression": "{Linux server:log[/var/log/system,Service .* has stopped].strlen()}<>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 frontends/php/include/classes/api/services/CTrigger.php.