VMware Cloud Director API
Введение
VMware Cloud Director API позволяет взаимодействовать с VMware Cloud Director через REST-клиент.
Описание методов VMware Cloud Director API — в документации VMware.
Учетные данные для API
Перед использованием VMware API необходимо иметь учетные данные для входа в свой VDC. Как правило вы получаете эти данные на электронный ящик или иным через вашего личного менеджера. Эти данные имеют вид:
Имя пользователя - имя пользователя для входа обратно совместимо с возможностью подключения к API.
Идентификатор организации - используйте его, чтобы однозначно идентифицировать vOrg при использовании vCloud API.
Пароль - для аутентификации с помощью vCloud API. Этот пароль такой же, как и тот, который вы используете для входа.
Получение актуальной версии API
Чтобы начать взаимодействие с vCloud API необходимо настроить и получить актуальную поддерживаемую версию API сервера.
Запустите API клиент
Сформируйте GET запрос на адрес https://cloud1.rcloud.ru/api/versions
В панели Authorization выберите тип аутентификации BasicAuth
В панели Username введите свой логин и через @ имя vORG
В панели Password укажите пароль от vORG в облаке
При успешном выполнении запроса вы должны получить от сервера ответ "Status: 200 OK", и в панели ответа Body будет перечень всех версий API неподдерживаемых (deprecated <true>) и поддерживаемых (deprecated <false>) сервером.
Получение API токена
Чтобы получить API токен для взаимодействия с vCloud API необходимо сделать следующие шаги:
Выбрать версию API (например Accept: application/json;version=39.1) и прописать данный параметр в разделе Headers;
Создать запрос POST https://cloud1.rcloud.ru/cloudapi/1.0.0/sessions;
Для выполнения запроса нажать на кнопку Send.
После получения ответа от сервера перейдите на панель Headers. Здесь мы можем увидеть несколько заголовков и ключей авторизации, нас интересует ключ x-vcloud-authorization. Это кратковременный ключ, который выдается на ограниченное время. Если сессия с этим ключом истекает, шаги по получению токена авторизации необходимо выполнить заново.