usergroup.massupdate

说明

object usergroup.massupdate(object parameters)

此方法允许同时更新多个用户组的属性，用户或权限。

此方法已被弃用，将来会被删除。 请改用usergroup.update

参数

(object) 包含要更新的用户组的ID和应更新的属性的参数。

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

属性 类型 说明
usrgrpids(required) string/array 要更新的用户组的ID。
rights string/array 更改分配给用户组的当前权限的权限。
userids object/array 用户的ID替换组中的用户。

返回值

(object) 返回包含“usrgrpids”属性下更新的用户组的ID的对象。

示例

Changing permissions for a user group

Update the permissions for two user groups to only allow read-write access to two host groups.

Request:

  1. {
  2.     "jsonrpc": "2.0",
  3.     "method": "usergroup.massupdate",
  4.     "params": {
  5.         "usrgrpids": [
  6.             "17",
  7.             "19"
  8.         ],
  9.         "rights": [
  10.             {
  11.                 "permission": 3,
  12.                 "id": "2"
  13.             },
  14.             {
  15.                 "permission": 3,
  16.                 "id": "3"
  17.             }
  18.         ]
  19.     },
  20.     "auth": "038e1d7b1735c6a5436ee9eae095879e",
  21.     "id": 1
  22. }

Response:

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

参见

来源

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