Zabbix Documentation 5.0

host.massadd

Описание

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

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

Параметры

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

Этот метод принимает следующие параметры.

Параметр	Тип	Описание
hosts (требуется)	объект/массив	Обновляемые узлы сети. У узлов сети должно быть задано свойство `hostid`.
groups	объект/массив	Группы узлов сети, к которым необходимо добавить заданные узлы сети. У групп узлов сети должно быть задано свойство `groupid`.
interfaces	объект/массив	Создаваемые интерфейсы узлов сети у заданных узлов сети.
macros	объект/массив	Добавляемые пользовательские макросы к заданным узлам сети.
templates	объект/массив	Присоединяемые шаблоны к заданным узлам сети. У шаблонов должно быть задано свойство `templateid`.

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

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

Примеры

Добавление макросов

Добавление двух новых макросов в два узла сети.

Запрос:

{
    "jsonrpc": "2.0",
    "method": "host.massadd",
    "params": {
        "hosts": [
            {
                "hostid": "10160"
            },
            {
                "hostid": "10167"
            }
        ],
        "macros": [
            {
                "macro": "{$TEST1}",
                "value": "MACROTEST1"
            },
            {
                "macro": "{$TEST2}",
                "value": "MACROTEST2"
            }
        ]
    },
    "auth": "038e1d7b1735c6a5436ee9eae095879e",
    "id": 1
}

Ответ:

{
    "jsonrpc": "2.0",
    "result": {
        "hostids": [
            "10160",
            "10167"
        ]
    },
    "id": 1
}

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

Исходный код

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