云数据库 RDS

产品文档

云数据库 RDS

帮助中心 > OpenAPI & SDK > 云数据库 RDS > describeBackupDownloadURL

describeBackupDownloadURL

描述

获取整个备份或备份中单个文件的下载链接。
- 当输入参数中有文件名时,获取该文件的下载链接。
- 输入参数中无文件名时,获取整个备份的下载链接。
由于备份机制的差异,使用该接口下载备份时,SQL Server必须输入文件名,每个文件逐一下载,不支持下载整个备份。SQL Server备份中的文件名(不包括后缀)即为备份的数据库名。例如文件名为my_test_db.bak,表示该文件是my_test_db数据库的备份。
MySQL可下载整个备份集,但不支持单个文件的下载。

请求方式

GET

请求地址

https://rds.jdcloud-api.com/v1/regions/{regionId}/backups/{backupId}:describeBackupDownloadURL

名称 类型 是否必需 默认值 描述
regionId String True 地域代码,取值范围参见《各地域及可用区对照表》
backupId String True 备份ID

请求参数

名称 类型 是否必需 默认值 描述
fileName String False 文件名称
- MySQL:不支持该参数
- SQL Server:必须输入该参数,指定该备份中需要获取下载链接的文件名称。备份中的文件名(不包括后缀)即为备份的数据库名。例如文件名为my_test_db.bak,表示该文件是my_test_db数据库的备份
urlExpirationSecond String False 指定下载链接的过期时间,单位秒, 取值范围为 1 ~ 86400 秒;支持 SQL Server:缺省为 86400 秒。支持 MySQL, Percona, MariaDB:缺省为 300 秒。

返回参数

名称 类型 描述
result Result

Result

名称 类型 描述
publicURL String 公网下载链接,若当前不可下载,则为空串
internalURL String 内网下载链接,若当前不可下载,则为空串

返回码

返回码 描述
200 OK

请求示例

GET

public void testDescribeBackupDownloadURL() {
    DescribeBackupDownloadURLRequest describeBackupDownloadURLRequest = new DescribeBackupDownloadURLRequest();
    describeBackupDownloadURLRequest.setBackupId("dcd25cd6-a787-4fea-8e89-1451ba600591");
    describeBackupDownloadURLRequest.setRegionId("cn-north-1");
    DescribeBackupDownloadURLResponse response = rdsClient.describeBackupDownloadURL(describeBackupDownloadURLRequest);
    System.out.println(new Gson().toJson(response));
}

返回示例

{
    "requestId": "bpa32pwe54627hpuqdmbvkaafiii38sf", 
    "result": {
        "internalURL": "http://oss-internal.cn-north-1.jcloudcs.com/trove-online-hb/233f1965-3a30-4d8c-a618-25c6f286a96e/backup/dcd25cd6-a787-4fea-8e89-1451ba600591.xbstream?Expires=1578381967&AccessKey=872DED479C1C41757FDCC3A7542BE694&Signature=UxVL6fP+x/WLFMQ/fpUugtQ2MSM=", 
        "publicURL": "http://oss.cn-north-1.jcloudcs.com/trove-online-hb/233f1965-3a30-4d8c-a618-25c6f286a96e/backup/dcd25cd6-a787-4fea-8e89-1451ba600591.xbstream?Expires=1578381967&AccessKey=872DED479C1C41757FDCC3A7542BE694&Signature=UxVL6fP+x/WLFMQ/fpUugtQ2MSM="
    }
}
更新时间:2020-01-19 16:57:34
feedback