更新时间:2024-03-28 GMT+08:00
表级时间点恢复(MySQL)
功能介绍
为了保证数据完整性,降低对原实例的性能影响,在进行表级时间点恢复备份时,首先将选中时间点的全量数据和增量数据在后台恢复至一个临时实例,然后自动导出用户需要恢复的表,再将这些表恢复至原实例。
该操作会在原实例上新生成恢复后的库表,请确保您的原实例磁盘空间充足。
- 调用接口前,您需要了解API 认证鉴权。
接口约束
- 该接口仅支持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 |
是否使用极速恢复。取值:true、false。
|
名称 |
是否必选 |
参数类型 |
说明 |
---|---|---|---|
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(推荐)