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

恢复到新实例V3

功能介绍

恢复到新实例

URI

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

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

租户在某一region下的project ID。

instance_id

是

String

实例 ID。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

用户Token。

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

参数

是否必选

参数类型

描述

source

否

Object

数据恢复源。

target

否

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

目标实例id。

响应参数

状态码：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

错误消息。

请求示例

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

响应示例

状态码：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

错误码

请参见错误码。

父主题： 备份管理

相关文档