功能介绍

查询指定时间点可恢复的库。

调用接口前，您需要了解API 认证鉴权。

调试

您可以在API Explorer中调试该接口。

URI

URI格式

POST /v3/{project_id}/{engine}/instances/history/databases

参数说明

表1 参数说明

名称	是否必选	说明
project_id	是	租户在某一region下的project ID。 获取方法请参见获取项目ID。
engine	是	数据库引擎。 支持的引擎：mysql，不区分大小写。

请求消息

参数说明

表2 参数说明

名称	是否必选	参数类型	说明
instance_ids	是	Array of strings	实例ID集合。
restore_time	是	Long	恢复时间点，采用毫秒时间戳。
database_name_like	否	String	数据库名，模糊查询，不支持含中文的数据库名查询。
instance_name_like	否	String	实例名称，模糊查询。

请求样例

查询RDS for MySQL实例指定时间点可恢复的库：

POST http://rds.cn-north-1.myhuaweicloud.com/v3/54623db08b174c858ba779d2aa7923a3/mysql/instances/history/databases
 {
   "instance_ids" : [ "5d742eda6e574ff3a003191638ef8c51in01" ],  
   "restore_time" : 1688554422000,  
   "database_name_like" : "",  
   "instance_name_like" : ""  
}

响应消息

正常响应要素说明

表3 要素说明

名称	参数类型	说明
database_limit	Integer	单个实例支持恢复的库数量上限。如果单个实例在可恢复时间点查询到的库超过上限，响应中只返回上限数量的库。
table_limit	Integer	单个实例支持恢复的所有库中包含的总的表数量上限。如果数据库在可恢复时间点查询到的表数量超过上限，响应中只返回总表数不超出上限的库。
instances	Array of objects	实例信息。详细说明请参见表4。

表4 instances字段数据结构说明

参数	参数类型	描述
id	String	实例ID。
name	String	实例名称。
total_tables	Integer	该实例中所有可恢复库中包含表的总个数。最大不超过table_limit。
databases	Array of objects	数据库信息。详细说明请参见表5。

表5 databases字段数据结构说明

参数	参数类型	描述
name	String	数据库名。当前不支持库名含中文的库恢复，可恢复库查询会过滤库名含中文的库。
total_tables	Integer	该数据库中包含表的总个数。最大不超过table_limit。

正常响应样例

RDS for MySQL实例指定时间点查询可恢复的库：

{
    "instances": [
        {
            "id": "5d742eda6e574ff3a003191638ef8c51in01",
            "name": "AUTO-GENERATED-INSTANCE-57-HA-LOCALSSD",
            "databases": [
                {
                    "name": "dbtest",
                    "total_tables": 1
                },
                {
                    "name": "dbtest_restore",
                    "total_tables": 1
                }
            ],
            "total_tables": 2
        }
    ],
    "database_limit": 2000,
    "table_limit": 20000
}

异常响应

请参见异常请求结果。

状态码

正常

200

异常

请参见状态码。

错误码

请参见错误码。

父主题： 备份与恢复

同意关联代理商云淘科技，购买华为云产品更优惠（QQ 78315851）

内容没看懂？ 不太想学习？想快速解决？ 有偿解决： 联系专家