On this page

用户对象

以下对象都是与 user 相关的API。

用户

用户对象具有以下属性。

属性 类型 描述
userid ID 用户的 ID。

属性行为：
- 只读
- 更新 操作时为 必填
username string 用户名。

属性行为：
- 创建 操作时为 必填
- 对于已预配用户，如果该用户已关联到用户目录（userdirectoryid 设置为非 "0" 的有效值），且用户目录预配状态已启用（用户目录对象 的 provision_status 设置为 "1"），并且所有 LDAP 或 SAML 预配的认证状态已启用（认证对象 的 ldap_jit_status 设置为“为已配置的 LDAP IdP 启用”，或 认证对象 的 saml_jit_status 设置为“为已配置的 SAML IdP 启用”），则该属性为 只读
passwd string 用户密码。

如果用户已关联到用户目录，则该参数的值可以为空字符串。

属性行为：
- 仅写
roleid ID 用户角色的 ID。

请注意，没有角色的用户只能通过 LDAP 或 SAML 认证登录 Zabbix，前提是其 LDAP/SAML 信息与 Zabbix 中配置的用户组映射相匹配。
attempt_clock timestamp 上次登录失败尝试的时间。

属性行为：
- 只读
attempt_failed integer 最近登录失败的次数。

属性行为：
- 只读
attempt_ip string 上次登录失败尝试来源的 IP 地址。

属性行为：
- 只读
autologin integer 是否启用自动登录。

可能的值：
0 - (默认) 禁用自动登录；
1 - 启用自动登录。
autologout string 用户会话生命周期。接受秒数以及带后缀的时间单位。如果设置为 0s，会话将永不过期。

默认值：15m。
lang string 用户语言的语言代码，例如 en_US。

默认值：default - 系统默认。
name string 用户的名字。
provisioned integer 用户是否已被预配。

可能的值：
0 - 未预配；
1 - 已预配。

属性行为：
- 只读
refresh string 自动刷新周期。接受秒数或带后缀的时间单位（例如 30s、90s、1m、1h）。

默认值：30s。
rows_per_page integer 每页显示的对象行数。

默认值：50。
surname string 用户的姓氏。
theme string 用户主题。

可能的值：
default - (默认) 系统默认；
blue-theme - 蓝色；
dark-theme - 深色。
ts_provisioned timestamp 最近一次执行预配操作的时间。

属性行为：
- 只读
- 对 超级管理员 类型用户 支持
url string 用户登录后要重定向到的页面 URL。
userdirectoryid ID 该用户所关联的用户目录的 ID。

用于预配（创建或更新），以及用于登录已关联到用户目录的用户。

对于登录操作，此属性的值将优先于该用户所属用户组的 userdirectoryid 属性。

默认值：0。

属性行为：
- 只读
- 对 超级管理员 类型用户 支持
timezone string 用户的时区，例如 Europe/London、UTC。

默认值：default - 系统默认。

有关支持的时区完整列表，请参见 PHP documentation。

媒介

媒介对象具有以下属性。

属性 类型 描述
mediaid ID 用户媒介的 ID。

属性行为：
- 只读
mediatypeid ID 用户媒介所使用的媒介类型的 ID。

属性行为：
- 必填
sendto string/array 收件人的地址、用户名或其他标识符。

如果 媒介类型 的 type 设置为“Email”，则值表示为数组。对于其他类型的 媒介类型，值表示为字符串。

属性行为：
- 必填
active integer 媒介是否启用。

可能的值：
0 - （默认） 启用；
1 - 禁用。
severity integer 发送通知的触发器严重性。

可能的位图值：
1 - 未分类；
2 - 信息；
4 - 警告；
8 - 一般严重；
16 - 高；
32 - 灾难。

这是一个位掩码字段；可以接受任意可能位图值之和（例如，48 表示一般严重、高和灾难）。

默认值：63。
period string 可发送通知的时间，以 时间段 或用分号分隔的用户宏表示。

默认值：1-7,00:00-24:00。
provisioned integer 用户是否已被预配。

可能的值：
0 - 未预配；
1 - 已预配。
userdirectory_mediaid ID 已预配媒介的用户目录媒介映射 ID。

属性行为：
- 只读
- 支持 超级管理员 类型的用户