更新时间:2024-03-28 GMT+08:00
表级时间点恢复(MySQL)
功能介绍
为了保证数据完整性,降低对原实例的性能影响,在进行表级时间点恢复备份时,首先将选中时间点的全量数据和增量数据在后台恢复至一个临时实例,然后自动导出用户需要恢复的表,再将这些表恢复至原实例。
该接口计划于2025-09-14下线,建议及时切换到新接口表级时间点恢复(MySQL)。
该操作会在原实例上新生成恢复后的库表,请确保您的原实例磁盘空间充足。
- 调用接口前,您需要了解API 认证鉴权。
接口约束
- 该接口仅支持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。
请求消息
名称 |
是否必选 |
参数类型 |
说明 |
---|---|---|---|
restoreTime |
是 |
Long |
备份时间点。 |
restoreTables |
是 |
Array of objects |
数据库信息,详细说明请参见表3。 |
is_fast_restore |
否 |
Boolean |
是否使用极速恢复。取值:true、false。
|
名称 |
是否必选 |
参数类型 |
说明 |
---|---|---|---|
database |
是 |
String |
数据库名称。 |
tables |
是 |
Array of objects |
表信息,详细说明请参见表4。 |
请求示例
恢复表数据到指定时间点。
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" }
- 异常响应
请参见异常请求结果。
状态码
- 正常
- 异常
请参见状态码。
错误码
请参见错误码。
父主题: API v3