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.