En esta página
Objeto usuario
Los siguientes objetos están directamente relacionados con la API de usuario.
Usuario
El objeto user tiene las siguientes propiedades.
| Property | Type | Description |
|---|---|---|
| userid | ID | ID del usuario. Comportamiento de la propiedad: - solo lectura - obligatorio para operaciones de actualización |
| username | string | 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 está establecido en un valor válido distinto de "0"), y el estado de aprovisionamiento del directorio de usuarios está habilitado (provision_status del objeto User directory está establecido en "1"), y el estado de autenticación de todo el aprovisionamiento LDAP o SAML está habilitado (ldap_jit_status del objeto Authentication está establecido en "Enabled for configured LDAP IdPs" o saml_jit_status del objeto Authentication está establecido en "Enabled for configured SAML IdPs") |
| passwd | string | 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. Comportamiento de la propiedad: - solo escritura |
| roleid | ID | ID del rol del usuario. Tenga en cuenta que los usuarios sin un rol solo pueden iniciar sesión en Zabbix mediante autenticación LDAP o 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: - solo lectura |
| attempt_failed | integer | Número reciente de intentos fallidos de inicio de sesión. Comportamiento de la propiedad: - solo lectura |
| attempt_ip | string | Dirección IP desde la que se produjo el último intento de inicio de sesión fallido. Comportamiento de la propiedad: - solo lectura |
| autologin | integer | Indica si se habilita 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 | string | Tiempo de vida de la sesión del usuario. Acepta segundos y unidades de tiempo con sufijo. Si se establece en 0s, la sesión nunca expirará. Predeterminado: 15m. |
| lang | string | Código de idioma del idioma del usuario, por ejemplo, en_US.Predeterminado: default - valor predeterminado del sistema. |
| name | string | Nombre del usuario. |
| provisioned | integer | Indica si el usuario ha sido aprovisionado. Valores posibles: 0 - no aprovisionado; 1 - aprovisionado. Comportamiento de la propiedad: - solo lectura |
| refresh | string | Período de actualización automática. Acepta segundos o una unidad de tiempo con sufijo (por ejemplo, 30s, 90s, 1m, 1h). Predeterminado: 30s. |
| rows_per_page | integer | Cantidad de filas de objetos que se mostrarán por página. Predeterminado: 50. |
| surname | string | Apellido del usuario. |
| theme | string | Tema del usuario. Valores posibles: default - (predeterminado) valor predeterminado del sistema;blue-theme - Azul;dark-theme - Oscuro;hc-light - Alto contraste claro;hc-dark - Alto contraste oscuro. |
| ts_provisioned | timestamp | Momento en que se realizó la última operación de aprovisionamiento. Comportamiento de la propiedad: - solo lectura - compatible para usuarios de tipo Super admin |
| url | string | URL de la página a la que se redirigirá al usuario después de iniciar sesión. |
| userdirectoryid | ID | ID del directorio de usuarios al que está vinculado el usuario. Se usa para el aprovisionamiento (creación o actualización), así como para iniciar sesión de 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 propiedad userdirectoryid de los grupos de usuarios a los que pertenece el usuario.Predeterminado: 0. Comportamiento de la propiedad: - solo lectura - compatible para usuarios de tipo Super admin |
| timezone | string | Zona horaria del usuario, por ejemplo, Europe/London, UTC.Predeterminado: default - valor predeterminado del sistema.Para la lista completa de zonas horarias compatibles, consulte la documentación de PHP. |
Medio
El objeto medio tiene las siguientes propiedades.
| Propiedad | Tipo | Descripción |
|---|---|---|
| mediaid | ID | ID del medio del usuario. Comportamiento de la propiedad: - solo lectura |
| mediatypeid | ID | ID del tipo de medio utilizado por el medio del usuario. Comportamiento de la propiedad: - requerido |
| sendto | string/array | Dirección, nombre de usuario u otro identificador del destinatario. Si el type del Tipo de medio está establecido en "Email", los valores se representan como un array. Para otros tipos de Tipos de medio, el valor se representa como una cadena.Comportamiento de la propiedad: - requerido |
| active | integer | Indica si el medio está habilitado. Valores posibles: 0 - (por defecto) habilitado; 1 - deshabilitado. |
| severity | integer | Gravedad de los disparadores sobre los que enviar notificaciones. Valores posibles de la máscara de bits: 1 - No clasificado; 2 - Información; 4 - Advertencia; 8 - Media; 16 - Alta; 32 - Desastre. Este es un campo de máscara de bits; cualquier suma de los valores posibles de la máscara de bits es aceptable (por ejemplo, 48 para Media, Alta y Desastre). Por defecto: 63. |
| period | string | Tiempo en el que se pueden enviar las notificaciones como un período de tiempo o macros de usuario separadas por punto y coma. Por defecto: 1-7,00:00-24:00. |
| provisioned | integer | Indica si el usuario ha sido provisionado. Valores posibles: 0 - no provisionado; 1 - provisionado. |
| userdirectory_mediaid | ID | ID de mapeo de medio de directorio de usuario para medios provisionados. Comportamiento de la propiedad: - solo lectura - soportado para usuarios de tipo Super admin |