表级时间点恢复（MySQL）

功能介绍

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

该接口计划于2025-09-14下线，建议及时切换到新接口表级时间点恢复（MySQL）。

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

• 调用接口前，您需要了解API 认证鉴权。

调试

您可以在API Explorer中调试该接口。

接口约束

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

URI

• URI格式

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

• 参数说明

  表1 参数说明

  名称	是否必选	说明
  project_id	是	租户在某一Region下的项目ID。 获取方法请参见获取项目ID。
  instance_id	是	实例ID。

请求消息

请求示例

POST https://{endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/instances/dsfae23fsfdsae3435in01/restore/tables
{
    "restoreTime": 1583720991838,
    "restoreTables": [
        {
            "database": "restoretest",
            "tables": [
                {
                    "oldName": "test",
                    "newName": "test_1583720991838"
                }
            ]
        }
    ],
    "is_fast_restore" : false
}

响应消息

• 正常响应要素说明

  表5 响应Body参数

  名称	参数类型	说明
  jobId	String	本次任务的ID。

• 正常响应样例

  {
      "jobId":"7b55d6ca-dc8e-4844-a9da-6c53a1506db3"
  }

• 异常响应

  请参见异常请求结果。

状态码

• 正常

  200

• 异常

  请参见状态码。

错误码

请参见错误码。