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.