Перейти к основному содержимому

Купить VPS

POST 

/vms

Выберите тариф, локацию и ОС из каталога. Для обычной установки передайте ровно одно из password или ssh_public_key, в том числе при расчёте цены. SSH-ключ — одна строка публичного ключа OpenSSH (Ed25519, RSA или ECDSA). По умолчанию cpu_percent=60, months=1, auto_renew=false. api_user_id — ваш идентификатор клиента.

Передавайте уникальный Idempotency-Key для каждого действия. При потере ответа повторите тот же запрос с тем же ключом и параметрами; не создавайте новый ключ для той же покупки.

HTTP 202 означает приём запроса, а не завершение. Сохраните order_id либо ID операции и проверяйте результат.

Правила запросов и ошибки · Жизненный цикл · Вебхуки

Необязательный JSON-объект cloud-config, не строка YAML. Не более 65536 байт после серверной JSON-сериализации (не-ASCII символы экранируются). users, packages, runcmd и write_files при наличии должны быть массивами. Сеть, hostname и основной доступ задаёт платформа. При повторе запроса передавайте тот же объект. Результат доступен отдельно в guest_initialization; содержимое cloud_init не возвращается в заказе или вебхуках.

Результат последней установки: succeeded — cloud-init завершился; failed / cloud_init_failed — ошибка пользовательской настройки; unknown / guest_initialization_timeout — результат не подтверждён за 15 минут. failed и unknown не означают, что работающий VPS не создан: заказ может быть completed, переустановка — succeeded. null — результата нет. Не подтверждает работоспособность приложения.

При нехватке ресурсов заказ остаётся processing и ждёт выдачи. Очередь и её отмена доступны по /orders/{order_id}/queue. После выдачи parameters.paid_until заказа обновляется фактическим сроком из результата создания; до выдачи дата предварительная.

Необязательный application_id выбирает приложение из GET /reference/applications. os_id и ровно один способ доступа остаются обязательными. Нельзя сочетать application_id с ненулевым cloud_init, включая {}. Доступность приложения, совместимость ОС и ресурсов проверяет сервис серверов при создании; Cloud API эти проверки не дублирует. При отклонении создания действует существующий возврат оплаты заказа. Расчёт цены определяет только стоимость VPS и не подтверждает совместимость приложения. Отдельной доплаты за приложение нет. При повторе с тем же Idempotency-Key сохраняйте application_id.

VPS с Windows создаётся этим же маршрутом с os_id из GET /reference/os. Логин новой установки Windows — admin, Linux — root. Для Windows обязателен password: 8–127 символов, минимум три категории из строчных, заглавных, цифр и специальных символов; без CR, LF, NUL и имени пользователя внутри пароля. Не передавайте ssh_public_key, application_id или cloud_init со значением, отличным от null (включая {}). Имя компьютера Windows — не более 15 символов, не только цифры. Совместимость ОС, шаблона и ресурсов проверяет сервис серверов при выдаче; расчёт цены её не подтверждает. При отклонении создания действует существующий возврат оплаты заказа.

Для новой VPS из оплаченного бекапа передайте backup_id вместо os_id. Не передавайте password, ssh_public_key, application_id и cloud_init: ОС, программы и доступы берутся из копии. api_user_id должен совпадать с владельцем бекапа. Новая VPS получает собственные адреса и оплачивается обычным заказом vm_purchase с наценкой тарифа и скидкой за срок. За восстановление отдельной платы нет; действует общий лимит 3 восстановления на услугу за 24 часа. Выбранный диск должен вместить все диски копии; совместимость проверяет сервис серверов.

Административная блокировка: admin_blocked_at и admin_block_reason возвращаются отдельно от status. Продление не снимает запрет и не запускает сервер. Ограничения и ошибки: административная блокировка.

Request​

Responses​

Принято в обработку

© 2026 AdaptGroup LLC. All rights reserved.
30 N Gould St Ste R, Sheridan, WY 82801, USA
Back to top