All Products
Search
Document Center

Cloud Backup:Restore OSS objects

Last Updated:Jan 22, 2026

Restore OSS objects from backup vaults to recover lost or damaged files. Restore all objects or selected objects to the source OSS bucket or a new OSS bucket at no cost. Use this feature when files are accidentally deleted, corrupted, or need to be restored to a different location.

Prerequisites

Before you begin, ensure that you have a backup plan created for the source OSS bucket with completed data backup. For more information, see Back up OSS objects and Back up a large amount of OSS objects using the OSS inventory feature.

Billing

Restore operations are free of charge.

For more information, see Billing methods and billable items.

Usage notes

  • The backup speed and recovery speed of Cloud Backup are obtained in a test environment. The values are provided for reference only. For more information, see Backup speed and recovery speed.

  • If you need to restore data to a new OSS bucket, you must create a bucket of the Standard storage class in the same region. For more information, see Create buckets.

Procedure

Restore backup data to the source OSS bucket or a different OSS bucket:

  1. Log on to the Cloud Backup console.

  2. In the navigation pane on the left, choose Backup > OSS Backup.

  3. In the top menu bar, select the region where the OSS bucket resides.

  4. On the Restore Jobs tab, click Create Restore Job.

  5. In the Create Restore Job panel, specify the Backup Vault and Source Bucket, select a backup that you want to restore, and then click Next.

    image.png

    Note

    Evaluate and select an appropriate historical backup point.

  6. In the Select Backup Files step, configure the Restore Items parameter and click Next.

    恢复规则

    Important

    Check the object list and select the objects to restore to improve accuracy and efficiency.

    • Include All Files: All objects in the source OSS bucket are restored.

    • Include Files or Exclude Files: In the Enter Paths field, specify the objects that you want to restore or do not want to restore from the source OSS bucket.

      In the text box, enter one path in each line. Each path must start with the source folder.

      • If the specified OSS prefix is a/b/ and you want to include or exclude the folder and file.txt objects, enter the following paths:

        a/b/folder
        a/b/file.txt
      • If no OSS prefix is specified and you want to include or exclude the folder and file.txt objects, enter the following paths:

        folder
        file.txt
  7. In the Configure Destination step, configure the parameters and click Create.

    Important
    • You can restore data to the source OSS bucket for free or restore data to a new OSS bucket for free. If you need to restore data to a new OSS bucket, you must create a bucket of the Standard storage class in the same region. For more information, see Create buckets.

    • If you specify a bucket prefix, create the prefix in the OSS console first.

    Parameter

    Description

    Destination Bucket

    Select the OSS bucket to which you want to restore data.

    Destination Path

    Select a bucket prefix. If you do not specify the destination path, the backup data is restored to the root directory of the destination OSS bucket.

    Virus Detection During Restoration

    If enabled, Cloud Backup performs virus detection on all files to be restored. The console provides detailed information about this feature. For more information, see Backup point virus detection.

    When Recovery Items Contain Detected Viruses

    • Do not restore the virus-infected files (You can find secure versions on the Virus Detection tab.)

    • I am aware of the risks and still want to restore all the selected items

    After the restore job is created, view the progress in the Status column on the Restore Jobs tab.

    image.png

What do I do if the Status of the restore job is Failed (The destination path does not exist.)?

The restore job fails because the bucket prefix that you specified in the Destination Path field in the Configure Destination step does not exist. Create a prefix in the OSS console or specify another prefix. Then, re-create the restore job and try again.image.png

References