Zabbix Documentation 4.4

2.23.04.04.2 (current)In development:4.4 (devel)Unsupported:1.82.02.43.23.4

User Tools

Site Tools


Sidebar

ru:manual:api:reference:usergroup:update

usergroup.update

Description

объект usergroup.update(объект/массив ГруппыПользователей)

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

Параметры

(объект/массив) Свойства групп пользователей, которые будут обновлены.

Свойство usrgrpid должно быть указано по каждой группе пользователей, все остальные свойства опциональны. Будут обновлены только переданные свойства, все остальные останутся неизменными.

В дополнение к стандартным свойствам группы пользователей, этот метод принимает следующие параметры.

Параметр Тип Описание
rights объект/массив Права доступа, которые заменят текущие права назначенные на группу пользователей.
tag_filters массив Права доступа на основе тегов, которые назначаются на группу
userids строка/массив ID пользователей, которые заменят текущих пользователей в группе.

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

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

Примеры

Деактивация группы пользователей

Деактивация группы пользователей.

Запрос:

{
    "jsonrpc": "2.0",
    "method": "usergroup.update",
    "params": {
        "usrgrpid": "17",
        "users_status": "1"
    },
    "auth": "038e1d7b1735c6a5436ee9eae095879e",
    "id": 1
}

Ответ:

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

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

Исходный код

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