Получение информации о клиенте
25 октября 2025
ID 199648
Позволяет получить информацию о клиенте из базы данных Сервера интеграции.
Метод:
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– клиент с указанным идентификатором не найден в базе данных Сервера интеграции.