hostgroup.massupdate

Описание

object hostgroup.massupdate(параметры объекта)

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

Этот метод доступен только пользователям с типом доступа Администратор и Супер-администратор. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе Роли пользователей.

Параметры

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

Параметр Тип Описание
groups
(требуется)		 объект/массив Обновляемые группы узлов сети.

У групп узлов сети должно быть задано свойство groupid.
hosts
(требуется)		 объект/массив Узлы сети, которые заменят текущие узлы сети в заданных группах узлов сети.
Все остальные узлы сети, кроме указанных, будут исключены из групп узлов сети.
Обнаруженные узлы сети не будут затронуты.

У узлов сети должно быть задано свойство hostid.
templates
(требуется)		 объект/массив Шаблоны, которые заменят текущие шаблоны в заданных группах узлов сети.
Все остальные шаблоны, кроме указанных, будут исключены из групп узлов сети.

У шаблонов должно быть задано свойство templateid.

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

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

Примеры

Замена узлов сети и шаблоноы в группе узлов сети

Replace all hosts in a host group to ones mentioned host and unlink all templates from host group.

Заменить все хосты в группе узлов сети на указанные узлы сети и отсоедините все шаблоны от группы узлов сети.

Запрос:

{
    "jsonrpc": "2.0",
    "method": "hostgroup.massupdate",
    "params": {
        "groups": [
            {
                "groupid": "6"
            }
        ],
        "hosts": [
            {
                "hostid": "30050"
            }
        ],
        "templates": []
    },
    "auth": "f223adf833b2bf2ff38574a67bba6372",
    "id": 1
}

Ответ:

{
    "jsonrpc": "2.0",
    "result": {
        "groupids": [
            "6",
        ]
    },
    "id": 1
}

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

Источник

CHostGroup::massUpdate() в ui/include/classes/api/services/CHostGroup.php.