Kaspersky Security для виртуальных сред 6 Легкий агент

Удаление тенанта

18 июля 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.

Вам помогла эта статья?
Что нам нужно улучшить?
Спасибо за ваш отзыв, вы помогаете нам становиться лучше!
Спасибо за ваш отзыв, вы помогаете нам становиться лучше!