hostgroup.massadd

Описание

object hostgroup.massadd(object parameters)

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

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

Параметры

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

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

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

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

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

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

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

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

Примеры

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

Добавьте два узла сети в группы узлов сети с ID 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.