[comment]: # aside: 1 [comment]: # ({8f026b4a-0834cf88}) # Oggetto utente I seguenti oggetti sono direttamente correlati all'API `user`. [comment]: # ({/8f026b4a-0834cf88}) [comment]: # ({cf0582ab-0ecc45be}) ### User L'oggetto user ha le seguenti proprietà. |Property|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|------| |userid|ID|ID dell'user.

[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):
- *sola lettura*
- *obbligatoria* per le operazioni di aggiornamento| |username|string|Nome dell'user.

[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):
- *obbligatoria* per le operazioni di creazione
- *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'[oggetto User directory](/manual/api/reference/userdirectory/object#userdirectory) è impostato su "1"), e lo stato di autenticazione di tutti i provisioning LDAP o SAML è abilitato (`ldap_jit_status` dell'[oggetto Authentication](/manual/api/reference/authentication/object#authentication) è impostato su "Enabled for configured LDAP IdPs" oppure `saml_jit_status` dell'[oggetto Authentication](/manual/api/reference/authentication/object#authentication) è impostato su "Enabled for configured SAML IdPs")| |passwd|string|Password dell'user.

Il valore di questo parametro può essere una stringa vuota se l'user è collegato a una [user directory](/manual/api/reference/userdirectory/object).

[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):
- *sola scrittura*| |roleid|ID|ID del ruolo dell'user.

Si noti 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.

[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):
- *sola lettura*| |attempt\_failed|integer|Numero recente di tentativi di accesso falliti.

[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):
- *sola lettura*| |attempt\_ip|string|Indirizzo IP da cui è provenuto 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 dell'user. 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'user, ad esempio `en_US`.

Predefinito: `default` - impostazione predefinita del sistema.| |name|string|Nome dell'user.| |provisioned|integer|Indica se l'user è stato [provisioned](/manual/api/reference/user/provision).

Valori possibili:
0 - non provisioned;
1 - provisioned.

Questa proprietà è supportata da Zabbix 7.0.9.

[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):
- *sola lettura*| |refresh|string|Intervallo 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 dell'oggetto da mostrare per pagina.

Predefinito: 50.| |surname|string|Cognome dell'user.| |theme|string|Tema dell'user.

Valori possibili:
`default` - *(predefinito)* impostazione predefinita del sistema;
`blue-theme` - Blue;
`dark-theme` - Dark;
`hc-light` - High-contrast light;
`hc-dark` - High-contrast dark.| |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 gli user di tipo *Super admin* (da Zabbix 7.0.9)| |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 è collegato l'user.

Usato per il provisioning (creazione o aggiornamento), così come per autenticare un user collegato a una user directory.

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.

Predefinito: 0.

[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):
- *sola lettura*
- *supportata* per gli user di tipo *Super admin* (da Zabbix 7.0.9)| |timezone|string|Fuso orario dell'user, ad esempio `Europe/London`, `UTC`.

Predefinito: `default` - impostazione predefinita del sistema.

Per l'elenco completo dei fusi orari supportati, fare riferimento alla [documentazione PHP](https://www.php.net/manual/en/timezones.php).| [comment]: # ({/cf0582ab-0ecc45be}) [comment]: # ({2b9f011b-1ad487be}) ### Media L'oggetto media ha le seguenti proprietà. |Property|Type|Description| |--|--|------| |mediaid|ID|ID del media dell'utente.

[Property behavior](/manual/api/reference_commentary#property-behavior):
- *read-only*| |mediatypeid|ID|ID del tipo di media utilizzato dal media dell'utente.

[Property behavior](/manual/api/reference_commentary#property-behavior):
- *required*| |sendto|string/array|Indirizzo, nome utente o altro identificatore del destinatario.

Se `type` di [Media type](/manual/api/reference/mediatype/object#mediatype) è impostato su "Email", i valori sono rappresentati come array. Per gli altri tipi di [Media types](/manual/api/reference/mediatype/object#mediatype), il valore è rappresentato come stringa.

[Property behavior](/manual/api/reference_commentary#property-behavior):
- *required*| |active|integer|Indica se il media è abilitato.

Valori possibili:
0 - *(default)* abilitato;
1 - disabilitato.| |severity|integer|Trigger severity per cui inviare notifiche.

Valori bitmap possibili:
1 - Not classified;
2 - Information;
4 - Warning;
8 - Average;
16 - High;
32 - Disaster.

Questo è un campo bitmask; è accettabile qualsiasi somma dei valori bitmap possibili (ad esempio, 48 per Average, High e Disaster).

Default: 63.| |period|string|Orario in cui le notifiche possono essere inviate come [time period](/manual/appendix/time_period) o macro utente separate da un punto e virgola.

Default: 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.

Questa proprietà è supportata da Zabbix 7.0.9.| |userdirectory_mediaid|ID|ID di mapping del media della directory utente per i media provisioned.

[Property behavior](/manual/api/reference_commentary#property-behavior):
- *read-only*
- *supported* per utenti di tipo *Super admin* (da Zabbix 7.0.9)| [comment]: # ({/2b9f011b-1ad487be})