创建

描述

object user.create(object/array users)

此方法用于创建新用户。

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

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

参数

(object/array) 用户创建。

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

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

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

返回值

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

示例

创建一个用户

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

请求:

  1. {
  2. "jsonrpc": "2.0",
  3. "method": "user.create",
  4. "params": {
  5. "username": "John",
  6. "passwd": "Doe123",
  7. "roleid": "5",
  8. "usrgrps": [
  9. {
  10. "usrgrpid": "7"
  11. }
  12. ],
  13. "medias": [
  14. {
  15. "mediatypeid": "1",
  16. "sendto": [
  17. "[email protected]"
  18. ],
  19. "active": 0,
  20. "severity": 63,
  21. "period": "1-7,00:00-24:00"
  22. }
  23. ]
  24. },
  25. "auth": "038e1d7b1735c6a5436ee9eae095879e",
  26. "id": 1
  27. }

响应:

  1. {
  2. "jsonrpc": "2.0",
  3. "result": {
  4. "userids": [
  5. "12"
  6. ]
  7. },
  8. "id": 1
  9. }

参考

来源

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