Activating the tenant
January 10, 2024
ID 199651
Allows you to perform the following actions depending on the tenant type:
- For a complete tenant type:
- Change the tenant status to Active.
- Change the status of the policies for enabling protection of the virtual machines with Kaspersky Security for Virtualization 5.1 Light Agent installed.
Policies for enabling 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 enabling 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 Active.
Method:
POST /api/2.0/virtualization/tenants/{tenant ID}/activate
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.
