移除租户

可让您根据租户类型和指定参数执行以下操作：

• 对于完全租户类型：
  • 从 Integration Server 数据库删除租户和租户虚拟机信息。
  • 从 Kaspersky Security Center 中删除已部署的租户保护基础架构（虚拟管理服务器、连接用的账户、文件夹和管理组结构、策略、任务及安装包）。如果没有其他租户，“Multitenancy KSV LA”文件夹也被删除。
  • 将租户虚拟管理服务器信息从 Integration Server 数据库中删除。

  调用租户移除方法不会禁用租户虚拟机上的保护。要禁用保护，请执行租户移除过程的所有步骤，包括从虚拟机移除 Light Agent for Windows、Light Agent for Linux 和 Kaspersky Security Center 网络代理。要为完全租户类型暂停虚拟机保护，请使用租户停用方法。

• 对于单纯租户类型：将租户从 Integration Server 数据库中删除。

方法：

DELETE /api/2.0/virtualization/tenants/{租户 ID}?removeTenantArtifacts={true|false}

其中：

• {租户 ID} – Integration Server 数据库中的租户标识符（必需参数）。
• removeTenantArtifacts={true|false} – 可选参数，确定从 Integration Server 数据库移除租户时是否移除租户保护基础架构。可能的值：
  • true – 租户被移除时将执行以下操作：
    • 删除租户虚拟管理服务器。
    • 删除租户虚拟管理服务器的管理员账户。
    • 删除 Multitenancy KSV LA → <租户名称> 文件夹及其内容。
    • 删除 Multitenancy KSV LA 文件夹（如果没有其他租户）。
  • false – 仅租户被从 Integration Server 数据库中删除，租户保护基础架构未被删除。

请求异步执行，REST API 返回“DeleteTenant”任务的识别符。您可以使用“任务”监控租户删除过程的进度。任务执行完成后，“结果”字段会显示已删除租户的信息或错误消息。

如果过程的任何一步发生错误，所有更改将被回滚。

返回代码：

• 202 (Accepted) – 请求被接受进行执行。响应返回“DeleteTenant”任务的识别符。
• 403 (Forbidden) – 资源访问被拒绝。

任务中的错误代码：

• VIRMT_TenantWithSpecifiedIdNotFound – 未在 Integration Server 数据库中找到具有指定识别符的租户。
• KSC_ServiceNotConfigured – Kaspersky Security Center 连接设置未指定。