All Products
Search
Document Center

Cloud Backup:Back up CPFS for AI

Last Updated:Oct 30, 2026

Use Cloud Backup to schedule backups for your CPFS for AI file systems. This topic explains how to create backup plans, monitor backup jobs, verify success, and manage backup content, plans, and recovery points.

Prerequisites

Important
  • Agentless backup for CPFS for AI is currently supported only in the China (Hangzhou) and China (Shanghai) regions. In regions where agentless backup for CPFS for AI is supported, new CPFS for AI backups use only the agentless method. Existing agent-based backup jobs for CPFS for AI have been recategorized as "CPFS General-purpose (agent-based backup)", and they continue to run without interruption.

    Alibaba Cloud will contact you to assist with the upgrade to agentless backup. This upgrade allows you to release backup node resources and reduce costs. To upgrade sooner, submit a ticket.

  • In regions other than China (Hangzhou) and China (Shanghai), only agent-based backup for CPFS for AI is supported. For more information, see Back up CPFS General-purpose.

  • You have activated the Alibaba Cloud Cloud Backup service. No fees are charged for activating Cloud Backup. However, using the CPFS backup feature of Cloud Backup incurs costs such as storage capacity fees. For more information, see Pricing details.

  • You have created a CPFS for AI file system.

Back up CPFS files

Create a backup plan

Note
  • The first backup job after a backup plan is created is a full backup. Subsequent jobs are incremental backups by default.

  • When you create a backup plan or bind a backup policy for the first time, Cloud Backup automatically creates a service-linked role to obtain the necessary permissions. Grant the permissions as prompted in the authorization dialog.

  1. On the CPFS Backup page, click the CPFS for AI tab, and then click Add CPFS Backup.

  2. In the Add CPFS Backup panel, configure the following parameters and click OK.

    Parameter

    Description

    Specify account

    Specify the account to which the CPFS file system belongs. The default value is Current Account. To back up a CPFS file system under another account, first add the target account on the Cross-account Backup page in the console.

    File system type

    Select the type of CPFS file system that you want to back up. Only CPFS for AI is supported.

    File system

    From the drop-down list, select the CPFS for AI file system to back up. You can select only one file system.

    Important

    If your CPFS file system is configured with on-demand data loading (Lazy-load), configuring a backup may trigger unintended data imports. In this case, submit a ticket to contact technical support.

    Source Paths

    Enter the directories to back up. Enter one path per line. For example, enter /data. Enter / to back up the entire file system.

    Filter backup file

    (Optional) Further filter the data to be backed up. The following two types of filter rules are supported and can be configured at the same time:

    • Add Global Filter: A global filter rule applies to files in all backup paths.

    • Add Specified Path Filter: Set a separate filter rule for a specified backup path. This is available only when multiple backup paths are configured.

    Rule description:

    • Each rule consists of a Rule Type (Include or Exclude) and a Matching Mode. If a file matches both an include rule and an exclude rule, the exclude rule takes precedence. Multiple rules have a logical OR relationship, meaning the filter applies if a file matches any rule.

    • The pattern matches the path relative to the backup directory. For example, if the backup directory is /data, /logs refers to /data/logs.

    • Paths are compared segment by segment, separated by /, and the comparison is case-sensitive.

    Common patterns:

    • temp: Matches any file or directory named temp at any level.

    • /temp: Matches a file or directory named temp directly under the backup directory.

    • /*/temp: Matches a file or directory named temp at the second level relative to the backup directory, such as /data/user1/temp.

    • *.log: Matches all .log files at any level.

    • /*.log: Matches all .log files directly under the backup directory.

    • README.md: Matches any file named README.md at any level.

    Backup Policy

    Select a backup policy from the drop-down list.

    Cloud Backup automatically backs up the file system according to the specified backup policy. A backup policy includes settings such as execution time, retention period, special retention rules, keeping at least one backup, automatic archiving, backup vault replication, backup locking, recovery point virus scan, and associated resource tags to help you flexibly manage your backup assets.

    If the default backup policy does not meet your needs, click Create Backup Policy or Edit Policy to manage your policies. For details about the parameters in a backup policy, see Create a backup policy.

    Note: A file system can be associated with only one backup policy at a time. If you select a policy that is already in use, the console displays a message indicating that the data source is already bound to the policy.

After the backup plan is created, Cloud Backup automatically runs backup jobs based on your specified start time and interval.

Backup running status

Backup running status

Description

Ready

The resource has just been added to the list of protected resources and is awaiting its first backup.

Backing Up

The backup plan is active and scheduled to run at the next interval.

Backing Up (In Progress)

A backup job is in progress.

Paused

All backup plans for this resource are paused. You can enable any backup plan in the backup plan list on the backup details page to resume backups.

Inactive

The source resource cannot be found (it may have been released). The backup data is automatically deleted upon expiration, typically within one day. You can view the expiration time or restore data from the Backup History list on the backup details page. The help icon next to the expiration time (displayed only for expired or nearly expired recovery points) provides an explanation of this status.

View backup jobs

At the scheduled backup time, Cloud Backup starts the backup job.

Note

The backup progress percentage is a dynamic estimate and is for reference only. The displayed amount of scanned data may be lower than the actual total while the scan is in progress. Only the final status of the backup job confirms its completion.

On the Backup Jobs tab, a Status of Completed indicates that the backup was successful. You can view details for the backup job, such as Total Scanned Data Amount at Source, Completed Backup Data Amount, Data Amount Written to Backup Vault, and Backup Speed. See the tooltips in the Cloud Backup console for descriptions of these metrics.

Note

Starting June 1, 2025, backup jobs will display both data amount and file count statistics for Total Amount of Data Scanned from Source, Amount of Data Backed Up, and Amount of Data Written to Vault. Jobs completed before this date show only data amount statistics for these metrics.

To cancel a running backup job, click Cancel in the Actions column for that job and confirm the cancellation.

Verify backup success

You can view backup jobs and recovery points on the file system details page. On the CPFS Backup page, click the CPFS for AI tab, select the region where the CPFS file system is located, and then click View Details in its Actions column.

After a backup job runs, confirm its success by using the following methods:

  1. On the Backup Jobs tab, check if the job status is Completed.

  2. In Backup History, verify that a new recovery point has been created and that its size is as expected.

  3. (Optional) Use the Browse feature to view the file directory structure within the recovery point and confirm that the directories containing key files have been successfully backed up.

Manage backup content

On the CPFS Backup page, click the CPFS for AI tab, select the region of the target CPFS file system at the top of the page, and then click View Details in the Actions column for the target file system. On the Backup Details tab, manage your backup content in the Backup History section as needed.

Browse backup files

You can use the Browse feature to view the directory structure of backed-up files. You cannot view the content of files directly.

  1. In Backup History, click Browse in the Actions column of the target recovery point.

    Alternatively, click the image icon on the right side of the Backup History to switch the display mode, then click the target recovery point and select Browse.

  2. In the Browse panel, view the backed-up CPFS file directory structure. To view the file content, you must first restore the files.

Note

You cannot download backed-up files directly. To retrieve them, restore the files to a specified path. For example, during a restore operation, set Restore Path Type to Specify Path and set Destination Path to /temp/path. Create this path before the restore job starts, or the restore fails. After the job completes, the files in that recovery point are available in the specified path.

Delete recovery points

Important
  • Deleting a recovery point is irreversible. Proceed with caution.

  • If the "Keep at least one backup version" setting is enabled in the backup plan, you cannot delete the latest recovery point. To delete it, you must first disable this setting.

  • After a backup plan is deleted, Cloud Backup removes the CPFS file system from the backup list when the last recovery point expires or is deleted.

In the list view of the Backup History, delete recovery points using either of the following methods:

  • Delete a single recovery point: Click Delete in the Actions column for the target recovery point and confirm the deletion.

  • Delete multiple recovery points: Select the target recovery points, click Delete Backup Point below the list, and confirm the deletion.

Alternatively, click the image icon on the right side of the Backup History to switch the display mode, then click the target recovery point and select Delete.

Manage backup plans

On the CPFS Backup page, click the CPFS for AI tab, select the region where the target CPFS file system is located, and then click View Details in the Actions column for the target file system. On the details page, switch to the Backup Plans tab to manage your backup plans. The operations in the ⋮ menu are batch operations that require you to select at least one backup plan first. If no plan is selected, a message prompts you to select at least one item.

Run a backup immediately

Select the target backup plan, and from the ⋮ > Actions > Run Now to start a backup immediately. If the backup plan is configured with multiple backup paths, select the path you want to back up in the dialog box that appears.

Modify a backup plan

  1. Click Modify in the Actions column of the backup plan.

  2. In the Configure Plan panel, modify the basic settings and backup policy as needed.

  3. Click OK.

Pause or resume a backup plan

Backup plans are enabled by default. If you need to stop data backups for a specific period, you can pause the backup plan. You can enable it again when you need to resume backups.

  • Pause a backup plan: Select the target backup plan, and from the ⋮ > Actions > Suspend Plan. Then, confirm the operation.

    After a plan is paused, subsequent backup jobs will not run. Existing recovery points are not affected and will expire automatically based on the retention period. If "Keep at least one backup version" is enabled, the retention period does not apply to the last recovery point. If recovery points for the CPFS file system still exist after the backup is paused, you will continue to be billed for the storage they consume.

  • Resume a backup plan: After pausing a backup plan, select it, and from the ⋮ > Actions > Resume Plan.

Alert settings

Select the target backup plan, and from the ⋮ > Actions > Alert Settings to configure alert notifications for backup jobs. For more information, see Configure alert rules for CPFS backup.

Delete a backup plan

If you no longer need to perform periodic backups for a resource, you can delete its backup plan.

Important

Deleting a backup plan is irreversible. Proceed with caution.

Select the target backup plan, and from the ⋮ > Actions > Delete Plan. Then, confirm the operation.

Stop CPFS backups

To stop backing up a CPFS file system, simply delete the backup plan and all associated recovery points.

Enterprise capabilities

Virus scan

To prevent infected files from being restored to your production environment, Cloud Backup provides the Backup point virus detection feature. This helps you select an uninfected backup point for future restores. On the Backup Details tab, in the Backup History section, find the backup point you want to scan, click ┇ in the Actions column, and then select Virus Detection.

For CPFS for AI backups, you can perform a virus scan on a recovery point in one of the following two ways:

  • Automatic scan based on a backup policy: Enable Backup Point Virus Detection in your backup policy. After this is enabled, a virus scan is automatically performed on the backup data after each scheduled backup is completed.

  • On-demand manual scan: In the Backup History section of the Backup Details tab, select a target recovery point to initiate a virus scan. You can also view the scan results for all recovery points on the Virus Scan tab.

Note

The Backup Point Virus Detection feature is a paid service that is billed based on the number of scanned files. A scan job cannot be canceled after it starts. Backup files larger than 100 MB are skipped. For more information, see Recovery point virus scan.

Backup vault replication

To prevent regional disasters or account management risks from affecting business continuity, Cloud Backup supports configuring Cross-region backup or Cross-account backup vault replication for backup vaults where the Storage Vault Type is General Backup. Once configured, data from the source backup vault is automatically synchronized to the destination backup vault, ensuring data consistency between the two locations. You can also perform cross-region data recovery from the destination backup vault as needed.

For general-purpose backup vaults that store CPFS backups, you can configure backup vault replication to achieve cross-region or cross-account disaster recovery.

Troubleshoot backup errors

If a backup plan or job has an abnormal Status, consider the following suggestions:

  • Follow the prompts in the console to check and correct your configuration. Pay close attention to the backup paths, file filtering rules, and backup policy.

  • The status of the backup resource is Inactive. This is usually because the original file system has been released. The backup data will be automatically deleted after it expires. To retrieve an unexpired recovery point, you can initiate a restore from the Backup History section on the Backup Details tab. For more information, see Restore CPFS for AI.

Related documents