Получение информации о тенанте
28 апреля 2026
ID 259247
Позволяет получить информацию о тенанте из базы данных Сервера интеграции.
Метод:
GET /api/2.0/virtualization/tenants/{идентификатор тенанта}
где:
{идентификатор тенанта} – идентификатор тенанта в базе данных Сервера интеграции (обязательный параметр).
В случае успешного выполнения запроса REST API возвращает сведения о тенанте в следующем виде:
<tenant id="{идентификатор}" created="{дата и время}" updated="{дата и время}">
<name>{название}</name>
<description>{описание}</description>
<userData><![CDATA[{дополнительные сведения}]]></userData>
<!-- Информация в секции vKsc доступна только для тенанта типа "полный" -->
<vKsc id="{идентификатор}">
<user>
<name>{администратор}</name>
</user>
</vKsc>
<status>{статус}</status>
<type>{тип тенанта}</type>
</tenant>
где:
tenant id="{идентификатор}"– идентификатор тенанта в базе данных Сервера интеграции.created="{дата и время}"– дата и время регистрации тенанта в базе данных Сервера интеграции в формате YYYY-MM-DDThh:mm:ss.updated="{дата и время}"– дата и время обновления сведений о тенанте в базе данных в формате YYYY-MM-DDThh:mm:ss.{название}– название тенанта, указанное при создании тенанта.{описание}– описание тенанта.{дополнительные сведения}– дополнительная информация о тенанте, внесенная в базу данных Сервера интеграции.vKsc id="{идентификатор}"– идентификатор, назначенный виртуальному Серверу администрирования тенанта в Kaspersky Security Center.{администратор}– имя администратора виртуального Сервера администрирования тенанта.{статус}– текущий статус тенанта: "активный" (Active) или "неактивный" (Inactive).{тип тенанта}– тип тенанта: "полный" (Complete) или "упрощенный" (Simple).
Коды возврата:
200 (OK)– запрос выполнен успешно. В ответе возвращаются сведения о тенанте.403 (Forbidden)– доступ к ресурсу запрещен.404 (Not Found) VIRMT_TenantWithSpecifiedIdNotFound– тенант с указанным идентификатором не найден в базе данных Сервера интеграции.