表级时间点恢复（MySQL）

功能介绍

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

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

• 调用接口前，您需要了解API 认证鉴权。
• 调用接口前，您需要提前获取到地区和终端节点，即下文中的Endpoint值。

接口约束

• 该接口仅支持MySQL引擎。
• 不支持云数据库MySQL 8.0版本的数据库实例。

URI

• URI格式

  POST

  https://{Endpoint}/v3/{project_id}/instances/{instance_id}/restore/tables

• 参数说明

  表1 参数说明

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

请求消息

• 参数说明

  表2 参数说明

  名称	是否必选	参数类型	说明
  restoreTime	是	Long	备份时间点。
  restoreTables	是	Array of objects	数据库信息，详细说明请参见表3。

  表3 restoreTables字段数据结构说明

  名称	是否必选	参数类型	说明
  database	是	String	数据库名称。
  tables	是	Array of objects	表信息，详细说明请参见表4。

  表4 tables字段数据结构说明

  名称	是否必选	参数类型	说明
  oldName	是	String	恢复前表名。
  newName	是	String	恢复后表名。

• 请求样例

  {
      "restoreTime": 1583720991838,
      "restoreTables": [
          {
              "database": "restoretest",
              "tables": [
                  {
                      "oldName": "test",
                      "newName": "test_1583720991838"
                  }
              ]
          }
      ]
  }

响应消息

• 正常响应要素说明

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

• 正常响应样例

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

• 异常响应

  请参见异常请求结果。

状态码

请参见状态码。

错误码

请参见错误码。