host.massupdate

Описание

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

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

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

Параметры

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

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

Parameter Type Description
hosts object/array Узлы сети, которые нужно обновить.

Узлы сети должны иметь определенным только свойство hostid.

Поведение параметра:
- required
groups object/array Группы узлов сети, которыми нужно заменить текущие группы узлов сети, к которым принадлежат узлы сети.

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

Режим инвентаря узла сети нельзя обновить с помощью параметра inventory, используйте вместо него inventory_mode.
macros object/array Пользовательские макросы, которыми нужно заменить текущие пользовательские макросы на указанных узлах сети.
templates object/array Шаблоны, которыми нужно заменить текущие связанные шаблоны на указанных узлах сети.

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

У шаблонов должно быть определено только свойство templateid.

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

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

Примеры

Включение нескольких узлов сети

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

Запрос:

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

Ответ:

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

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

Источник

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