调用DescribeRestoreRangeInfo接口,查看一个备份计划可恢复时间段详情。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | DescribeRestoreRangeInfo |
系统规定参数,取值:DescribeRestoreRangeInfo。 |
BackupPlanId | String | 是 | dbstooi0XXXX |
备份计划ID。 |
BeginTimestampForRestore | Long | 是 | 1554560477000 |
查询可恢复开始时间,取值:1554560477000。 |
EndTimestampForRestore | Long | 是 | 1554560477000 |
查询可恢复结束时间,取值:1554560477000。 |
RegionId | String | 否 | cn-hangzhou |
地域ID,调用DescribeRegions接口查看DBS支持地域。 |
ClientToken | String | 否 | ETnLKlblzczshOTUbOCzxxxxxxx |
用于保证请求的幂等性,防止重复提交请求。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
ErrCode | String | Param.NotFound |
错误码。 |
ErrMessage | String | The specified parameter %s value is not valid. |
错误信息。 |
HttpStatusCode | Integer | 200 |
HTTP状态码。 |
Items | Array of DBSRecoverRange |
可恢复时间段信息。 |
|
DBSRecoverRange | |||
BeginTimestampForRestore | Long | 1554560477000 |
可恢复开始时间戳。 |
EndTimestampForRestore | Long | 1554560477000 |
可恢复结束时间戳。 |
FullBackupList | Array of FullBackupDetail |
当RangeType为point时,该字段展示这个时间段范围内所有的权利。备份点信息。 |
|
FullBackupDetail | |||
BackupSetId | String | dbs1hvbXXXXX |
备份集ID。 |
EndTime | Long | 1554560477000 |
全量备份结束时间,取值:1554560477000。 |
StartTime | Long | 1554560477000 |
全量备份开始时间,取值:1554560477000。 |
RangeType | String | point |
可恢复时间段类型,取值:
|
SourceEndpointInstanceID | String | rm-bp1p8cXXXXX |
数据库实例ID。 |
SourceEndpointInstanceType | String | rm-bp1p8cXXXXX |
数据库所在位置。 |
RequestId | String | 7A851299-A739-4801-B4BC-FC30A535B538 |
请求ID。 |
Success | Boolean | false |
是否成功。 |
示例
请求示例
http(s)://dbs-api.cn-hangzhou.aliyuncs.com/?Action=DescribeRestoreRangeInfo
&BackupPlanId=dbstooi0XXXX
&BeginTimestampForRestore=1554560477000
&EndTimestampForRestore=1554560477000
&<公共请求参数>
正常返回示例
XML
格式
<DescribeJobErrorCodeReponse>
<HttpStatusCode>200</HttpStatusCode>
<RequestId>7A851299-A739-4801-B4BC-FC30A535B538</RequestId>
<Items>
<DBSRecoverRange>
<BeginTimestampForRestore>1554560477000</BeginTimestampForRestore>
<EndTimestampForRestore>1554560477000</EndTimestampForRestore>
<FullBackupList>
<FullBackupDetail>
<BackupSetId>dbs1hvbXXXXX</BackupSetId>
<EndTime>1554560477000</EndTime>
<StartTime>1554560477000</StartTime>
</FullBackupDetail>
</FullBackupList>
<RangeType>point</RangeType>
<SourceEndpointInstanceID>rm-bp1p8cXXXXX</SourceEndpointInstanceID>
<SourceEndpointInstanceType>rm-bp1p8cXXXXX</SourceEndpointInstanceType>
</DBSRecoverRange>
</Items>
</DescribeJobErrorCodeReponse>
JSON
格式
{
"HttpStatusCode": 200,
"RequestId": "7A851299-A739-4801-B4BC-FC30A535B538",
"Items": {
"DBSRecoverRange": {
"BeginTimestampForRestore": 1554560477000,
"EndTimestampForRestore": 1554560477000,
"FullBackupList": [
{
"FullBackupDetail": {
"BackupSetId": "dbs1hvbXXXXX",
"EndTime": 1554560477000,
"StartTime": 1554560477000
}
}
],
"RangeType": "point",
"SourceEndpointInstanceID": "rm-bp1p8cXXXXX",
"SourceEndpointInstanceType": "rm-bp1p8cXXXXX"
}
}
}
错误码
访问错误中心查看更多错误码。
在文档使用中是否遇到以下问题
更多建议
匿名提交