All Products
Search
Document Center

Cloud Backup:Back up OSS objects

Last Updated:May 27, 2026

Cloud Backup protects objects in your OSS buckets from accidental deletion, modification, or overwriting. Flexible backup policies automate scheduled backups and let you restore data at any time.

Prerequisites

  • Cloud Backup has been activated. Activation is free, but OSS backup incurs Cloud Backup storage fees and OSS request fees. The request fees are billed by OSS. OSS backup fees.

  • An OSS bucket of the Standard or Infrequent Access (IA) storage class has been created. For more information, see Create buckets.

Usage notes

  • When you first create a backup plan or attach a backup policy, Cloud Backup creates a service-linked role for Cloud Backup (AliyunServiceRoleForHbrOssBackup) to access related resources. Grant the required permissions in the authorization dialog box.

  • Before you use Cloud Backup to protect OSS data, note the following:

    • Cloud Backup supports backing up and restoring Standard and IA buckets. Archive, Cold Archive, and Deep Cold Archive buckets are not supported.

    • Cloud Backup supports backing up and restoring Standard and IA objects. IA objects are restored as Standard. Archive, Cold Archive, and Deep Cold Archive objects are not supported.

  • Cloud Backup does not back up or restore object access control lists (ACLs).

    • Cloud Backup incurs OSS request fees for API operations called during backup. These fees are billed by OSS. For more information, see Billing overview.

    • When Cloud Backup reads IA bucket or object data for backup, you incur OSS data retrieval fees based on retrieved data volume. These fees are billed by OSS. For more information, see Data processing fees.

    • Deleting an earlier backup version from the history does not affect the data integrity of other versions.

    • The scheduled backup plan enabled when you create an OSS bucket is a 30-day free trial, automatically disabled upon expiration. Switch to a paid plan before it expires.

      Important

      The free trial does not support backup policies, and its source path and backup cycle are fixed. The trial uses an isolated backup vault that cannot be changed or merged after converting to a paid plan. To consolidate all backups into a single vault, start directly with a paid plan.

Create a backup plan to periodically back up OSS objects

Note

The first backup job performs a full backup. Subsequent jobs are incremental by default.

To create a backup plan:

  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 OSS Backup page, click Create Backup Plan.

  5. In the Create Backup Plan panel, configure the parameters as described in the following table and click OK.

    Note
    • A 30-day free trial begins on the day you create the plan. For example, a plan created on February 14, 2020 is free until March 15.

    • The free trial has limitations: source path and backup cycle are fixed. The trial uses an isolated vault that cannot be changed or merged after converting to a paid plan. To use a unified vault, start with a paid plan.

    The following describes parameters for a paid plan. Free plan configuration is similar.

    1. Click Switch to Paid Plan.

    2. Configure the basic settings.

      Important
      • In regions that support backup policies, backup plans must be attached to a policy that governs periodic backup of your OSS data.

      • In the navigation pane on the left of the console, click Policy Center to view the regions that support backup policies. For more information about how to create a backup policy, see Create a backup policy.

      Parameter

      Description

      Source OSS Bucket

      Select the OSS bucket to back up. Cloud Backup lists all buckets in the current region.

      Source Path

      Select a bucket directory. By default, all files in the root directory are backed up.

      Backup Policy

      Select a backup policy from the drop-down list.

      Cloud Backup backs up data based on the configured policy. A backup policy defines vault encryption, backup interval, retention period, cross-region replication, automatic archiving, and backup point virus detection.

      To customize, click Create Backup Policy or Edit Policy. For more information about backup policy parameters, see Policy center.

      Performance Optimization

      Use OSS Inventory

      Enables OSS inventory for backup. Default: No. For large datasets, back up a large amount of OSS objects using the OSS inventory feature.

    After creation, the plan status is Running. Cloud Backup runs backup jobs based on the specified schedule.

Verify backup results

  • At the scheduled time, Cloud Backup runs the backup job.

    Note

    The backup progress percentage is a dynamic estimate based on the current data volume and is for reference only. It does not represent the exact completion ratio. During the backup process, the total scanned size displayed may be smaller than the actual total data volume because the data scan may not be complete. Rely on the final job status to confirm completion.

    On the Backup jobs tab, if the Status of a backup job is Completed, the backup is successful.

    You can view details about the backup job, such as Total scanned size, Backup completion size, Backup vault written size, and Backup speed. For more information about these metrics, see the tooltips in the Cloud Backup console.

    Note
    • For backup jobs completed on or after June 1, 2025, Cloud Backup displays statistics for both data volume and file count for Total scanned size, Backup completion size, and Backup vault written size. For backup jobs completed before this date, these metrics show only data volume statistics.

    • The job list displays only backup job records from the last six months. To view older jobs, export them from the Audit Report page.

    image

  • On the Backup Plans tab, click the image icon next to the target bucket to view backup records and backup points in the Backup History section. You can OSS objects can be restored from these backup points.

    image

Partially Completed status

A Partially Completed status means Archive, Cold Archive, and Deep Cold Archive data was excluded because Cloud Backup does not support these storage classes.

image

Troubleshooting

If the Status of a backup plan or job is abnormal, resolve it as follows.

  • Backup job Status: Failed (The OSS bucket does not exist.)

    This indicates the OSS bucket was deleted.

    • If the deletion was intentional, ignore the backup job status. To avoid additional storage fees, navigate to the Storage Vaults page and delete the corresponding backup vault.

    • If the bucket was deleted by mistake, create a new OSS bucket in the same region and use it as the restore destination. Create an OSS restore job.image.png

    • Backup plan Status: Suspended

      A Suspended status means the backup plan is paused and your bucket is unprotected. Resume it immediately to restore data protection.

Browse and download backup files

  • Browse backup files

    The Browse feature lets you view backed-up files. If virus detection was performed, infected files are marked.

    1. On the Backup Plans tab, click the image icon next to the target OSS bucket.

    2. In the Backup History section, find the backup point that corresponds to the desired point in time and click Browse.

    image

  • Download backup files

    Backed-up files cannot be downloaded directly. Restore them to a temporary path in an OSS bucket first.

Extend the retention period of a backup point

Extend the retention period of a backup point to keep historical OSS backup data longer.

Note
  • The retention period of a backup point can only be extended. It cannot be shortened.

  • The retention period of a backup point that is set to never expire cannot be extended.

  1. On the Backup Plans tab, click the image icon next to the target OSS bucket.

  2. In the Backup History section, find the backup point whose retention period you want to extend. Set the expiration time to a specified time or select Never Expire.

    image

  3. Click Save.

After you extend the retention period, view the new expiration time in the Expires At column.

image

Virus detection

Cloud Backup's Backup Point Virus Detection scans backup points for threats, helping you select a clean version for restoration. For more information, see Backup point virus detection.

Backup vault replication

To prevent regional disasters or account management risks from affecting business continuity, Cloud Backup allows you to configure cross-region backup or cross-account replication for backup vaults where the Backup Vault Type is Standard. After you complete the configuration, data in the source backup vault is automatically synchronized to the destination backup vault to ensure data consistency between the two locations. You can also perform on-demand cross-region data recovery from the destination backup vault.

Backup vault replication enables cross-region or cross-account disaster recovery for OSS backup vaults. OSS backup also offers enterprise features including Cross-account backup, Automatic archiving, KMS encryption, and Immutable backup.

More operations

The following operations are available in the Actions column on the Backup Plans tab.

Operation

Description

Backup History

View all or the last three months of backup records for the bucket.

Execute Immediately

Immediately run a backup plan.

Edit

Modify a backup plan.

Suspend Plan

Suspend a running backup plan.

Resume Plan

Resume a suspended backup plan.

Delete Plan

Delete a backup plan. The plan stops running, but backed-up data is retained.

Alert Settings

Cloud Backup sends alert notifications by default when a backup fails or the server connection is lost. For more information, see Set alerts for local file backups.

Restore OSS objects

See Restore OSS objects.

References