hostgroup.massadd

Описание

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

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

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

Параметры

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

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

Параметр Type Описание
groups object/array Группы узлов сети, которые необходимо обновить.

Для групп узлов сети должно быть определено только свойство groupid.

Поведение параметров:
- обязательный
hosts object/array Узлы сети для добавления во все группы узлов сети.

Для узлов сети должно быть определено только свойство hostid.

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

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

Примеры

Добавление узлов сети в группы узлов сети

Добавьте два узла сети в группы узлов сети с идентификаторами 5 и 6.

Запрос:

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

Ответ:

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

См. также

Источник

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