更新时间:2024-09-04 GMT+08:00

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

功能介绍

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

URI

  • URI格式

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

  • 参数说明
    表1 参数说明

    名称

    是否必选

    参数类型

    说明

    project_id

    String

    参数解释

    租户在某一Region下的项目ID。

    获取方法请参见获取项目ID

    约束限制

    不涉及。

    取值范围

    不涉及。

    默认取值

    不涉及。

    engine

    String

    参数解释

    数据库引擎。

    约束限制

    不涉及。

    取值范围

    不区分大小写:mysql

    默认取值

    不涉及。

请求消息

  • 参数说明
    表2 参数说明

    名称

    是否必选

    参数类型

    说明

    instance_ids

    Array of strings

    参数解释

    实例ID集合。

    约束限制

    不涉及。

    restore_time

    Long

    参数解释

    恢复时间点。

    约束限制

    不涉及。

    取值范围

    不涉及。

    默认取值

    不涉及。

    database_name_like

    String

    参数解释

    数据库名,模糊查询。

    约束限制

    不涉及。

    取值范围

    长度1~64个字符,可以包含字母、数字、$、中划线、点或者下划线,不能包含其他的特殊字符。

    默认取值

    不涉及。

    table_name_like

    String

    参数解释

    数据库表名,模糊查询。

    约束限制

    不涉及。

    取值范围

    不能包含'、"、\、/、四种字符。

    默认取值

    不涉及。

    instance_name_like

    String

    参数解释

    实例名称,模糊查询。

    约束限制

    不涉及。

    取值范围

    长度1~64个字符,可以包含字母、数字、中文字符(一个中文字符占用3个字节)、中划线、点或者下划线,不能包含其他的特殊字符。

    默认取值

    不涉及。

  • 请求样例
    POST https://{Endpoint}/v3/4879de6859e345c780f1a22d8bc6f229/mysql/instances/history/tables
    { 
      "instance_ids" : [ "e38d120bb5a640519fb2a1613140afd9in01" ], 
      "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 database字段数据结构说明

    参数

    参数类型

    描述

    name

    String

    参数解释

    模式名。

    取值范围

    不涉及。

    total_tables

    Integer

    参数解释

    可恢复表的数量。

    取值范围

    不涉及。

    tables

    Array of objects

    参数解释

    表信息。详细说明请参见表6

    表6 tables字段数据结构说明

    参数

    参数类型

    描述

    name

    String

    参数解释

    表名。

    取值范围

    不涉及。

  • 正常响应样例
    {
        "instances": [
            {
                "id": "e38d120bb5a640519fb2a1613140afd9in01",
                "name": "rds-abc",
                "total_tables": 1,
                "databases": [
                    {
                        "name": "test",
                        "total_tables": 1,
                        "tables": [
                            {
                                "name": "t1"
                            }
                        ]
                    }
                ]
            }
        ],
        "table_limit": 2000
    }
    
  • 异常响应

    请参见异常请求结果

状态码