Using Download URL

Scenarios

DDS supports backup downloading, giving users greater control over their data. It allows you to manage the backup lifecycle independently while meeting enterprise-level requirements for disaster recovery, migration, and compliance. You can download manual or automated backup files using the URL provided by DDS to a local device for backup or restoration.

Precautions

Backups downloaded from the DDS console are all full backups.

Procedure

1. Log in to the management console.
2. Click in the upper left corner and select a region and a project.
3. Click in the upper left corner of the page and choose Databases > Document Database Service.
4. In the navigation pane on the left, choose Backups.
5. On the Backups page, click the Clusters, Replica Sets, or Single Nodes tab, locate the available backup you want to download and click Download in the Operation column.
6. In the displayed dialog box, select Use Download URL for Download Method, click to copy the URL, and click OK.
   Figure 1 Selecting a download method
   

   A valid URL for downloading the backup data is displayed.

   • You can use various download tools, such as your browser and Xunlei to download backup files.
   • You can also run a wget command to download backup files:

     wget -O FILE_NAME --no-check-certificate "DOWNLOAD_URL"

     Parameter description:

     FILE_NAME is the new name of the downloaded backup file. The original backup file name may be too long and exceed the maximum characters allowed by the client file system, so you are advised to rename the backup file.

     DOWNLOAD_URL is the location of the backup file to be downloaded. If the location contains special characters, escape is required.

7. After the backup file is downloaded, decompress it using LZ4.

   Run the following command to decompress the backup file:

   lz4 -d $1 | tar -xC $2

   $1: indicates the downloaded backup file.

   $2: indicates the directory to which the backup file is decompressed.

8. You can restore data locally as required.
   For details, see the following documentation.

   • Restoring a Cluster Backup to an On-premises Database
   • Restoring a Replica Set Backup to an On-Premises Database

Related APIs