host.massupdate

Описание

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

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

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

Параметры

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

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

Параметр	Тип	Описание
hosts (обязательно)	object/array	Hosts для обновления. Хосты должны иметь `hostid` свойство определено.
groups	object/array	Host groups для замены текущих групп хостов, к которым принадлежат хосты. Группы хостов должны иметь свойство `groupid` определено.
interfaces	object/array	Host interfaces для замены текущих интерфейсов хоста на заданных хостах.
inventory	object	Свойства хоста inventory. Режим инвентаризации хоста нельзя обновить с помощью параметра `inventory`, вместо этого используйте `inventory_mode`.
macros	object/array	Пользовательские макросы для замены текущих пользовательских макросов на заданных хостах.
templates	object/array	Templates для замены текущих связанных шаблонов на заданных хостах. В шаблонах должно быть определено свойство `templateid`.
templates_clear	object/array	Templates, чтобы разорвать связь и очистить указанные хосты. В шаблонах должно быть определено свойство `templateid`.

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

(object) Возвращает объект, содержащий идентификаторы обновленных хостов. под свойством 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() в ui/include/classes/api/services/CHost.php.

Documentation