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.