Updated on 2024-04-11 GMT+08:00

Obtaining the Link for Downloading a Backup File

Function

This API is used to obtain the link for downloading a backup file.

  • Before calling an API, you need to understand the API in Authentication.

Constraints

This API is used to query full and incremental backups of DB instances.

URI

  • URI format

    GET /v3/{project_id}/backup-files?backup_id={backup_id}

  • Example

    https://{Endpoint}/v3/97b026aa9cc4417888c14c84a1ad9860/backup-files?backup_id=c0c9f155c7b7423a9d30f0175998b63bbr01

  • Parameter description
    Table 1 Parameter description

    Name

    Mandatory

    Description

    project_id

    Yes

    Specifies the project ID of a tenant in a region.

    For details about how to obtain the project ID, see Obtaining a Project ID.

    backup_id

    Yes

    Specifies the backup ID.

Request

None

Response

  • Normal response
    Table 2 Parameter description

    Name

    Type

    Description

    files

    Array of objects

    Indicates the list of backup files.

    For details, see Table 3.

    bucket

    String

    Indicates the name of the bucket where the file is located.

    Table 3 files field data structure description

    Name

    Type

    Description

    name

    String

    Indicates the file name.

    size

    Long

    Indicates the file size in KB.

    download_link

    String

    Indicates the link for downloading the backup file.

    link_expired_time

    String

    Indicates the link expiration time. The format is "yyyy-mm-ddThh:mm:ssZ".

  • Example normal response
    {
       "files": [
        {
            "name": "43e4feaab48f11e89039fa163ebaa7e4br01.xxx",
            "size": 2803,
            "download_link":"https://obs.domainname.com/rdsbucket.username.1/xxxxxx",
            "link_expired_time":"2018-08-016T10:15:14+0000"
         }
         ],
        "bucket": "rdsbucket.bucketname"
    }
  • Abnormal response

    For details, see Abnormal Request Results.

Status Code

Error Code

For details, see Error Codes.