库表恢复到新实例
更新时间：2026-08-04
功能说明
调用创建实例接口时，可指定将源实例中的一个或多个数据库或集合恢复到新创建的实例中。支持以下两种恢复方式：
- 按时间点恢复
- 按备份集恢复
请求参数
除以下新增参数外，其余请求参数请参见创建实例接口。
| 参数名称 | 参数类型 | 是否必须 | 参数位置 | 描述 | 示例值 |
|---|---|---|---|---|---|
| srcDbInstanceId | String | 是 | body | 源实例 ID。 | m-btVMND |
| srcRegion | String | 是 | body | 源实例所在地域。 | gz |
| restoreTime | String | 否 | body | 恢复时间点，与 backupId 二选一。 | 2026-03-19T02:32:43Z |
| backupId | String | 否 | body | 备份集 ID，与 restoreTime 二选一。 | backup-GKGnfD |
| tableRestore | Boolean | 是 | body | 是否开启库表恢复，固定为 true。 | true |
| tableRestoreParams | List |
是 | body | 待恢复的数据库或集合信息。 | - |
TableRestoreItem 数据结构说明
| 参数名称 | 参数类型 | 是否必须 | 描述 |
|---|---|---|---|
| type | String | 是 | 对象类型，固定为 database。 |
| name | String | 是 | 数据库名称。 |
| newName | String | 是 | 恢复后的数据库名称。 |
| subObjects | List |
否 | 数据库包含的集合列表。为空时表示恢复整个数据库。 |
SubObjectItem 数据结构说明
| 参数名称 | 参数类型 | 是否必须 | 描述 | 示例值 |
|---|---|---|---|---|
| type | String | 是 | 对象类型，固定为 table。 | table |
| name | String | 是 | 集合名称。 | coll1 |
| newName | String | 是 | 恢复后的集合名称。 | coll1_backup |
请求示例一：按时间点恢复
Plain Text
1POST /v1/instance?from=api
2Host: mongodb.bj.baidubce.com
3Authorization: authorization string
4{
5 "billing": {
6 "paymentTiming": "Postpaid"
7 },
8 "storageEngine": "WiredTiger",
9 "dbInstanceCpuCount": 1,
10 "dbInstanceMemoryCapacity": 2,
11 "dbInstanceStorage": 5,
12 "votingMemberNum": 3,
13 "mongosCount": 2,
14 "mongosCpuCount": 1,
15 "mongosMemoryCapacity": 2,
16 "shardCount": 2,
17 "shardCpuCount": 1,
18 "shardMemoryCapacity": 2,
19 "shardStorage": 5,
20 "engineVersion": "8.0",
21 "dbInstanceType": "sharding",
22 "dbInstanceName": "sdk-shard",
23 "accountPassword": "CE9966507EE955670D20C4461E53E6FF",
24 "dbInstanceStorageType": "CDS_ENHANCED_SSD",
25 "vpcId": "vpc-ifsrdnrvcaiq",
26 "subnets": [
27 {
28 "zoneName": "cn-gz-d",
29 "subnetId": "sbn-tzwbteas2m0w"
30 }
31 ],
32 "isDataBackupCopy": false,
33 "srcDbInstanceId": "m-btVMND",
34 "srcRegion": "gz",
35 "restoreTime": "2026-03-19T02:32:43Z",
36 "tableRestore": true,
37 "tableRestoreParams": [
38 {
39 "type": "database",
40 "name": "dbA",
41 "newName": "dbA",
42 "subObjects": [
43 {
44 "type": "table",
45 "name": "coll1",
46 "newName": "coll1_new"
47 }
48 ]
49 }
50 ]
51}请求示例二：按备份集恢复
除恢复参数外，其余请求参数与请求示例一：按时间点恢复保持一致，仅需将 restoreTime 替换为 backupId。
Plain Text
1{
2 "backupId": "backup-PQ6gz0",
3 "tableRestore": true,
4 "tableRestoreParams": [
5 {
6 "type": "database",
7 "name": "dbA",
8 "newName": "dbA",
9 "subObjects": [
10 {
11 "type": "table",
12 "name": "coll1",
13 "newName": "coll1_new"
14 }
15 ]
16 }
17 ]
18}返回
Plain Text
1HTTP/1.1 200 OK
2<公共响应头>评价此篇文章