trigger.update

Description

object trigger.update(object/array triggers)

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

Cette méthode est disponible uniquement pour les types d'utilisateurs Admin et Super admin. Les autorisations d'appeler la méthode peuvent être révoquées dans les paramètres de rôles utilisateur. Voir Rôles Utilisateur 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 la propriété `triggerid` définie.
tags	array	Tags. de déclencheur.

L'expression du déclencheur 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
       }

Replacing dependencies

Replace dependencies for trigger.

Request:

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

Response:

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

Source

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

Documentation