调用DescribeRestoreRangeInfo接口,查看一个备份计划可恢复时间段详情。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String DescribeRestoreRangeInfo

系统规定参数。取值:DescribeRestoreRangeInfo

BackupPlanId String dbssl67c7mx****

备份计划ID,可通过调用DescribeBackupPlanList接口获取该参数的值。

BeginTimestampForRestore Long 1646674092000

查询可恢复开始时间,可通过调用DescribeBackupPlanList接口获取该参数的值。

EndTimestampForRestore Long 1646846814000

查询可恢复结束时间,可通过调用DescribeBackupPlanList接口获取该参数的值。

RegionId String cn-hangzhou

地域ID,可通过调用DescribeRegions接口获取该参数的值。

ClientToken String ETnLKlblzczshOTUbOCzxxxxxxx

用于保证请求的幂等性,防止重复提交请求。

RecentlyRestore Boolean true

是否开启最近恢复。

返回数据

名称 类型 示例值 描述
HttpStatusCode Integer 200

HTTP状态码。

RequestId String E2BD9DFC-6760-5F49-97C5-DA739E29****

请求ID。

ErrCode String Param.NotFound

错误码。

Success Boolean true

请求是否成功,返回值如下:

  • true:请求成功
  • false:请求失败
ErrMessage String The specified parameter %s value is not valid.

错误信息。

Items Array of DBSRecoverRange

可恢复时间段信息。

DBSRecoverRange
EndTimestampForRestore Long 1646760308000

可恢复结束时间戳。

SourceEndpointInstanceType String rds

数据库所在位置。

RangeType String point

可恢复时间段类型,返回值如下:

  • point:该时间段为全量备份离散时间点。
  • range:该时间段为连续备份时间段,可指定任意时间。
BeginTimestampForRestore Long 1646760282000

可恢复开始时间戳。

SourceEndpointInstanceID String rm-bp106x9tk2c91****

数据库实例ID。

FullBackupList Array of FullBackupDetail

当RangeType为point时,该字段展示这个时间段范围内所有的权利。备份点信息。

FullBackupDetail
EndTime Long 1646760308000

全量备份结束时间,返回值:1646760308000。

StartTime Long 1646760282000

全量备份开始时间,返回值:1646760282000。

BackupSetId String qecnsxkd****

备份集ID。

示例

请求示例

http(s)://dbs-api.cn-hangzhou.aliyuncs.com/?Action=DescribeRestoreRangeInfo
&BackupPlanId=dbssl67c7mx****
&BeginTimestampForRestore=1646674092000
&EndTimestampForRestore=1646846814000
&ClientToken=ETnLKlblzczshOTUbOCzxxxxxxx
&RecentlyRestore=true
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeRestoreRangeInfoResponse>
    <RequestId>E2BD9DFC-6760-5F49-97C5-DA739E29****</RequestId>
    <HttpStatusCode>200</HttpStatusCode>
    <Items>
        <DBSRecoverRange>
            <RangeType>point</RangeType>
            <SourceEndpointInstanceID>rm-bp106x9tk2c91****</SourceEndpointInstanceID>
            <FullBackupList>
                <FullBackupDetail>
                    <EndTime>1646760308000</EndTime>
                    <StartTime>1646760282000</StartTime>
                    <BackupSetId>qecnsxkd****</BackupSetId>
                </FullBackupDetail>
            </FullBackupList>
            <SourceEndpointInstanceType>rds</SourceEndpointInstanceType>
            <EndTimestampForRestore>1646760308000</EndTimestampForRestore>
            <BeginTimestampForRestore>1646760282000</BeginTimestampForRestore>
        </DBSRecoverRange>
    </Items>
    <Success>true</Success>
</DescribeRestoreRangeInfoResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "E2BD9DFC-6760-5F49-97C5-DA739E29****",
  "HttpStatusCode" : 200,
  "Items" : {
    "DBSRecoverRange" : [ {
      "RangeType" : "point",
      "SourceEndpointInstanceID" : "rm-bp106x9tk2c91****",
      "FullBackupList" : {
        "FullBackupDetail" : [ {
          "EndTime" : 1646760308000,
          "StartTime" : 1646760282000,
          "BackupSetId" : "qecnsxkd****"
        } ]
      },
      "SourceEndpointInstanceType" : "rds",
      "EndTimestampForRestore" : 1646760308000,
      "BeginTimestampForRestore" : 1646760282000
    } ]
  },
  "Success" : true
}

错误码

访问错误中心查看更多错误码。