Documentation
Table of Contents
²¹³¦³¦¾±¨®.³¦°ù±ð²¹°ù
¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®
object action.create(object/array actions)
Aquest m¨¨tode permet crear accions noves.
Aquest m¨¨tode ¨¦s disponible nom¨¦s per als usuaris de tipus Admin i Super admin. Els permisos per cridar al m¨¨tode es poden revocar a la configuraci¨® de rols d'usuaris. Per a m¨¦s informaci¨®, veieu Rols d'usuari.
±Ê²¹°ù¨¤³¾±ð³Ù°ù±ð²õ
(object/array) Accions per crear.
A m¨¦s de les propietat d'accions per defecte, el m¨¨tode accepta els par¨¤metres seg¨¹ents:
| ±Ê²¹°ù¨¤³¾±ð³Ù°ù±ð | Tipus | ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨® |
|---|---|---|
| filtre | objecte | Filtre d'acci¨® objecte per a l'acci¨®. |
| operacions | matriu | Operaci¨® d'acci¨® per crear per a l'acci¨®. |
| recovery_operations | matriu | Operacions de recuperaci¨® d'acci¨® per crear per a l'acci¨®. |
| update_operations | matriu | Operacions d'actualitzaci¨® d'acci¨® per crear per a l'acci¨®. |
Valors de retorn
(object) Retorna un objecte amb els IDs de les accions creades segons la propietat actionids. L'ordre dels IDs retornats correspon a l'ordre de les accions donades.
Exemples
Crear una acci¨® de trigger
Crear una acci¨® que ser¨¤ executada quan un trigger de l'equip "10084"que tingui la paraula "mem¨°ria" al seu nom entri en estat de PROBLEMA. L'acci¨® tindr¨¤ 4 operacions configurades. L'acci¨® ha de, primerament, enviar un missatge a tots els usuaris del grup d'usuaris "7" per via del tipus de suport "1". Si l'esdeveniment no fos pas corregit en 30 minuts, llavors far¨¤ c¨®rrer l'script "5" (script amb ¨¤mbit "Operaci¨® d'acci¨®" a tots els equips del grup "2". Quan l'esdeveniment quedi resolt, una operaci¨® de recuperaci¨® notificar¨¤ a tots els usuaris que hagin rebut qualsevol dels missatges d'av¨ªs del problema. Si l'esdeveniment s'actualitza, es notificaran les operacions de reconeixement/actualitzaci¨® (amb un assumpte i missatge a mida) a tots els usuaris que hagin rebut qualsevol missatge veient el problema.
±Ê±ð³Ù¾±³¦¾±¨®:
{
"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
}Resposta:
Crear una acci¨® de descoberta
Crea una acci¨® que vincular¨¤ els equips descoberts amb la plantilla "10001".
{
"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"
}
]
}
]
},
"id": 1
}Response:
Emprant un filtre d'expressi¨® personalitzat
Crear un trigger que far¨¤ ¨²s d'una expressi¨® personalitzada - "A i (B o C)" - per avaluar les condicions d'acci¨®. Quan el trigger amb una gravetat m¨¦s alta o igual a "Av¨ªs" dels equips "10084" i "10106" assoleixin un estat PROBLEMA, l'acci¨® enviar¨¤ un missatge a tots els usuaris del grup d'usuaris "7" via el tipus de suport "1". Els IDS de f¨°rmula "A", "B" i "C" s'han triat arbitr¨¤riament.
±Ê±ð³Ù¾±³¦¾±¨®:
{
¡¤ "jsonrpc": "2.0",
¡¤ "method": "action.create",
¡¤ "params": {
¡¤ "name": "´¡³¦³¦¾±¨® de trigger",
¡¤ "eventsource": 0,
¡¤ "esc_period": "15m",
¡¤ "filter": {
¡¤ "evaltype": 3,
¡¤ "formula": "A i (B o 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_step_from": 1,
¡¤ "esc_step_to": 1,
¡¤ "opmessage_grp": [
¡¤ {
¡¤ "usrgrpid": "7"
¡¤ }
¡¤ ],
¡¤ "opmessage": {
¡¤ "default_msg": 1,
¡¤ "mediatypeid": "1"
¡¤ }
¡¤ }
¡¤ ]
¡¤ },
¡¤ "auth": "038e1d7b1735c6a5436ee9eae095879e",
¡¤ "id": 1
}Resposta:
Crear una regla de registre autom¨¤tic d'agent
Crea una acci¨® d'autoregistre que afegeix un equip al grup d'equips "2" quan el nom d'equip contingui "SRV" o trobi "AlmaLinux" a les metadades.
±Ê±ð³Ù¾±³¦¾±¨®:
{
"jsonrpc": "2.0",
"method": "action.create",
"params": {
"name": "Registrar servidors Linux",
"eventsource": "2",
"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
}Resposta:
Creaci¨® d'una regla d'autoregistre de l'agent amb etiquetes d'equip
Crea una acci¨® de registre autom¨¤tic que afegeix un equip al grup d'equips "2" i afegeix dues etiquetes d'equip.
{
"jsonrpc": "2.0",
"method": "action.create",
"params": {
"name": "Register Linux servers with tags",
"eventsource": "2",
"operations": [
{
"operationtype": "4",
"opgroup": [
{
"groupid": "2"
}
]
},
{
"operationtype": "13",
"optag": [
{
"tag": "location",
"value": "office"
},
{
"tag": "city",
"value": "Riga"
}
]
}
]
},
"id": 1
}Resposta:
Veieu tamb¨¦
Font
CAction::create() in ui/include/classes/api/services/CAction.php.