hostgroup.delete

Описание

object hostgroup.delete(массив hostGroupIds)

Этот метод позволяет удалять группы узлов сети.

Группу узлов сети нельзя удалить в случае, если:

  • она содержит узлы сети, которые принадлежат только этой группе узлов сети;
  • она отмечена как внутренняя;
  • она используется прототипом узлов сети;
  • она используется в глобальном скрипте;
  • она используется в условии корреляции.

Этот метод доступен только пользователям с типом доступа Администратор и Супер-администратор. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе Роли пользователей.

Параметры

(массив) ID удаляемых групп узлов сети.

Возвращаемые значения

(объект) Возвращает объект, который содержит ID удаленных групп узлов сети, указанных в свойстве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.