hostgroup.delete

Опис

object hostgroup.delete(array hostGroupIds)

Цей метод дозволяє видаляти групи хостів.

Групу хостів не можна видалити, якщо:

  • містить хости, які належать лише до цієї групи;
  • позначено як внутрішнє;
  • використовується прототипом хоста;
  • використовується в глобальному сценарії;
  • використовується в умові кореляції.

Цей метод доступний лише для користувачів типу Admin і Super admin. Дозволи на виклик методу можна скасувати в налаштуваннях ролі користувача. Див. Ролі користувача для отримання додаткової інформації.

Параметри

(array) ID груп хостів для видалення.

Повернуті значення

(object) Повертає об’єкт, що містить ідентифікатори видалених груп хостів у властивості groupids.

Приклади

Видалення кількох груп хостів

Видалити дві групи хостів.

Запит:

{  "jsonrpc": "2.0",  "method": "hostgroup.delete",  "params": [  "107824",  "107825"  ],  "auth": "3a57200802b24cda67c4e4010b50c065",  "id": 1 }

Відповідь:

{  "jsonrpc": "2.0",  "result": {  "groupids": [  "107824",  "107825"  ]  },  "id": 1 }

Джерело

CHostGroup::delete() в ui/include/classes/api/services/CHostGroup.php.