You need to enable JavaScript to run this app.
导航
GetBackupDownloadLink
最近更新时间:2024.01.15 19:02:14首次发布时间:2023.02.02 17:41:21

调用 GetBackupDownloadLink 接口获取备份下载链接。

说明

获取备份下载链接前,需要先调用 DescribeBackups 接口获取数据备份文件的 BackupId,或调用 DescribeBinlogFiles 接口获取 Binlog 备份文件的 FileName。

请求类型

同步请求。

请求参数

名称类型是否必选示例值描述
InstanceIdStringmysql-ce48081d****实例 ID。

BackupId

String

BackupId 示例:f1f2284117a344a38370c37b841fec75
FileName 示例:binlog-1683420632178737071-binlog.000044

  • 如果下载的是数据备份,该字段的值为备份文件的 BackupId,可通过调用 DescribeBackups 接口获取;
  • 如果下载的是 Binlog 备份,该字段的值为备份文件的 FileName,可通过调用 DescribeBinlogFiles 接口获取。

说明

批量获取 Binlog 备份链接时,多个 FileName 之间使用英文逗号(,)分隔。

返回参数

名称类型示例值描述
InstanceIdStringmysql-ce48081d****实例 ID。
BackupIdStringBackupId 示例:f1f2284117a344a38370c37b841fec75
FileName 示例:binlog-1683420632178737071-binlog.000044

BackupType

String

Full

备份类型,取值:

  • Full:全量备份。
  • Increment:增量备份。
BackupFileNameStringfull-16347766163043687****.xbstream备份文件名。
BackupFileSizeInteger1024备份文件大小,单位为 GB。
BackupDownloadLinkStringhttps://xxxxxx备份下载链接。
LinkExpiredTimeString2022-01-01T10:10:10Z下载链接过期时间,格式: yyyy-MM-dd HH:mm:ss(UTC 时间)。
DownloadProgressInteger10备份文件准备进度,单位为 %。

请求示例

POST /?Action=GetBackupDownloadLink&Version=2022-01-01 HTTP/1.1
Accept: application/json
Content-Type: application/json
Host: rds.volcengineapi.com
X-Date: 20211202T101010Z
Authorization: HMAC-SHA256 Credential=AKLTN2I0MmFiNzMxNWE5NDgzMzk4MmVjMTVkODlkZTZjMzY/20211202/cn-beijing/rds_mysql/request, SignedHeaders=x-date, Signature=71d31fc7bcf990142851c9833c5656391486cda0ae2e0b8ada733b7c645aff88

{
    "InstanceId": "mysql-ce48081d****",
    "BackupId": "541631e5f0614267a04d63d096a3****"
}

返回示例

正常返回示例

{
    "ResponseMetadata": {
        "RequestId": "20230111114418DB36CB9353CB1E84B4CC",
        "Action": "GetBackupDownloadLink",
        "Version": "2022-01-01",
        "Service": "rds_mysql",
        "Region": "cn-beijing"
    },
    "Result": {
        "BackupDownloadLink": "http://rds-mysql-bj.s3.cn-beijing.amazonaws.com/rds/mysql-ce48081d****/mysql-ce48081d****-sd17e-0/merge/full-1673380140045452608.xbstream?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKLTMDcyNTA4YzIwYWUxNDkzNDhmYzRkNDU1NmUwZGUxNmE%2F20230111%2Fcn-beijing%2Fs3%2Faws4_request&X-Amz-Date=20230111T034418Z&X-Amz-Expires=900&X-Amz-SignedHeaders=host&X-Amz-Signature=8b75aee7068b06ebc3b839f57ff4a0c9db3b7e7f74e0d67efa2de5202fdfae3d",
        "BackupFileName": "",
        "BackupFileSize": 0,
        "BackupId": "541631e5f0614267a04d63d096a3****",
        "BackupType": "Full",
        "DownloadProgress": 100,
        "InstanceId": "mysql-ce48081d****",
        "LinkExpiredTime": "2023-01-18T03:41:01.000Z"
    }
}

错误码

更多详情,请参见错误码