Sidebar

2022 Zabbix中国峰会
2022 Zabbix中国峰会

Table of Contents

> 用户对象

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

用户

用户对象具有如下属性.

属性 类型 描述
userid 字符串 (只读) 用户ID.
username
(必需)
字符串 用户名称.
attempt_clock 时间戳 (只读) 最近一次登录失败时间.
attempt_failed 整数 (只读) 最近登录失败尝试次数.
attempt_ip 字符串 (只读) 最近一次登录失败的来源IP地址.
autologin 整数 是否允许自动登录.

可用值:
0 - (default) 禁止自动登录;
1 - 允许自动登录.
autologout 字符串 会话过期时长. 接受具有后缀的秒或时间单位. 如果设置为 0s, 会话将永不过期.

默认: 15m.
lang 字符串 用户语言代码, 示例, en_GB.

默认: default - 系统默认语言.
name 字符串 用户名.
refresh 字符串 自动刷新间隔. 接受具有后缀的秒或时间单位.

默认: 30s.
rows_per_page 整数 每页显示的对象条目.

默认: 50.
surname 字符串 姓.
theme 字符串 用户的主题.

可用值:
default - (default) 系统默认主题;
blue-theme - 蓝主题;
dark-theme - 黑主题.
url 字符串 用户登录后重定向页面的URL.
timezone 字符串 用户时区, 示例, Europe/London, UTC.

默认: default - 系统默认时区.

查看所有支持的时区列表请参阅 PHP documentation.
roleid
(required)
字符串 用户的角色ID.

注意,对于某些方法(更新、删除),必需/可选参数组合是不同的。

媒介

媒介对象具有如下属性.

属性 属性类型 描述
mediatypeid
(required)
string 被使用的媒介类型ID.
sendto
(required)
string/array 地址, 用户名或者其他接收标识符.

如果 媒介类型 是邮件, 值被定义为数组. 如果 媒介类型 是其他类型, 值被定义为字符串.
active integer 是否启用媒介.

可用值:
0 - (default) 启用;
1 - 禁用.
severity integer 触发媒介发送告警的告警级别.

每一位数字代表一个告警级别,并以二进制形式存储. 例如, 12 相当于二进制的 1100, 它表示告警级别为警告和一般严重的告警将触发告警媒介.

参阅 触发器对象 查看告警级别列表.

默认: 63
period string 时间窗口: 能够发送告警通知的 时间段 或者以分号分隔的用户宏.

默认: 1-7,00:00-24:00