You need to enable JavaScript to run this app.
导航
云数据库 MySQL 版
  • 文档首页
    • /
  • 云数据库 MySQL 版

GetBackupDownloadLink

最近更新时间：2024.01.15 19:02:14

首次发布时间：2023.02.02 17:41:21

我的收藏

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

说明

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

请求类型

同步请求。

请求参数

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

BackupId

String

是

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

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

说明

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

返回参数

名称类型示例值描述
InstanceIdStringmysql-ce48081d****实例 ID。
BackupIdString是BackupId 示例：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"
    }
}

错误码

更多详情，请参见错误码。