文档首页/ 分布式数据库中间件 DDM/ API参考/ API（推荐）/ 备份管理/ 恢复到新实例V3
更新时间：2026-05-21 GMT+08:00
查看PDF
分享

恢复到新实例V3

功能介绍

恢复到新实例

URI

POST /v3/{project_id}/instances/{instance_id}/backups/recovery

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

租户在某一region下的project ID。

获取方法请参见获取项目ID。

instance_id

是

String

DDM实例ID。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

用户Token。

通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。
表3 请求Body参数

参数

是否必选

参数类型

描述

source

是

RestoreInstSource object

数据恢复源。

target

是

RestoreInstTarget object

数据恢复目标。

data_node_relations

是

Array of DataNodeRelation objects

关联dn。
表4 RestoreInstSource

参数

是否必选

参数类型

描述

restore_time

是

Number

恢复时间。
表5 RestoreInstTarget

参数

是否必选

参数类型

描述

instance_id

是

String

实例id。
表6 DataNodeRelation

参数

是否必选

参数类型

描述

source_instance_id

是

String

源数据节点实例ID。获取方法参见查询实例在恢复时间点关联的数据节点。

target_instance_id

是

String

目标数据节点列表。获取方法参见查询可用于时间点恢复的数据节点列表。

响应参数

状态码：202

表7 响应Body参数

参数

参数类型

描述

job_id

String

任务id

状态码：400

表8 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_msg

String

错误消息。

状态码：500

表9 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_msg

String

错误消息。

请求示例

POST https://{endpoint}/v3/{project_id}/instances/{instance_id}/backups/recovery

{
  "source" : {
    "restore_time" : 1747732352076
  },
  "target" : {
    "instance_id" : "2f0324a93859487eb5566d75951fcd2din09"
  },
  "data_node_relations" : [ {
    "source_instance_id" : "f4e2949e9b9b4d60b42c89ed39bfe34cin01",
    "target_instance_id" : "f4e2949e9b9b4d60b42c89ed39bfe34cin01"
  } ]
}

响应示例

状态码：202

{
  "job_id": "09902ee7866649b8908ec209bfee2747"
}

状态码：400

bad request

{
  "error_msg" : "Parameter error.",
  "error_code" : "DBS.280001"
}

状态码：500

server error

{
  "error_msg" : "Parameter error.",
  "error_code" : "DBS.280001"
}

状态码

状态码

描述

202

ok

400

bad request

500

server error

错误码

请参见错误码。

父主题： 备份管理

相关文档