Запрос объектов виртуального ЦОД с помощью 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-элементах QueryResultRecords — OrgVdcRecord.

<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/.

Запустили Evolution free tier
для Dev & Test
Получить