[comment]: # aside: 1
[comment]: # ({8f026b4a-0834cf88})
# Oggetto utente
I seguenti oggetti sono direttamente correlati all'API `user`.
[comment]: # ({/8f026b4a-0834cf88})
[comment]: # ({aee2a82c-0ecc45be})
### Utente
L'oggetto utente ha le seguenti proprietà.
|Proprietà|[Tipo](/manual/api/reference_commentary#data-types)|Descrizione|
|--|--|------|
|userid|ID|ID dell'utente.
[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):
- *sola lettura*
- *obbligatoria* per le operazioni di aggiornamento|
|username|string|Nome dell'utente.
[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):
- *obbligatoria* per le operazioni di creazione
- *sola lettura* per gli [utenti sottoposti a provisioning](/manual/web_interface/frontend_sections/users/authentication#default-authentication) se l'utente è collegato a una [directory utenti](/manual/api/reference/userdirectory/object) (`userdirectoryid` è impostato su un valore valido diverso da "0"), lo stato di provisioning della directory utenti è abilitato (`provision_status` dell'[oggetto directory utenti](/manual/api/reference/userdirectory/object#userdirectory) è impostato su "1") e lo stato di autenticazione di tutto il provisioning LDAP o SAML è abilitato (`ldap_jit_status` dell'[oggetto autenticazione](/manual/api/reference/authentication/object#authentication) è impostato su "Enabled for configured LDAP IdPs" oppure `saml_jit_status` dell'[oggetto autenticazione](/manual/api/reference/authentication/object#authentication) è impostato su "Enabled for configured SAML IdPs")|
|passwd|string|Password dell'utente.
Il valore di questo parametro può essere una stringa vuota se l'utente è collegato a una [directory utenti](/manual/api/reference/userdirectory/object).
[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):
- *sola scrittura*|
|roleid|ID|ID del ruolo dell'utente.
Si noti che gli utenti senza ruolo possono accedere a Zabbix solo utilizzando l'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 utenti configurate in Zabbix.|
|attempt\_clock|timestamp|Ora dell'ultimo tentativo di accesso non riuscito.
[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):
- *sola lettura*|
|attempt\_failed|integer|Numero recente di tentativi di accesso non riusciti.
[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):
- *sola lettura*|
|attempt\_ip|string|Indirizzo IP da cui è arrivato l'ultimo tentativo di accesso non riuscito.
[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):
- *sola lettura*|
|autologin|integer|Indica se abilitare l'accesso automatico.
Valori possibili:
0 - *(predefinito)* accesso automatico disabilitato;
1 - accesso automatico abilitato.|
|autologout|string|Durata della sessione utente. Accetta secondi e unità di tempo con suffisso. Se impostato su 0s, la sessione non scadrà mai.
Predefinito: 15m.|
|lang|string|Codice della lingua dell'utente, ad esempio `en_US`.
Predefinito: `default` - valore predefinito del sistema.|
|name|string|Nome dell'utente.|
|provisioned|integer|Indica se l'utente è stato [sottoposto a provisioning](/manual/api/reference/user/provision).
Valori possibili:
0 - provisioning non eseguito;
1 - provisioning eseguito.
[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):
- *sola lettura*|
|refresh|string|Periodo di aggiornamento automatico. Accetta secondi o unità di tempo con suffisso (ad esempio 30s, 90s, 1m, 1h).
Predefinito: 30s.|
|rows\_per\_page|integer|Numero di righe di oggetti da mostrare per pagina.
Predefinito: 50.|
|surname|string|Cognome dell'utente.|
|theme|string|Tema dell'utente.
Valori possibili:
`default` - *(predefinito)* valore predefinito del sistema;
`blue-theme` - Blu;
`blue-classic-theme` - Blu (classico);
`dark-theme` - Scuro;
`dark-classic-theme` - Scuro (classico);
`hc-light` - Chiaro ad alto contrasto;
`hc-dark` - Scuro ad alto contrasto.|
|ts_provisioned|timestamp|Ora in cui è stata eseguita l'ultima operazione di [provisioning](/manual/api/reference/user/provision).
[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):
- *sola lettura*
- *supportata* per utenti di tipo *Super admin*|
|url|string|URL della pagina a cui reindirizzare l'utente dopo l'accesso.|
|userdirectoryid|ID|ID della [directory utenti](/manual/api/reference/userdirectory/object) a cui l'utente è collegato.
Utilizzato per il provisioning (creazione o aggiornamento), nonché per consentire l'accesso a un utente collegato a una directory utenti.
Per le operazioni di accesso, il valore di questa proprietà avrà priorità rispetto alla proprietà `userdirectoryid` dei [gruppi utenti](/manual/api/reference/usergroup/object#user-group) a cui l'utente appartiene.
Predefinito: 0.
[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):
- *sola lettura*
- *supportata* per utenti di tipo *Super admin*|
|timezone|string|Fuso orario dell'utente, ad esempio `Europe/London`, `UTC`.
Predefinito: `default` - valore predefinito del sistema.
Per l'elenco completo dei fusi orari supportati, fare riferimento alla [documentazione PHP](https://www.php.net/manual/en/timezones.php).|
[comment]: # ({/aee2a82c-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.
[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):
- *sola lettura*|
|mediatypeid|ID|ID del tipo di supporto di notifica utilizzato dal supporto di notifica dell'utente.
[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):
- *obbligatoria*|
|sendto|string/array|Indirizzo, nome utente o altro identificatore del destinatario.
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.
[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):
- *obbligatoria*|
|active|integer|Indica se il supporto di notifica è abilitato.
Valori possibili:
0 - *(predefinito)* abilitato;
1 - disabilitato.|
|severity|integer|Gravità dei trigger per cui inviare notifiche.
Valori bitmap possibili:
1 - Non classificato;
2 - Informazione;
4 - Avviso;
8 - Medio;
16 - Alto;
32 - Disastro.
Questo è un campo bitmask; è accettata qualsiasi somma dei possibili valori bitmap (ad esempio, 48 per Medio, Alto e Disastro).
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.
Predefinito: 1-7,00:00-24:00.|
|provisioned|integer|Indica se l'utente è stato [provisioned](/manual/api/reference/user/provision).
Valori possibili:
0 - non provisioned;
1 - provisioned.|
|userdirectory_mediaid|ID|ID della mappatura del supporto di notifica della directory utente per i supporti di notifica provisioned.
[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):
- *sola lettura*
- *supportata* per utenti di tipo *Super admin*|
[comment]: # ({/e65af01e-1ad487be})