host.massupdate

Описание

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

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

Параметры

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

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

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

У узлов сети должно быть задано свойство hostid.
groups объект/массив Группы узлов сети, которые заменят текущие группы узлов сети в которые входят заданные узлы сети.

У групп узлов сети должно быть задано свойство groupid.
interfaces объект/массив Интерфейсы узла сети, которые заменят текущие интерфейсы узла сети у заданных узлов сети.
inventory объект Свойства инвентаризации узлов сети.

Режим инвентаризации узлов сети нельзя обновить при помощи параметра inventory, вместо него используйте inventory_mode.
inventory_mode целое число Режим заполнения инвентаризации узлов сети.

Обратитесь к странице объекта инвентаризации узлов сети для получения списка поддерживаемых режимов инвентаризации.
macros объект/массив Пользовательские макросы, которые заменят текущие макросы у заданных узлов сети.
templates объект/массив Шаблоны, которые заменят присоединенные в настоящий момент шаблоны к заданным узлам сети.

У шаблонов должно быть задано свойство templateid.
templates_clear объект/массив Шаблоны, которые отсоединятся и очистят от заданных узлов сети.

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

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

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

Примеры

Активация нескольких узлов сети

Активация мониторинга двух узлов, то есть изменение их состояния на значение 0.

Запрос:

{
           "jsonrpc": "2.0",
           "method": "host.massupdate",
           "params": {
               "hosts": [
                   {
                       "hostid": "69665"
                   },
                   {
                       "hostid": "69666"
                   }
               ],
               "status": 0
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Ответ:

{
           "jsonrpc": "2.0",
           "result": {
               "hostids": [
                   "69665",
                   "69666"
               ]
           },
           "id": 1
       }

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

Исходный код

CHost::massUpdate() в frontends/php/include/classes/api/services/CHost.php.