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

Выделенные серверы

Маршруты раздела «Выделенные серверы» для интеграции Cloud API.

📄️Рассчитать аренду сервера

Передайте ровно один вариант: disk_layout для тарифа с общей разметкой либо disk_layouts для тарифа с группами дисков. disk_layouts — объект, где ключи взяты из disks[].id каталога, а значения — разрешённые коды разметки этих групп. Нужно передать все группы, без лишних ключей. ID непрозрачны: не определяйте их по типу диска. Значения по умолчанию выбирает клиент; API не подставляет их. При повторе заказа сохраните тот же выбор.

📄️Арендовать выделенный сервер

Передайте ровно один вариант: disk_layout для тарифа с общей разметкой либо disk_layouts для тарифа с группами дисков. disk_layouts — объект, где ключи взяты из disks[].id каталога, а значения — разрешённые коды разметки этих групп. Нужно передать все группы, без лишних ключей. ID непрозрачны: не определяйте их по типу диска. Значения по умолчанию выбирает клиент; API не подставляет их. При повторе заказа сохраните тот же выбор.

📄️Состояние выделенного сервера

Возвращает power_state, доступные power_actions и признак поддержки reinstall. Управление доступно только для выданной, активной и оплаченной аренды на подготовленном сервере. Используйте список power_actions: не все серверы поддерживают пять команд, неподдержанная команда не заменяется принудительной перезагрузкой. On не подтверждает готовность ОС или приложений. Cache-Control: no-store.

📄️Питание выделенного сервера

Принимает start, shutdown, stop, reboot или reset. Сначала получите доступные power_actions в статусе аренды. shutdown/reboot запрашивают штатное завершение/перезапуск; stop/reset выполняются принудительно с риском потери несохранённых данных. Возвращается асинхронная операция, а не финансовый заказ; баланс интеграции не списывается. Новая команда доступна только активной оплаченной аренде с подключённым управлением.

📄️Переустановка ОС выделенного сервера

Переустанавливает ОС с удалением данных на дисках сервера; обязательно confirmed: true. Передайте os_id из справочника ОС. Сервер должен поддерживать переустановку и выбранную ОС; hostname, логин, схема дисков, IP, владелец и оплаченный срок сохраняются. Если password и ssh_public_key отсутствуют, сохраняются текущие доступы. Если хотя бы одно поле передано, весь комплект доступов заменяется; отсутствующая часть не сохраняется. Можно передать пароль, публичный SSH-ключ или оба; пустой комплект отклоняется. cloud_init здесь не поддерживается. Команда не списывает баланс. После успеха получите актуальные доступы в деталях аренды; операции и вебхуки их не содержат.

📄️История операций выделенного сервера

Список операций питания и переустановки этой аренды, в том числе после её завершения. Сначала новые; total_count — количество до пагинации. Выполняющаяся операция или неразрешённый requires_review блокирует новую команду. review_resolved_at указывает на завершённую администратором проверку и не изменяет исторический результат failed.

📄️Операция выделенного сервера

Возвращает операцию только для указанной аренды и интеграции. Статусы: queued, running, succeeded, failed, cancelled. Результат успешного питания содержит power_state, changed и необязательный power_action; переустановки — os и verified. verified подтверждает проверки установки, а не работу приложений клиента. Ошибка содержит публичный код и requires_review. При requires_review=true и review_resolved_at=null обратитесь в поддержку перед новой командой; повтор того же Idempotency-Key возвращает прежнюю операцию.

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