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.

Documentation