文档首页/ 云数据库 RDS/ API参考/ API v3(推荐)/ 备份与恢复/ 查询指定时间点可恢复的表(PostgreSQL)
更新时间:2024-08-28 GMT+08:00

查询指定时间点可恢复的表(PostgreSQL)

功能介绍

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

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 
    }
  • 异常响应

    请参见异常请求结果

状态码

错误码

请参见错误码