Важно!
Создавать облачные VDS можно только если в панели управления аккаунтом заказана услуга "Облачные VDS" (раздел Услуги).Для управления виртуальными машинами через HTTP-API нужно:
Получение ключа
Для получения ключа от API достаточно перейти по ссылке и нажать Создать ключ или Показать (если он уже был создан ранее).
Если ключ был скомпрометирован, нужно перегенерировать ключ нажатием на Сменить ключ.
Генерация токена
Для генерации авторизационного токена необходимо отправить POST-запрос к ресурсу /api/cvds/v1/token/:
curl -XPOST https://panel.netangels.ru/api/cvds/v1/token/ \
-d 'api_key=Z9wHn3wVX7h6cUa9K8tGnJtkRUTeoqmBlqfHo8L1udZpwGfkHxbxM3ZW'
В ответе будет JSON вида:
{"token":"dicHCttH8vA1Yz4qLsuV"}
Полученный токен необходимо передавать в большинстве запросов к API.
Он действителен в течение 24 часов с момента последнего использования. Таким образом, токен может не утратить свою актуальность при частом использовании.
Использование токена
Все запросы необходимо отправлять на базовый URL: /api/cvds/v1/.
При запросах к API авторизационный токен необходимо передавать в заголовке Authorization:
curl -XGET https://panel.netangels.ru/api/cvds/v1/vms/ \
--header "Authorization: Token gp223fRURyF3WHyYUjb7"
Примеры использования токена в методах работы с виртуальными машинами: