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

功能介绍

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

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

调试

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

接口约束

该接口仅支持MySQL和PostgreSQL引擎。

URI

• URI格式

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

• 参数说明

  表1 参数说明

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

请求消息

请求示例

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

POST http://{endpoint}/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

• 异常

  请参见状态码。

错误码

请参见错误码。