查询指定时间点可恢复的表（PostgreSQL）

功能介绍

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

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

URI

• URI格式

  POST /v3/{project_id}/{database_name}/instances/history/tables

• 参数说明

  表1 参数说明

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

请求消息

• 参数说明

  表2 参数说明

  名称	是否必选	参数类型	说明
  instance_ids	是	Array of strings	实例ID集合。
  restore_time	是	Long	恢复时间点。
  database_name_like	否	String	数据库名，模糊查询。
  table_name_like	否	String	数据库表名，模糊查询。
  instance_name_like	否	String	实例名称，模糊查询。

• 请求样例

  POST https://{endpoint}/v3/4879de6859e345c780f1a22d8bc6f229/postgresql/instances/history/tables
  { 
    "instance_ids" : [ "f9e0b25a7b984a5cb193bebc98029914in03" ], 
    "restore_time" : 1688554112000, 
    "database_name_like" : "", 
    "table_name_like" : "", 
    "instance_name_like" : "" 
  }

响应消息

• 正常响应要素说明

  表3 要素说明

  名称	参数类型	说明
  table_limit	Integer	恢复表数量限制个数。
  instances	Array of objects	实例信息。详细说明请参见表4。

  表4 instances字段数据结构说明

  参数	参数类型	描述
  id	String	实例ID。
  name	String	实例名称。
  total_tables	Integer	可恢复表的数量。
  databases	Array of objects	数据库信息。详细说明请参见表5。

  表5 databases字段数据结构说明

  参数	参数类型	描述
  name	String	数据库名。
  total_tables	Integer	可恢复表的数量。
  schemas	Array of objects	模式信息。详细说明请参见表6。

  表6 schemas字段数据结构说明

  参数	参数类型	描述
  name	String	模式名。
  total_tables	Integer	可恢复表的数量。
  tables	Array of objects	表信息。详细说明请参见表7。

  表7 tables字段数据结构说明

  参数	参数类型	描述
  name	String	表名。

• 正常响应样例

  {
    "instances" : [ { 
      "id" : "70f639ffa8e343e1b7797c1705d4fe71in03", 
      "name" : "rds-e1c8", 
      "databases" : [ { 
        "name" : "db1", 
        "schemas" : [ { 
          "name" : "public", 
          "tables" : [ { 
            "name" : "tb1" 
          } ], 
          "total_tables" : 1 
        }, { 
          "name" : "schema1", 
          "tables" : [ { 
            "name" : "tb1" 
          } ], 
          "total_tables" : 1 
        } ], 
        "total_tables" : 2 
      } ], 
      "total_tables" : 2 
    } ], 
    "table_limit" : 2000 
  }

• 异常响应

  请参见异常请求结果。

状态码

• 正常

  200

• 异常

  请参见状态码。

错误码

请参见错误码。