Переустановить ОС
POST/vms/:vm_id/reinstall
Пересоздаёт системный диск с удалением его данных. Дополнительные диски сохраняются, если wipe_extra_disks=false. Передайте пароль либо публичный SSH-ключ; без обоих сохраняются настройки доступа установки. Оба сразу недопустимы. ID VPS, сеть и оплаченный срок сохраняются.
Передавайте уникальный 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 — результата нет. Не подтверждает работоспособность приложения.
Request
Responses
- 202
- 401
- 404
- 409
- 422
- 500
- 503
Принято в обработку
Нет ключа, неверный ключ/ID либо интеграция выключена
Ресурс не найден в интеграции
Конфликт параметров или состояния; проверьте detail
Неверные поля запроса либо неподдерживаемые параметры
Непредвиденная ошибка сервера
Сервис недоступен или результат не подтверждён; сохраните ключ повтора изменяющего запроса