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