Это перевод страницы документации с английского языка. Помогите нам сделать его лучше.

host.massupdate

Описание

object host.massupdate(object parameters)

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

Этот метод доступен только для пользователей с ролью Admin и Super admin. Разрешения на вызов метода можно отозвать в настройках роли пользователя. Смотрите Роли пользователя, чтобы получить больше информации.

Параметры

(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.