[comment]: # aside: 1 [comment]: # ({b751c407-a17bb95b}) # Oggetto scenario web I seguenti oggetti sono direttamente correlati all'API `webcheck`. [comment]: # ({/b751c407-a17bb95b}) [comment]: # ({24442f22-e60908bb}) ### Scenario web L'oggetto scenario web ha le seguenti proprietà. |Proprietà|[Tipo](/manual/api/reference_commentary#data-types)|Descrizione| |--|--|------| |httptestid|ID|ID dello scenario web.

[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):
- *sola lettura*
- *obbligatoria* per le operazioni di aggiornamento| |hostid|ID|ID dell'host a cui appartiene lo scenario web.

[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):
- *costante*
- *obbligatoria* per le operazioni di creazione| |name|string|Nome dello scenario web.

[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):
- *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](/manual/api/reference/httptest/object#http-field) 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à](/manual/api/reference_commentary#property-behavior):
- *sola lettura*| |variables|array|[Variabili](/manual/api/reference/httptest/object#http-field) 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à](/manual/api/reference_commentary#property-behavior):
- *supportata* se lo scenario web appartiene a un template| [comment]: # ({/24442f22-e60908bb}) [comment]: # ({dcde4da9-eb20f47d}) ### Passo dello scenario L'oggetto del passo dello scenario definisce un controllo specifico di uno scenario web. Ha le seguenti proprietà. |Property|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|------| |name|string|Nome del passo dello scenario.

[Property behavior](/manual/api/reference_commentary#property-behavior):
- *required*| |no|integer|Numero sequenziale del passo in uno scenario web.

[Property behavior](/manual/api/reference_commentary#property-behavior):
- *required*| |url|string|URL da controllare.

[Property behavior](/manual/api/reference_commentary#property-behavior):
- *required*| |follow\_redirects|integer|Indica se seguire i reindirizzamenti HTTP.

Valori possibili:
0 - non seguire i reindirizzamenti;
1 - *(default)* seguire i reindirizzamenti.| |headers|array|[Intestazioni HTTP](/manual/api/reference/httptest/object#http-field) che verranno inviate durante l'esecuzione di una richiesta. Le intestazioni del passo dello scenario sovrascriveranno le intestazioni specificate per lo scenario web.| |posts|string/array|Variabili HTTP POST come stringa (dati post grezzi) o come array di [campi HTTP](/manual/api/reference/httptest/object#http-field) (dati dei campi del modulo).| |required|string|Testo che deve essere presente nella risposta.| |retrieve\_mode|integer|Parte della risposta HTTP che il passo dello scenario deve recuperare.

Valori possibili:
0 - *(default)* solo il corpo;
1 - solo le intestazioni;
2 - intestazioni e corpo.| |status\_codes|string|Intervalli di codici di stato HTTP richiesti, separati da virgole.| |timeout|string|Timeout della richiesta in secondi. Accetta secondi, unità di tempo con suffisso o una macro utente.

Predefinito: 15s. Massimo: 1h. Minimo: 1s.| |variables|array|[Variabili](/manual/api/reference/httptest/object#http-field) del passo dello scenario.| |query\_fields|array|Campi di query - array di [campi HTTP](/manual/api/reference/httptest/object#http-field) che verranno aggiunti all'URL durante l'esecuzione di una richiesta.| [comment]: # ({/dcde4da9-eb20f47d}) [comment]: # ({75483b8b-d69e8b7b}) #### 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](/manual/api/reference_commentary#data-types)|Description| |--|--|------| |name|string|Nome dell'intestazione/variabile/campo POST o GET.

[Property behavior](/manual/api/reference_commentary#property-behavior):
- *obbligatorio*| |value|string|Valore dell'intestazione/variabile/campo POST o GET.

[Property behavior](/manual/api/reference_commentary#property-behavior):
- *obbligatorio*| [comment]: # ({/75483b8b-d69e8b7b}) [comment]: # ({ec1bbb32-c7ab7fb0}) ### Tag dello scenario web L'oggetto tag dello scenario web ha le seguenti proprietà. |Property|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|------| |tag|string|Nome del tag dello scenario web.

[Property behavior](/manual/api/reference_commentary#property-behavior):
- *required*| |value|string|Valore del tag dello scenario web.| [comment]: # ({/ec1bbb32-c7ab7fb0})