调用DescribeSandboxRecoveryTime接口，查看沙箱实例的可恢复时间范围。

执行该操作前，您需要先开启数据库实例的沙箱功能，详情请参见RDS MySQL应急恢复或自建MySQL应急恢复（沙箱实例）。

当前接口仅支持DBS API服务2021-01-01版本。

调试

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

请求参数

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

系统规定参数。取值：DescribeSandboxRecoveryTime。

BackupPlanId String 是 1hxxxx8xxxxxa

备份计划ID，您可以通过DescribeBackupPlanList接口获取该参数。

说明 若您的实例为RDS MySQL，请通过自动添加数据源功能，将RDS自动添加至DBS中，即可获取备份计划ID。

返回数据

名称 类型 示例值 描述
Code String Param.NotFound

错误码。
Data Struct

返回参数。
BackupPlanId String 1hxxxx8xxxxxa

沙箱实例的备份计划。
RecoveryBeginTime String 2021-08-01T12:01:01Z

可恢复的开始时间，格式：yyyy-MM-ddTHH:mm:ssZ（UTC时间）。
RecoveryEndTime String 2021-08-02T12:01:01Z

可恢复的截止时间，格式：yyyy-MM-ddTHH:mm:ssZ（UTC时间）。
ErrCode String Param.NotFound

错误码。
ErrMessage String The specified parameter %s value is not valid.

错误信息。
Message String The specified parameter %s value is not valid.

错误信息。
RequestId String 4F1888AC-1138-4995-B9FE-D2734F61C058

请求ID。
Success String true

是否请求成功。

示例

请求示例

http(s)://dbs-api.cn-hangzhou.aliyuncs.com/?Action=DescribeSandboxRecoveryTime
&<公共请求参数>

正常返回示例

XML格式 

<RequestId>2FC5BFF1-C6AB-594A-9C54-34F9E3A67380</RequestId>
<Data>
    <RecoveryEndTime>2021-08-30T10:49:18Z</RecoveryEndTime>
    <RecoveryBeginTime>2021-08-23T13:25:12Z</RecoveryBeginTime>
    <BackupPlanId>1hxxxx8xxxxxa</BackupPlanId>
</Data>
<Code>Success</Code>
<Success>true</Success>
<ErrCode>Success</ErrCode>

JSON格式 

{
    "RequestId": "2FC5BFF1-C6AB-594A-9C54-34F9E3A67380",
    "Data": {
        "RecoveryEndTime": "2021-08-30T10:49:18Z",
        "RecoveryBeginTime": "2021-08-23T13:25:12Z",
        "BackupPlanId": "1hxxxx8xxxxxa"
    },
    "Code": "Success",
    "Success": true,
    "ErrCode": "Success"
}

错误码

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