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

创建

描述

object user.create(object/array users)

此方法用于创建新用户。

此方法仅适用于Super admin(超级管理员)类型的用户。可在用户角色设置中撤销调用该方法的权限,参阅用户角色获取详情。

通过认证API定义的密码策略规则来验证用户密码的强度。更多信息请查看认证

参数

(object/array) 用户创建。

除了标准用户属性,该方法还接受以下参数。

参数 类型 描述
usrgrps array 要将用户添加到的用户组

用户组必须具有已定义的usrgrpid属性。
medias array 要创建的用户媒介

返回值

(object) 返回一个包含创建值的ID的对象映射 userids 属性,返回的ID顺序与传入的用户顺序相匹配。

示例

创建一个用户

创建一个新用户, 并加入用户组同时为其添加用户媒介。

请求:

{
           "jsonrpc": "2.0",
           "method": "user.create",
           "params": {
               "username": "John",
               "passwd": "Doe123",
               "roleid": "5",
               "usrgrps": [
                   {
                       "usrgrpid": "7"
                   }
               ],
               "medias": [
                   {
                       "mediatypeid": "1",
                       "sendto": [
                           "[email protected]"
                       ],
                       "active": 0,
                       "severity": 63,
                       "period": "1-7,00:00-24:00"
                   }
               ]
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

响应:

{
           "jsonrpc": "2.0",
           "result": {
               "userids": [
                   "12"
               ]
           },
           "id": 1
       }

参考

来源

CUser::create() in ui/include/classes/api/services/CUser.php.