trigger.create
Description
object trigger.create(object/array triggers)
Cette méthode permet de créer de nouveaux déclencheurs.
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) Déclencheurs à créer.
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 créés sous la propriété triggerids. L'ordre des ID retournés correspond à l'ordre des déclencheurs transmis.
Exemples
Création d'un déclencheur
Créez un déclencheur avec une seule dépendance de déclencheur.
Requête :
{
"jsonrpc": "2.0",
"method": "trigger.create",
"params": [
{
"description": "Processor load is too high on {HOST.NAME}",
"expression": "last(/Linux server/system.cpu.load[percpu,avg1])>5",
"dependencies": [
{
"triggerid": "17367"
}
]
},
{
"description": "Service status",
"expression": "length(last(/Linux server/log[/var/log/system,Service .* has stopped]))<>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 ui/include/classes/api/services/CTrigger.php.