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