# usergroup.massupdate

### Описание

`объект usergroup.massupdate(объект параметры)`

Этот метод позволяет одновременно обновлять свойства, пользователей и
права доступа по нескольким группам пользователей.

### Параметры

`(объект)` Параметры, которые содержат ID обновленных групп
пользователей и свойства, которые необходимо обновить.

Этот метод принимает следующие параметры.

|Параметр|Тип|Описание|
|----------------|------|----------------|
|**usrgrpids**<br>(требуется)|строка/массив|ID обновляемых групп пользователей.|
|rights|объект/массив|Права доступа, которые заменят текущие права доступа группы пользователей.|
|userids|строка/массив|ID пользователей, которые заменят текущих пользователей в группах пользователей.|

### Возвращаемые значения

`(объект)` Возвращает объект, который содержит ID обновленных групп
пользователей под свойством `usrgrpids`.

### Примеры

#### Изменение прав доступа группы пользователей

Обновление прав доступа по двум группам пользователей на разрешение
только чтение-запись доступа к двум группам узлов сети.

Запрос:

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

Ответ:

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

### Смотрите также

-   [Права доступа](object#права_доступа)
-   [usergroup.massadd](massadd)
-   [usergroup.update](update)

### Исходный код

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