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

В зависимости от типа клиента и заданных параметров, позволяет выполнить следующие действия:

• Для клиента типа "полный":
  • Удалить информацию о клиенте и виртуальных машинах клиента из базы данных Сервера интеграции.
  • Удалить структуру защиты клиента в 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.