Objet utilisateur

Les objets suivants sont directement liés à l'API user.

Utilisateur

L'objet utilisateur possède les propriétés suivantes.

Propriété Type Description
userid ID ID de l'utilisateur.

Comportement de la propriété :
- lecture seule
- obligatoire pour les opérations de mise à jour
username string Nom de l'utilisateur.

Comportement de la propriété :
- obligatoire pour les opérations de création
- lecture seule pour les utilisateurs provisionnés si l'utilisateur est lié à un répertoire d'utilisateurs (userdirectoryid est défini sur une valeur valide différente de "0"), que le statut de provisionnement du répertoire d'utilisateurs est activé (provision_status de l'objet Répertoire d'utilisateurs est défini sur "1"), et que le statut d'authentification de tous les provisionnements LDAP ou SAML est activé (ldap_jit_status de l'objet Authentification est défini sur "Enabled for configured LDAP IdPs" ou saml_jit_status de l'objet Authentification est défini sur "Enabled for configured SAML IdPs")
passwd string Mot de passe de l'utilisateur.

La valeur de ce paramètre peut être une chaîne vide si l'utilisateur est lié à un répertoire d'utilisateurs.

Comportement de la propriété :
- écriture seule
roleid ID ID du rôle de l'utilisateur.

Notez que les utilisateurs sans rôle peuvent se connecter à Zabbix uniquement à l'aide de l'authentification LDAP ou SAML, à condition que leurs informations LDAP/SAML correspondent aux mappages de groupes d'utilisateurs configurés dans Zabbix.
attempt_clock timestamp Heure de la dernière tentative de connexion infructueuse.

Comportement de la propriété :
- lecture seule
attempt_failed integer Nombre récent de tentatives de connexion échouées.

Comportement de la propriété :
- lecture seule
attempt_ip string Adresse IP d'où provenait la dernière tentative de connexion infructueuse.

Comportement de la propriété :
- lecture seule
autologin integer Indique s'il faut activer la connexion automatique.

Valeurs possibles :
0 - (par défaut) connexion automatique désactivée ;
1 - connexion automatique activée.
autologout string Durée de vie de la session utilisateur. Accepte des secondes et une unité de temps avec suffixe. Si défini sur 0s, la session n'expirera jamais.

Par défaut : 15m.
lang string Code de langue de l'utilisateur, par exemple en_US.

Par défaut : default - valeur par défaut du système.
name string Prénom de l'utilisateur.
provisioned integer Indique si l'utilisateur a été provisionné.

Valeurs possibles :
0 - non provisionné ;
1 - provisionné.

Comportement de la propriété :
- lecture seule
refresh string Période de rafraîchissement automatique. Accepte des secondes ou une unité de temps avec suffixe (par ex., 30s, 90s, 1m, 1h).

Par défaut : 30s.
rows_per_page integer Nombre de lignes d'objet à afficher par page.

Par défaut : 50.
surname string Nom de famille de l'utilisateur.
theme string Thème de l'utilisateur.

Valeurs possibles :
default - (par défaut) valeur par défaut du système ;
blue-theme - Bleu ;
dark-theme - Sombre.
ts_provisioned timestamp Heure à laquelle la dernière opération de provisionnement a été effectuée.

Comportement de la propriété :
- lecture seule
- pris en charge pour les utilisateurs de type Super admin
url string URL de la page vers laquelle rediriger l'utilisateur après la connexion.
userdirectoryid ID ID du répertoire d'utilisateurs auquel l'utilisateur est lié.

Utilisé pour le provisionnement (création ou mise à jour), ainsi que pour connecter un utilisateur lié à un répertoire d'utilisateurs.

Pour les opérations de connexion, la valeur de cette propriété aura priorité sur la propriété userdirectoryid des groupes d'utilisateurs auxquels l'utilisateur appartient.

Par défaut : 0.

Comportement de la propriété :
- lecture seule
- pris en charge pour les utilisateurs de type Super admin
timezone string Fuseau horaire de l'utilisateur, par exemple Europe/London, UTC.

Par défaut : default - valeur par défaut du système.

Pour la liste complète des fuseaux horaires pris en charge, veuillez consulter la documentation PHP.

Média

L'objet média possède les propriétés suivantes.

Propriété Type Description
mediaid ID ID du média de l'utilisateur.

Comportement de la propriété :
- lecture seule
mediatypeid ID ID du type de média utilisé par le média de l'utilisateur.

Comportement de la propriété :
- obligatoire
sendto string/array Adresse, nom d'utilisateur ou autre identifiant du destinataire.

Si le type du type de média est défini sur « Email », les valeurs sont représentées sous forme de tableau. Pour les autres types de types de média, la valeur est représentée sous forme de chaîne.

Comportement de la propriété :
- obligatoire
active integer Indique si le média est activé.

Valeurs possibles :
0 - (par défaut) activé ;
1 - désactivé.
severity integer Sévérités de déclencheur pour lesquelles envoyer des notifications.

Valeurs bitmap possibles :
1 - Non classé ;
2 - Information ;
4 - Avertissement ;
8 - Moyenne ;
16 - Haute ;
32 - Désastre.

Il s'agit d'un champ de masque de bits ; toute somme des valeurs bitmap possibles est acceptée (par exemple, 48 pour Moyenne, Haute et Désastre).

Par défaut : 63.
period string Période pendant laquelle les notifications peuvent être envoyées, sous la forme d'une période de temps ou de macros utilisateur séparées par un point-virgule.

Par défaut : 1-7,00:00-24:00.
provisioned integer Indique si l'utilisateur a été provisionné.

Valeurs possibles :
0 - non provisionné ;
1 - provisionné.
userdirectory_mediaid ID ID du mappage du média de l'annuaire utilisateur pour les médias provisionnés.

Comportement de la propriété :
- lecture seule
- pris en charge pour les utilisateurs de type Super admin