这是原厂英文文档的翻译页面. 欢迎帮助我们 完善文档.

创建用户

描述

object user.create(object/array users)

此方法用于创建新用户.

此方法只有Super admin(超级管理员)用户可用。可以在用户角色设置中撤销调用该方法的权限。更多信息请查看用户角色.

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

参数

(object/array) 用户创建。

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

参数 类型 描述
passwd
(必需)
字符串 用户的密码。

如果用户仅添加到具有 LDAP 访问权限的组,则可以省略。
usrgrps
(必需)
数组 要将用户添加到的用户

用户组必须具有已定义的 usrgrpid 属性。
medias 数组 要创建的用户 media
user_medias
(已弃用)
数组 此参数已弃用,请改用“medias”。
要创建的用户 media

返回值

(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.