hostgroup.massadd
Описание
object hostgroup.massadd(параметры объекта)
Этот метод позволяет добавить одновременно несколько связанных объектов во все заданные группы узлов сети.
Этот метод доступен только пользователям с типом доступа Администратор и Супер-администратор. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе Роли пользователей.
Параметры
(объект) Параметры, которые содержат ID обновляемых групп узлов сети и
добавляемых объектов в во все эти группы узлов сети.
Этот метод принимает следующие параметры.
| Параметр | Тип | Описание |
|---|---|---|
| groups (требуется) |
объект/массив | Обновляемые группы узлов сети. У групп узлов сети должно быть задано свойство groupid. |
| hosts | объект/массив | Добавляемые узлы сети во все группы узлов сети. У узлов сети должно быть задано свойство hostid. |
| templates | объект/массив | Добавляемые шаблоны во все группы узлов сети. У шаблонов должно быть задано свойство templateid. |
Возвращаемые значения
(объект) Возвращает объект, который содержит ID обновленных групп
узлов сети, указанных в свойстве groupids.
Примеры
Добавление узла сети в группу узлов сети
Добавить два узла сети в группы узлов сети с ID 5 и 6.
Запрос:
{
"jsonrpc": "2.0",
"method": "hostgroup.massadd",
"params": {
"groups": [
{
"groupid": "5"
},
{
"groupid": "6"
}
],
"hosts": [
{
"hostid": "30050"
},
{
"hostid": "30001"
}
]
},
"auth": "f223adf833b2bf2ff38574a67bba6372",
"id": 1
}Ответ:
{
"jsonrpc": "2.0",
"result": {
"groupids": [
"5",
"6"
]
},
"id": 1
}Смотрите также
Источник
CHostGroup::massAdd() в ui/include/classes/api/services/CHostGroup.php.