On this page
Obiekt scenariusza internetowego
Następujące obiekty są bezpośrednio powiązane z API webcheck.
Scenariusz WWW
Obiekt scenariusza WWW ma następujące właściwości.
| Właściwość | Typ | Opis |
|---|---|---|
| httptestid | ID | ID scenariusza WWW. Zachowanie właściwości: - tylko do odczytu - wymagane dla operacji aktualizacji |
| hostid | ID | ID hosta, do którego należy scenariusz WWW. Zachowanie właściwości: - stałe - wymagane dla operacji tworzenia |
| name | string | Nazwa scenariusza WWW. Zachowanie właściwości: - wymagane dla operacji tworzenia |
| agent | string | Ciąg user agent, który będzie używany przez scenariusz WWW. Domyślnie: Zabbix |
| authentication | integer | Metoda uwierzytelniania, która będzie używana przez scenariusz WWW. Możliwe wartości: 0 - (domyślnie) brak; 1 - podstawowe uwierzytelnianie HTTP; 2 - uwierzytelnianie NTLM; 3 - uwierzytelnianie Kerberos; 4 - uwierzytelnianie Digest. |
| delay | string | Interwał wykonywania scenariusza WWW. Akceptuje sekundy lub jednostkę czasu z sufiksem (np. 30s, 1m, 2h, 1d) albo makro użytkownika. Domyślnie: 1m. |
| headers | array | Nagłówki HTTP, które będą wysyłane podczas wykonywania żądania. |
| http_password | string | Hasło używane do podstawowego uwierzytelniania HTTP, NTLM, Kerberos lub Digest. |
| http_proxy | string | Proxy, który będzie używany przez scenariusz WWW, podany jako http://\[username\[:password\]@\]proxy.example.com\[:port]. |
| http_user | string | Nazwa użytkownika używana do podstawowego uwierzytelniania HTTP, NTLM, Kerberos lub Digest. |
| retries | integer | Liczba prób wykonania każdego kroku przez scenariusz WWW przed zgłoszeniem niepowodzenia. Domyślnie: 1. |
| ssl_cert_file | string | Nazwa pliku certyfikatu SSL używanego do uwierzytelniania klienta (musi być w formacie PEM). |
| ssl_key_file | string | Nazwa pliku klucza prywatnego SSL używanego do uwierzytelniania klienta (musi być w formacie PEM). |
| ssl_key_password | string | Hasło klucza prywatnego SSL. |
| status | integer | Określa, czy scenariusz WWW jest włączony. Możliwe wartości: 0 - (domyślnie) włączony; 1 - wyłączony. |
| templateid | ID | ID nadrzędnego scenariusza WWW szablonu. Zachowanie właściwości: - tylko do odczytu |
| variables | array | Zmienne scenariusza WWW. |
| verify_host | integer | Określa, czy należy sprawdzać, czy nazwa hosta dla połączenia jest zgodna z nazwą w certyfikacie hosta. Możliwe wartości: 0 - (domyślnie) pomiń weryfikację hosta; 1 - weryfikuj hosta. |
| verify_peer | integer | Określa, czy należy sprawdzać autentyczność certyfikatu hosta. Możliwe wartości: 0 - (domyślnie) pomiń weryfikację peer; 1 - weryfikuj peer. |
| uuid | string | Globalny unikalny identyfikator używany do łączenia importowanych scenariuszy WWW z już istniejącymi. Generowany automatycznie, jeśli nie został podany. Zachowanie właściwości: - obsługiwane, jeśli scenariusz WWW należy do szablonu |
Krok scenariusza
Obiekt kroku scenariusza definiuje określone sprawdzenie scenariusza WWW. Ma następujące właściwości.
| Właściwość | Typ | Opis |
|---|---|---|
| name | string | Nazwa kroku scenariusza. Zachowanie właściwości: - wymagane |
| no | integer | Numer sekwencyjny kroku w scenariuszu WWW. Zachowanie właściwości: - wymagane |
| url | string | Adres URL do sprawdzenia. Zachowanie właściwości: - wymagane |
| follow_redirects | integer | Określa, czy podążać za przekierowaniami HTTP. Możliwe wartości: 0 - nie podążaj za przekierowaniami; 1 - (domyślnie) podążaj za przekierowaniami. |
| headers | array | Nagłówki HTTP, które zostaną wysłane podczas wykonywania żądania. Nagłówki kroku scenariusza zastąpią nagłówki określone dla scenariusza WWW. |
| posts | string/array | Zmienne HTTP POST jako ciąg znaków (surowe dane POST) lub jako tablica pól HTTP (dane pól formularza). |
| required | string | Tekst, który musi występować w odpowiedzi. |
| retrieve_mode | integer | Część odpowiedzi HTTP, którą krok scenariusza musi pobrać. Możliwe wartości: 0 - (domyślnie) tylko treść; 1 - tylko nagłówki; 2 - nagłówki i treść. |
| status_codes | string | Zakresy wymaganych kodów statusu HTTP, oddzielone przecinkami. |
| timeout | string | Limit czasu żądania w sekundach. Akceptuje sekundy, jednostkę czasu z sufiksem lub makro użytkownika. Domyślnie: 15s. Maksimum: 1h. Minimum: 1s. |
| variables | array | Zmienne kroku scenariusza. |
| query_fields | array | Pola zapytania - tablica pól HTTP, które zostaną dodane do adresu URL podczas wykonywania żądania. |
Pole HTTP
Obiekt pola HTTP definiuje nazwę i wartość używane do określania zmiennych scenariusza WWW, nagłówków HTTP oraz pól POST lub pól zapytania. Ma następujące właściwości.
| Właściwość | Typ | Opis |
|---|---|---|
| name | string | Nazwa nagłówka/zmiennej/pola POST lub GET. Zachowanie właściwości: - wymagane |
| value | string | Wartość nagłówka/zmiennej/pola POST lub GET. Zachowanie właściwości: - wymagane |
Tag scenariusza WWW
Obiekt tagu scenariusza WWW ma następujące właściwości.
| Właściwość | Typ | Opis |
|---|---|---|
| tag | string | Nazwa tagu scenariusza WWW. Zachowanie właściwości: - wymagane |
| value | string | Wartość tagu scenariusza WWW. Zachowanie właściwości: - tylko do odczytu. |
| object | integer | Typ obiektu, z którego tag został odziedziczony. Możliwe wartości: 0 - szablon; 1 - host. Zachowanie właściwości: - tylko do odczytu. |
| objectid | ID | ID obiektu, z którego tag został odziedziczony. Zachowanie właściwości: - tylko do odczytu. |