На странице
host.massremove
Описание
object host.massremove(параметры объекта)
Этот метод позволяет удалять связанные объекты с нескольких хостов.
Этот метод доступен только пользователям с типом доступа Администратор и Супер-администратор. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе Роли пользователей.
Параметры
(object) Параметры, содержащие ID узлов сети, которые нужно обновить, и
объекты, которые следует удалить.
| Parameter | Type | Description |
|---|---|---|
| hostids | ID/array | ID узлов сети, которые нужно обновить. Поведение параметра: - required |
| groupids | ID/array | ID групп узлов сети, из которых нужно удалить указанные узлы сети. |
| interfaces | object/array | Интерфейсы узла сети, которые нужно удалить у указанных узлов сети. Объект интерфейса узла сети должен содержать только свойства ip, dns и port. |
| macros | string/array | Пользовательские макросы, которые нужно удалить у указанных узлов сети. |
| templateids | ID/array | ID шаблонов, которые нужно отвязать от указанных узлов сети. |
| templateids_clear | ID/array | ID шаблонов, которые нужно отвязать и очистить у указанных узлов сети. |
Возвращаемые значения
(object) Возвращает объект, содержащий идентификаторы обновленных хостов.
под свойством hostids.
Примеры
Отвязка шаблонов
Отвяжите шаблон от двух узлов сети и удалите все сущности, унаследованные от шаблона.
{
"jsonrpc": "2.0",
"method": "host.massremove",
"params": {
"hostids": ["69665", "69666"],
"templateids_clear": "325"
},
"id": 1
}Ответ:
{
"jsonrpc": "2.0",
"result": {
"hostids": [
"69665",
"69666"
]
},
"id": 1
}См. также
Источник
CHost::massRemove() в ui/include/classes/api/services/CHost.php.