获取备份下载链接

功能介绍

获取备份下载链接。

调用接口前，您需要了解API 认证鉴权。
调用接口前，您需要了解请求Header参数说明。

接口约束

该接口支持查询RDS for MySQL的全量备份文件下载链接和Binlog备份文件下载链接、RDS for PostgreSQL的全量备份文件下载链接和增量备份文件下载链接、RDS for SQL Server的全量备份文件下载链接和增量备份文件下载链接。

URI

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

参数说明

表1 参数说明
名称	是否必选	说明
project_id	是	参数解释：租户在某一Region下的项目ID。获取方法请参见获取项目ID。约束限制：不涉及。取值范围：不涉及。默认取值：不涉及。
backup_id	是	参数解释：备份ID。约束限制：不涉及。取值范围：不涉及。默认取值：不涉及。

请求消息

请求参数
 无。

URI样例
 GET https://{endpoint}/v3/97b026aa9cc4417888c14c84a1ad9860/backup-files?backup_id=c0c9f155c7b7423a9d30f0175998b63bbr01

响应消息

正常响应要素说明

表2 要素说明
名称	参数类型	说明
files	Array of objects	参数解释：备份包含的文件列表。详情请参见表3。
bucket	String	参数解释：文件所在的桶名。取值范围：不涉及。

表3 files字段数据结构说明
名称	参数类型	说明
name	String	参数解释：文件名。取值范围：不涉及。
size	Long	参数解释：文件大小，单位：KB。取值范围：不涉及。
download_link	String	参数解释：文件下载链接。取值范围：不涉及。
link_expired_time	String	参数解释：下载链接过期时间，格式为“yyyy-mm-ddThh:mm:ssZ”。其中，T指某个时间的开始，Z指时区偏移量。取值范围：不涉及。

正常响应样例

{
   "files": [
    {
        "name": "43e4feaab48f11e89039fa163ebaa7e4br01.xxx",
        "size": 2803,
        "download_link":"https://obs.domainname.com/rdsbucket.username.1/xxxxxx",
        "link_expired_time":"2018-08-16T10:15:14+0800"
     }
     ],
    "bucket": "rdsbucket.bucketname"
}