[comment]: # aside: 1

[comment]: # translation:outdated

[comment]: # ({43284bfe-8b1700c1})
# Oggetto Script

I seguenti oggetti sono direttamente correlati all'API `script`.

[comment]: # ({/43284bfe-8b1700c1})

[comment]: # ({1c7e0362-9c6db006})
### Script

L'oggetto script ha le seguenti proprietà.

|Proprietà|[Type](/manual/api/reference_commentary#data-types)|Descrizione|
|--|--|------|
|scriptid|ID|ID dello script.<br><br>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *sola lettura*<br>- *obbligatoria* per le operazioni di aggiornamento|
|name|string|Nome dello script.<br><br>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *obbligatoria* per le operazioni di creazione|
|type|integer|Tipo di script.<br><br>Valori possibili se `scope` è impostato su "action operation":<br>0 - Script;<br>1 - IPMI;<br>2 - SSH;<br>3 - TELNET;<br>5 - Webhook.<br><br>Valori possibili se `scope` è impostato su "manual host action" o "manual event action":<br>6 - URL.<br><br>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *obbligatoria* per le operazioni di creazione|
|command|string|Comando da eseguire.<br><br>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *obbligatoria* se `type` è impostato su "Script", "IPMI", "SSH", "TELNET" o "Webhook"|
|scope|integer|Ambito dello script.<br><br>Valori possibili:<br>1 - action operation;<br>2 - manual host action;<br>4 - manual event action.<br><br>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *obbligatoria* per le operazioni di creazione|
|execute\_on|integer|Dove eseguire lo script.<br><br>Valori possibili:<br>0 - esegui su Zabbix agent;<br>1 - esegui su Zabbix server. È *supportato* solo se l'esecuzione degli script globali è abilitata su Zabbix server;<br>2 - *(predefinito)* esegui su Zabbix server o proxy.<br><br>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *supportato* se `type` è impostato su "Script"|
|menu\_path|string|Cartelle separate da slash che formano una navigazione simile a un menu nel frontend quando si fa clic su host o evento.<br><br>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *supportato* se `scope` è impostato su "manual host action" o "manual event action"|
|authtype|integer|Metodo di autenticazione usato per il tipo di script SSH.<br><br>Valori possibili:<br>0 - password;<br>1 - chiave pubblica.<br><br>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *supportato* se `type` è impostato su "SSH"|
|username|string|Nome utente usato per l'autenticazione.<br><br>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *obbligatoria* se `type` è impostato su "SSH" o "TELNET"|
|password|string|Password usata per gli script SSH con autenticazione tramite password e per gli script TELNET.<br><br>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *supportato* se `type` è impostato su "SSH" e `authtype` è impostato su "password", oppure `type` è impostato su "TELNET"|
|publickey|string|Nome del file della chiave pubblica usato per gli script SSH con autenticazione tramite chiave pubblica.<br><br>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *obbligatoria* se `type` è impostato su "SSH" e `authtype` è impostato su "public key"|
|privatekey|string|Nome del file della chiave privata usato per gli script SSH con autenticazione tramite chiave pubblica.<br><br>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *obbligatoria* se `type` è impostato su "SSH" e `authtype` è impostato su "public key"|
|port|string|Numero di porta usato per gli script SSH e TELNET.<br><br>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *supportato* se `type` è impostato su "SSH" o "TELNET"|
|groupid|ID|ID del gruppo host su cui lo script può essere eseguito.<br><br>Se impostato su "0", lo script sarà disponibile per tutti i gruppi host.<br><br>Predefinito: 0.|
|usrgrpid|ID|ID del gruppo utenti a cui sarà consentito eseguire lo script.<br><br>Se impostato su "0", lo script sarà disponibile per tutti i gruppi utenti.<br><br>Predefinito: 0.<br><br>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *supportato* se `scope` è impostato su "manual host action" o "manual event action"|
|host\_access|integer|Permessi host necessari per eseguire lo script.<br><br>Valori possibili:<br>2 - *(predefinito)* lettura;<br>3 - scrittura.<br><br>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *supportato* se `scope` è impostato su "manual host action" o "manual event action"|
|confirmation|string|Testo del popup di conferma.<br>Il popup apparirà quando si tenta di eseguire lo script dal frontend di Zabbix.<br><br>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *supportato* se `scope` è impostato su "manual host action" o "manual event action"|
|timeout|string|Timeout di esecuzione dello script webhook in secondi. I suffissi temporali sono supportati (ad esempio, 30s, 1m).<br><br>Valori possibili: 1-60s.<br><br>Predefinito: 30s.<br><br>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *obbligatoria* se `type` è impostato su "Webhook"|
|parameters|array|Array dei [parametri di input del webhook](/manual/api/reference/script/object#webhook-parameters).<br><br>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *supportato* se `type` è impostato su "Webhook"|
|description|string|Descrizione dello script.|
|url|string|URL definito dall'utente.<br><br>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *obbligatoria* se `type` è impostato su "URL"|
|new_window|integer|Apri URL in una nuova finestra.<br><br>Valori possibili:<br>0 - No;<br>1 - *(predefinito)* Sì.<br><br>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *supportato* se `type` è impostato su "URL"|
|manualinput|integer|Indica se lo script accetta input fornito dall'utente.<br><br>Valori possibili:<br>0 - *(predefinito)* Disabilitato;<br>1 - Abilitato;<br><br>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *supportato* se `scope` è impostato su "manual host action" o "manual event action"|
|manualinput_prompt|string|Testo del prompt per l'input manuale.<br><br>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *obbligatoria* se `manualinput` è impostato su "Enabled"|
|manualinput_validator|string|Campo stringa usato per convalidare l'input fornito dall'utente. La stringa consiste in un'espressione regolare oppure in un insieme di valori separati da virgole.<br><br>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *obbligatoria* se `manualinput` è impostato su "Enabled"|
|manualinput_validator_type|integer|Determina il tipo di input utente previsto.<br><br>Valori possibili:<br>0 - *(predefinito)* Stringa. Indica che manualinput_validator deve essere trattato come un'espressione regolare;<br>1 - Elenco. Indica che manualinput_validator deve essere trattato come un elenco separato da virgole dei possibili valori di input.<br><br>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *supportato* se `manualinput` è impostato su "Enabled"|
|manualinput_default_value|string|Valore predefinito per il riempimento automatico dell'input utente.<br><br>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *supportato* se `manualinput_validator_type` è impostato su "String"|

[comment]: # ({/1c7e0362-9c6db006})

[comment]: # ({4ab66f57-05b0e37d})
#### Parametri del webhook

I parametri passati allo script webhook quando viene chiamato hanno le seguenti
proprietà.

|Proprietà|[Tipo](/manual/api/reference_commentary#data-types)|Descrizione|
|--|--|------|
|name|string|Nome del parametro.<br><br>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *obbligatorio*|
|value|string|Valore del parametro. Supporta le [macro](/manual/appendix/macros/supported_by_location).|

[comment]: # ({/4ab66f57-05b0e37d})

[comment]: # ({0ba46586-587d2fd0})
### Debug

Informazioni di debug dello script webhook eseguito. L'oggetto debug ha le
seguenti proprietà.

|Proprietà|[Type](/manual/api/reference_commentary#data-types)|Descrizione|
|--|--|------|
|logs|array|Array di [voci di log](/manual/api/reference/script/object#log-entry).|
|ms|string|Durata dell'esecuzione dello script in millisecondi.|

[comment]: # ({/0ba46586-587d2fd0})

[comment]: # ({f7a09e87-8ea23127})
#### Voce di log

L'oggetto voce di log ha le seguenti proprietà.

|Proprietà|[Type](/manual/api/reference_commentary#data-types)|Descrizione|
|--|--|------|
|level|integer|Livello di log.|
|ms|string|Il tempo trascorso in millisecondi dall'esecuzione dello script prima che la voce di log fosse aggiunta.|
|message|string|Messaggio di log.|

[comment]: # ({/f7a09e87-8ea23127})