[comment]: # aside: 1 [comment]: # ({8f026b4a-0834cf88}) # Objet utilisateur Les objets suivants sont directement liés à l'API `user`. [comment]: # ({/8f026b4a-0834cf88}) [comment]: # ({730822db-0ecc45be}) ### Utilisateur L'objet utilisateur possède les propriétés suivantes. |Property|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|--| |userid|ID|ID de l'utilisateur.

[Comportement de la propriété](/manual/api/reference_commentary#property-behavior):
- *lecture seule*
- *obligatoire* pour les opérations de mise à jour| |username|string|Nom de l'utilisateur.

[Comportement de la propriété](/manual/api/reference_commentary#property-behavior):
- *obligatoire* pour les opérations de création
- *lecture seule* pour les [utilisateurs provisionnés](/manual/web_interface/frontend_sections/users/authentication#default-authentication) si l'utilisateur est lié à un [annuaire d'utilisateurs](/manual/api/reference/userdirectory/object) (`userdirectoryid` est défini sur une valeur valide différente de "0"), et si l'état de provisionnement de l'annuaire d'utilisateurs est activé (`provision_status` de l'[objet annuaire d'utilisateurs](/manual/api/reference/userdirectory/object#userdirectory) est défini sur "1"), et si l'état d'authentification de tout le provisionnement LDAP ou SAML est activé (`ldap_jit_status` de l'[objet Authentication](/manual/api/reference/authentication/object#authentication) est défini sur "Enabled for configured LDAP IdPs" ou `saml_jit_status` de l'[objet Authentication](/manual/api/reference/authentication/object#authentication) 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 [annuaire d'utilisateurs](/manual/api/reference/userdirectory/object).

[Comportement de la propriété](/manual/api/reference_commentary#property-behavior):
- *é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](/manual/web_interface/frontend_sections/users/authentication/ldap) ou [SAML](/manual/web_interface/frontend_sections/users/authentication/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é](/manual/api/reference_commentary#property-behavior):
- *lecture seule*| |attempt\_failed|integer|Nombre récent de tentatives de connexion échouées.

[Comportement de la propriété](/manual/api/reference_commentary#property-behavior):
- *lecture seule*| |attempt\_ip|string|Adresse IP d'où provenait la dernière tentative de connexion infructueuse.

[Comportement de la propriété](/manual/api/reference_commentary#property-behavior):
- *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é](/manual/api/reference/user/provision).

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

[Comportement de la propriété](/manual/api/reference_commentary#property-behavior):
- *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;
`hc-light` - Contraste élevé clair;
`hc-dark` - Contraste élevé sombre.| |ts_provisioned|timestamp|Moment où la dernière opération de [provisionnement](/manual/api/reference/user/provision) a été effectuée.

[Comportement de la propriété](/manual/api/reference_commentary#property-behavior):
- *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 de l'[annuaire d'utilisateurs](/manual/api/reference/userdirectory/object) auquel l'utilisateur est lié.

Utilisé pour le provisionnement (création ou mise à jour), ainsi que pour connecter un utilisateur lié à un annuaire 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](/manual/api/reference/usergroup/object#user-group) auxquels l'utilisateur appartient.

Par défaut : 0.

[Comportement de la propriété](/manual/api/reference_commentary#property-behavior):
- *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](https://www.php.net/manual/en/timezones.php).| [comment]: # ({/730822db-0ecc45be}) [comment]: # ({e65af01e-1ad487be}) ### 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é](/manual/api/reference_commentary#property-behavior) :
- *lecture seule*| |mediatypeid|ID|ID du type de média utilisé par le média de l'utilisateur.

[Comportement de la propriété](/manual/api/reference_commentary#property-behavior) :
- *obligatoire*| |sendto|string/array|Adresse, nom d'utilisateur ou autre identifiant du destinataire.

Si le `type` du [type de média](/manual/api/reference/mediatype/object#mediatype) est défini sur « Email », les valeurs sont représentées sous forme de tableau. Pour les autres types de [types de média](/manual/api/reference/mediatype/object#mediatype), la valeur est représentée sous forme de chaîne.

[Comportement de la propriété](/manual/api/reference_commentary#property-behavior) :
- *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](/manual/appendix/time_period) 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é](/manual/api/reference/user/provision).

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é](/manual/api/reference_commentary#property-behavior) :
- *lecture seule*
- *pris en charge* pour les utilisateurs de type *Super admin*| [comment]: # ({/e65af01e-1ad487be})