Documentation
Table of Contents
action.create
Description
object action.create(object/array actions)
Cette m¨¦thode permet de cr¨¦er de nouvelles actions.
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.
±Ê²¹°ù²¹³¾¨¨³Ù°ù±ð²õ
(object/array) Actions ¨¤ cr¨¦er.
En plus des propri¨¦t¨¦s d'action standard, la m¨¦thode accepte les param¨¨tres suivants.
| ±Ê²¹°ù²¹³¾¨¨³Ù°ù±ð | Type | Description |
|---|---|---|
| filter | object | Objet de filtre d'action pour l'action. |
| operations | array | °¿±è¨¦°ù²¹³Ù¾±´Ç²Ô²õ d'action ¨¤ cr¨¦er pour l'action. |
| recovery_operations | array | °¿±è¨¦°ù²¹³Ù¾±´Ç²Ô²õ de r¨¦cup¨¦ration d'action ¨¤ cr¨¦er pour l'action. |
| update_operations | array | °¿±è¨¦°ù²¹³Ù¾±´Ç²Ô²õ de mise ¨¤ jour 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¨¦ez une action de d¨¦clencheur qui commencera une fois qu'un d¨¦clencheur (avec le mot "m¨¦moire" dans son nom) de l'h?te "10084" passera ¨¤ l'¨¦tat PROBL?ME. L'action aura 4 op¨¦rations configur¨¦es. La premi¨¨re op¨¦ration imm¨¦diate enverra un message ¨¤ tous les utilisateurs du groupe d'utilisateurs "7" via le type de m¨¦dia "1". Si l'¨¦v¨¦nement n'est pas r¨¦solu en 30?minutes, la deuxi¨¨me op¨¦ration s'ex¨¦cutera script "5" (script avec la port¨¦e "Action operation") sur tous les h?tes du groupe "2". Si l'¨¦v¨¦nement est r¨¦solu, une op¨¦ration de r¨¦cup¨¦ration informera tous les utilisateurs qui ont re?u des messages concernant le probl¨¨me. Si l'¨¦v¨¦nement est mis ¨¤ jour, une op¨¦ration d'accus¨¦ de r¨¦ception/de mise ¨¤ jour notifiera (avec un objet et un message personnalis¨¦s) tous les utilisateurs qui ont re?u des messages concernant le probl¨¨me.
Requ¨ºte :
{
"jsonrpc": "2.0",
"method": "action.create",
"params": {
"name": "Trigger action",
"eventsource": 0,
"esc_period": "30m",
"filter": {
"evaltype": 0,
"conditions": [
{
"conditiontype": 1,
"operator": 0,
"value": "10084"
},
{
"conditiontype": 3,
"operator": 2,
"value": "memory"
}
]
},
"operations": [
{
"operationtype": 0,
"esc_step_from": 1,
"esc_step_to": 1,
"opmessage_grp": [
{
"usrgrpid": "7"
}
],
"opmessage": {
"default_msg": 1,
"mediatypeid": "1"
}
},
{
"operationtype": 1,
"esc_step_from": 2,
"esc_step_to": 2,
"opconditions": [
{
"conditiontype": 14,
"operator": 0,
"value": "0"
}
],
"opcommand_grp": [
{
"groupid": "2"
}
],
"opcommand": {
"scriptid": "5"
}
}
],
"recovery_operations": [
{
"operationtype": "11",
"opmessage": {
"default_msg": 1
}
}
],
"update_operations": [
{
"operationtype": "12",
"opmessage": {
"default_msg": 0,
"message": "Custom update operation message body",
"subject": "Custom update operation message subject"
}
}
]
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 1
}R¨¦ponse :
Cr¨¦er une action de d¨¦couverte
Cr¨¦er une action qui liera les h?tes d¨¦couverts au mod¨¨le "10001".
Requ¨ºte :
{
"jsonrpc": "2.0",
"method": "action.create",
"params": {
"name": "Discovery action",
"eventsource": 1,
"filter": {
"evaltype": 0,
"conditions": [
{
"conditiontype": 21,
"operator": 0,
"value": "1"
},
{
"conditiontype": 10,
"operator": 0,
"value": "2"
}
]
},
"operations": [
{
"operationtype": 6,
"optemplate": [
{
"templateid": "10001"
}
]
}
]
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 1
}R¨¦ponse :
Utilisation d'un filtre d'expression personnalis¨¦
Cr¨¦ez une action de d¨¦clencheur qui utilisera une condition de filtre personnalis¨¦e. L'action doit envoyer un message pour chaque d¨¦clencheur avec une s¨¦v¨¦rit¨¦ sup¨¦rieure ou ¨¦gale ¨¤ "Warning" pour les hosts "10084" et "10106". Les identifiants de formule "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",
"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"
}
}
],
"pause_suppressed": "0",
"notify_if_canceled": "0"
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 1
}R¨¦ponse :
Cr¨¦er une r¨¨gle d'enregistrement automatique des agents
Ajoutez un h?te au groupe d'h?tes "Linux servers" lorsque le nom d'h?te contient "SRV" ou que les m¨¦tadonn¨¦es contiennent "AlmaLinux".
Requ¨ºte :
{
"jsonrpc": "2.0",
"method": "action.create",
"params": {
"name": "Register Linux servers",
"eventsource": "2",
"status": "0",
"filter": {
"evaltype": "2",
"conditions": [
{
"conditiontype": "22",
"operator": "2",
"value": "SRV"
},
{
"conditiontype": "24",
"operator": "2",
"value": "AlmaLinux"
}
]
},
"operations": [
{
"operationtype": "4",
"opgroup": [
{
"groupid": "2"
}
]
}
]
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 1
}R¨¦ponse :
Voir ¨¦galement
Source
CAction::create() dans ui/include/classes/api/services/CAction.php.