[comment]: # translation:outdated

[comment]: # aside:1

[comment]: # ({8f026b4a-0834cf88})
# Objecte usuari

Els següents objectes són relacionats amb l'API `user`.

[comment]: # ({/8f026b4a-0834cf88})

[comment]: # ({dfb701c0-0ecc45be})
### Usuari

L'objecte usuari té les propietats següents.

|Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció|
|--|--|------|
|userid|ID|ID de l'usuari.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *només lectura*<br>- *obligatori* per operacions d'actualització|
|username|string|Nom de l'usuari.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* per a operacions de creació<br>- *només lectura* per a [usuaris subministrats](/manual/web_interface/frontend_sections/users/authentication#default-authentication) si l'usuari és vinculat a un [directori d'usuari](/manual/api/reference/userdirectory/object) ('userdirectoryid' és establert a un valor vàlid que no sigui "0"), i l'estat de subministrament del directori d'usuari és habilitat ('provision_status' de l'[objecte de directori d'usuari](/manual/api/reference/userdirectory/object#userdirectory) s'estableix a "1"), i l'estat d'autenticació de tot l'aprovisionament LDAP o SAML és habilitat (`ldap_jit_status` de [Authentication object](/manual/api/reference/authentication/object#authentication) s'estableix a "Actiu per LDAP IdPs configurades" o `saml_jit_status` d'[objecte d'autenticació](/manual/api/reference/authentication/object#authentication) s'ha establert a "Activat per a identificadors SAML configurats")|
|passwd|string|Mot de pas de l'usuari.<br><br>El valor d'aquest paràmetre pot ser una cadena buida si l'usuari és vinculat a un [directori d'usuari](/manual/api/reference/userdirectory/object).<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *només escriptura*|
|roleid|ID|ID de rol de l'usuari.<br><br>Fixeu-vos que els usuaris sense cap rol poden entrar a Zabbix només emprant autenticació [LDAP](/manual/web_interface/frontend_sections/users/authentication/ldap) o [SAML](/manual/web_interface/frontend_sections/users/authentication/saml), indicant que la informació d'LDAP/SAML coincideixi amb els mapatges de grup d'usuari configurats a Zabbix.|
|attempt\_clock|timestamp|Hora del darrer intent d'inici de sessió sense èxit.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *només lectura*|
|attempt\_failed|integer|Recompte d'intents d'inici de sessió fallits recents.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *només lectura*|
|attempt\_ip|string|Adreça IP d'on prové el darrer intent d'inici de sessió infructuós.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *només lectura *|
|autologin|integer|Si s'ha d'activar l'inici de sessió automàtic.<br><br>Valors possibles:<br>0 - *(per defecte)* inici de sessió automàtic desactivat;<br>1 - inici de sessió automàtic activat.|
|autologout|string|Vida útil de la sessió d'usuari. Admet segons i unitat de temps amb sufix. Si s'estableix en 0, la sessió no caducarà mai.<br><br>Per defecte: 15 m.|
|lang|string|Codi d'idioma de l'idioma de l'usuari, per exemple, `en_US`.<br><br>Per defecte: `default` - predeterminat del sistema.|
|name|string|Nom de l'usuari.|
|provisioned|enter|Si l'usuari ha estat [provisionat](/manual/api/reference/user/provision).<br><br>Valors possibles:<br>0 - no provisionat;<br>1 - provisionat.<br><br>[Comporatament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *només lectura*|
|refresh|string|Període d'actualització automàtica. Admet segons i unitat de temps amb sufix.<br><br>Per defecte: 30s.|
|rows\_per\_page|integer|Quantitat de files d'objectes per mostrar per pàgina.<br><br>Per defecte: 50.|
|surname|string|Cognom de l'usuari.|
|theme|string|Tema de l'usuari.<br><br>Valors possibles:<br>`default` - *(default)* per defecte;<br>`blue-theme` - Blau;<br>`dark-theme` ` - Fosc.|
|ts_provisioned|timestamp|Hora en què s'ha fet la darrera operació de [provisionament](/manual/api/reference/user/provision).<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior) :<br>- *només lectura*<br>- *admès* per usuaris de tipus *Super admin*|
|url|string|URL de la pàgina per redirigir l'usuari després d'iniciar sessió.|
|userdirectoryid|ID|ID del [directori d'usuari](/manual/api/reference/userdirectory/object) al qual l'usuari és enllaçat.<br><br>S'empra per al subministrament (creació o actualització), així com per iniciar la sessió a un usuari que sigui vinculat a un directori d'usuaris.<br><br>Per a les operacions d'inici de sessió, el valor d'aquesta propietat tindrà prioritat sobre la propietat `userdirectoryid` de [grups d'usuaris](/manual/api/reference/usergroup/object #user-group) al qual pertany l'usuari.<br><br>Per defecte: 0.<br><br>- *admès* per usuaris de tipus *Super admin*|
|timezone|string|La zona horària de l'usuari, per exemple, `Europe/London`, `UTC`.<br><br>Per defecte: `default` - per defecte del sistema.<br><br>Per a la llista completa de l'hora compatible zones si us plau, consulteu [documentació PHP](https://www.php.net/manual/en/timezones.php).|

[comment]: # ({/dfb701c0-0ecc45be})

[comment]: # ({e65af01e-1ad487be})
### Suport

L'objecte suport té les propietats següents.

|Propietat|Tipus|Descripció|
|--|--|------|
|mediaid|ID|ID del suport de l'usuari.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *només lectura*|
|mediatypeid|ID|ID del tipus de suport emprat pel suport.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori*|
|sendto|string/array|Adreça, nom d'usuari o un altre identificador del destinatari.<br><br>Si `type` de [tipus de suport](/manual/api/reference/mediatype/object#mediatype) s'estableix a "Correu electrònic", els valors es representen com a matriu. Per a altres tipus de [Tipus de suport](/manual/api/reference/mediatype/object#mediatype), el valor es representa com una cadena.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property- behavior):<br>- *obligatori*|
|active|integer|Si el suport és habilitat.<br><br>Valors possibles:<br>0 - *(per defecte)* activat;<br>1 - desactivat.|
|severity|integer|Activa les gravetats per enviar notificacions.<br><br>Possibles valors de bitmap:<br>1 - No classificat;<br>2 - Informació;<br>4 - Avís;<br>8 - Mitjana;<br>16 - Alta;<br>32 - Desastre.<br><br>És un camp de màscara de bit; s'admet qualsevol suma de possibles valors de mapa de bits (per exemple, 48 per Mitjana, Alta i Desastre).<br><br>Per defecte: 63|
|period|string|Hora en què les notificacions es poden enviar com a [període de temps](/manual/appendix/time_period) o macros d'usuari separades per punt i coma.<br><br>Per defecte: 1-7,00:00-24:00.|
|provisioned|enter|Si l'usuari ha estat [provisionat](/manual/api/reference/user/provision).<br><br>Valors possibles:<br>0 - no provisionat;<br>1 - provisionat.|
|userdirectory_mediaid|ID|ID del directori de mapatge de suport per suports aprovisionats.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property- behavior):<br>- *només lectura*<br>- *admès* per usuaris de tipus *Super admin*|

[comment]: # ({/e65af01e-1ad487be})