Oggetto utente

I seguenti oggetti sono direttamente correlati all'API user.

Utente

L'oggetto utente ha le seguenti proprietà.

Proprietà Type Descrizione
userid ID ID dell'utente.

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

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

Comportamento della proprietà:
- 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 o 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à:
- sola lettura
attempt_failed integer Numero recente di tentativi di accesso non riusciti.

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 - accesso automatico disabilitato (predefinito);
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 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 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;
dark-theme - Scuro.
ts_provisioned timestamp Ora in cui è stata eseguita l'ultima operazione di provisioning.

Comportamento della proprietà:
- 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 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 a cui l'utente appartiene.

Predefinito: 0.

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

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