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