Работа с API VPC

Введение: проекты, ресурсы и квоты

Базовым понятием в сервисе “Виртуальное приватное облако” является проект — это совокупность объектов и ресурсов в нескольких регионах и зонах доступности, к которым может иметь доступ пользователь: виртуальных машин, дисков, сетей и других. В рамках каждого проекта пользователь может распределять между объектами ресурсы (оперативную память, ядра CPU, дисковое пространство и так далее).

Управлять проектами, ресурсами и объектами можно с помощью API. Взаимодействие с API осуществляется с помощью стандартных HTTP-запросов. Чтобы осуществить вызов к API, нужно выбрать в документации нужный метод, сформировать запрос в соответствии с описанием этого метода и выполнить его. API возвращает ответ в формате JSON.

Структура типовых запросов (создание проекта, назначение квот для этого проекта и добавление пользователей) и ответов на них описана ниже. Полная документация опубликована в панели управления.

curl 'https://api.selectel.ru/vpc/resell/v2/projects'  -X POST  -H "Content-Type: application/json" --data-binary {project:{"name":"test"}}' -H "X-Token: qX3Npu42ua73kPkhe4QCQ8Vv9_xxxxx"

Подготовка к работе: получение ключа

Прежде чем приступать к работе с API, необходимо получить ключ (токен). Зарегистрированные пользователи Selectel могут получить ключ на странице my.selectel.ru/profile/apikeys. Токен представляется собой строку вида qX3Npu42ua73kPkhe4QCQ8Vv9_xxxxx, где xxxxx — это номер учётной записи пользователя.

Ключ передаётся в каждом запросе в заголовке X-Token, например:

curl -i https://api.selectel.ru/vpc/resell/v2/projects -H 'X-Token: qX3Npu42ua73kPkhe4QCQ8Vv9_xxxxx'

Создание проекта

Создадим проект с именем test. Это мы сделаем при помощи следующего запроса:

curl 'https://api.selectel.ru/vpc/resell/v2/projects' -X POST -H "Content-Type: application/json" --data-binary '{"project" :{"name":"test", "quotas": {"compute_cores": [{"region": "ru-1", "zone": "ru-1b", "value": 8}]}}}' -H "X-Token: g4ZVkDAD9mpKYnC8UEX24Ue89_xxxxx"

Ответ:

{“project”: {“url”: “https://*****.selvpc.ru“, “enabled”: true, “quotas”: {“compute_cores”: [{“region”: “ru-1”, “value”: 8, “zone”: “ru-1b”}]}, “name”: “test”, “id”: “b4ce7652c7e2416ab2cba991443f9e99"}}

В ответе содержится следующая информация о том, что:

проект создан и готов к работе;
внешняя панель управления проектом доступна по адресу https://*****.selvpc.ru;
проект получил идентификационный номер b4ce7652c7e2416ab2cba991443f9e99 (он понадобится в некоторых последующих запросах, а также для работы со сторонними библиотеками и консольными клиентами);
в соответствии с запросом проект получил имя test.

При создании проекта можно передать параметр auto_quotas со значением True, что приведет к установке автоматически рассчитанных квот. Например:

curl 'https://api.selectel.ru/vpc/resell/v2/projects' -X POST -H "Content-Type: application/json" --data-binary '{"project": {"name": "test", "auto_quotas": "true"}}' -H "X-Token: g4ZVkDAD9mpKYnC8UEX24Ue89_*****"

Для изменения установленных на проект квот можно воспользоваться запросом (в данном примере мы выделяем 8192 МБ памяти):

curl -i -XPATCH "https://api.selectel.ru/vpc/resell/v2/quotas/projects/fa9e778a6cb64fcca46605be6b58164c" -H "X-Token: qX3Npu42ua73kPkhe4QCQ8Vv9_*****" -H "Content-Type: application/json" -H "Accept: application/json" -H "User-Agent: python-selvpcclient/1.0" -d '{"quotas": {"compute_ram": [{"region": "ru-1", "zone": "ru-1b", "value": 8192}]}}'

Общую информацию о проекте можно просмотреть так:

curl 'https://api.selectel.ru/vpc/resell/v2/projects/fa9e778a6cb64fcca46605be6b58164c' -H 'X-Token: qX3Npu42ua73kPkhe4QCQ8Vv9_*****'

Чтобы виртуальные машины в проекте были доступны из внешней сети, добавим плавающие IP-адреса:

curl -i -XPOST 'https://api.selectel.ru/vpc/resell/v2/floatingips/projects/fa9e778a6cb64fcca46605be6b58164c' -H 'Content-Type: application/json' --data-binary '{"floatingips":[{"region":"ru-1","quantity":3}]}' -H 'X-Token: qX3Npu42ua73kPkhe4QCQ8Vv9_*****'

Добавим 3 адреса ("quantity": 3) в регионе ru-1.

Ответ на этот запрос выглядит так:

{"floatingips": [{"status": "DOWN", "region": "ru-1", "floating_ip_address": "77.244.220.30", "project_id": "fa9e778a6cb64fcca46605be6b58164c", "id": "d5489d04-6c5f-46f5-810b-7f86c71ce8ae"}, {"status": "DOWN", "region": "ru-1", "floating_ip_address": "77.244.220.50", "project_id": "fa9e778a6cb64fcca46605be6b58164c", "id": "12d78f81-3d56-4592-92f2-558d5c4e2f68"},{"status": "DOWN", "region": "ru-1", "floating_ip_address": "77.244.220.73", "project_id": "fa9e778a6cb64fcca46605be6b58164c", "id": "7569e8f8-3cb1-4823-8e1e-c69574b0282f"}

Каждый IP-адрес имеет статус DOWN, но это свидетельствует не о какой-то неполадке, а лишь о том, что в настоящий момент он не присвоен ни одной виртуальной машине. Как и у всех объектов VPC, у каждого IP-адреса есть ID.

Этот параметр также будет нужен в дальнейшем, когда мы будем создавать виртуальные машины и назначать им адреса.

Пользователи и роли

В проект могут быть добавлены пользователи. Порядок действий при этом таков: сначала нужно создать пользователя, а затем добавить его в проект.

Пользователь, который добавлен в проект и обладает определённым набором прав в рамках этого проекта, в терминологии OpenStack имеет роль в этом проекте. Роль в проекте нужна для работы с OpenStack API, например, с помощью программ, которые описаны в статье Консольные клиенты.

Чтобы создать нового пользователя, нужно отправить POST-запрос и передать логин и пароль:

curl -i -XPOST "https://api.selectel.ru/vpc/resell/v2/users" -H "X-Token: qX3Npu42ua73kPkhe4QCQ8Vv9_xxxxx" -H "Content-Type: application/json" -H "Accept: application/json -d '{"user": {"password": "password, "enabled": true, "name": "new user"}}'

Если запрос выполнен успешно, API возвращает ответ вида:

{"user": {"enabled": true, "name": "newuser", "id": "6000869ba906427aaeb997835c4babdb"}}

Чтобы назначить пользователю роль (т.е. добавить пользователя в проект), выполним запрос вида:

curl -i -XPOST "https://api.selectel.ru/vpc/resell/v2/roles/projects/{id проекта}/users/{id пользователя}" -H "X-Token:qX3Npu42ua73kPkhe4QCQ8Vv9_xxxxx"

Итак, проект создан, квоты назначены, пользователь добавлен. Всё готово к созданию виртуальных машин.

Эта операция осуществляется с помощью консольных клиентов OpenStack, работа с которыми описывается в статье Консольные клиенты.

Библиотеки для работы с API

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