API (консоль управления)

В этом разделе — вводная информация для работы c API VMware Cloud Director. Вы узнаете об основных принципах работы с API, сможете пройти аутентификацию и выполнить несколько простых запросов.

Данный документ не является справочником по API.

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

{SITE} — зависит от региона, в котором размещается ваш виртуальный ЦОД. Он отображается в ссылке на VMware Cloud Director https://{SITE}/tenant/my-tenant/. Ее мы отправляем при подключении услуги. Например, для региона PD01 параметр {SITE} принимает значение vcd.sbercloud.ru, для PD11 — vcd11.msk.sbercloud.ru.

Для знакомства с API предлагаем выполнить следующие шаги:

Инструменты для создания тестовых запросов

Для выполнения тестовых запросов из этого раздела вы можете использовать cURL, Postman или другие инструменты.

Особенности API

API позволяет взаимодействовать с VMware Cloud Director через REST-клиент. REST-клиенты обмениваются с сервером XML-представлениями объектов VMware Cloud Director по протоколу HTTP.

Доступные методы:

  • GET — получить представление объекта;

  • POST — создать объект;

  • PUT — изменить объект;

  • DELETE — удалить объект.

Для работы с REST-клиентом нужно понимать:

  • HTTP.

  • Cемантику XML.

  • Структуру XML-представлений объектов VMware Cloud Director и значение элементов и атрибутов на XML-схеме организации.

  • Связь объектов, с которыми работает API: организации, виртуальные ЦОД, vApp, VM, каталоги, пользователи и др.

  • Принцип работы REST-клиента с XML-представлениями объектов.

API использует уникальные идентификаторы (universal unique identifiers, UUID), определенные в RFC 4122. В руководстве они заменены на упрощенные варианты, например:

  • vapp-f5e185a4-7c10-41f1-8с91-0e662d538101 заменяется на vapp-{VAPP-ID} или vapp-f5e185...;

  • org/89a1a8f3-c518-5f53-940c-950df6e3 заменяется на org/{ORG-ID} или org/89a1a8....

Масштабная конференция
GoCloud 2024:
облачные грани будущего