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 webowego. 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 webowym.

Zachowanie właściwości:
- required
url string Adres URL do sprawdzenia.

Zachowanie właściwości:
- required
follow_redirects integer Czy podążać za przekierowaniami HTTP.

Possible values:
0 - don't follow redirects;
1 - (default) follow redirects.
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 webowego.
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 być obecny w odpowiedzi.
retrieve_mode integer Część odpowiedzi HTTP, którą krok scenariusza ma pobrać.

Possible values:
0 - (default) only body;
1 - only headers;
2 - headers and body.
status_codes string Zakresy wymaganych kodów statusu HTTP, rozdzielone przecinkami.
timeout string Limit czasu żądania w sekundach. Akceptuje sekundy, jednostkę czasu z sufiksem lub makro użytkownika.

Default: 15s. Maximum: 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 web

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

Property Type Description
tag string Nazwa tagu scenariusza web.

Zachowanie właściwości:
- wymagane
value string Wartość tagu scenariusza web.