Help Center> Distributed Cache Service> API Reference> Backup and Restoration APIs> Obtaining Backup File URLs
View PDF

Obtaining Backup File URLs

Function

This API is used to obtain the download links of backup files.

This API is available only in the CN North-Beijing4 region.

URI

POST /v1.0/{project_id}/instances/{instance_id}/backups/{backup_id}/links

Parameter

Mandatory

Type

Description

project_id

Yes

String

Project ID.

instance_id

Yes

String

Instance ID.

backup_id

Yes

String

Backup ID obtained by calling the API for Querying DCS Instance Backup Records.

Request

Request parameters

Parameter

Mandatory

Type

Description

expiration

Yes

String

Validity period (in seconds) of a URL. The value must be within 5 minutes and 24 hours.

Example request

{
	"expiration":300
}

Response

If the status code is 200, the response parameters and example responses are as follows:

Response parameters

Parameter

Type

Description

bucket_name

String

OBS bucket name.

file_path

String

Paths of files in the OBS bucket.

links

Array

Collection of URLs for downloading backup files. A maximum of 64 links are allowed.

Parameter

Type

Description

file_name

String

Backup file name.

link

String

URL for downloading backup files.

Example response

{
    "bucket_name": "bucket6d1b61f3d7434f60b7e465f4037d73f3",
    "file_path": "3dc6ba15-ba97-4624-bcbd-3cc08d6336b0/20190924204307_redis.rdb",
    "links": [
        {
            "file_name": "20190924204307_redis.rdb",
            "link": "https://bucket6d1b61f3d7434f60b7e465f4037d73f3.obs.cn-north-4.myhuaweicloud.com:443/3dc6ba15-ba97-4624-bcbd-3cc08d6336b0/20190924204307_redis.rdb?AWSAccessKeyId=IMRORRY3GETV9CEH3GE0&Expires=1569329601&Signature=NGhdEGwHImXNyYyryx3AYqfAvoA%3D"
        }
    ]
}

Return Value

Return Value

Description

200

Successfully obtained backup file URLs.