База знаний

Облако VMware Облако LINX CS (KVM) Сервисы ИБ

VMware Cloud Director API

В инструкции описаны основные принципы для работы с VMware Cloud Director API.

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

Для выполнения тестовых запросов в инструкции будет использоваться Postman и утилита cURL.

Для авторизации и начала использования API, необходимо узнать версию API и получить токен.

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

1. Postman

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

GET-запрос на https://iaas-ru.linxdatacenter.com/api/versions

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

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

2. cURL

curl -X GET https://iaas-ru.linxdatacenter.com/api/sessions

Бесплатно проконсультируем по вашим вопросам

Заказать звонок

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

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

Версию API (актуальная, 36.3)
Зону API:

- СПБ — https://iaas-ru.linxdatacenter.com/api/sessions

- МСК — https://iaas-mow.linxdatacenter.com/api/sessions

Tenant name — название тенанта, искать в URL-адресе для входа в VMware Cloud Director:

- https://iaas-mow.linxdatacenter.com/tenant/

- https://iaas-ru.linxdatacenter.com/tenant/

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

1. Postman

POST-запрос на https://iaas-ru.linxdatacenter.com/api/sessions

Вкладка 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.

2. cURL

curl -X POST «https://iaas-ru.linxdatacenter.com/api/sessions» -i -H «Accept: application/*;version=36.3» -H «Autorization: Basic credentials»

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

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

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

1. Postman

GET-запрос на «https://iaas-ru.linxdatacenter.com/api/org/ID_org»

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

2. cURL

curl -X GET «https://iaas-ru.linxdatacenter.com/api/org/39afa137-f5ad-40f3-ae3d-6a46635eb6d1» -H «Accept: application/*;version=36.3» -H «Autorization: Bearer Token»

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

Было полезно?

Следующая Информация о VDC

Остались вопросы?

Опишите вашу задачу, и мы поможем вам ее решить

Или напишите нам info@linxdatacenter.com

Нажимая кнопку «Отправить», вы соглашаетесь с Политикой обработки персональных данных ООО «Связь ВСД»