usergroup.create
描述
object usergroup.create(object/array userGroups)
此方法允许创建新的用户组。
此方法仅适用于超级管理员用户类型。 调用该方法的权限可以在用户角色设置中撤销。更多信息请参阅 User roles
参数
(object/array) 要创建的用户组。
除用户组外， 该方法还接受以下参数。
| 参数 | 数据类型 | 说明 |
|---|---|---|
| rights | object/array | 要分配给该组的权限 |
| tag_filters | array | 要分配给该组的基于标签的权限 |
| users | object/array | 要添加到用户组的Users。 用户必须已定义 userid属性。 |
返回值
(object) 返回一个包含所创建用户组ID的object，这些ID位于usrgrpids属性下。返回的ID顺序与传入的用户组顺序一致。
示例
创建用户组
创建用户组并拒绝访问主机分组"2"，然后添加用户至该组。
请求：
{
"jsonrpc": "2.0",
"method": "usergroup.create",
"params": {
"name": "Operation managers",
"rights": {
"permission": 0,
"id": "2"
},
"users": [
{"userid": "12"}
]
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 1
}响应：
另请参阅
来源
CUserGroup::create() 方法位于 ui/include/classes/api/services/CUserGroup.php 文件中。