hostgroup.massupdate

Описание

object hostgroup.massupdate(object parameters)

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

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

Параметры

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

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

Группы узлов сети должны содержать только свойство groupid.

Поведение параметра:
- required
hosts object/array Узлы сети, которые заменят текущие узлы сети в указанных группах узлов сети.
Все остальные узлы сети, кроме указанных, будут исключены из групп узлов сети.
Обнаруженные узлы сети не будут затронуты.

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

Поведение параметра:
- required

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

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

Примеры

Замена узлов сети в группе узлов сети

Замените все узлы сети в группе узлов сети на указанный узел сети.

Запрос:

{
    "jsonrpc": "2.0",
    "method": "hostgroup.massupdate",
    "params": {
        "groups": [
            {
                "groupid": "6"
            }
        ],
        "hosts": [
            {
                "hostid": "30050"
            }
        ]
    },
    "id": 1
}

Ответ:

{
    "jsonrpc": "2.0",
    "result": {
        "groupids": [
            "6",
        ]
    },
    "id": 1
}

См. также

Источник

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