You need to enable JavaScript to run this app.
RDS for MySQL

RDS for MySQL

  • Documentation
    • RDS for MySQLAPI referenceV2（2022-01-01）Backup and recoveryDescribeRecoverableTime
Copy page
Download PDF
Backup and recovery
DescribeRecoverableTime
Copy page
Download PDF
DescribeRecoverableTime

Call the DescribeRecoverableTime API to view the recoverable time range.

Request type

Synchronous request.

Request parameters

Name
Type
Required
Example
Description
InstanceId
String
Yes
mysql-h441603c****
Instance ID.
RestoreType
String
No
TABLE_LEVEL

Indicates the type of recovery. Currently, only the value of TABLE_LEVEL is supported, that is, library and table-level recovery.

tip

This field will be deprecated soon.

BackupRegion
String
No
cn-shanghai
The region where the backup is located. The default value is the region of the instance.

Response parameters

Name
Type
Example
Description
RecoverableTimeInfo
Object[]
[ { "EarliestRecoverableTime": "2023-01-10T14:27:44.000Z", "LatestRecoverableTime": "2023-01-11T06:05:14.093Z" } ]
The recoverable time period of the instance (+0800). If empty, it means the instance is currently not recoverable.
EarliestRecoverableTime
String
2022-01-01T10:10:10Z
The earliest recoverable time of the instance (+0800). If it is empty, it means that the instance is currently not recoverable.
LatestRecoverableTime
String
2022-01-01T10:10:10Z
The latest recoverable time of the instance (+0800), if it is empty, it means that the instance is not recoverable at present.

Sample request 

POST /?Action=DescribeRecoverableTime&Version=2022-01-01 HTTP/1.1
Accept: application/json
Content-Type: application/json
Host: rds-mysql.cn-beijing.volcengineapi.com
X-Date: 20211202T101010Z
Authorization: HMAC-SHA256 Credential=AKLTN2I0MmFiNzMxNWE5NDgzMzk4MmVjMTVkODlkZTZ****/20211202/cn-beijing/rds_mysql/request,SignedHeaders=x-date, Signature=71d31fc7bcf990142851c9833c5656391486cda0ae2e0b8ada733b7c6458****
{
    "InstanceId": "mysql-ce48081d****",
    "RestoreType": "TABLE_LEVEL"
}

Sample response 

{
    "ResponseMetadata": {
        "RequestId": "202301111405138FCE5A0097D88059AC62",
        "Action": "DescribeRecoverableTime",
        "Version": "2022-01-01",
        "Service": "rds_mysql",
        "Region": "cn-beijing"
    },
    "Result": {
        "RecoverableTimeInfo": [
            {
                "EarliestRecoverableTime": "2023-01-10T14:27:44.000Z",
                "LatestRecoverableTime": "2023-01-11T06:05:14.093Z"
            }
        ]
    }
}

Error codes

For more details, refer to Error codes.

Last updated: 2025.07.07 15:52:02