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 ».
{
"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.
{
"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.