trigger.update

Description

object trigger.update(object/array triggers)

Cette méthode permet de mettre à jour des déclencheurs existants.

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 du rôle utilisateur. Voir User roles pour plus d'informations.

Paramètres

(object/array) Propriétés du déclencheur à mettre à jour.

La propriété triggerid doit être définie pour chaque déclencheur, toutes les autres propriétés sont facultatives. Seules les propriétés transmises seront mises à jour, toutes les autres resteront inchangées.

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 mis à jour sous la propriété triggerids.

Exemples

Activation d’un déclencheur

Activez un déclencheur, c’est-à-dire définissez son statut sur « 0 ».

Requête:

{
    "jsonrpc": "2.0",
    "method": "trigger.update",
    "params": {
        "triggerid": "13938",
        "status": 0
    },
    "id": 1
}

Réponse :

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

Remplacement des tags de déclencheur

Remplacez les tags du déclencheur.

Requête :

{
    "jsonrpc": "2.0",
    "method": "trigger.update",
    "params": {
        "triggerid": "13938",
        "tags": [
            {
                "tag": "service",
                "value": "{{ITEM.VALUE}.regsub(\"Service (.*) has stopped\", \"\\1\")}"
            },
            {
                "tag": "error",
                "value": ""
            }
        ]
    },
    "id": 1
}

Réponse :

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

Remplacement des dépendances

Remplace les dépendances du déclencheur.

Requête:

{
    "jsonrpc": "2.0",
    "method": "trigger.update",
    "params": {
        "triggerid": "22713",
        "dependencies": [
            {
                "triggerid": "22712"
            },
            {
                "triggerid": "22772"
            }
        ]
    },
    "id": 1
}

Réponse :

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

Source

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