文档首页/ 云数据库 RDS/ API参考/ API v3.1(推荐)/ 表级时间点恢复(MySQL)
更新时间:2024-03-28 GMT+08:00

表级时间点恢复(MySQL)

功能介绍

为了保证数据完整性,降低对原实例的性能影响,在进行表级时间点恢复备份时,首先将选中时间点的全量数据和增量数据在后台恢复至一个临时实例,然后自动导出用户需要恢复的表,再将这些表恢复至原实例。

该操作会在原实例上新生成恢复后的库表,请确保您的原实例磁盘空间充足。

接口约束

  • 该接口仅支持MySQL引擎。
  • 不支持带中文的库名和表名恢复。

URI

  • URI格式

    POST /v3.1/{project_id}/instances/{instance_id}/restore/tables

  • 参数说明
    表1 参数说明

    名称

    是否必选

    说明

    project_id

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

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

    instance_id

    实例ID。

请求消息

表2 参数说明

名称

是否必选

参数类型

说明

restore_time

Long

恢复时间戳。

restore_tables

Array of objects

表信息,详细说明请参见表3

is_fast_restore

Boolean

是否使用极速恢复。取值:true、false。

表3 restore_tables字段数据结构说明

名称

是否必选

参数类型

说明

database

String

数据库名称。

tables

Array of objects

表信息,详细说明请参见表4

表4 tables字段数据结构说明

名称

是否必选

参数类型

说明

old_name

String

恢复前表名。

new_name

String

恢复后表名。

请求示例

恢复表数据到指定时间点。
POST https://{endpoint}/v3.1/054e292c9880d4992f02c0196d3ea468/instances/d8e6ca5a624745bcb546a227aa3ae1cfin01/restore/tables 
{ 
   "restore_time" : 1689859468000, 
   "restore_tables" : [ { 
     "database" : "database", 
     "tables" : [ { 
       "old_name" : "oldTable", 
       "new_name" : "newTable" 
     } ] 
   } ] 
 }

响应消息

  • 正常响应要素说明
    表5 响应Body参数

    名称

    参数类型

    说明

    job_id

    String

    任务ID。

  • 正常响应样例
    { 
      "job_id" : "04efe8e2-9255-44ae-a98b-d87cae411890" 
    }
  • 异常响应

    请参见异常请求结果

状态码

错误码

请参见错误码