action.create
Opis
object action.create(object/array actions)
Ta metoda umożliwia tworzenie nowych akcji.
Ta metoda jest dostępna tylko dla typów użytkowników Admin i Super admin. Uprawnienia do wywoływania tej metody mogą zostać cofnięte w ustawieniach ról użytkowników. Więcej informacji znajduje się w sekcji Role użytkowników.
Parametry
(object/array) Akcje do utworzenia.
Oprócz standardowych właściwości akcji, metoda akceptuje następujące parametry.
| Parametr | Typ | Opis |
|---|---|---|
| filter | object | Obiekt filtra akcji dla akcji. |
| operations | array | Operacje akcji do utworzenia dla akcji. |
| recovery_operations | array | Operacje odzyskiwania akcji do utworzenia dla akcji. |
| update_operations | array | Operacje aktualizacji akcji do utworzenia dla akcji. |
Zwracane wartości
(object) Zwraca obiekt zawierający identyfikatory ID utworzonych akcji
we właściwości actionids. Kolejność zwracanych identyfikatorów ID jest zgodna
z kolejnością przekazanych akcji.
Przykłady
Utwórz akcję wyzwalacza
Utwórz akcję wyzwalacza, która rozpocznie się, gdy wyzwalacz (zawierający słowo „memory” w nazwie) z hosta „10084” przejdzie do stanu PROBLEM. Akcja będzie miała 4 skonfigurowane operacje. Pierwsza, wykonywana natychmiast operacja wyśle wiadomość do wszystkich użytkowników z grupy użytkowników „7” za pośrednictwem typu mediów „1”. Jeśli zdarzenie nie zostanie rozwiązane w ciągu 30 minut, druga operacja uruchomi skrypt „5” (skrypt o zakresie „Action operation”) na wszystkich hostach z grupy „2”. Jeśli zdarzenie zostanie rozwiązane, operacja odzyskiwania powiadomi wszystkich użytkowników, którzy otrzymali jakiekolwiek wiadomości dotyczące problemu. Jeśli zdarzenie zostanie zaktualizowane, operacja potwierdzenia/aktualizacji powiadomi (z niestandardowym tematem i wiadomością) wszystkich użytkowników, którzy otrzymali jakiekolwiek wiadomości dotyczące problemu.
{
"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
}Odpowiedź:
{
"jsonrpc": "2.0",
"result": {
"actionids": [
"17"
]
},
"id": 1
}Utwórz akcję wykrywania
Utwórz akcję wykrywania, która połączy szablon „10001” z wykrytymi hostami.
{
"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
}Odpowiedź:
{
"jsonrpc": "2.0",
"result": {
"actionids": [
"18"
]
},
"id": 1
}Używanie niestandardowego filtra wyrażeń
Utwórz akcję wyzwalacza, która używa niestandardowego wyrażenia - „A and (B or C)” - do oceniania warunków akcji. Gdy wyzwalacz o ważności wyższej lub równej „Warning” z hosta „10084” lub hosta „10106” przejdzie do stanu PROBLEM, akcja wyśle wiadomość do wszystkich użytkowników z grupy użytkowników „7” za pośrednictwem typu nośnika „1”. Identyfikatory formuły „A”, „B” i „C” zostały wybrane arbitralnie.
{
"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
}Odpowiedź:
{
"jsonrpc": "2.0",
"result": {
"actionids": [
"18"
]
},
"id": 1
}Utwórz regułę autorejestracji agent
Utwórz akcję autorejestracji, która dodaje host do grupy hostów „2”, gdy nazwa hosta zawiera „SRV” lub metadane zawierają „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
}Odpowiedź:
{
"jsonrpc": "2.0",
"result": {
"actionids": [
19
]
},
"id": 1
}Utwórz regułę autorejestracji agent z tagami hosta
Utwórz akcję autorejestracji, która dodaje host do grupy hostów „2” oraz dodaje dwa tagi hosta.
{
"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
}Odpowiedź:
{
"jsonrpc": "2.0",
"result": {
"actionids": [
20
]
},
"id": 1
}Zobacz także
Źródło
CAction::create() w ui/include/classes/api/services/CAction.php.