hostgroup.massadd

Описание

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

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

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

Параметры

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

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

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.