action.create
Apraksts
object action.create(object/array actions)
Šī metode ļauj izveidot jaunas darbības.
Šī metode ir pieejama tikai Admin un Super admin lietotāju tipiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet Lietotāju lomas.
Parametri
(object/array) Darbības, ko izveidot.
Papildus standarta darbības īpašībām metode pieņem šādus parametrus.
| Parametrs | Tips | Apraksts |
|---|---|---|
| filter | object | Darbības filtra objekts darbībai. |
| operations | array | Darbības operācijas, ko izveidot darbībai. |
| recovery_operations | array | Darbības atkopšanas operācijas, ko izveidot darbībai. |
| update_operations | array | Darbības atjaunināšanas operācijas, ko izveidot darbībai. |
Atgrieztās vērtības
(object) Atgriež objektu, kas satur izveidoto darbību ID
īpašībā actionids. Atgriezto ID secība atbilst
nodoto darbību secībai.
Piemēri
Izveidot trigera darbību
Izveidojiet trigera darbību, kas sāksies, tiklīdz trigeris (ar vārdu "memory" tā nosaukumā) no hosta "10084" pāries PROBLEM stāvoklī. Darbībai būs konfigurētas 4 operācijas. Pirmā un tūlītējā operācija nosūtīs ziņojumu visiem lietotājiem lietotāju grupā "7", izmantojot medija tipu "1". Ja notikums netiek atrisināts 30 minūšu laikā, tiks izpildīta otrā operācija — skripts "5" (skripts ar tvērumu "Action operation") — visos hostos grupā "2". Ja notikums tiek atrisināts, atkopšanas operācija paziņos visiem lietotājiem, kuri saņēma jebkādus ziņojumus par problēmu. Ja notikums tiek atjaunināts, apstiprināšanas/atjaunināšanas operācija paziņos (ar pielāgotu tēmu un ziņojumu) visiem lietotājiem, kuri saņēma jebkādus ziņojumus par problēmu.
{
"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"
}
}
]
},
"id": 1
}Atbilde:
{
"jsonrpc": "2.0",
"result": {
"actionids": [
"17"
]
},
"id": 1
}Izveidot atklāšanas darbību
Izveidojiet atklāšanas darbību, kas piesaistīs veidni "10001" atklātajiem hostiem.
{
"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
}Atbilde:
{
"jsonrpc": "2.0",
"result": {
"actionids": [
"18"
]
},
"id": 1
}Pielāgotas izteiksmes filtra izmantošana
Izveidojiet trigera darbību, kas darbības nosacījumu novērtēšanai izmanto pielāgotu izteiksmi — "A and (B or C)". Kad trigeris ar svarīgumu, kas ir augstāks vai vienāds ar "Warning", no hosta "10084" vai hosta "10106" pāriet PROBLEM stāvoklī, darbība nosūtīs ziņojumu visiem lietotājiem lietotāju grupā "7", izmantojot medija tipu "1". Formulu ID "A", "B" un "C" ir izvēlēti patvaļīgi.
{
"jsonrpc": "2.0",
"method": "action.create",
"params": {
"name": "Trigger action",
"eventsource": 0,
"esc_period": "15m",
"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_step_from": 1,
"esc_step_to": 1,
"opmessage_grp": [
{
"usrgrpid": "7"
}
],
"opmessage": {
"default_msg": 1,
"mediatypeid": "1"
}
}
]
},
"id": 1
}Atbilde:
{
"jsonrpc": "2.0",
"result": {
"actionids": [
"18"
]
},
"id": 1
}Izveidot aģenta automātiskās reģistrācijas kārtulu
Izveidojiet automātiskās reģistrācijas darbību, kas pievieno hostu hostu grupai "2", ja hosta nosaukums satur "SRV" vai metadati satur "AlmaLinux".
{
"jsonrpc": "2.0",
"method": "action.create",
"params": {
"name": "Register Linux servers",
"eventsource": "2",
"filter": {
"evaltype": "2",
"conditions": [
{
"conditiontype": "22",
"operator": "2",
"value": "SRV"
},
{
"conditiontype": "24",
"operator": "2",
"value": "AlmaLinux"
}
]
},
"operations": [
{
"operationtype": "4",
"opgroup": [
{
"groupid": "2"
}
]
}
]
},
"id": 1
}Atbilde:
{
"jsonrpc": "2.0",
"result": {
"actionids": [
19
]
},
"id": 1
}Izveidojiet aģenta automātiskās reģistrācijas kārtulu ar hostu tagiem
Izveidojiet automātiskās reģistrācijas darbību, kas pievieno hostu hostu grupai "2" un pievieno divus hostu tagus.
{
"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
}Atbilde:
{
"jsonrpc": "2.0",
"result": {
"actionids": [
20
]
},
"id": 1
}Skatiet arī
Avots
CAction::create() failā ui/include/classes/api/services/CAction.php.