Получение списка виртуальных машин тенанта

Позволяет получить список всех зарегистрированных виртуальных машин тенанта.

Метод:

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 – тенант с указанным идентификатором не найден в базе данных Сервера интеграции.

В начало