Бекапы

Хранение и восстановление копий VPS.

Размеры бекапа

Размер хранения бекапа (stored_size_bytes) и размер ZIP для скачивания (size_bytes экспорта) — разные величины. Экспорт собирается отдельно из восстановленного образа диска и сжимается заново, поэтому архив может быть больше или меньше. Само по себе различие размеров не означает повреждение бекапа.

📄️Оценка размера бекапа

Возвращает выделенный объём дисков и, если доступно, занятое место внутри гостя. stored_size_bytes равен null: точный оплачиваемый размер известен только после создания копии. Запрос не создаёт бекап и не списывает деньги.

📄️Рассчитать подключение бекапов

Расчёт без заказа и списания. Idempotency-Key не требуется. Автоматические бекапы рассчитываются по текущему тарифу; ручное продление — по измеренному размеру. При создании ручной копии amount_usd=0.0000, exact_size_available_after_backup=true: это ещё не итоговая стоимость, передаётся ставка manual_gb_month_price_usd за GiB в месяц. При оплате можно передать expected_amount_usd и expected_manual_rate_usd; при изменении цены — 409 price_changed.

📄️Рассчитать продление бекапов

📄️Создание услуги бекапов

Создаёт отдельную услугу автоматического или ручного хранения для существующей VPS. auto_renew по умолчанию false. Автоматическая услуга: первая копия при подключении, далее ежедневно, хранятся последние 7 успешных копий. Одна ручная услуга хранит одну копию. Срок — один календарный месяц; итоговый paid_until определяется при активации услуги. Автоматические бекапы оплачиваются заранее по цене тарифа из GET /plans; при неуспешном создании оплата возвращается. Ручные оплачиваются после создания: stored_size_bytes / 1073741824 × ставка на момент заказа, округление до 4 знаков USD. Пока ручная копия создаётся, amount_usd=0.0000 не означает бесплатную услугу. Если денег недостаточно, копия удаляется; разрешённый отрицательный баланс учитывается. Копии недоступны до подтверждения первой оплаты. Без наценки интеграции, коэффициента CPU и скидки за срок.

📄️Список услуг бекапов

Список неудалённых услуг интеграции, включая услуги после удаления исходной VPS. Необязательные фильтры api_user_id и vm_id; total_count — число услуг по фильтрам. Статус услуги относится к хранению; оплату проверяйте по заказу покупки.

📄️Детали услуги бекапов

Возвращает владельца, тип, статус хранения, auto_renew и paid_until. Услуга сохраняется после удаления исходной VPS. После окончания оплаты есть 24 часа на продление или восстановление до удаления. Первую оплату проверяйте по заказу покупки.

📄️Автопродление бекапов

Включает или выключает продление с баланса интеграции. Текущий оплаченный срок не меняется, возврата нет. Попытка автопродления выполняется по предупреждению за 24 часа до окончания оплаты и повторно за час до удаления, если услуга ещё не продлена. Уже принятый заказ продления продолжает выполняться после отключения автопродления.

📄️Продление услуги бекапов

Продлевает paid_until на один календарный месяц от max(текущий paid_until, сейчас), по актуальным ценам без наценки и скидок. Для ручной копии используется измеренный размер. Для автоматических бекапов — текущий тариф VPS; после удаления VPS — последний сохранённый тариф услуги. Списание и заказ фиксируются вместе. При отклонении продления оплата возвращается. Доступно до начала удаления в пределах 24 часов после окончания оплаты.

📄️Удаление услуги бекапов

Удаляет услугу и все её копии. Удаление асинхронное и необратимое. Неиспользованный оплаченный срок не возвращается. Ручную копию удаляйте этим маршрутом вместе с услугой.

📄️Список копий

Неудалённые копии оплаченной услуги, сначала новые. Доступны только после подтверждения первой оплаты. total_count — число подходящих копий. Размер хранения бекапа (stored_size_bytes) и размер ZIP для скачивания (size_bytes экспорта) — разные величины. Экспорт собирается отдельно из восстановленного образа диска и сжимается заново, поэтому архив может быть больше или меньше. Само по себе различие размеров не означает повреждение бекапа.

📄️Детали копии

Статус копии, измеренные размеры и публичная конфигурация VPS. Ключи шифрования, реквизиты инфраструктуры и сохранённые пароли не возвращаются. Размер хранения бекапа (stored_size_bytes) и размер ZIP для скачивания (size_bytes экспорта) — разные величины. Экспорт собирается отдельно из восстановленного образа диска и сжимается заново, поэтому архив может быть больше или меньше. Само по себе различие размеров не означает повреждение бекапа.

📄️Удаление копии

Удаляет одну автоматическую копию; услуга автоматических бекапов остаётся включённой. Для ручной копии удалите услугу. Занятая копия может быть недоступна для удаления.

📄️Восстановление исходной VPS

Восстанавливает диски исходной VPS; vm_id должен указывать на неё. Текущее содержимое дисков перезаписывается. Доступы и программы берутся из копии. Отдельной платы нет. Лимит — 3 принятых восстановления на услугу за скользящие 24 часа, общий с созданием новой VPS из её копий. Ожидающие и неуспешные попытки учитываются; повтор с тем же Idempotency-Key повторно лимит не расходует. При превышении — HTTP 429 backup_limit_reached.

📄️Подготовка скачивания бекапа

Готовит ZIP64-архив с raw-дисками и конфигурацией. Отдельной платы нет. Лимит — одна принятая подготовка на копию за скользящие 24 часа, включая ожидающие и неуспешные попытки. Повтор с тем же ключом не расходует лимит повторно. По worker_operation_id заказа можно получить статус экспорта и ссылку. Готовый архив хранится 24 часа после завершения. Размер хранения бекапа (stored_size_bytes) и размер ZIP для скачивания (size_bytes экспорта) — разные величины. Экспорт собирается отдельно из восстановленного образа диска и сжимается заново, поэтому архив может быть больше или меньше. Само по себе различие размеров не означает повреждение бекапа.

📄️Статус экспорта бекапа

Статус по worker_operation_id из заказа экспорта. ready — файл готов, expired — срок хранения закончился. Подписанная ссылка здесь не возвращается. Размер хранения бекапа (stored_size_bytes) и размер ZIP для скачивания (size_bytes экспорта) — разные величины. Экспорт собирается отдельно из восстановленного образа диска и сжимается заново, поэтому архив может быть больше или меньше. Само по себе различие размеров не означает повреждение бекапа.

📄️Ссылка скачивания бекапа

Временная ссылка на готовый архив действует не более часа и не дольше срока хранения архива. Повторная выдача ссылки не расходует лимит подготовки и не продлевает 24 часа хранения. Лимит не ограничивает число скачиваний готового файла. Ссылку следует хранить как секрет. Cache-Control: no-store. Размер хранения бекапа (stored_size_bytes) и размер ZIP для скачивания (size_bytes экспорта) — разные величины. Экспорт собирается отдельно из восстановленного образа диска и сжимается заново, поэтому архив может быть больше или меньше. Само по себе различие размеров не означает повреждение бекапа.

📄️Статус операции бекапа

operation_id — worker_operation_id из заказа; также подходит ID из вебхука бекапа. Здесь показано выполнение воркером, оплату отдельно подтверждает заказ. Внутренние запросы и исходные ошибки инфраструктуры не возвращаются.

Размеры бекапа​