功能介绍

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

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

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

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

调试

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

接口约束

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

URI

URI格式

POST /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。
is_fast_restore	否	Boolean	是否使用极速恢复。取值：true、false。 配置该参数时，参考查询实例是否能在库表恢复时使用极速恢复（MySQL）接口判断本次恢复是否能使用极速恢复。能使用极速恢复时，如果实例存在XA事务，会导致数据丢失，请选择普通恢复，即设置参数值为“false”。 不传该参数时，将根据查询实例是否能在库表恢复时使用极速恢复（MySQL）的查询结果，默认是否使用极速恢复。如果支持极速恢复功能，并且实例存在XA事务，请选择普通恢复，即传参并设置参数值为“false”。

表3 restoreTables字段数据结构说明

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

表4 tables字段数据结构说明

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

请求示例

恢复表数据到指定时间点

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

异常

请参见状态码。

错误码

请参见错误码。

父主题： API v3

同意关联代理商云淘科技，购买华为云产品更优惠（QQ 78315851）

内容没看懂？ 不太想学习？想快速解决？ 有偿解决： 联系专家