All Products
Search
Document Center

Cloud Backup:Create an OSS restore job

Last Updated:Oct 09, 2026

If files in an OSS bucket are lost or damaged, use Cloud Backup to restore all or selected files from a backup to the source bucket or a different bucket.

Prerequisites

A backup has been completed based on an OSS backup plan. Back up OSS files.

Billing

Restoring data is free of charge. Billing methods and billable items.

Procedure

Restore backed-up OSS data to the source bucket or a different bucket.

  1. On the OSS File Backup page, select the region of the target bucket, and then click View Details next to the bucket.

    Note

    If you use the Legacy Console (indicated by Try New Version in the upper-right corner), go to the Backup Plans tab, expand the target instance row, click the backup point to open the details panel, and click Restore.

  2. In the Backup History section, find the target backup point and click Restore in the Actions column.

    You can also click the image icon in the upper-right corner of the backup history to switch to the timeline view, then click a backup point and click Restore.

    Note

    Each backup point may contain different data. Choose the one that matches the files you need.

  3. In the Create Restore Job panel, configure the settings in the Restore Items section, and then click Next.

    Important

    Specify files to restore for better accuracy and efficiency.

    • Include All Files: Restores all files in the bucket.

    • Include Files or Exclude Files: Enter file paths in the Enter Paths box. Files are restored based on the selected rule.

      Enter one path per line. Each path must start with the prefix specified during backup.

      • If the backup prefix is a/b/, enter:

        a/b/folder
        a/b/file.txt
      • If no prefix was specified, enter:

        folder
        file.txt
  4. Configure the Configure Destination, and then click Create.

    Important

    To restore to a new bucket, first create a Standard storage class bucket in the same region. Create a bucket.

    Parameter

    Description

    Recover to OSS Bucket

    Select the destination bucket.

    Restore to Bucket Prefix

    Select or enter a destination prefix for restored files. If empty, files restore to the bucket root directory. Nonexistent prefixes are created automatically.

    Virus Detection During Restoration

    When enabled, Cloud Backup runs a virus scan on files before restoring them:

    • Safe files are restored.

    • Infected files are skipped. Check the Virus Scan page to review infected files and restore a safe version.

    Important

    Virus scanning is a paid feature (approximately 1.5 CNY per 1,000 files). Budget accordingly to avoid overdue payments. Billing methods and billable items.

  5. Go to the Restore Jobs tab to view the progress of the restore job in the Status column.

    Note

    To cancel an in-progress restore job, click Cancel in the Actions column and confirm the cancellation.

References