Выделенные серверы
Маршруты раздела «Выделенные серверы» для интеграции Cloud API.
Рассчитать аренду сервера
Передайте ровно один вариант: disk_layout для тарифа с общей разметкой либо disk_layouts для тарифа с группами дисков. disk_layouts — объект, где ключи взяты из disks[].id каталога, а значения — разрешённые коды разметки этих групп. Нужно передать все группы, без лишних ключей. ID непрозрачны: не определяйте их по типу диска. Значения по умолчанию выбирает клиент; API не подставляет их. При повторе заказа сохраните тот же выбор.
Арендовать выделенный сервер
Передайте ровно один вариант: disk_layout для тарифа с общей разметкой либо disk_layouts для тарифа с группами дисков. disk_layouts — объект, где ключи взяты из disks[].id каталога, а значения — разрешённые коды разметки этих групп. Нужно передать все группы, без лишних ключей. ID непрозрачны: не определяйте их по типу диска. Значения по умолчанию выбирает клиент; API не подставляет их. При повторе заказа сохраните тот же выбор.
Список аренд
Список аренд интеграции с фильтрами по клиенту, локации, платформе и статусу. Доступы находятся только в деталях аренды.
Детали аренды и доступы
Возвращает оборудование, срок оплаты, статус и доступы аренды. До выдачи доступы могут быть null. Cache-Control: no-store. preparing — подготовка, active — выдан, overdue — оплата истекла, cleaning — освобождение/очистка, completed и cancelled — конечные статусы.
Состояние выделенного сервера
Возвращает 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 возвращает прежнюю операцию.
Рассчитать продление аренды
Продлевает выданную аренду по текущим ценам и скидкам выбранного срока. Дополнительные IPv4 в составе аренды оплачиваются по фиксированной цене. Продление возможно в active или overdue до начала очистки.
Продлить аренду
Продлевает выданную аренду по текущим ценам и скидкам выбранного срока. Дополнительные IPv4 в составе аренды оплачиваются по фиксированной цене. Продление возможно в active или overdue до начала очистки.
Автопродление аренды
Меняет настройку автопродления без списания баланса и изменения оплаченного срока. По умолчанию false. Сроки попыток, длительность и цены описаны в разделе жизненного цикла.