Deactivating the tenant
July 3, 2024
ID 199652
Allows you to perform the following actions depending on the tenant type:
- For a complete tenant type:
- Change the tenant status to Inactive.
- Change the status of the policies for disabling protection of the virtual machines with Kaspersky Security for Virtualization 5.1 Light Agent installed.
Policies for disabling protection are applied only if Kaspersky Security for Virtualization 5.1 Light Agent is installed in the tenant virtual infrastructure. If there are no policies for disabling tenant protection, they will be automatically created. For more information refer to Kaspersky Security for Virtualization 5.1 Light Agent Help.
- For a simple tenant type: only change the tenant status to Inactive.
Method:
POST /api/2.0/virtualization/tenants/{tenant ID
}/deactivate
where:
{
tenant ID
}
– tenant identifier in the Integration Server database (required parameter).
The request is executed asynchronously, REST API returns identifier of the ChangeTenantActivation task. Using the task, you can monitor the progress of the tenant status changing procedure. When the task execution completes, the result field displays confirmation that the tenant status is changed (true
) or an error message.
Return codes:
202 (Accepted)
– the request is accepted for execution. The response returns the identifier of the ChangeTenantActivation task.403 (Forbidden)
– access to the resource is denied.
Error codes in the task:
VIRMT_TenantWithSpecifiedIdNotFound
– the tenant with the specified identifier is not found in the Integration Server database.KSC_ServiceNotConfigured
– Kaspersky Security Center connection settings are not specified.