Арендовать выделенный сервер
POST/dedicated/rentals
Передайте ровно один вариант: disk_layout для тарифа с общей разметкой либо disk_layouts для тарифа с группами дисков. disk_layouts — объект, где ключи взяты из disks[].id каталога, а значения — разрешённые коды разметки этих групп. Нужно передать все группы, без лишних ключей. ID непрозрачны: не определяйте их по типу диска. Значения по умолчанию выбирает клиент; API не подставляет их. При повторе заказа сохраните тот же выбор.
Выберите plan_id из каталога дедиков. Физический сервер выбирает платформа. Передайте ровно одно: пароль или публичный SSH-ключ, в том числе для расчёта. extra_ipv4_count добавляет адреса к аренде по фиксированной цене. Завершённый заказ подтверждает резерв; выдавайте сервер клиенту после dedicated.issued / статуса active. Срок начинается с выдачи.
Передавайте уникальный Idempotency-Key для каждого действия. При потере ответа повторите тот же запрос с тем же ключом и параметрами; не создавайте новый ключ для той же покупки.
HTTP 202 означает приём запроса, а не завершение. Сохраните order_id либо ID операции и проверяйте результат.
Для групп HDD доступны RAID 5 (от 3 дисков), RAID 6 (от 4) и RAID 10 (чётное число от 4), если соответствующий код есть в вариантах группы. Для других типов дисков и общей разметки эти варианты недоступны.
Правила запросов и ошибки · Жизненный цикл · Вебхуки
Request
Responses
- 202
- 401
- 403
- 404
- 409
- 422
- 500
- 503
Принято в обработку
Нет ключа, неверный ключ/ID либо интеграция выключена
IP клиента не входит в белый список интеграции (ip_not_allowed).
Ресурс не найден в интеграции
Конфликт параметров или состояния; проверьте detail
Неверные поля запроса либо неподдерживаемые параметры
Непредвиденная ошибка сервера
Сервис недоступен или результат не подтверждён; сохраните ключ повтора изменяющего запроса