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

元数据恢复V3

功能介绍

元数据恢复

URI

POST /v3/{project_id}/instances/{instance_id}/backups/metadata-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

metadata恢复源。

target

是

Object

metadata恢复目标。
表4 RestoreMetaDataSource

参数

是否必选

参数类型

描述

restore_time

否

Number

恢复时间点，时间戳精确到毫秒（backup_id两者选一个）。

backup_id

否

String

备份ID（restore_time两者选一个）。
表5 RestoreMetaDataTarget

参数

是否必选

参数类型

描述

data_nodes

否

Array of strings

metadata恢复目标dn。

instance_id

否

String

实例id。

响应参数

状态码：202

表6 响应Body参数

参数

参数类型

描述

job_id

String

任务id

状态码：400

表7 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_msg

String

错误消息。

状态码：500

表8 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_msg

String

错误消息。

请求示例

{
  "source" : {
    "backup_id" : "defa45b24d314e878fde930a61732e9dbr09"
  },
  "target" : {
    "instance_id" : "2f0324a93859487eb5566d75951fcd2din09"
  },
  "data_nodes" : [ "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

错误码

请参见错误码。

父主题： 备份管理

相关文档