Удаление тенанта
27 августа 2024
ID 259255
В зависимости от типа тенанта и заданных параметров, позволяет выполнить следующие действия:
- Для тенанта типа "полный":
- Удалить информацию о тенанте и виртуальных машинах тенанта из базы данных Сервера интеграции.
- Удалить структуру защиты тенанта в Kaspersky Security Center (виртуальный Сервер администрирования, учетную запись для подключения к нему, структуру папок и групп администрирования, политики, задачи и инсталляционные пакеты). Если других тенантов нет, также удаляется папка Multitenancy KSV LA.
- Удалить сведения о виртуальном Сервере администрирования тенанта из базы данных Сервера интеграции.
Вызов метода удаления тенанта не приводит к выключению защиты на виртуальных машинах тенанта. Чтобы выключить защиту, вам нужно выполнить все этапы процедуры удаления тенанта, в том числе удалить на виртуальных машинах Легкий агент для Windows, Легкий агент для Linux и Агент администрирования Kaspersky Security Center. Если вы хотите приостановить защиту виртуальных машин тенанта типа "полный", вы можете использовать метод деактивации тенанта.
- Для тенанта типа "упрощенный": удалить тенанта из базы данных Сервера интеграции.
Метод:
DELETE /api/2.0/virtualization/tenants/{идентификатор тенанта
}?removeTenantArtifacts={true|false}
где:
{
идентификатор тенанта
}
– идентификатор тенанта в базе данных Сервера интеграции (обязательный параметр).removeTenantArtifacts={true|false}
– необязательный параметр, определяющий необходимость удаления структуры защиты тенанта при удалении тенанта из базы данных Сервера интеграции. Возможные значения:true
– при удалении тенанта будут также выполнены следующие действия:- удаление виртуального Сервера администрирования тенанта;
- удаление учетной записи администратора виртуального Сервера администрирования тенанта;
- удаление папки Multitenancy KSV LA → <Название тенанта> и ее содержимого;
- если других тенантов нет, удаление папки Multitenancy KSV LA.
false
– выполняется только удаление тенанта из базы данных Сервера интеграции, структура защиты тенанта не удаляется.
Запрос выполняется асинхронно, REST API возвращает идентификатор задачи с типом DeleteTenant. С помощью задачи вы можете следить за ходом выполнения процедуры удаления тенанта. После завершения задачи в поле result содержится информация об удаленном тенанте или сведения об ошибке.
В случае ошибки на любом из шагов выполнения процедуры выполняется откат всех внесенных изменений.
Коды возврата:
202 (Accepted)
– запрос принят к исполнению. В ответе возвращается идентификатор задачи типа DeleteTenant.403 (Forbidden)
– доступ к ресурсу запрещен.
Коды ошибок в задаче:
VIRMT_TenantWithSpecifiedIdNotFound
– тенант с указанным идентификатором не найден в базе данных Сервера интеграции.KSC_ServiceNotConfigured
– не заданы параметры подключения к Kaspersky Security Center.