hostgroup.massupdate

Описание

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

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

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

Параметры

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