Sidebar

fr:manual:api:reference:trigger:update

trigger.update

Description

object trigger.update(object/array triggers)

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

Paramètres

(object/array) Propriétés des déclencheurs à 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 du 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 mis à jour sous la propriété triggerids.

Exemples

Activer un déclencheur

Activer un déclencheur, c’est-à-dire définir son statut à 0.

Requête :

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

Réponse :

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

Remplacement des tags des déclencheurs

Remplacement des tags des déclencheurs.

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": ""
            }
        ]
    },
    "auth": "038e1d7b1735c6a5436ee9eae095879e",
    "id": 1
}

Réponse :

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

Voir également

Source

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