创建

描述

object usergroup.create(object/array userGroups)

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

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

参数

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

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

参数	类型	描述
hostgroup_rights	object/array	分配给用户组的权限。
templategroup_rights	object/array	分配给用户组的模板组权限。
tag_filters	array	分配给用户组的标签权限。
users	object/array	需要添加到用户组的用户。用户必须只定义`userid`属性。
rights (deprecated)	object/array	此参数已弃用，请改用 `hostgroup_rights` 或 `templategroup_rights`。分配给用户组的权限。

返回值

(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.

Documentation

创建

描述

参数

返回值

示例

创建一个用户组

参考

来源