> Objeto de usuario

Los siguientes objetos están directamente relacionados con la API user.

Usuario

El objeto de usuario tiene las siguientes propiedades.

Propiedad	Tipo	Descripción
userid	cadena	ID del usuario. Comportamiento de la propiedad: - solo lectura - obligatorio para operaciones de actualización
username	cadena	Nombre del usuario. Comportamiento de la propiedad: - obligatorio para operaciones de creación - solo lectura para usuarios aprovisionados si el usuario está vinculado a un directorio de usuarios (`userdirectoryid` se establece en un valor válido que no es "0"), y el estado de aprovisionamiento del directorio de usuarios está habilitado (`provision_status` del objeto de directorio de usuarios se establece en "1"), y el estado de autenticación de todo el aprovisionamiento LDAP o SAML está habilitado (`ldap_jit .... object](/manual/api/reference/authentication/object#authentication) está configurado como "Habilitado para los IdP de LDAP configurados" o`saml_jit_statusde [Authentication object](/manual/api/reference/authentication/object#authentication) está configurado como "Habilitado para los IdP de SAML configurados")\| \|passwd\|cadena\|Contraseña del usuario. El valor de este parámetro puede ser una cadena vacía si el usuario está vinculado a un [directorio de usuarios](/manual/api/reference/userdirectory/object). [Comportamiento de la propiedad](/manual/api/reference_commentary#property-behavior): - solo escritura\| \|roleid\|cadena\|Identificador de rol del usuario. Tenga en cuenta que los usuarios sin un rol pueden iniciar sesión en Zabbix solo mediante autenticación [LDAP](/manual/web_interface/frontend_sections/users/authentication/ldap) o [SAML](/manual/web_interface/frontend_sections/users/authentication/saml), siempre que su información LDAP/SAML coincida con las asignaciones de grupos de usuarios configuradas en Zabbix.\| \|attempt\_clock\|timestamp\|Hora del último intento de inicio de sesión fallido. [Comportamiento de la propiedad](/manual/api/reference_commentary#property-behavior): - solo lectura\| \|attempt\_failed\|entero\|Recuento de intentos de inicio de sesión fallidos recientes. [Comportamiento de la propiedad](/manual/api/reference_commentary#property-behavior): - solo lectura\| \|attempt\_ip\|cadena\|Dirección IP desde la que se realizó el último intento de inicio de sesión fallido. [Comportamiento de la propiedad](/manual/api/reference_commentary#property-behavior): - solo lectura\| \|autologin\|entero\|Si se debe habilitar el inicio de sesión automático. Valores posibles: 0 - (predeterminado) inicio de sesión automático deshabilitado; 1 - inicio de sesión automático habilitado.\| \|autologout\|cadena\|Tiempo de vida de la sesión del usuario. Acepta segundos y unidades de tiempo con sufijo. Si se establece en 0 s, la sesión nunca caducará. Predeterminado: 15 m.\| \|lang\|string\|Código de idioma del idioma del usuario, por ejemplo,en_US`. Predeterminado:`default`- valor predeterminado del sistema.\| \|name\|cadena\|Nombre del usuario.\| \|refresh\|cadena\|Período de actualización automático. Acepta segundos o unidades de tiempo con sufijo (p. ej., 30 s, 90 s, 1 m, 1 h). Predeterminado: 30 s.\| \|rows\_per\_page\|entero\|Cantidad de filas de objetos que se mostrarán por página. Predeterminado: 50.\| \|surname\|cadena\|Apellido del usuario.\| \|theme\|cadena\|Tema del usuario. Valores posibles:`default`- (default) valor predeterminado del sistema;`blue-theme`- Azul;`dark-theme- Oscuro.\| \|ts_provisioned\|timestamp\|Hora en la que se realizó la última operación de [aprovisionamiento](/manual/api/reference/user/provision). [Comportamiento de la propiedad](/manual/api/reference_commentary#property-behavior): - solo lectura\| \|url\|cadena\|URL de la página a la que se redirigirá al usuario después de iniciar sesión.\| \|userdirectoryid\|cadena\|ID del [directorio de usuarios](/manual/api/reference/userdirectory/object) al que está vinculado el usuario. Se utiliza para el aprovisionamiento (creación o actualización), así como para iniciar sesión en un usuario vinculado a un directorio de usuarios. Para las operaciones de inicio de sesión, el valor de esta propiedad tendrá prioridad sobre la propiedaduserdirectoryid`de los [grupos de usuarios](/manual/api/reference/usergroup/object#user-group) a los que pertenece el usuario. Valor predeterminado: 0.\| \|timezone\|cadena\|Zona horaria del usuario, por ejemplo,`Europa/Londres`,`UTC`. Valor predeterminado:`default` - valor predeterminado del sistema. Para obtener la lista completa de zonas horarias compatibles, consulte la documentación de PHP.

Medios

El objeto de medios tiene las siguientes propiedades.

Propiedad	Tipo	Descripción
mediatypeid	cadena	ID del tipo de medio utilizado por el medio. Comportamiento de la propiedad: - requerido
sendto	cadena/matriz	Dirección, nombre de usuario u otro identificador del destinatario. Si `type` de Tipo de medio está configurado en "Correo electrónico", los valores se representan como una matriz. Para otros tipos de Tipos de medios, el valor se representa como una cadena. Comportamiento de la propiedad: - obligatorio
active	entero	Si los medios están habilitados. Valores posibles: 0 - (predeterminado) habilitado; 1 - deshabilitado.
severity	entero	Gravedades de activación sobre las que enviar notificaciones. Las gravedades se almacenan en formato binario y cada bit representa la gravedad correspondiente. Por ejemplo, "12" equivale a "1100" en binario y significa que las notificaciones se enviarán desde activadores con gravedades "advertencia" y "promedio". Consulte la página del objeto iniciador para obtener una lista de las gravedades de activación admitidas. Valor predeterminado: 63.
period	cadena	Hora en la que las notificaciones se pueden enviar como un período de tiempo o macros de usuario separadas por un punto y coma. Predeterminado: 1-7,00:00- 24:00.

Documentation

> Objeto de usuario

Usuario

Medios