Documentation
Table of Contents
action.create
Description
object action.create(object/array actions)
Cette méthode permet de créer de nouvelles actions.
Paramètres
(object/array) Actions à créer.
En plus des propriétés de l'objet action standard, la méthode accepte les paramètres suivants.
| Paramètre | Type | Description |
|---|---|---|
| filter | object | Objet de filtre d'action pour l'action. |
| operations | array | Opérations d'action à créer pour l'action. |
| recovery_operations | array | Opérations de récupération d'action à créer pour l'action. |
| acknowledge_operations | array | Opérations d'acquittement d'action à créer pour l'action. |
Valeurs retournées
(object) Retourne un objet contenant les identifiants des actions créées sous la propriété actionids. L'ordre des ID retournés correspond à l'ordre des actions transmises.
Exemples
Créer une action de déclenchement
Créer une action à exécuter lorsqu'un déclencheur de l'hôte "30045" portant le mot "memory" dans son nom passe à l'état problématique. L'action doit d'abord envoyer un message à tous les utilisateurs du groupe d'utilisateurs "7". Si l'événement n'est pas résolu dans les 4 minutes, le script "3" sera exécuté sur tous les hôtes du groupe "2". Lors de la récupération par déclenchement, il avertira tous les utilisateurs ayant reçu des messages concernant le problème auparavant. Lors de l'acquittement du déclencheur, un message avec un sujet et un corps personnalisés sera envoyé à tous ceux qui ont laissé des accusés de réception et des commentaires via tous les types de support.
Requête :
{
"jsonrpc": "2.0",
"method": "action.create",
"params": {
"name": "Trigger action",
"eventsource": 0,
"status": 0,
"esc_period": "2m",
"def_shortdata": "{TRIGGER.NAME}: {TRIGGER.STATUS}",
"def_longdata": "{TRIGGER.NAME}: {TRIGGER.STATUS}\r\nLast value: {ITEM.LASTVALUE}\r\n\r\n{TRIGGER.URL}",
"filter": {
"evaltype": 0,
"conditions": [
{
"conditiontype": 1,
"operator": 0,
"value": "10084"
},
{
"conditiontype": 3,
"operator": 2,
"value": "memory"
}
]
},
"operations": [
{
"operationtype": 0,
"esc_period": "0s",
"esc_step_from": 1,
"esc_step_to": 2,
"evaltype": 0,
"opmessage_grp": [
{
"usrgrpid": "7"
}
],
"opmessage": {
"default_msg": 1,
"mediatypeid": "1"
}
},
{
"operationtype": 1,
"esc_step_from": 3,
"esc_step_to": 4,
"evaltype": 0,
"opconditions": [
{
"conditiontype": 14,
"operator": 0,
"value": "0"
}
],
"opcommand_grp": [
{
"groupid": "2"
}
],
"opcommand": {
"type": 4,
"scriptid": "3"
}
}
],
"recovery_operations": [
{
"operationtype": "11",
"opmessage": {
"default_msg": 1
}
}
],
"acknowledge_operations": [
{
"operationtype": "12",
"opmessage": {
"message": "Custom acknowledge operation message body",
"subject": "Custom acknowledge operation message subject"
}
}
]
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 1
}Réponse :
Création d'une action de découverte
Créer une action qui liera les hôtes découverts au modèle "30085".
Requête :
{
"jsonrpc": "2.0",
"method": "action.create",
"params": {
"name": "Discovery action",
"eventsource": 1,
"status": 0,
"esc_period": "0s",
"filter": {
"evaltype": 0,
"conditions": [
{
"conditiontype": 21,
"value": "1"
},
{
"conditiontype": 10,
"value": "2"
}
]
},
"operations": [
{
"esc_step_from": 1,
"esc_period": "0s",
"optemplate": [
{
"templateid": "10091"
}
],
"operationtype": 6,
"esc_step_to": 1
}
]
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 1
}Réponse :
Utilisation d'un filtre d'expression personnalisé
Créer une action de déclenchement qui utilisera une condition de filtre personnalisée. L'action doit envoyer un message pour chaque déclencheur avec une gravité supérieure ou égale à "Avertissement" pour les hôtes "10084" et "10106". Les identifiants de formules "A", "B" et "C" ont été choisis arbitrairement.
Requête :
{
"jsonrpc": "2.0",
"method": "action.create",
"params": {
"name": "Trigger action",
"eventsource": 0,
"status": 0,
"esc_period": "2m",
"def_shortdata": "{TRIGGER.NAME}: {TRIGGER.STATUS}",
"def_longdata": "{TRIGGER.NAME}: {TRIGGER.STATUS}\r\nLast value: {ITEM.LASTVALUE}\r\n\r\n{TRIGGER.URL}",
"filter": {
"evaltype": 3,
"formula": "A and (B or C)",
"conditions": [
{
"conditiontype": 4,
"operator": 5,
"value": "2",
"formulaid": "A"
},
{
"conditiontype": 1,
"operator": 0,
"value": "10084",
"formulaid": "B"
},
{
"conditiontype": 1,
"operator": 0,
"value": "10106",
"formulaid": "C"
}
]
},
"operations": [
{
"operationtype": 0,
"esc_period": "0s",
"esc_step_from": 1,
"esc_step_to": 2,
"evaltype": 0,
"opmessage_grp": [
{
"usrgrpid": "7"
}
],
"opmessage": {
"default_msg": 1,
"mediatypeid": "1"
}
}
]
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 1
}Réponse :
Voir également
Source
CAction::create() dans frontends/php/include/classes/api/services/CAction.php.