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

元数据恢复V3

功能介绍

元数据恢复

URI

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

是

RestoreMetaDataSource object

metadata恢复源。

target

是

RestoreMetaDataTarget object

metadata恢复目标。
表4 RestoreMetaDataSource

参数

是否必选

参数类型

描述

restore_time

否

Number

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

backup_id

否

String

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

参数

是否必选

参数类型

描述

data_nodes

是

Array of strings

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

与DDM实例同VPC、子网且能相互通信。

完成了PITR操作的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

错误消息。

请求示例

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

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

错误码

请参见错误码。

父主题： 备份管理

相关文档