更新时间：2025-12-09 GMT+08:00
表级时间点恢复（MySQL） - RestoreTablesNew
功能介绍
为了保证数据完整性，降低对原实例的性能影响，在进行表级时间点恢复备份时，首先将选中时间点的全量数据和增量数据在后台恢复至一个临时实例，然后自动导出用户需要恢复的表，再将这些表恢复至原实例。
- 调用接口前，您需要了解API认证鉴权。
- 调用接口前，您需要了解请求Header参数说明。
授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见权限和授权项。
- 如果使用身份策略授权，需具备如下身份策略权限。
授权项 | 访问级别 | 资源类型（*为必须） | 条件键 | 别名 | 依赖的授权项 |
|---|---|---|---|---|---|
rds:instance:tableRestore | write | - | - | - | - |
接口约束
- 该接口仅支持MySQL引擎。
- 该操作会在原实例上新生成恢复后的库表，请确保您的原实例磁盘空间充足。
- 不支持带中文的库名和表名恢复。
URI
- URI格式
POST /v3.1/{project_id}/instances/{instance_id}/restore/tables
- 参数说明
表1 参数说明 名称
是否必选
说明
project_id
是
参数解释：
租户在某一Region下的项目ID。
获取方法请参见获取项目ID。
约束限制：
不涉及。
取值范围：
不涉及。
默认取值：
不涉及。
instance_id
是
参数解释：
实例ID。
约束限制：
不涉及。
取值范围：
不涉及。
默认取值：
不涉及。
请求消息
名称 | 是否必选 | 参数类型 | 说明 |
|---|---|---|---|
restore_time | 是 | Long | 参数解释： 恢复时间戳。以毫秒为单位。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 |
restore_tables | 是 | Array of objects | 参数解释： 表信息，详细说明请参见表3。 约束限制： 不涉及。 |
is_fast_restore | 否 | Boolean | 参数解释： 是否使用极速恢复。 约束限制：
取值范围：
默认取值： 不涉及。 |
名称 | 是否必选 | 参数类型 | 说明 |
|---|---|---|---|
database | 是 | String | 参数解释： 数据库名称。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 |
tables | 是 | Array of objects | 参数解释： 表信息，详细说明请参见表4。 约束限制： 不涉及。 |
请求示例
恢复表数据到指定时间点。
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" } - 异常响应
请参见异常请求结果。
状态码
- 正常
- 异常
请参见状态码。
错误码
请参见错误码。
父主题：API v3.1（推荐）
