创建

描述

object usergroup.create(object/array userGroups)

此方法用于创建新的用户组。

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

参数

(object/array) 要创建的用户组。

除了 标准用户组属性, 此方法接受如下参数。

返回值

(object) 返回一个带有usrgrpids属性（其中包含被创建用户组ID）的对象，返回的ID的顺序与传递的用户组的顺序相匹配。

示例

创建一个用户组

创建一个用户组, 禁止其访问主机组”2” , 并向其添加一个用户。

请求:

{
           "jsonrpc": "2.0",
           "method": "usergroup.create",
           "params": {
               "name": "Operation managers",
               "hostgroup_rights": {
                   "id": "2",
                   "permission": 0
               },
               "users": [
                   {
                       "userid": "12"
                   }
               ]
           },
           "id": 1
       }

响应:

{
           "jsonrpc": "2.0",
           "result": {
               "usrgrpids": [
                   "20"
               ]
           },
           "id": 1
       }

参考

• 权限

来源

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