[comment]: # translation:outdated

[comment]: # ({c40e8cd1-c40e8cd1})
# 创建用户组

[comment]: # ({/c40e8cd1-c40e8cd1})

[comment]: # ({a2b8acb5-c74b5711})
### 描述

`object usergroup.create(object/array userGroups)`

此方法用户创建新的用户组.

::: noteclassic
此方法只有*Super admin(超级管理员)*用户可用。可以在用户角色设置中撤销调用该方法的权限。更多信息请查看[用户角色](/manual/web_interface/frontend_sections/administration/user_roles).
:::

[comment]: # ({/a2b8acb5-c74b5711})

[comment]: # ({87331185-3b20a75b})
### 参数

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


除了 [标准用户组属性](object#user_group), 此方法接受如下参数.

|参数|[类型](/manual/api/reference_commentary#data_types)|描述|
|---------|---------------------------------------------------|-----------|
|rights|object/array|分配给用户组的 [权限](/manual/api/reference/usergroup/object#permission) |
|tag\_filters|array|分配给用户组 [标签权限](/manual/api/reference/usergroup/object#tag_based_permission) |
|users|object/array|需要添加到用户组的 [用户](/manual/api/reference/user/create).<br><br>用户必须拥有 `userid` 属性.|

[comment]: # ({/87331185-3b20a75b})

[comment]: # ({19e4f0cc-19e4f0cc})
### 返回值

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

[comment]: # ({/19e4f0cc-19e4f0cc})

[comment]: # ({b41637d2-b41637d2})
### 示例

[comment]: # ({/b41637d2-b41637d2})

[comment]: # ({9accd4bb-61abd39a})
#### 创建一个用户组

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

请求:

```json
{
    "jsonrpc": "2.0",
    "method": "usergroup.create",
    "params": {
        "name": "Operation managers",
        "rights": {
            "permission": 0,
            "id": "2"
        },
        "users": [
            {"userid": "12"}
        ]
    },
    "auth": "038e1d7b1735c6a5436ee9eae095879e",
    "id": 1
}
```

返回:

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

[comment]: # ({/9accd4bb-61abd39a})

[comment]: # ({d5c7ed4f-d5c7ed4f})
### 参考

-   [权限](object#permission)

[comment]: # ({/d5c7ed4f-d5c7ed4f})

[comment]: # ({2d7f8c71-2d7f8c71})
### 来源

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

[comment]: # ({/2d7f8c71-2d7f8c71})