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:

{
    "jsonrpc": "2.0",
    "method": "usergroup.massupdate",
    "params": {
        "usrgrpids": [
            "17",
            "19"
        ],
        "rights": [
            {
                "permission": 3,
                "id": "2"
            },
            {
                "permission": 3,
                "id": "3"
            }
        ]
    },
    "auth": "038e1d7b1735c6a5436ee9eae095879e",
    "id": 1
}

Response:

{
    "jsonrpc": "2.0",
    "result": {
        "usrgrpids": [
            "17",
            "19"
        ]
    },
    "id": 1
}

参见

来源

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