移除租户

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

• 对于完整租户：
  • 从 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 连接设置未指定。