文档中心

云数据库 veDB MySQL 版

备份恢复

RestoreTable - 库表级恢复

调用 RestoreTable 接口将实例的历史数据库和表恢复至原实例中。

请求类型

异步请求。

调试

API Explorer

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

去调试

请求参数

参数	类型	是否必选	示例值	描述
InstanceId	String	是	vedbm-dfaa2zic****	备份数据所属的实例 ID。
BackupId	String	否	snap-6511****-ce0d	备份文件 ID。通过调用 DescribeBackups 接口可查询 BackupID。说明该参数与 RestoreTime 参数二者必选其一。
RestoreTime	String	否	2023-09-19T07:21:09Z	实例备份保留周期内的任意时间点，格式为 yyyy-MM-ddTHH:mm:ssZ（UTC 时间）。通过调用 DescribeRecoverableTime 可查询实例备份可恢复的时间范围。说明该参数与 BackupId 参数二者必选其一。
TableMeta	Array of TableMetaObject	是	请参见请求示例。	进行库表恢复时，指定恢复的库表信息。说明您可通过调用 DescribeRecoverableTables 接口查看实例可恢复的库和表。

TableMetaObject

参数	类型	是否必选	示例值	描述
DBName	String	是	testdb1	需要恢复的目标库名。
NewDBName	String	是	testdb2	恢复后的新库名。说明 NewDBName（新库名）不能与 DBName（原库名）相同，否则执行库表恢复操作会失败。
Table	Array of TableObject	否	请参见请求示例。	指定恢复的数据库中的表。说明当 Table 为空时表示恢复指定库下所有的表。单次最多支持恢复的整库和单表的总数不能超过 100 个。

TableObject

参数	类型	是否必选	示例值	描述
TableName	String	是	table1	需要恢复的目标表名。
NewTableName	String	是	table2	恢复后的新表名。

返回参数

null

示例

请求示例

POST /?Action=RestoreTable&Version=2022-01-01 HTTP/1.1​
Content-Type: application/json​
Host:vedbm.cn-beijing.volcengineapi.com​
X-Date: 20220101T101010Z​
Authorization: HMAC-SHA256 Credential=AKLTN2I0MmFiNzMxNWE5NDgzMzk4MmVjMTVkODlkZTZ****/20220101/cn-beijing/vedbm/request,SignedHeaders=x-date, Signature=71d31fc7bcf990142851c9833c5656391486cda0ae2e0b8ada733b7c645****​
{​
    "InstanceId": "vedbm-dfaa2zic****",​
    "BackupId": "snap-6511****-ce0d",​
    "TableMeta": [​
        {​
            "DBName": "testdb3",​
            "NewDBName": "testdb3",​
            "Table": [​
                {​
                    "TableName": "auth_operation",​
                    "NewTableName": "auth_operation1"​
                }​
            ]​
        }​
    ]​
}​

返回示例

{​
    "ResponseMetadata": {​
        "RequestId": "202309251609144398CF115AE2B9290462",​
        "Action": "RestoreTable",​
        "Version": "2022-01-01",​
        "Service": "vedbm",​
        "Region": "cn-beijing"​
    },​
    "Result": {}​
}​

错误码

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

最近更新时间：2026.02.25 13:20:57

这个页面对您有帮助吗？

有用

无用