Documentation
Table of Contents
acció.crear
Descripció
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.
Paràmetres
(object/array) Accions per crear.
A més de les propietat d'accions per defecte, el mètode accepta els paràmetres següents:
| Paràmetre | Tipus | Descripció |
|---|---|---|
| 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.
Petició:
{
"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.
Petició:
{
· "jsonrpc": "2.0",
· "method": "action.create",
· "params": {
· "name": "Acció 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.
Petició:
{
"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.