Oggetto scenario web

I seguenti oggetti sono direttamente correlati all'API webcheck.

Scenario web

L'oggetto scenario web presenta le seguenti proprietà.

Property Type Description
httptestid ID ID dello scenario web.

Comportamento della proprietà:
- sola lettura
- obbligatoria per le operazioni di aggiornamento
hostid ID ID dell'host a cui appartiene lo scenario web.

Comportamento della proprietà:
- costante
- obbligatoria per le operazioni di creazione
name string Nome dello scenario web.

Comportamento della proprietà:
- obbligatoria per le operazioni di creazione
agent string Stringa user agent utilizzata dallo scenario web.

Predefinito: Zabbix
authentication integer Metodo di autenticazione utilizzato dallo scenario web.

Valori possibili:
0 - (predefinito) nessuno;
1 - autenticazione HTTP di base;
2 - autenticazione NTLM;
3 - autenticazione Kerberos;
4 - autenticazione Digest.
delay string Intervallo di esecuzione dello scenario web.

Accetta un numero di secondi (ad esempio, 1, 60, 300), un valore con un suffisso temporale (ad esempio, 30s, 1m, 2h, 1d) o una macro utente.

Predefinito: 1m.
headers array Intestazioni HTTP inviate durante l'esecuzione di una richiesta.
http_password string Password utilizzata per l'autenticazione HTTP di base, NTLM, Kerberos o Digest.
http_proxy string proxy utilizzato dallo scenario web, nel formato http://\[username\[:password\]@\]proxy.example.com\[:port].
http_user string Nome utente utilizzato per l'autenticazione HTTP di base, NTLM, Kerberos o Digest.
retries integer Numero di volte in cui uno scenario web tenterà di eseguire ogni passaggio prima di non riuscire.

Predefinito: 1.
ssl_cert_file string Nome del file del certificato SSL utilizzato per l'autenticazione del client (deve essere in formato PEM).
ssl_key_file string Nome del file della chiave privata SSL utilizzata per l'autenticazione del client (deve essere in formato PEM).
ssl_key_password string Password della chiave privata SSL.
status integer Indica se lo scenario web è abilitato.

Valori possibili:
0 - (predefinito) abilitato;
1 - disabilitato.
templateid ID ID dello scenario web del template principale.

Comportamento della proprietà:
- sola lettura
variables array Variabili dello scenario web.
verify_host integer Indica se verificare che il nome host della connessione corrisponda a quello presente nel certificato dell'host.

Valori possibili:
0 - (predefinito) non verificare l'host;
1 - verificare l'host.
verify_peer integer Indica se verificare che il certificato dell'host sia autentico.

Valori possibili:
0 - (predefinito) non verificare il peer;
1 - verificare il peer.
uuid string Identificatore univoco globale, utilizzato per collegare gli scenari web importati a quelli già esistenti. Generato automaticamente se non specificato.

Comportamento della proprietà:
- supportato se lo scenario web appartiene a un template

Passaggio dello scenario

L'oggetto del passaggio dello scenario definisce un controllo specifico dello scenario web. Presenta le seguenti proprietà.

Property Type Description
name string Nome del passaggio dello scenario.

Comportamento della proprietà:
- obbligatoria
no integer Numero progressivo del passaggio in uno scenario web.

Comportamento della proprietà:
- obbligatoria
url string URL da controllare.

Comportamento della proprietà:
- obbligatoria
follow_redirects integer Indica se seguire i reindirizzamenti HTTP.

Valori possibili:
0 - non seguire i reindirizzamenti;
1 - (predefinito) seguire i reindirizzamenti.
headers array Intestazioni HTTP da inviare durante l'esecuzione di una richiesta. Le intestazioni del passaggio dello scenario sovrascriveranno quelle specificate per lo scenario web.
posts string/array Variabili HTTP POST come stringa (dati post non elaborati) o come array di campi HTTP (dati dei campi del modulo).
required string Testo che deve essere presente nella risposta.
retrieve_mode integer Parte della risposta HTTP che il passaggio dello scenario deve recuperare.

Valori possibili:
0 - (predefinito) solo corpo;
1 - solo intestazioni;
2 - intestazioni e corpo.
status_codes string Intervalli dei codici di stato HTTP richiesti, separati da virgole.
timeout string Timeout della richiesta in secondi. Accetta un numero di secondi (ad esempio, 1, 60, 300), un valore con un suffisso temporale (ad esempio, 30s, 1m, 1h) o una macro utente.

Predefinito: 15s. Massimo: 1h. Minimo: 1s.
variables array Variabili del passaggio dello scenario.
query_fields array Campi della query - array di campi HTTP che verranno aggiunti all'URL durante l'esecuzione di una richiesta.

Campo HTTP

L'oggetto campo HTTP definisce il nome e il valore utilizzati per specificare le variabili dello scenario web, le intestazioni HTTP e i campi POST o i campi di query. Ha le seguenti proprietà.

Property Type Description
name string Nome dell'intestazione/variabile/campo POST o GET.

Property behavior:
- obbligatorio
value string Valore dell'intestazione/variabile/campo POST o GET.

Property behavior:
- obbligatorio

Tag dello scenario web

L'oggetto tag dello scenario web ha le seguenti proprietà.

Proprietà Tipo Descrizione
tag string Nome del tag dello scenario web.

Comportamento della proprietà:
- obbligatoria
value string Valore del tag dello scenario web.

Comportamento della proprietà:
- sola lettura.
object integer Tipo di oggetto da cui il tag è stato ereditato.

Valori possibili:
0 - template;
1 - host.

Comportamento della proprietà:
- sola lettura.
objectid ID ID dell'oggetto da cui il tag è stato ereditato.

Comportamento della proprietà:
- sola lettura.