Removing a tenant

Allows you to perform the following actions depending on the tenant type and the specified parameters:

• For a complete tenant:
  • Delete information about the tenant and the tenant virtual machines from the Integration Server database.
  • Delete the tenant protection infrastructure deployed from Kaspersky Security Center (virtual Administration Server, account for connecting to it, structure of folders and administration groups, policies, tasks, and installation packages). If there are no other tenants, the Multitenancy KSV LA folder is also deleted.
  • Delete information about the tenant virtual Administration Server from the Integration Server database.

  Calling the tenant deletion method does not disable protection on the tenant virtual machines. To disable protection, you need to perform all steps of the tenant deletion procedure, including removal of Light Agent for Windows, Light Agent for Linux, and Kaspersky Security Center Network Agent from the virtual machines. To suspend the protection of the virtual machine for a tenant of the complete type, use the tenant deactivation method.

• For a simple tenant: remove the tenant from the Integration Server database.

Method:

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

where:

• {tenant ID} – tenant identifier in the Integration Server database (required parameter).
• removeTenantArtifacts={true|false} – optional parameter that indicates whether the tenant protection infrastructure must be removed when removing the tenant from the Integration Server database. Possible values:
  • true – when the tenant is removed, the following actions are performed:
    • Remove the virtual Administration Server of the tenant.
    • Delete the administrator account of the tenant virtual Administration Server.
    • Delete the Multitenancy KSV LA → <Tenant name> folder and its contents.
    • Delete the Multitenancy KSV LA folder if there are no other tenants.
  • false – the tenant is only deleted from the Integration Server database; the tenant protection infrastructure is not deleted.

The request is executed asynchronously, REST API returns identifier of the DeleteTenant task. You can use the task to monitor the progress of the tenant removal procedure. When the task completes, the result field displays information about the removed tenant or an error message.

In case of an error at any step of the procedure, all the changes are rolled back.

Return codes:

• 202 (Accepted) – the request is accepted for execution. The response returns the identifier of the DeleteTenant task.
• 403 (Forbidden) – access to the resource is denied.

Error codes in the task:

• VIRMT_TenantWithSpecifiedIdNotFound – tenant with the specified identifier not found in the Integration Server database.
• KSC_ServiceNotConfigured – Kaspersky Security Center connection settings are not specified.

Page top