云数据库 RDS

云数据库 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