调用DescribeAvailableRecoveryTime接口查询某跨地域备份文件可恢复哪个时间段的数据。
查看普通备份文件可恢复哪个时间段的数据请参见DescribeBackups。
仅适用于如下实例类型:
- RDS MySQL:支持的实例版本请参见MySQL跨地域备份。
- RDS PostgreSQL :支持的实例版本请参见PostgreSQL跨地域备份。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | DescribeAvailableRecoveryTime |
系统规定参数。取值:DescribeAvailableRecoveryTime。 |
CrossBackupId | Integer | 是 | 14*** |
跨地域备份文件ID。可以通过接口DescribeCrossRegionBackups查看备份集ID。 |
RegionId | String | 否 | cn-hangzhou |
地域ID。 |
ResourceGroupId | String | 否 | rg-acfmy***** |
资源组ID。 |
DBInstanceId | String | 否 | rm-uf6wjk5***** |
实例ID。可调用DescribeDBInstances获取。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
RecoveryEndTime | String | 2019-06-12T07:33:12Z |
跨地域备份文件可恢复的结束时间。格式:yyyy-MM-ddTHH:mm:ssZ(UTC时间)。 |
RequestId | String | 8CCBF4BA-7CE1-47E1-B49F-E97EA200A40D |
请求ID。 |
CrossBackupId | Integer | 14377 |
跨地域备份文件ID。 |
RecoveryBeginTime | String | 2019-06-12T05:22:29Z |
跨地域备份文件可恢复的起始时间。格式:yyyy-MM-ddTHH:mm:ssZ(UTC时间)。 |
RegionId | String | cn-hangzhou |
源实例所在地域。 |
示例
请求示例
http(s)://rds.aliyuncs.com/?Action=DescribeAvailableRecoveryTime
&CrossBackupId=14***
&<公共请求参数>
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<DescribeAvailableRecoveryTimeResponse>
<RecoveryEndTime>2019-06-12T07:33:12Z</RecoveryEndTime>
<RecoveryBeginTime>2019-06-12T05:22:29Z</RecoveryBeginTime>
<RequestId>8CCBF4BA-7CE1-47E1-B49F-E97EA200A40D</RequestId>
<RegionId>cn-hangzhou</RegionId>
<CrossBackupId>14377</CrossBackupId>
</DescribeAvailableRecoveryTimeResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RecoveryEndTime" : "2019-06-12T07:33:12Z",
"RecoveryBeginTime" : "2019-06-12T05:22:29Z",
"RequestId" : "8CCBF4BA-7CE1-47E1-B49F-E97EA200A40D",
"RegionId" : "cn-hangzhou",
"CrossBackupId" : 14377
}
错误码
HttpCode | 错误码 | 错误信息 | 描述 |
---|---|---|---|
400 | NoAvailableLogBackup | No available log backup. | 操作失败,当前没有可用的日志备份。 |
400 | NoAvailableDisasterRestoreBakset | No available disaster restore bakset. | 操作失败,当前没有可用的恢复集。 |
403 | CrossBackupNotSupport | Specified region not support cross region backup. | 指定的区域不支持跨区域备份。 |
404 | InvalidBackupSetID.NotFound | Specified backup set ID does not exist. | 备份集不存在。请查看已存在的备份集。 |
404 | InvalidPage.notFound | Page not found. | 指定参数未找到,请检查确认参数。 |
访问错误中心查看更多错误码。