Oggetto utente

I seguenti oggetti sono direttamente correlati all'API user.

User

L'oggetto user ha le seguenti proprietà.

Property Type Description
userid ID ID dell'user.

Comportamento della proprietà:
- sola lettura
- obbligatoria per le operazioni di aggiornamento
username string Nome dell'user.

Comportamento della proprietà:
- obbligatoria per le operazioni di creazione
- sola lettura per gli user provisioned se l'user è collegato a una user directory (userdirectoryid è impostato a un valore valido diverso da "0"), e lo stato di provisioning della user directory è abilitato (provision_status dell'User directory object è impostato a "1"), e lo stato di autenticazione di tutti i provisioning LDAP o SAML è abilitato (ldap_jit_status dell'Authentication object è impostato su "Enabled for configured LDAP IdPs" oppure saml_jit_status dell'Authentication object è 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.

Comportamento della proprietà:
- sola scrittura
roleid ID ID del ruolo dell'user.

Nota che gli user senza un ruolo possono accedere a Zabbix solo tramite autenticazione LDAP o 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à:
- sola lettura
attempt_failed integer Numero recente di tentativi di accesso falliti.

Comportamento della proprietà:
- sola lettura
attempt_ip string Indirizzo IP da cui è provenuto l'ultimo tentativo di accesso non riuscito.

Comportamento della proprietà:
- 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 a 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.

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

Comportamento della proprietà:
- 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.

Comportamento della proprietà:
- sola lettura
- 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 a cui l'user è collegato.

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 a cui l'user appartiene.

Predefinito: 0.

Comportamento della proprietà:
- sola lettura
- supportata per gli user di tipo Super admin
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.

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à:
- sola lettura
mediatypeid ID ID del tipo di supporto di notifica utilizzato dal supporto di notifica dell'utente.

Comportamento della proprietà:
- obbligatoria
sendto string/array Indirizzo, nome utente o altro identificatore del destinatario.

Se type del tipo di supporto di notifica è impostato su "Email", i valori sono rappresentati come array. Per altri tipi di tipi di supporto di notifica, il valore è rappresentato come stringa.

Comportamento della proprietà:
- 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 o macro utente separate da un punto e virgola.

Predefinito: 1-7,00:00-24:00.
provisioned integer Indica se l'utente è stato provisioned.

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à:
- sola lettura
- supportata per utenti di tipo Super admin