文档中心

云数据库 MySQL 版

请输入

备份与恢复

RestoreToExistedInstance - 将数据恢复到一个已有数据库实例

调用 RestoreToExistedInstance 接口将数据恢复到一个已有数据库实例。

请求类型

异步请求。

注意事项

不支持跨大版本恢复实例。例如：将 MySQL 5.7 版本的实例恢复为 MySQL 8.0 版本的实例。

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

请求参数

参数	类型	是否必选	示例值	描述
SourceDBInstanceId	String	是	mysql-e7fda57b****	备份数据所属的源实例的 ID。
BackupId	String	否	effc1de81b8a4c8e886fef2c3e06****	备份文件 ID。通过调用 DescribeBackups 可查询 BackupID。说明该参数与 RestoreTime 参数二者必选其一。仅支持通过物理备份恢复到原实例。
RestoreTime	String	否	2022-01-01T10:10:10Z	源实例备份保留周期内的任意时间点，格式为 yyyy-MM-ddTHH:mm:ssZ（UTC 时间）。通过调用 DescribeRecoverableTime 可查询该时间点是否支持还原。说明该参数与 BackupId 参数二者必选其一。
RestoreType	String	否	TABLE_LEVEL	表示恢复的类型。当前仅支持取值为：TABLE_LEVEL，即库表级恢复。说明该字段即将被弃用。
TableMeta	Array of TableMetaObject	否	[ { "DBName" : "db", "NewDBName" : "db_new", "Table": [ { "TableName" : "table", "NewTableName" : "table_new" } ] } ]	进行库表恢复时，指定恢复的库表信息。当 RestoreType 为 TABLE_LEVEL 时，该参数必选。
FastMode	Boolean	否	true	是否启用极速恢复模式。取值： true：是。 false：否。默认指。

TableMetaObject

参数	类型	是否必选	示例值	描述
DBName	String	是	testdb1	指定恢复的 DB。
NewDBName	String	否	testdb2	DB 新名称。命名规则如下：名称唯一。长度为 2~64 个字符。以字母开头，以字母或数字结尾。由字母、数字、下划线（_）或中划线（-）组成。不能使用某些预留字，包括 root、admin 等。被禁用的预留字请参见禁用词列表。说明如果只是恢复表，其值可以与 DBName 相同。
Table	Array of Table	否	[ { "TableName" : "table1", "NewTableName" : "table2" } ]	指定恢复的 DB 内的表，当 Table 为空时全库恢复。

Table

参数	类型	是否必选	示例值	描述
TableName	String	是	table1	指定恢复的表。
NewTableName	String	否	table2	表的新名称。命名规则如下：名称唯一。长度为 2~64 个字符。以字母开头，以字母或数字结尾。由字母、数字、下划线（_）或中划线（-）组成。不能使用某些预留字，包括 root、admin 等。被禁用的预留字请参见禁用词列表。

返回参数

null

示例

请求示例

返回示例

错误码

更多详情，请参见错误码。

最近更新时间：2026.06.10 10:58:16

这个页面对您有帮助吗？

有用

无用