All Products
Search
Document Center

Cloud Backup:Create an OSS restore job

Last Updated:May 30, 2026

If files in an OSS bucket are lost or damaged, you can use Cloud Backup to restore them from a backup. You can restore all files or only specific files that meet certain conditions. You can restore the files to the source OSS bucket or to a new OSS bucket.

Prerequisites

A backup has been completed based on an OSS backup plan. For more information, see Back up OSS files.

Billing

The restore feature is free of charge. For more information about billing, see Billing methods and billable items.

Procedure

You can restore data from an OSS backup to the source bucket or to 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, which displays Try New Version in the upper-right corner, go to the Backup Plans tab and expand the row for the target instance. Click the target backup point to open the details panel, and then click Restore.

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

    Alternatively, you can click the image icon in the upper-right corner of the backup history to switch to the timeline view. Then, click the target backup point to view its details and click Restore.

    Note

    Select a suitable backup point. Different backup points may contain different data.

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

    Important

    To improve the accuracy and efficiency of the restore job, we recommend that you specify the files to restore.

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

    • Include Files or Exclude Files: In the Enter Paths box, enter the paths of the files to include or exclude. The files are restored based on the selected rule.

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

      • If the prefix was set to a/b/ during the backup, enter the following to include (or exclude) the folder and file.txt:

        a/b/folder
        a/b/file.txt
      • If no prefix was specified during the backup, enter the following to include (or exclude) the folder and file.txt:

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

    Important

    To restore to a new OSS bucket, you must first create a Standard storage class bucket in the same region. For more information, see Create a bucket.

    Parameter

    Description

    Destination Bucket

    Select the destination OSS bucket for the restore.

    Destination Path

    Select or enter a destination prefix for the restored files. If you do not specify a prefix, files are restored to the root directory of the bucket. If you enter a prefix that does not exist, Cloud Backup creates it automatically.

    Virus Detection During Restoration

    When enabled, Cloud Backup runs a virus scan on all files to be restored. The results are handled as follows:

    • Safe files are restored directly.

    • Files detected as viruses are not restored. Go to the Virus Scan page to view the infected files and find a safe version to restore.

    Important

    Virus scanning for backup points is a paid feature. You are charged based on the number of files scanned (approximately 1.5 CNY per 1,000 files). Budget accordingly to avoid overdue payments. For billing details, see 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 a restore job that is in progress, click Cancel in the Operation column for the job and confirm the cancellation.

References