更新时间:2023-11-24 GMT+08:00

库表级时间点恢复

接口说明

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

约束说明

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

URI

  • URI格式

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

  • URI样例

    https://dds.ap-southeast-1.myhuaweicloud.com/v3/056538411200d4cd2f79c003c7606412/instances/d5833c2854a4486cb7960f829269e211in02/restore/collections

表1 请求参数

名称

类型

IN

是否必选

描述

X-Auth-Token

string

header

从IAM服务获取的用户Token。请参考认证鉴权

X-Language

string

header

语言。

project_id

string

path

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

instance_id

string

path

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

请求消息

  • 参数说明
    表2 参数说明

    名称

    参数类型

    是否必选

    描述

    restore_collections

    Array of objects

    数据库信息。

    请参见表3

    表3 restore_collections字段数据结构说明

    名称

    参数类型

    是否必选

    描述

    database

    String

    数据库名称。

    collections

    Array of objects

    集合信息。

    请参见表4

    restore_database_time

    String

    数据库恢复时间点。

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

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

    表4 collections字段数据结构说明

    名称

    参数类型

    是否必选

    描述

    old_name

    String

    恢复前表名。

    new_name

    String

    恢复后表名。

    restore_collection_time

    String

    数据库集合恢复时间点。

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

请求示例

  • 恢复数据库级备份,数据库名称为test
    {
      "restore_collections": [
        {
          "database": "test",
          "restore_database_time": 1607762955000
        }
      ]
    }
  • 恢复集合级备份,恢复前表名为test
    {
      "restore_collections": [
        {
          "database": "test",
          "collections": [
            {
              "old_name": "test",
              "restore_collection_time": 1607762955000
            }
          ]
        }
      ]
    }

响应消息

  • 参数说明
    表5 参数说明

    名称

    参数类型

    是否必选

    描述

    job_id

    String

    恢复操作的异步任务ID。

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

SDK

单击文档数据库服务 DDS SDK,下载SDK或查看SDK文档。SDK的安装、认证方式等在SDK文档中对应语言类型的【使用】目录下。

状态码

详情请参见状态码

错误码

详情请参见错误码