All Products
Search
Document Center

Cloud Backup:Restore a CPFS for Lingjun file system

Last Updated:Oct 30, 2026

After you use Cloud Backup to back up the files of a CPFS for Lingjun file system to a cloud backup vault, you can restore all files or some files that meet specified conditions from a historical backup point to the source file system or a new CPFS for Lingjun file system if files in the file system are lost or damaged.

Prerequisites

Important
  • CPFS for Lingjun (agentless backup) is currently available only in the China (Hangzhou) and China (Shanghai) regions. In regions where CPFS for Lingjun (agentless backup) is available, new CPFS for Lingjun backup jobs use only the agentless method. Existing CPFS for Lingjun (agent-based backup) jobs are now managed under the CPFS General-purpose Edition (agent-based backup) category, and these jobs continue to run without impact.

    We will contact you in phases to help you upgrade to agentless backup. After the upgrade, you can release backup node resources and reduce solution costs. To upgrade earlier, submit a ticket.

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

  • You have completed Back up a CPFS for Lingjun file system.

  • You have obtained the permissions required to use Cloud Backup. If you use a RAM user to perform the operations, make sure that the RAM user is granted the required Cloud Backup permissions.

Billing

Restoring data is free of charge. For more information, see Billing methods and billable items.

If you enable Perform virus scan during restoration, you are charged a virus scan fee based on the number of scanned files (approximately CNY 1.50 per 1,000 files). For more information, see CPFS backup pricing.

Usage notes

  • The restore speed depends on the number and size of the files. Restoring a large number of files may take a long time. For more information, see File backup and restore speed (data from the test environment, for reference only).

  • When you restore files to the original path or a specified path, if files with the same name exist in the destination path, you can choose to skip them, overwrite them, or compare modification times and keep the latest version. We recommend that you check the existing data in the destination path before you restore files.

Create a restore job

  1. Log on to the Cloud Backup console.

  2. In the left-side navigation pane, choose Back Up>CPFS Backup.

  3. In the upper-left corner of the top navigation bar, select the region.

  4. On the CPFS for Lingjun Agentless Backup tab, find the target file system and click View Details in the Actions column to go to the file system details page.

  5. On the Backup Details tab, in the Backup History section, click Restore in the Actions column of the target backup point.

    Note
    • Select an appropriate historical backup point. The backup data may differ between backup points. You can still restore from a backup point that has expired but has not been automatically deleted.

    • The Actions column in the backup history also provides options such as Browse, Delete, and Virus Scan. The Browse option lets you view the file directory structure in a backup point before you restore files; it does not support viewing file content directly.

  6. In the Create Restore Job panel, follow the wizard to complete the following operations.

    1. Select Select Restore Items, and then click Next.

      Parameter

      Description

      Restore Items

      Configure the files or folders to restore. The restore rules include the following three options, which are mutually exclusive and only one can take effect at a time:

      • Include All Files: Restores all files in the source file system.

      • Include Files or Exclude Files: You can manually enter a list of files to include or exclude, and Cloud Backup then restores the specified files based on the rule.

        • Manually enter a file list

          Enter one path per line. Each line must start with the last folder in the source backup path.

          • Restore specified files

            For example, if the backup path is folder/test/data and you want to restore file.txt and abc.png in the data directory, enter the following in the file list:

            /data/file.txt
            /data/abc.png
          • Restore a specified directory

            For example, if the backup path is folder/test/data and you want to restore all files and subdirectories in the data directory, enter the following in the file list:

            /data/
          • Restore files or directories that match a wildcard

            For example, if the backup path is folder/test/data and you want to restore files or subdirectories in the data directory whose names start with abc, enter the following in the file list:

            /data/abc*
    2. In Restore Destination, select the file system to which you want to restore files, and then click Next.

      • Specify Account: If cross-account backup is configured, you can use this option to specify the account to which the destination resource belongs. The default value is Current Account. You can change it to an account that has been added for backup.

      • File System: Only one file system can be selected. You can restore to the source file system or to another CPFS for Lingjun file system in the same account. You do not need to add a data source in advance.

    3. Configure Destination Path, and then click OK.

      Important

      Make sure that the restore path exists. Otherwise, the restore job fails.

      Parameter

      Description

      Restore Path Type

      • Specify Path: Restores files to a specified path. After you select this option, enter the destination path in Destination Path, for example, /cpfs/abc.

      • Origin Path: Restores files to the original path where they were backed up.

      If a file with the same name exists in the restore path

      Select how to handle a file with the same name in the destination path:

      • Skip this file: Does not restore the file with the same name. The existing file in the destination path is retained.

      • Overwrite the file with the same name in the restore path: Overwrites the file with the same name in the destination path with the backup data.

      • Compare modification times (accurate to the second) and keep the latest version: Compares the modification time of the backup file with that of the target file and restores only the newer version.

      Perform virus scan during restoration

      If you enable this option, Cloud Backup scans all files to be restored for viruses and handles them as follows: Files detected as safe are restored, and files detected as viruses are not restored. We recommend that you go to the Virus Scan page to view risky files and find a safe version to restore.

      Note

      Virus scan for backup points is a paid feature and is billed based on the number of scanned files. Plan your budget accordingly to avoid overdue payments on your account.

    After you create the restore job, you can view its progress in the Status column on the Restore Jobs tab. For a running job, click Cancel in the Actions column.