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

15 мая 2024

ID 199655

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

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

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