On this page

Oggetto utente

I seguenti oggetti sono direttamente correlati all'API user.

Utente

L'oggetto utente ha le seguenti proprietà.

Property Type Description
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 sottoposti a provisioning 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 User directory è impostato su "1") e lo stato di autenticazione di tutto il provisioning LDAP o SAML è abilitato (ldap_jit_status dell'oggetto Authentication è impostato su "Enabled for configured LDAP IdPs" oppure saml_jit_status dell'oggetto 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.

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

Gli utenti senza un ruolo possono accedere a Zabbix solo utilizzando l'autenticazione LDAP o SAML, a condizione che le relative 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 dei tentativi di accesso non riusciti recenti.

Comportamento della proprietà:
- sola lettura
attempt_ip string Indirizzo IP da cui è stato effettuato 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'utente. Accetta un numero di secondi (ad esempio, 1, 60, 300) oppure un valore con un suffisso temporale (ad esempio, 30s, 1m, 2h). Se impostato su 0s, la sessione non scadrà mai.

Predefinito: 15m.
lang string Codice della lingua dell'utente, ad esempio en_US.

Predefinito: default - impostazione predefinita del sistema.
name string Nome dell'utente.
provisioned integer Indica se l'utente è stato sottoposto a provisioning.

Valori possibili:
0 - non sottoposto a provisioning;
1 - sottoposto a provisioning.

Questa proprietà è supportata a partire da Zabbix 7.0.9.

Comportamento della proprietà:
- sola lettura
refresh string Intervallo di aggiornamento automatico. Accetta un numero di secondi (ad esempio, 1, 60, 300) oppure un valore con un suffisso temporale (ad esempio, 30s, 1m, 2h, 1d).

Predefinito: 30s.
rows_per_page integer Numero di righe di oggetti da visualizzare per pagina.

Predefinito: 50.
surname string Cognome dell'utente.
theme string Tema dell'utente.

Valori possibili:
default - (predefinito) impostazione predefinita del sistema;
blue-theme - Blu;
dark-theme - Scuro;
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.

Comportamento della proprietà:
- sola lettura
- supportata per gli utenti di tipo Super admin (a partire da Zabbix 7.0.9)
url string URL della pagina a cui reindirizzare l'utente dopo l'accesso.
userdirectoryid ID ID della directory utenti a cui è collegato l'utente.

Utilizzato per il provisioning (creazione o aggiornamento) e per consentire l'accesso a un utente collegato a una directory utenti.

Per le operazioni di accesso, il valore di questa proprietà avrà la precedenza sulla proprietà userdirectoryid dei gruppi utenti a cui appartiene l'utente.

Predefinito: 0.

Comportamento della proprietà:
- sola lettura
- supportata per gli utenti di tipo Super admin (a partire da Zabbix 7.0.9)
timezone string Fuso orario dell'utente, ad esempio Europe/London, UTC.

Predefinito: default - impostazione predefinita del sistema.

Per l'elenco completo dei fusi orari supportati, consultare la documentazione PHP.

Media

L'oggetto media ha le seguenti proprietà.

Property Type Description
mediaid ID ID del media dell'utente.

Property behavior:
- read-only
mediatypeid ID ID del tipo di media utilizzato dal media dell'utente.

Property behavior:
- required
sendto string/array Indirizzo, nome utente o altro identificatore del destinatario.

Se type di Media type è impostato su "Email", i valori sono rappresentati come array. Per gli altri tipi di Media types, il valore è rappresentato come stringa.

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 o macro utente separate da un punto e virgola.

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

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:
- read-only
- supported per utenti di tipo Super admin (da Zabbix 7.0.9)