VMware Cloud Director API

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

Запрос версии API

• Postman
Получить список версий API:

*В инструкции используется версия 36.3 и URL https://iaas-ru.linxdatacenter.com/api/sessions
• cURL

Запрос токена

Для получения токена необходимо знать:

• • Версию API (актуальная, 36.3)
  • Зону API:
    • МСК — https://iaas-mow.linxdatacenter.com/api/sessions
    • СПБ — https://iaas-ru.linxdatacenter.com/api/sessions
  • Tenant name — название тенанта, искать в URL-адресе для входа в VMware Cloud Director:
    • https://iaas-mow.linxdatacenter.com/tenant/<tenant_name>
    • https://iaas-ru.linxdatacenter.com/tenant/<tenant_name>

• • User — логин для входа в VMware Cloud Director (формат user@tenant_name)
  • Password — пароль для входа в VMware Cloud Director

• Postman

Вкладка Authorization:

• Поле – Type, выбираем Basic Auth
• Поле – Username указываем логин и название тенанта user@tenant name
• Поле – Password указываем пароль

Вкладка Headers:

• Добавляем в поле Key значение Accept, а в поле Value вводим application/*+xml;version=36.3

После получения ответа от сервера переходим на вкладку Headers, где отображается список из нескольких заголовков и ключей авторизации.
* Для дальнейшей работы (Запрос объектов организации и др., на вкладке Authorization в поле Type выбираем Bearer Token и в поле Token вводим токен текущей сессии x-vmware-vcloud-access-token.

• cURL

• • User — логин для входа в VMware Cloud Director (формат user@tenant_name)
  • Password — пароль для входа в VMware Cloud Director

* credentials – это user@tenant_name:password в кодировке MIME Base64

Запрос объектов организации

• Postman

*ID_org получен на предыдущем шаге в ответе на вкладке Body

• cURL

* Token– это токен текущей сессии x-vmware-vcloud-access-token (см. Запрос токена)