ApsaraDB for MongoDB:Download a backup file

Applicability

The MongoDB instance must meet the following requirements:

• Service architecture: Replica set (excluding single-node) or sharded cluster.

• Storage type: ESSD cloud disk.

• Status: Running.

• The instance is in one of the following regions (public cloud only): China (Chengdu), China (Guangzhou), China (Qingdao), China (Beijing), China (Shanghai), China (Zhangjiakou), China (Hangzhou), China (Shenzhen), China (Hong Kong), Malaysia (Kuala Lumpur), Indonesia (Jakarta), Japan (Tokyo), Singapore, Germany (Frankfurt), US (Silicon Valley), or US (Virginia).

• The backup data is not encrypted.

• If you use a Resource Access Management (RAM) user, the user must have permissions to download backup files.

  How do I grant permissions to a RAM user?

  1. Log on to the RAM console using your Alibaba Cloud account.

  2. In the navigation pane on the left, choose Permission Management > Policies.

  3. Click Create Policy, select the Script tab, enter the following policy content, and then click OK.

     {
       "Statement": [
         {
           "Effect": "Allow",
           "Action": "dds:Describe*",
           "Resource": "*"
         },
         {
           "Effect": "Allow",
           "Action": [
             "dbs:CreateDownload",
             "dbs:DescribeDBInstanceDownloadSize",
             "dbs:DescribeDownloadSupport"
           ],
           "Resource": "*"
         }
       ],
       "Version": "1"
     }

  4. In the Create Policy dialog box, enter a Name and Note for the policy. Confirm that the policy content is correct and click OK again.

  5. In the navigation pane on the left, choose Permission Management > Authorization.

  6. Click Grant Permission and grant the newly created policy to the RAM user. For more information, see Grant permissions to a RAM user on the Authorization page.

  7. Click OK.

Supported data for instance backup downloads

• Unsupported:

  • The admin, local, or config system databases.

  • System tables that start with "system.".

  • Views or functions.

  • Time-series collections.

• Supported: Collections (non-time-series) and index information.

Procedure

1. Navigate to the backup list

   1. Go to the ApsaraDB for MongoDB replica set instances or sharded cluster instances list. Select a resource group and a region at the top of the page, and then click the ID of the target instance.

   2. In the navigation pane on the left of the instance details page, click Backup and Restoration.

   3. click Backup Download List.

2. Start the download task: On the Backup Download List tab, click Download Instance Backup.

3. Configure the download parameters

   1. In the Download Point-in-time and Backup Set step, select the required Backup Set and click Next.

   2. In the Download Instance, Database, and Table step, keep the default setting (Instance Download) and click Next.

   3. In the Download Destination and Format step, configure the download destination and format.

      Download Destination	Configuration
      OSS (Recommended)	Select Write data to your OSS. Enter the bucket name and folder prefix for the destination OSS. Only the Standard storage class for OSS is supported. To convert the storage class, see Convert storage class. Set Download Format to the default value BSON. If this is your first time using this feature, click Authorize > Agree to Authorization as prompted to grant ApsaraDB for MongoDB permissions to access OSS.
      URL	Select URL. Select a download format. After the task is successful, you must manually generate a download link. The link is valid for a limited time.

4. Confirm and execute Read and select the notice, and then click Complete. You are redirected to the Backup Download List tab, where you can monitor the task status.

5. Obtain the backup file

   • OSS method: Wait for the task status to change to Successful. The file is automatically saved to the specified OSS bucket and folder.

   • URL method: Wait for the task status to change to Successful. The download task is valid for 3 days. During this period, click Generate Link in the Download Destination column. Set the validity period of the link, which can be from 5 minutes to 1 day. The default is 2 hours. You can then obtain the internal or external download URL. After the task and the link expire, the temporary data is automatically deleted. You must start a new download task to obtain the file.

   Important

   The download may fail if computing resources cannot be allocated due to contention on the service side. The download may also fail because of unsupported data formats. If a task fails, you can retry the download task or contact Data Disaster Recovery support.

6. Download the file using a command-line tool

   After you obtain the download URL:

   • Use a command-line tool such as wget or curl to download the file (Recommended). For more information, see Appendix 1: Download commands in this topic.

   • For small files, you can copy the external download URL to the address bar of your browser.

Applicability

1. You can download backup files only for local disk instances that run MongoDB 4.2 or earlier.

2. Backup file downloads are supported for only Physical Backups and Logical Backups, but not for Snapshot Backups. To download backup files for other instances, see What do I do if my instance does not support backup file downloads?.

Procedure

1. Navigate to the backup list

   1. Go to the ApsaraDB for MongoDB replica set instances or sharded cluster instances list. Select a resource group and a region at the top of the page, and then click the ID of the target instance.

   2. In the navigation pane on the left of the instance details page, click Backup and Restoration.

2. Start a download task

   1. On the Full Backup tab, find the target backup file and click Download in the Actions column.

   2. In the Download Backup dialog box that appears, Copy the Public Connection String or Private Connection String as required.

   3. Click OK.

3. Download the file using a command-line tool

   After you obtain the download URL:

   • Use a command-line tool such as wget or curl to download the file (Recommended). For more information, see Appendix 1: Download commands in this topic.

   • For small files, you can copy the external download URL to the address bar of your browser.

Download a backup file on Windows or macOS

Paste the download URL of the backup file into the address bar of your browser and press Enter. The browser automatically downloads the backup file.

Download a backup file on Linux

wget -c '<Backup_file_download_URL>' -O <Custom_file_name><File_name_extension>

wget -c 'http://rdsbak-hz-v3.oss-cn-hangzhou-internal.aliyuncs.com/custins5475****/hins1907****_data_20210906103710_qp.xb?Expires=......' -O backupfile._qp.xb