> Action object

Następujące obiekty są bezpośrednio powiązane z API action.

Authentication

Obiekt authentication posiada następujące właściwości.

Właściwość Typ Opis
authentication_type integer Domyślne uwierzytelnianie.

Możliwe wartości:
0 - (domyślnie) Wewnętrzne;
1 - LDAP.
http_auth_enabled integer Włącz autentykację HTTP.

Możliwe wartości:
0 - (domyślnie) Wyłącz;
1 - Włącz.
http_login_form integer Domyślny format logowania.

Możliwe wartości:
0 - (domyślnie) Formularz logowania Zabbix;
1 - Formularz logowania HTTP.
http_strip_domains string Usuń nazwę domeny.
http_case_sensitive integer Logowanie HTTP z rozróżnianiem wielkości liter.

Możliwe wartości:
0 - Wyłącz;
1 - (domyślnie) Włącz.
ldap_configured integer Włącz autentykację LDAP.

Możliwe wartości:
0 - Wyłącz;
1 - (domyślnie) Włącz.
ldap_host string Host LDAP.
ldap_port integer Port LDAP.
ldap_base_dn string Bazowa DN LDAP.
ldap_search_attribute string Atrybut wyszukiwania LDAP.
ldap_bind_dn string DN dostępu LDAP.
ldap_case_sensitive integer Logowanie LDAP z rozróżnieniem wielkości liter.

Możliwe wartości:
0 - Wyłącz;
1 - (domyślnie) Włącz.
ldap_bind_password string Hasło dostępu LDAP.
saml_auth_enabled integer Włącz autentykację SAML.

Możliwe wartości:
0 - (domyślnie) Wyłącz;
1 - Włącz.
saml_idp_entityid string ID jednostki IdP SAML.
saml_sso_url string URL usługi SSO SAML.
saml_slo_url string URL usługi SLO SAML.
saml_username_attribute string Atrybut użytkownika SAML.
saml_sp_entityid string ID jednostki SP SAML.
saml_nameid_format string Format ID nazwy SP SAML.
saml_sign_messages integer Podpis komunikatów SAML.

Możliwe wartości:
0 - (domyślnie) Nie podpisuj komunikatów;
1 - Podpisuj komunikaty.
saml_sign_assertions integer Podpis zapewnień SAML.

Możliwe wartości:
0 - (domyślnie) Nie podpisuj zapewnień;
1 - Podpisuj zapewnienia.
saml_sign_authn_requests integer SAML sign AuthN requests.

Możliwe wartości:
0 - (domyślnie) Nie podpisuj prośby o uwierzytelnienie;
1 - Podpisuj prośby o uwierzytelnienie.
saml_sign_logout_requests integer SAML sign logout requests.

Możliwe wartości:
0 - (domyślnie) Nie odpisuj prośby o uwierzytelnienie;
1 - Podpisuj prośby o wylogowanie.
saml_sign_logout_responses integer SAML sign logout responses.

Możliwe wartości:
0 - (domyślnie) Nie podpisuj odpowiedzi wylogowania;
1 - Podpisuj odpowiedzi wylogowania.
saml_encrypt_nameid integer Szyfrowanie ID nazwy SAML.

Możliwe wartości:
0 - (domyślnie) Nie szyfruj ID nazwy;
1 - Szyfruj ID nazwy.
saml_encrypt_assertions integer Szyfrowanie zapewnień SAML.

Możliwe wartości:
0 - (domyślnie) Nie szyfruj zapewnienia;
1 - Szyfruj zapewnienia.
saml_case_sensitive integer Logowanie SAMLz rozróżnianiem wielkości liter.

Możliwe wartości:
0 - Wyłącz;
1 - (domyślnie) Włącz.
passwd_min_length integer Wymagana minimalna długość hasła.

Możliwy zakres wartości: 1-70
8 - domyślnie
passwd_check_rules integer Reguły sprawdzania hasła.

Możliwe wartości mapy bitowej to:
0 - sprawdź długość hasła;
1 - sprawdź, czy hasło zawiera wielką i małą literę alfabetu łacińskiego;
2 - sprawdź, czy hasło zawiera cyfry;
4 - sprawdź, czy hasło zawiera znaki specjalne;
8 - (domyślnie) sprawdź, czy hasło nie znajduje się na liście najczęściej używanych haseł, nie zawiera podobieństw do słowa "Zabbix" lub imienia, nazwiska lub nazwy użytkownika.

Action operation

Obiekt action operation definiuje operację, która zostanie wykonana gdy wykonywana jest akcja. Posiada następujące właściwości.

Właściwość Typ Opis
operationid string (tylko do odczytu) identyfikator ID akcji.
operationtype
(wymagane)
integer Typ operacji.

Możliwe wartości:
0 - Wyślij wiadomość;
1 - globalny skrypt;
2 - dodaj host;
3 - usuń hosta;
4 - dodaj do grupy hostów;
5 - usuń z grupy hostów;
6 - połącz z szablonem;
7 - odłącz od szablonów;
8 - włącz hosta;
9 - wyłącz hosta;
10 - ustaw tryb inwentarza hosta.

Pamiętaj, że tylko typy '0' i '1' są obsługiwane tylko dla akcji wyzwalacza oraz usług, natomiast '0' tylko dla akcji wewnętrznych. Wszystkie typy są obsługiwane dla akcji wykrywania i autorejestracji.
actionid string (tylko do odczytu) Identyfikator ID akcji, do której należy operacja.
esc_period string Domyślny czas trwania kroku operacji. Pole musi wynosić co najmniej 60 sekund. Akceptuje sekundy, jednostkę czasu z sufiksem oraz makro użytkownika. Jeśli jest ustawione na 0 lub 0s, zostanie użyta domyślna wartość kroku operacji .

Domyślnie: 0s.

Pamiętaj, że eskalacje są obsługiwane tylko dla wyzwalaczy, akcji wewnętrznych i usług tylko w podstawowych operacjach.
esc_step_from integer Krok, od którego należy rozpocząć eskalację.

Domyślnie: 1.

Pamiętaj, że eskalacje są obsługiwane tylko dla wyzwalaczy, akcji wewnętrznych i usług tylko w podstawowych operacjach.
esc_step_to integer Krok do zakończenia eskalacji.

Domyślnie: 1.

Pamiętaj, że eskalacje są obsługiwane tylko dla wyzwalaczy, akcji wewnętrznych i usług tylko w podstawowych operacjach.
evaltype integer Typ obliczeń warunku operacji.

Możliwe wartości:
0 - (Domyślnie) I / Lub;
1 - I;
2 - Lub.
opcommand object Obiekt zawierający dane globalnego skryptu uruchamianego przez operację.

Każdy obiekt ma jedną następującą właściwość: scriptid - (string) identyfikator ID skryptu.

Wymagane dla operacji skryptów globalnych.
opcommand_grp array Grupy hostów do uruchamiania globalnych skryptów.

Każdy obiekt ma następujące właściwości:
opcommand_grpid - (string, tylko do odczytu) identyfikator ID obiektu;
operationid - (string, tylko do odczytu) identyfikator ID operacji;
groupid - (string) identyfikator ID grupy hostów.

Wymagany dla operacji skryptów globalnych jeżeli nie ustawiono opcommand_hst.
opcommand_hst array Host do uruchamiania globalnych skryptów.

Każdy obiekt ma następujące właściwości:
opcommand_hstid - (string, tylko do odczytu) identyfikator ID obiektu;
operationid - (string, tylko do odczytu) identyfikator ID operacji;
hostid - (string) identyfikator ID hosta; Jeśli ustawiono na 0, polecenie zostanie uruchomione na aktualnym hoście.

Wymagany dla operacji skryptów globalnych jeżeli nie ustawiono opcommand_grp.
opconditions array Warunki operacji używane do akcji wyzwalaczy.

Obiekt warunków operacji jest szczegółowo opisany poniżej.
opgroup array Grupy hostów, do których mają być dodawane hosty.

Każdy obiekt ma następujące właściwości:
operationid - (string, tylko do odczytu) identyfikator ID operacji;
groupid - (string) identyfikator ID grupy hostów.

Wymagane dla operacji "dodaj do grupy hostów" i "usuń z grupy hostów".
opmessage object Obiekt zawierający dane o wiadomości wysłanej przez operację.

Obiekt komunikatu operacji jest szczegółowo opisany poniżej.

Wymagane dla operacji "wyślij wiadomość".
opmessage_grp array Grupy użytkowników, do których mają być wysyłane wiadomości.

Każdy obiekt ma następujące właściwości:
operationid - (string, tylko do odczytu) identyfikator ID operacji;
usrgrpid - (string) identyfikator ID grupy hostów.

Wymagane dla operacji "wyślij wiadomość" jeżeli nie ustawionoopmessage_usr.
opmessage_usr array Użytkownicy, do których mają być wysyłane wiadomości.

Każdy obiekt ma następujące właściwości:
operationid - (string, tylko do odczytu) identyfikator ID operacji;
userid - (string) identyfikator ID użytkownika.

Wymagane dla operacji "wyślij wiadomość" jeżeli nie ustawiono opmessage_grp.
optemplate array Szablony do połączenia z hostem.

Każdy obiekt ma następujące właściwości:
operationid - (string, tylko do odczytu) identyfikator ID operacji;
templateid - (string) identyfikator ID szablonu.

Wymagane dla operacji "Połącz z szablonami" i "odłącz od szablonu".
opinventory object Ustaw tryb inwentarza dla hosta.

Obiekt ma następujące właściwości:
operationid - (string, tylko do odczytu) identyfikator ID operacji;
inventory_mode - (string) tryb inwentarza.

Wymagane dla operacji"ustaw tryb inwentarza hosta".

Action operation message

Obiekt operation message zawiera dane o wiadomości, która będzie wysłana przez operacje.

Właściwość Typ Opis
default_msg integer Czy użyć domyślnego tekstu i tematu wiadomości akcji

Możliwe wartości:
0 - użyj danych z operacji;
1 - (domyślnie) użyj danych z typu mediów.
mediatypeid string identyfikator ID typu mediów, który zostanie użyty do wysłania wiadomości.
message string Tekst wiadomości operacji.
subject string Temat wiadomości operacji.

Action operation condition

Obiekt action operation condition definiuje warunek, który musi być spełniony, by wykonać bieżącą operacje. Posiada następujące właściwości.

Właściwość Typ Opis
opconditionid string (tylko do odczytu) Identyfikator ID warunku akcji
conditiontype
(wymagany)
integer Typ warunku.

Możliwe wartości:
14 - zdarzenie potwierdzone.
value
(wymagany)
string Wartość do porównania.
operationid string (tylko do odczytu) identyfikator ID operacji.
operator integer Operator warunku.

Możliwe wartości:
0 - (domyślnie) =.

Następujące operatory i wartości są obsługiwane dla każdego typu warunku operacji.

Warunek Nazwa warunku Obsługiwane operatory Oczekiwana wartość
14 Zdarzenie potwierdzone = Czy zdarzenie zostało potwierdzone.

Możliwe wartości:
0 - niepotwierdzone;
1 - potwierdzone.

Action recovery operation

Obiekt action recovery operation definiuje operację, która będzie wykonywana kiedy problem zostanie rozwiązany. Możliwe są operacje odzyskiwania dla akcji wyzwalacza, wewnętrznych i usług. Posiada następujące właściwości.

Właściwość Typ Opis
operationid string (tylko do odczytu) identyfikator ID operacji akcji.
operationtype
(wymagane)
integer Typ operacji.

Możliwe wartości dla akcji wyzwalacza oraz usługi:
0 - wyślij wiadomość;
1 - globalny skrypt;
11 - Powiadom wszystkich zaangażowanych.

Możliwe wartości dla akcji wewnętrznych:
0 - wyślij wiadomość;
11 - Powiadom wszystkich zaangażowanych.
actionid string (tylko do odczytu) identyfikator ID akcji, do której należy operacja odzyskiwania.
opcommand object Obiekt zawierający dane globalnego skryptu uruchamianego przez operację.

Każdy obiekt ma jedną następującą właściwość: scriptid - (string) identyfikator ID skryptu.

Wymagane dla operacji skryptów globalnych.
opcommand_grp array Grupy hostów do uruchamiania globalnych skryptów.

Każdy obiekt ma następujące właściwości:
opcommand_grpid - (string, tylko do odczytu) identyfikator ID obiektu;
operationid - (string, tylko do odczytu) identyfikator ID operacji;
groupid - (string) identyfikator ID grupy hostów.

Wymagany dla operacji skryptów globalnych jeżeli nie ustawiono opcommand_hst.
opcommand_hst array Host do uruchamiania globalnych skryptów.

Każdy obiekt ma następujące właściwości:
opcommand_hstid - (string, tylko do odczytu) identyfikator ID obiektu;
operationid - (string, tylko do odczytu) identyfikator ID operacji;
hostid - (string) identyfikator ID hosta; Jeśli ustawiono na 0, polecenie zostanie uruchomione na aktualnym hoście.

Wymagane dla operacji skryptów globalnych jeżeli nie ustawiono opcommand_grp.
opmessage object Obiekt zawierający dane o wiadomości wysłanej przez operację.

Obiekt komunikatu operacji jest szczegółowo opisany poniżej.

Wymagane dla operacji "wyślij wiadomość".
opmessage_grp array Grupy użytkowników, do których mają być wysyłane wiadomości.

Każdy obiekt ma następujące właściwości:
operationid - (string, tylko do odczytu) identyfikator ID operacji;
usrgrpid - (string) identyfikator ID grupy hostów.

Wymagane dla operacji "wyślij wiadomość" jeżeli nie ustawionoopmessage_usr.
opmessage_usr array Użytkownicy, do których mają być wysyłane wiadomości.

Każdy obiekt ma następujące właściwości:
operationid - (string, tylko do odczytu) identyfikator ID operacji;
userid - (string) identyfikator ID użytkownika.

Wymagane dla operacji "wyślij wiadomość" jeżeli nie ustawiono opmessage_grp.

Action update operation

Obiekt action update operation definiuje operację, która będzie wykonana kiedy problem jest aktualizowany (skomentowany, potwierdzony, zmieniono poziom lub ręcznie zamknięty). Operacje aktualizacji są możliwe dla akcji wyzwalacza i usług. Posiadają następujące właściwości.

Właściwość Typ Opis
operationid string (tylko do odczytu) identyfikator ID operacji akcji.
operationtype
(wymagane)
integer Typ operacji.

Możliwe wartości dla akcji wyzwalacza oraz usługi:
0 - wyślij wiadomość;
1 - globalny skrypt;
11 - Powiadom wszystkich zaangażowanych.

Możliwe wartości dla akcji wewnętrznych:
0 - wyślij wiadomość;
11 - Powiadom wszystkich zaangażowanych.
opcommand object Obiekt zawierający dane globalnego skryptu uruchamianego przez operację.

Każdy obiekt ma jedną następującą właściwość: scriptid - (string) identyfikator ID skryptu.

Wymagane dla operacji skryptów globalnych.
opcommand_grp array Grupy hostów do uruchamiania globalnych skryptów.

Każdy obiekt ma następujące właściwości:
groupid - (string) identyfikator ID grupy hostów.

Wymagany dla operacji skryptów globalnych jeżeli nie ustawiono opcommand_hst.
opcommand_hst array Host do uruchamiania globalnych skryptów.

Każdy obiekt ma następujące właściwości:
hostid - **(string)* identyfikator ID hosta; Jeśli ustawiono na 0, polecenie zostanie uruchomione na aktualnym hoście.

Wymagany dla operacji skryptów globalnych jeżeli nie ustawiono opcommand_grp.
opmessage object Obiekt zawierający dane o wiadomości wysłanej przez operację.

Obiekt komunikatu operacji jest szczegółowo opisany poniżej.
opmessage_grp array Grupy użytkowników, do których mają być wysyłane wiadomości.

Każdy obiekt ma następujące właściwości:
usrgrpid - (string) Iidentyfikator ID grupy hostów..

RWymagane dla operacji "wyślij wiadomość" jeżeli nie ustawionoopmessage_usr.
Jest ignorowane dla operacji wyślij wiadomość aktualizacji.
opmessage_usr array Użytkownicy, do których mają być wysyłane wiadomości.

Każdy obiekt ma następujące właściwości:
userid - (string) identyfikator ID użytkownika.

Wymagane dla operacji "wyślij wiadomość" jeżeli nie ustawiono opmessage_grp.
Jest ignorowane dla operacji wyślij wiadomość aktualizacji.

Action filter

Obiekt action filter definiuje zestaw warunków, które muszą być spełnione, aby wykonać operacje akcji. Mają następujące właściwości.

Właściwość Typ Opis
conditions
(wymagane)
array Zestaw warunków filtrowania używanych do filtrowania wyników.
evaltype
(wymagane)
integer Filter condition evaluation method.

Typ obliczeń warunku operacji.

Możliwe wartości:
0 - (Domyślnie) I / Lub;
1 - I;
2 - Lub;
3 - wyrażenie użytkownika.
eval_formula string (tylko do odczytu) Wygenerowane wyrażenie, które będzie używane do sprawdzenia warunków filtrowania. Wyrażenie zawiera identyfikatory ID, które odwołują się do określonych warunków filtrowania za pomocą ID formuły. Wartość eval_formula jest równa wartości formula dla filtrów z wyrażeniem użytkownika.
formula string Wyrażenie zdefiniowane przez użytkownika dla sprawdzenia warunków filtrów dla wyrażenia użytkownika. Wyrażenie musi zawierać identyfikatory ID, które odpowiadają identyfikatorom zdefiniowanych w warunkach filtrowania za pomocą formulaid. Identyfikatory ID użyte w wyrażeniu muszę dokładnie odpowiadać identyfikatorom zdefiniowanym w warunkach filtrowania: żaden warunek nie może pozostać nieużyty lub pominięty.

Wymagane w przypadku filtrów z wyrażeniem użytkownika.

Action filter condition

Obiekt action filter condition definiuje konkretny warunek, który należy sprawdzić przed uruchomieniem operacji akcji.

Właściwość Typ Opis
conditionid string (tylko do odczytu) Identyfikator warunku akcji.
conditiontype
(wymagany)
integer Typ warunku.

Możliwe wartości dla akcji wyzwalacza:
0 - grupa hostów;
1 - host;
2 - wyzwalacz;
3 - nazwa wyzwalacza;
4 - poziom wyzwalacza;
6 - okres czasu;
13 - szablon hosta;
16 - problem jest pomijany;
25 - tag zdarzenia;
26 - wartość tagu zdarzenia.

Możliwe wartości dla akcji wykrywania:
7 - adres IP hosta;
8 - typ wykrytej usługi;
9 - wykryty port usługi;
10 - stan wykrywania;
11 - czas działania lub przestoju;
12 - otrzymana wartość;
18 - reguła wykrywania;
19 - kontrola wykrywania;
20 - proxy;
21 - obiekt wykrywania.

Możliwe wartości dla akcji autorejestracji:
20 - proxy;
22 - nazwa hosta;
24 - metadane hosta.

Możliwe wartości dla akcji wewnętrznych:
0 - grupa hostów;
1 - host;
13 - szablon hosta;
23 - typ zdarzenia;
25 - tag zdarzenia;
26 - wartość tagu zdarzenia.

Możliwe wartości dla akcji usług:
25 - tag zdarzenia;
26 - wartość tagu zdarzenia;
27 - usługa;
28 - nazwa usługi.
value
(wymagany)
string Wartość do porównania.
value2
string Druga wartość do porównania. Wymagane dla akcji wyzwalających, wewnętrznych i serwisowych, gdy typ warunku to 26.
actionid string (tylko do odczytu) Identyfikator akcji, do której należy warunek.
formulaid string Dowolny unikatowy identyfikator używany do odwoływania się do warunku z wyrażenia niestandardowego. Może zawierać tylko wielkie litery. Identyfikator musi być zdefiniowany przez użytkownika podczas modyfikowania warunków filtrowania, ale jest ponownie generowany na żądanie później.
operator integer Operator warunku.

Możliwe wartości:
0 - (domyślnie) równa się;
1 - nie równa się;
2 - zawiera;
3 - nie zawiera;
4 - w;
5 - jest większa lub równa;
6 - jest mniejsza lub równa;
7 - nie jest w;
8 - pasuje;<br >9 - nie pasuje;
10 - Tak;
11 - Nie.

Aby lepiej zrozumieć, jak używać filtrów z różnymi rodzajami wyrażeń, zobacz przykłady action.get i action.create na ich stronach.

Następujące operatory i wartości są obsługiwane dla każdego typu warunku.

Warunek Nazwa warunku Obsługiwane operatory Oczekiwana wartość
0 Grupa hostów równa się,
nie równa się
ID grupy hostów.
1 Host równa się,
nie równa się
ID hosta.
2 Wyzwalacz równa się,
nie równa się
ID wyzwalacza.
3 Nazwa wyzwalacza zawiera,
nie zawiera
Nazwy wyzwalacza.
4 Poziom wyzwalacza równa się,
nie jest równa,
jest większa lub równa,
jest mniejsza lub równa
poziom aktywowania. Zapoznaj się z właściwością wyzwalacza „poziom”, aby uzyskać listę obsługiwanych poziomów wyzwalaczy.
5 Wartość wyzwalacza równa się Wartość wyzwalacza. Zapoznaj się z właściwością „wartość” wyzwalacza, aby uzyskać listę obsługiwanych wartości wyzwalacza.
6 Okres czasu w, nie jest w Czas, w którym zdarzenie zostało wyzwolone jako okres.
7 Adres IP hosta równa się,
nie jest równy
Jeden lub kilka zakresów adresów IP do sprawdzenia oddzielonych przecinkami. Więcej informacji o obsługiwanych formatach zakresów adresów IP znajdziesz w sekcji konfiguracja wykrywania sieci.
8 Typ wykrytej usługi równa się,
nie jest równy
Typ wykrytej usługi. Typ usługi jest zgodny z typem testu wykrywania używanego do wykrycia usługi. Zapoznaj się z właściwością wykrywania „type”, aby uzyskać listę obsługiwanych typów.
9 Wykryty port usługi równa się,
nie równa się
Jeden lub kilka zakresów portów oddzielonych przecinkami.
10 Stan wykrycia równa się Stan wykrytego obiektu.

Możliwe wartości:
0 – uruchomienie hosta lub usługi;
1 – wyłączenie hosta lub usługi;
2 – uruchomienie hosta lub usługi wykryto usługę;
3 - utracono host lub usługę.
11 Czas działania lub przestoju jest większy lub równy,
jest mniejszy lub równy
Czas wskazujący, jak długo wykryty obiekt znajduje się w bieżącym stanie, w sekundach.
12 Otrzymane wartości równa się,
nie jest równe,
jest większe lub równe,
jest mniejsze lub równe,
zawiera,
nie zawiera
Wartości zwracanej podczas wykonywania wykrywanie za pomocą Agent Zabbix, SNMPv1, SNMPv2 lub SNMPv3.
13 Szablon hosta równa się,
nie jest równy
identyfikator połączonego szablonu.
16 Problem jest pominięty Tak, Nie Wartość nie jest wymagana: użycie operatora "Tak" oznacza, że ​​problem musi być wstrzymany, "Nie" - nie wstrzymany.
18 Reguła wykrywania równa się,
nie równa się
ID reguły wykrywania.
19 Kontrola wykrywania równa się,
nie równa się
ID testu wykrywania.
20 Proxy równa się,
nie równa się
ID proxy.
21 Obiekt wykrywania równa się Typ obiektu, który wyzwolił zdarzenie wykrywania.

Możliwe wartości:
1 — wykryty host;
2 — wykryta usługa.
22 Nazwa hosta zawiera,
nie zawiera,
dopasowania,
nie pasuje
Nazwa hosta.
Używanie wyrażenia regularnego jest obsługiwane dla operatorów pasuje i nie pasuje w warunkach autorejestracji.
23 Typ zdarzenia równa się Określone zdarzenie wewnętrzne.

Możliwe wartości:
0 - pozycja w stanie "nieobsługiwany";
1 - pozycja w stanie "normalnym";
2 - reguła LLD w stanie "nieobsługiwana";
3 - reguła LLD w stanie "normalnym";
4 - wyzwalacz w stanie "nieznany";
5 - wyzwalacz w stanie "normalnym".
24 Metadane hosta zawierają,
nie zawierają,
dopasowania,
nie są zgodne
Metadane automatycznie zarejestrowanego hosta.
Używanie wyrażenia regularnego jest obsługiwane w przypadku operatorów dopasowania i nie pasuje.
25 Tag równa się,
nie równa się,
zawiera,
nie zawiera
Tag zdarzenia.
26 Wartość tagu równa się,
nie jest równy,
zawiera,
nie zawiera
Wartość tagu zdarzenia.
27 Usługa równa się,
nie równa się
Identyfikator usługi.
28 Nazwa usługi równa się,
nie równa się
Nazwa usługi.