Obiekt scenariusza internetowego

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

Scenariusz internetowy

Obiekt scenariusza internetowego ma następujące właściwości.

Property Type Description
httptestid ID Identyfikator scenariusza internetowego.

Zachowanie właściwości:
- tylko do odczytu
- wymagane w operacjach aktualizacji
hostid ID Identyfikator hosta, do którego należy scenariusz internetowy.

Zachowanie właściwości:
- stałe
- wymagane w operacjach tworzenia
name string Nazwa scenariusza internetowego.

Zachowanie właściwości:
- wymagane w operacjach tworzenia
agent string Ciąg user agent, który będzie używany przez scenariusz internetowy.

Wartość domyślna: Zabbix
authentication integer Metoda uwierzytelniania, która będzie używana przez scenariusz internetowy.

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 internetowego.

Akceptuje liczbę sekund (np. 1, 60, 300), wartość z przyrostkiem czasu (np. 30s, 1m, 2h, 1d) lub makro użytkownika.

Wartość domyślna: 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, uwierzytelniania NTLM, Kerberos lub Digest.
http_proxy string Proxy, który będzie używany przez scenariusz internetowy, w formacie http://\[username\[:password\]@\]proxy.example.com\[:port].
http_user string Nazwa użytkownika używana do podstawowego uwierzytelniania HTTP, uwierzytelniania NTLM, Kerberos lub Digest.
retries integer Liczba prób wykonania każdego kroku przez scenariusz internetowy przed zgłoszeniem błędu.

Wartość domyślna: 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 prywatnego klucza SSL używanego do uwierzytelniania klienta (musi być w formacie PEM).
ssl_key_password string Hasło prywatnego klucza SSL.
status integer Określa, czy scenariusz internetowy jest włączony.

Możliwe wartości:
0 - (domyślnie) włączony;
1 - wyłączony.
templateid ID Identyfikator nadrzędnego scenariusza internetowego szablonu.

Zachowanie właściwości:
- tylko do odczytu
variables array Zmienne scenariusza internetowego.
verify_host integer Określa, czy należy sprawdzić, czy nazwa hosta używana w połączeniu 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 sprawdzić autentyczność certyfikatu hosta.

Możliwe wartości:
0 - (domyślnie) pomiń weryfikację peer;
1 - weryfikuj peer.
uuid string Globalny unikatowy identyfikator używany do łączenia importowanych scenariuszy internetowych z już istniejącymi. Generowany automatycznie, jeśli nie zostanie podany.

Zachowanie właściwości:
- obsługiwane, jeśli scenariusz internetowy należy do szablonu

Krok scenariusza

Obiekt kroku scenariusza definiuje określone sprawdzenie scenariusza internetowego. Ma on następujące właściwości.

Property Type Description
name string Nazwa kroku scenariusza.

Zachowanie właściwości:
- required
no integer Numer sekwencyjny kroku w scenariuszu internetowym.

Zachowanie właściwości:
- required
url string Adres URL, który ma zostać sprawdzony.

Zachowanie właściwości:
- required
follow_redirects integer Określa, czy należy podążać za przekierowaniami HTTP.

Możliwe wartości:
0 - nie podążać za przekierowaniami;
1 - (default) podążać 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 internetowego.
posts string/array Zmienne HTTP POST jako ciąg znaków (surowe dane POST) lub tablica pól HTTP (dane pól formularza).
required string Tekst, który musi znajdować się w odpowiedzi.
retrieve_mode integer Część odpowiedzi HTTP, którą krok scenariusza musi pobrać.

Możliwe wartości:
0 - (default) tylko treść;
1 - tylko nagłówki;
2 - nagłówki i treść.
status_codes string Zakresy wymaganych kodów stanu HTTP, rozdzielone przecinkami.
timeout string Limit czasu żądania w sekundach. Akceptuje liczbę sekund (np. 1, 60, 300), wartość z przyrostkiem czasu (np. 30s, 1m, 1h) lub makro użytkownika.

Wartość domyślna: 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.