移除租戶

可讓您根據租戶類型和指定參數執行以下操作：

• 對於完全租戶類型：
  • 從 Integration Server 資料庫刪除租戶和租戶虛擬機資訊。
  • 刪除從 Kaspersky Security Center 部署的租戶防護基礎架構 (虛擬管理伺服器、與其連線的帳戶、資料夾和管理群組結構、政策、工作和安裝套件)。如果沒有其他租戶，多租戶 KSV LA 資料夾也會被刪除。
  • 將租戶虛擬管理伺服器資訊從 Integration Server 資料庫中刪除。

  呼叫租戶移除方法不會停用租戶虛擬機上的防護。若要停用防護，請執行租戶移除程序的所有步骤，包括從虛擬機移除 Light Agent for Windows、Light Agent for Linux 和卡巴斯基安全管理中心網路代理。若要為完全租戶類型暫停虛擬機防護，請使用租戶取消啟動方法。

• 對於單純租戶類型：將租戶從 Integration Server 資料庫中刪除。

方法：

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

其中：

• {tenant 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 – 未指定卡巴斯基安全管理中心連線設定。