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

表级时间点恢复(MySQL)

功能介绍

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

该接口计划于2025-09-14下线,建议及时切换到新接口表级时间点恢复(MySQL)

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

接口约束

  • 该接口仅支持MySQL引擎。
  • 不支持RDS for MySQL 8.0版本的数据库实例。
  • 不支持带中文的库名和表名恢复。

URI

  • URI格式

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

  • 参数说明
    表1 参数说明

    名称

    是否必选

    说明

    project_id

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

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

    instance_id

    实例ID。

请求消息

表2 参数说明

名称

是否必选

参数类型

说明

restoreTime

Long

备份时间点。

restoreTables

Array of objects

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

is_fast_restore

Boolean

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

表3 restoreTables字段数据结构说明

名称

是否必选

参数类型

说明

database

String

数据库名称。

tables

Array of objects

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

表4 tables字段数据结构说明

名称

是否必选

参数类型

说明

oldName

String

恢复前表名。

newName

String

恢复后表名。

请求示例

恢复表数据到指定时间点。
POST https://{endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/instances/dsfae23fsfdsae3435in01/restore/tables
{
    "restoreTime": 1583720991838,
    "restoreTables": [
        {
            "database": "restoretest",
            "tables": [
                {
                    "oldName": "test",
                    "newName": "test_1583720991838"
                }
            ]
        }
    ]}

响应消息

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

    名称

    参数类型

    说明

    jobId

    String

    本次任务的ID。

  • 正常响应样例
    {
        "jobId":"7b55d6ca-dc8e-4844-a9da-6c53a1506db3"
    }
  • 异常响应

    请参见异常请求结果

状态码

错误码

请参见错误码