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 文件中。