Получение списка виртуальных машин клиента
25 октября 2025
ID 199649
Позволяет получить список всех зарегистрированных виртуальных машин клиента.
Метод:
GET /api/2.0/virtualization/tenants/{идентификатор клиента}/vms
где:
{идентификатор клиента} – идентификатор клиента в базе данных Сервера интеграции (обязательный параметр).
В случае успешного выполнения запроса REST API возвращает список виртуальных машин и сведения о каждой виртуальной машине клиента в следующем виде:
<vm id="{идентификатор в базе}" biosId={идентификатор BIOS ID} created="{дата и время}" updated="{дата и время}">
<name>{имя}</name>
<userData><![CDATA[{дополнительные сведения}]]></userData>
</vm>
где:
{идентификатор в базе}– идентификатор, назначенный виртуальной машине в базе данных Сервера интеграции.{идентификаторBIOS ID}– идентификатор виртуальной машины (BIOS ID) в формате UUID.created="{дата и время}"– дата и время регистрации виртуальной машины в базе данных Сервера интеграции в формате YYYY-MM-DDThh:mm:ss.updated="{дата и время}"– дата и время обновления сведений о виртуально машине в базе данных в формате YYYY-MM-DDThh:mm:ss.{имя}– имя виртуальной машины.{дополнительные сведения}– дополнительная информация о виртуальной машине, внесенная в базу данных Сервера интеграции.
Коды возврата:
200 (OK)– запрос выполнен успешно. В ответе возвращается список виртуальных машин клиента.403 (Forbidden)– доступ к ресурсу запрещен.404 (Not Found) VIRMT_TenantWithSpecifiedIdNotFound– клиент с указанным идентификатором не найден в базе данных Сервера интеграции.