[comment]: # aside: 1

[comment]: # ({8f026b4a-0834cf88})
# Oggetto utente

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

[comment]: # ({/8f026b4a-0834cf88})

[comment]: # ({730822db-0ecc45be})
### User

L'oggetto user ha le seguenti proprietà.

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|userid|ID|ID dell'user.<br><br>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *sola lettura*<br>- *obbligatoria* per le operazioni di aggiornamento|
|username|string|Nome dell'user.<br><br>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *obbligatoria* per le operazioni di creazione<br>- *sola lettura* per gli [user provisioned](/manual/web_interface/frontend_sections/users/authentication#default-authentication) se l'user è collegato a una [user directory](/manual/api/reference/userdirectory/object) (`userdirectoryid` è impostato a un valore valido diverso da "0"), e lo stato di provisioning della user directory è abilitato (`provision_status` dell'[User directory object](/manual/api/reference/userdirectory/object#userdirectory) è impostato a "1"), e lo stato di autenticazione di tutti i provisioning LDAP o SAML è abilitato (`ldap_jit_status` dell'[Authentication object](/manual/api/reference/authentication/object#authentication) è impostato su "Enabled for configured LDAP IdPs" oppure `saml_jit_status` dell'[Authentication object](/manual/api/reference/authentication/object#authentication) è impostato su "Enabled for configured SAML IdPs")|
|passwd|string|Password dell'user.<br><br>Il valore di questo parametro può essere una stringa vuota se l'user è collegato a una [user directory](/manual/api/reference/userdirectory/object).<br><br>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *sola scrittura*|
|roleid|ID|ID del ruolo dell'user.<br><br>Nota che gli user senza un ruolo possono accedere a Zabbix solo tramite autenticazione [LDAP](/manual/web_interface/frontend_sections/users/authentication/ldap) o [SAML](/manual/web_interface/frontend_sections/users/authentication/saml), a condizione che le loro informazioni LDAP/SAML corrispondano alle mappature dei gruppi di user configurate in Zabbix.|
|attempt\_clock|timestamp|Ora dell'ultimo tentativo di accesso non riuscito.<br><br>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *sola lettura*|
|attempt\_failed|integer|Numero recente di tentativi di accesso falliti.<br><br>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *sola lettura*|
|attempt\_ip|string|Indirizzo IP da cui è provenuto l'ultimo tentativo di accesso non riuscito.<br><br>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *sola lettura*|
|autologin|integer|Indica se abilitare l'accesso automatico.<br><br>Valori possibili:<br>0 - *(predefinito)* accesso automatico disabilitato;<br>1 - accesso automatico abilitato.|
|autologout|string|Durata della sessione dell'user. Accetta secondi e unità di tempo con suffisso. Se impostato a 0s, la sessione non scadrà mai.<br><br>Predefinito: 15m.|
|lang|string|Codice della lingua dell'user, ad esempio `en_US`.<br><br>Predefinito: `default` - impostazione predefinita del sistema.|
|name|string|Nome dell'user.|
|provisioned|integer|Indica se l'user è stato [provisioned](/manual/api/reference/user/provision).<br><br>Valori possibili:<br>0 - non provisioned;<br>1 - provisioned.<br><br>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *sola lettura*|
|refresh|string|Intervallo di aggiornamento automatico. Accetta secondi o unità di tempo con suffisso (ad esempio 30s, 90s, 1m, 1h).<br><br>Predefinito: 30s.|
|rows\_per\_page|integer|Numero di righe dell'oggetto da mostrare per pagina.<br><br>Predefinito: 50.|
|surname|string|Cognome dell'user.|
|theme|string|Tema dell'user.<br><br>Valori possibili:<br>`default` - *(predefinito)* impostazione predefinita del sistema;<br>`blue-theme` - Blue;<br>`dark-theme` - Dark;<br>`hc-light` - High-contrast light;<br>`hc-dark` - High-contrast dark.|
|ts_provisioned|timestamp|Ora in cui è stata eseguita l'ultima operazione di [provisioning](/manual/api/reference/user/provision).<br><br>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *sola lettura*<br>- *supportata* per gli user di tipo *Super admin*|
|url|string|URL della pagina a cui reindirizzare l'user dopo l'accesso.|
|userdirectoryid|ID|ID della [user directory](/manual/api/reference/userdirectory/object) a cui l'user è collegato.<br><br>Usato per il provisioning (creazione o aggiornamento), così come per autenticare un user collegato a una user directory.<br><br>Per le operazioni di accesso, il valore di questa proprietà avrà priorità rispetto alla proprietà `userdirectoryid` dei [user groups](/manual/api/reference/usergroup/object#user-group) a cui l'user appartiene.<br><br>Predefinito: 0.<br><br>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *sola lettura*<br>- *supportata* per gli user di tipo *Super admin*|
|timezone|string|Fuso orario dell'user, ad esempio `Europe/London`, `UTC`.<br><br>Predefinito: `default` - impostazione predefinita del sistema.<br><br>Per l'elenco completo dei fusi orari supportati, fare riferimento alla [documentazione PHP](https://www.php.net/manual/en/timezones.php).|

[comment]: # ({/730822db-0ecc45be})

[comment]: # ({e65af01e-1ad487be})
### Supporto di notifica

L'oggetto media dispone delle seguenti proprietà.

|Property|Type|Description|
|--|--|------|
|mediaid|ID|ID del supporto di notifica dell'utente.<br><br>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *sola lettura*|
|mediatypeid|ID|ID del tipo di supporto di notifica utilizzato dal supporto di notifica dell'utente.<br><br>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *obbligatoria*|
|sendto|string/array|Indirizzo, nome utente o altro identificatore del destinatario.<br><br>Se `type` del [tipo di supporto di notifica](/manual/api/reference/mediatype/object#mediatype) è impostato su "Email", i valori sono rappresentati come array. Per altri tipi di [tipi di supporto di notifica](/manual/api/reference/mediatype/object#mediatype), il valore è rappresentato come stringa.<br><br>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *obbligatoria*|
|active|integer|Indica se il supporto di notifica è abilitato.<br><br>Valori possibili:<br>0 - *(predefinito)* abilitato;<br>1 - disabilitato.|
|severity|integer|Gravità dei trigger per cui inviare notifiche.<br><br>Valori bitmap possibili:<br>1 - Non classificato;<br>2 - Informazione;<br>4 - Avviso;<br>8 - Medio;<br>16 - Alto;<br>32 - Disastro.<br><br>Questo è un campo bitmask; è accettata qualsiasi somma dei possibili valori bitmap (ad esempio, 48 per Medio, Alto e Disastro).<br><br>Predefinito: 63.|
|period|string|Periodo di tempo in cui è possibile inviare le notifiche, come [periodo di tempo](/manual/appendix/time_period) o macro utente separate da un punto e virgola.<br><br>Predefinito: 1-7,00:00-24:00.|
|provisioned|integer|Indica se l'utente è stato [provisioned](/manual/api/reference/user/provision).<br><br>Valori possibili:<br>0 - non provisioned;<br>1 - provisioned.|
|userdirectory_mediaid|ID|ID della mappatura del supporto di notifica della directory utente per i supporti di notifica provisioned.<br><br>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *sola lettura*<br>- *supportata* per utenti di tipo *Super admin*|

[comment]: # ({/e65af01e-1ad487be})
