hostgroup.massadd

Описание

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

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

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

Параметры

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