# 查询指定时间点可恢复的表（PostgreSQL） - ListPostgresqlListHistoryTables
#### 功能介绍
查询指定时间点可恢复的表。
- 调用接口前，您需要了解API[认证鉴权](https://support.huaweicloud.com/api-rds/rds_03_0001.html)。
- 调用接口前，您需要了解[请求Header参数说明](https://support.huaweicloud.com/api-rds/rds_03_0005.html#rds_03_0005__section479119143310)。
 
#### 调试
您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/RDS/doc?api=ListPostgresqlListHistoryTables)中调试该接口。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-rds/rds_10_0005.html)。
- 如果使用身份策略授权，当前API调用无需身份策略权限。
 
#### URI
- URI格式 POST /v3/{project_id}/{database_name}/instances/history/tables
  
- 参数说明
  表1参数说明 
  | 名称            | 是否必选 | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
  |:---|:---|:---|
  | project_id    | 是    | **参数解释：** 租户在某一region下的project ID。 获取方法请参见[获取项目ID](https://support.huaweicloud.com/api-rds/rds_03_0002.html)。 **约束限制：** 不涉及。 **取值范围：** 不涉及。 **默认取值：** 不涉及。 |
  | database_name | 是    | **参数解释：** 数据库引擎。 **约束限制**： 不涉及。 **取值范围**： 支持的引擎如下，不区分大小写：postgresql **默认取值**： 不涉及。                                                                                                                                                                                                                                                                                                                                   |
     
  
 
#### 请求消息
- 参数说明
  表2参数说明 
  | 名称                 | 是否必选 | 参数类型             | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
  |:---|:---|:---|:---|
  | instance_ids       | 是    | Array of strings | **参数解释：** 实例ID集合。 **约束限制**： 不涉及。 **取值范围**： 该参数值可调用[查询数据库实例列表](https://support.huaweicloud.com/api-rds/rds_01_0004.html)接口，通过[表4](https://support.huaweicloud.com/api-rds/rds_01_0004.html#rds_01_0004__table2058713718267)中的"id"获取。 **默认取值**： 不涉及。 |
  | restore_time       | 是    | Long             | **参数解释：** 恢复时间点，采用毫秒时间戳。 **约束限制**： 不涉及。 **取值范围**： 不涉及。 **默认取值**： 不涉及。                                                                                                                                                                                          |
  | database_name_like | 否    | String           | **参数解释：** 数据库名，模糊查询。 **约束限制**： 不涉及。 **取值范围**： 字符串长度0-64字符，可以包含字母、数字、中划线、下划线或中文，不能包含其他特殊字符。 **默认取值**： 不涉及。                                                                                                                                         |
  | table_name_like    | 否    | String           | **参数解释：** 数据库表名，模糊查询。 **约束限制**： 不涉及。 **取值范围**： 字符串长度0-64字符，可以包含字母、数字、中划线、下划线或中文，不能包含其他特殊字符。 **默认取值**： 不涉及。                                                                                                                                        |
  | instance_name_like | 否    | String           | **参数解释：** 实例名称，模糊查询。 **约束限制**： 不涉及。 **取值范围**： 字符串长度0-64字符，可以包含字母、数字、中划线、下划线或中文，不能包含其他特殊字符。 **默认取值**： 不涉及。                                                                                                                                             |
     
  
- 请求样例
  ```
  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]。                                   |
     
   表4instances字段数据结构说明 
  | 参数           | 参数类型             | 描述                                                                                                                                                          |
  |:---|:---|:---|
  | id           | String           | **参数解释：** 实例ID。 **取值范围**： 不涉及。    |
  | name         | String           | **参数解释：** 实例名称。 **取值范围**： 不涉及。       |
  | total_tables | Integer          | **参数解释：** 可恢复表的数量。 **取值范围**： 不涉及。 |
  | databases    | Array of objects | **参数解释：** 数据库信息。详细说明请参见[表5]。                                    |
     
   表5databases字段数据结构说明 
  | 参数           | 参数类型             | 描述                                                                                                                                                       |
  |:---|:---|:---|
  | name         | String           | **参数解释：** 数据库名。 **取值范围**： 不涉及。 |
  | total_tables | Integer          | **参数解释：** 可恢复表的数量。 **取值范围**： 不涉及。 |
  | schemas      | Array of objects | **参数解释：** 模式信息。详细说明请参见[表6]。                              |
     
   表6schemas字段数据结构说明 
  | 参数           | 参数类型             | 描述                                                                                                                                                      |
  |:---|:---|:---|
  | name         | String           | **参数解释：** 模式名。 **取值范围**： 不涉及。       |
  | total_tables | Integer          | **参数解释：** 可恢复表的数量。 **取值范围**： 不涉及。 |
  | tables       | Array of objects | **参数解释：** 表信息。详细说明请参见[表7]。                                 |
     
   表7tables字段数据结构说明 
  | 参数   | 参数类型   | 描述                                                                                                                                                  |
  |:---|:---|:---|
  | 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 
  }
  ```
  
- 异常响应 请参见[异常响应结果](https://support.huaweicloud.com/api-rds/rds_01_0010.html)。
  
 
#### 状态码
- 正常 200
  
- 异常 请参见[状态码](https://support.huaweicloud.com/api-rds/rds_10_0200.html)。
  
 
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-rds/rds_10_0201.html)。