On this page

用户对象

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

用户

user 对象具有以下属性。

Property Type Description
userid ID 用户的 ID。

属性行为:
- 只读
- 更新操作时为 必需
username string 用户名称。

属性行为:
- 创建操作时为 必需
- 如果用户已链接到 user directory（userdirectoryid 设置为有效且不为 "0" 的值），并且已启用 user directory provisioning 状态（User directory object 的 provision_status 设置为 "1"），且已启用所有 LDAP 或 SAML provisioning 的认证状态（[Authentication object](/manual/api/reference/authentication/object#authentication) 的ldap_jit_status设置为 "Enabled for configured LDAP IdPs"，或 Authentication object 的 saml_jit_status 设置为 "Enabled for configured SAML IdPs"`），则对 provisioned users 为 只读
passwd string 用户密码。

如果用户已链接到 user directory，则此参数的值可以为空字符串。

属性行为:
- 仅写
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 用户是否已被 provisioned。

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

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

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

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

可能的值：
default - (默认) 系统默认值；
blue-theme - 蓝色；
dark-theme - 深色；
hc-light - 高对比度浅色；
hc-dark - 高对比度深色。
ts_provisioned timestamp 最近一次 provisioning 操作的时间。

属性行为:
- 只读
- 支持 Super admin 类型用户
url string 登录后重定向用户的页面 URL。
userdirectoryid ID 用户所链接的 user directory 的 ID。

用于 provisioning（创建或更新），以及登录链接到 user directory 的用户。

对于登录操作，此属性的值优先于用户所属 user groups 的 userdirectoryid 属性。

默认值：0。

属性行为:
- 只读
- 支持 Super admin 类型用户
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。

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