> 用户对象

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

用户

用户对象具有如下属性.

属性类型描述
useridstring(readonly) 用户ID.
username
(required)
string用户名称.
attempt_clocktimestamp(readonly) 最近一次登录失败时间.
attempt_failedinteger(readonly) 最近登录失败尝试次数.
attempt_ipstring(readonly) 最近一次登录失败的来源IP地址.
autologininteger是否允许自动登录.

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

默认: 15m.
langstring用户语言代码, 示例, en_GB.

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

默认: 30s.
rows_per_pageinteger每页显示的对象条目.

默认: 50.
surnamestring姓.
themestring用户的主题.

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

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

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

媒介

媒介对象具有如下属性.

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

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

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

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

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

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

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