Oggetto scenario web

I seguenti oggetti sono direttamente correlati all'API webcheck.

Scenario web

L'oggetto scenario web ha le seguenti proprietà.

Proprietà Tipo Descrizione
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 che verrà utilizzata dallo scenario web.

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

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

Accetta secondi o un'unità di tempo con suffisso (ad es. 30s, 1m, 2h, 1d), oppure una macro utente.

Predefinito: 1m.
headers array Header HTTP che verranno inviati 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 che verrà utilizzato dallo scenario web, specificato come 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 fallire.

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

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) salta la verifica dell'host;
1 - verifica host.
verify_peer integer Indica se verificare che il certificato dell'host sia autentico.

Valori possibili:
0 - (predefinito) salta la verifica del peer;
1 - verifica 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à:
- supportata se lo scenario web appartiene a un template

Passaggio dello scenario

L'oggetto passaggio dello scenario definisce uno specifico controllo di uno scenario web. Ha le seguenti proprietà.

Proprietà Type Descrizione
name string Nome del passaggio dello scenario.

Comportamento della proprietà:
- obbligatoria
no integer Numero di sequenza 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 Header HTTP che verranno inviati durante l'esecuzione di una richiesta. Gli header del passaggio dello scenario sovrascriveranno gli header specificati per lo scenario web.
posts string/array Variabili HTTP POST come stringa (dati POST grezzi) 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 header;
2 - header e corpo.
status_codes string Intervalli dei codici di stato HTTP richiesti, separati da virgole.
timeout string Timeout della richiesta in secondi. Accetta secondi, un'unità di tempo con suffisso o una macro utente.

Predefinito: 15s. Massimo: 1h. Minimo: 1s.
variables array Variabili del passaggio dello scenario.
query_fields array Campi di 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.