文档首页/文档数据库服务 DDS/API参考（联盟区域）/API v3（推荐）/备份与恢复/库表级时间点恢复
更新时间：2026-01-07 GMT+08:00
查看PDF
分享

库表级时间点恢复

接口说明

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

约束说明

该接口只支持副本集实例。

URI

  • URI格式

    POST https://{Endpoint}/v3/{project_id}/instances/{instance_id}/restore/collections

表1 路径参数

名称

类型

IN

是否必选

描述

X-Language

string

header

否

语言。

project_id

string

path

是

项目ID。请参考获取项目ID章节获取项目编号。

instance_id

string

path

是

实例ID，可以调用“查询实例列表和详情”接口获取。如果未申请实例，可以调用“创建实例”接口创建。

请求参数

表2 请求Header参数

名称

类型

IN

是否必选

描述

X-Auth-Token

string

header

是

用户Token。

表3 参数说明

名称

参数类型

是否必选

描述

restore_collections

Array of objects

是

数据库信息。

请参见表4。

表4 restore_collections字段数据结构说明

名称

参数类型

是否必选

描述

database

String

是

数据库名称。

collections

Array of objects

否

集合信息。

请参见表5。

restore_database_time

String

否

数据库恢复时间点。

如果是数据库级恢复，该参数必传，

UNIX时间戳格式，单位是毫秒，时区是UTC。

表5 collections字段数据结构说明

名称

参数类型

是否必选

描述

old_name

String

是

恢复前表名。

new_name

String

否

恢复后表名。

restore_collection_time

String

是

数据库集合恢复时间点。

UNIX时间戳格式，单位是毫秒，时区是UTC。

  • 请求示例
    • 数据库级恢复 
      {
  "restore_collections": [
    {
      "database": "test",
      "restore_database_time": 1607762955000
    }
  ]
}
    • 集合级恢复 
      {
  "restore_collections": [
    {
      "database": "test",
      "collections": [
        {
          "old_name": "test",
          "restore_collection_time": 1607762955000
        }
      ]
    }
  ]
}

响应参数

表6 参数说明

名称

参数类型

是否必选

描述

job_id

String

是

恢复操作的异步任务ID。

  • 响应示例 
    {
    "job_id": "a03b1b8a-b756-467c-8a49-38720c3d23ec"
}

状态码

详情请参见状态码。

错误码

详情请参见错误码。

父主题：备份与恢复