创建

说明

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

此方法允许创建新的用户组。

参数

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

除了标准用户组属性之外, 该方法接受以下参数。

属性类型说明
rightsobject/array分配给组的权限
tag_filtersarray基于标签的权限分配给组
useridsstring/array要添加到用户组的用户的ID。

返回值

(object) 返回包含“usrgrpids”属性下创建的用户组的ID的对象。 返回的ID的顺序与传递的用户组的顺序相匹配。

示例

创建一个用户组

创建一个用户组,拒绝访问主机组“2”,并向其添加用户。

Request:

  1. {
  2. "jsonrpc": "2.0",
  3. "method": "usergroup.create",
  4. "params": {
  5. "name": "Operation managers",
  6. "rights": {
  7. "permission": 0,
  8. "id": "2"
  9. },
  10. "userids": "12"
  11. },
  12. "auth": "038e1d7b1735c6a5436ee9eae095879e",
  13. "id": 1
  14. }

Response:

  1. {
  2. "jsonrpc": "2.0",
  3. "result": {
  4. "usrgrpids": [
  5. "20"
  6. ]
  7. },
  8. "id": 1
  9. }

参见

来源

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