nav-img
Облако VMware

Запрос объектов виртуального ЦОД с помощью API

В виртуальном ЦОД размещаются виртуальные машины, шаблоны vApp, образы ISO, Edge Gateway и сети организации. Чтобы получить к ним доступ, необходимо получить список виртуальных ЦОД организации, а затем запросить список объектов нужного виртуального ЦОД.

Запрос списка виртуальных ЦОД

Request

Отправьте GET-запрос на https://{SITE}/api/query?type=orgVdc. Этот URL можно получить в ответе на Запрос объектов организации с помощью API.


curl -k --header "Accept: application/*;version={VERSION}" --header "Authorization: Bearer {TOKEN}" --request GET "https://{SITE}/api/query?type=orgVdc"

Response

Сервер вернет список виртуальных ЦОД организации, URL которых располагаются в XML-элементах QueryResultRecordsOrgVdcRecord.

<QueryResultRecords>
<OrgVdcRecord
name="my-tenant"
description="This is my tenant"
isEnabled="true"
href="https://{SITE}/api/vdc/{VDC-ID}"/>
<!-- Other params -->
...
</QueryResultRecords>

Запрос XML-представления виртуального ЦОД

Request

Отправьте GET-запрос на URL виртуального ЦОД.


curl -k --header "Accept: application/*;version={VERSION}" --header "Authorization: Bearer {TOKEN}" --request GET "https://{SITE}/api/vdc/{VDC-ID}"

Response

Сервер вернет список объектов виртуального ЦОД.

<Vdc>
<Link
href="https://{SITE}/api/vdc/{VDC-ID}/media"
rel="add"/>
<Link
rel="edgeGateways"
href="https://{SITE}/api/admin/vdc/{VDC-ID}/edgeGateways"/>
<Link
rel="add"
href="https://{SITE}/api/vdc/{VDC-ID}/action/instantiateVAppTemplate"/>
<AvailableNetworks>
<Network
href="https://{SITE}/api/network/{NET-ID}"
id="urn:vcloud:network:{NET-ID}"
name="{NET-Name}"/>
...
</AvailableNetworks>
...
</Vdc>
См.также

Полное описание конечных точек, методов и параметров запросов можно посмотреть по ссылке https://{SITE}/docs/.