[comment]: # translation:outdated

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

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

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

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

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

::: noteclassic
此方法仅适用于*Super admin(超级管理员)*类型的用户。可在用户角色设置中撤销调用该方法的权限，参阅[用户角色](/manual/web_interface/frontend_sections/users/user_roles)获取详情。
:::

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

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

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

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

|参数|[类型](/manual/api/reference_commentary#数据类型)|描述|
|--|--|------|
|hostgroup_rights|object/array|分配给用户组的[权限](/manual/api/reference/usergroup/object#权限)。|
|templategroup_rights|object/array|分配给用户组的模板组[权限](/manual/api/reference/usergroup/object#权限)。|
|tag\_filters|array|分配给用户组的[标签权限](/manual/api/reference/usergroup/object#基于标签的权限)。|
|users|object/array|需要添加到用户组的 [用户](/manual/api/reference/user/create)。<br><br>用户必须只定义`userid`属性。|
|rights<br>(deprecated)|object/array|此参数已弃用，请改用 `hostgroup_rights` 或 `templategroup_rights`。<br>分配给用户组的[权限](/manual/api/reference/usergroup/object#权限)。|

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

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

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

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

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

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

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

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

[请求](/manual/api#执行请求):

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

响应:

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

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

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

-   [权限](object#权限)

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

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

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

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