文档首页/ 分布式数据库中间件 DDM/ API参考/ API(推荐)/ 备份管理/ 查询可用于时间点恢复的数据节点列表V3
更新时间:2025-11-28 GMT+08:00
分享

查询可用于时间点恢复的数据节点列表V3

功能介绍

查询可用于时间点恢复的数据节点列表

URI

GET /v3/{project_id}/instances/{instance_id}/backups/restorable-data-node

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

租户在某一region下的project ID。

instance_id

String

实例 ID。

表2 Query参数

参数

是否必选

参数类型

描述

target_instance_id

String

目标实例 ID。

source_dn_instance_id

String

源DN实例 ID。

restore_time

String

恢复时间。

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token。

通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。

响应参数

状态码:200

表4 响应Body参数

参数

参数类型

描述

target_data_nodes

Array of TargetDn4Restore objects

可用目标DN。

表5 TargetDn4Restore

参数

参数类型

描述

instance_name

String

实例名称。

instance_id

String

实例ID。

engine_name

String

引擎名称。

status

String

状态。

available

Boolean

是否可用。

unavailable_reason

String

无法使用原因。

vpc_name

String

虚拟私有云名称。

private_ip

String

私有ip。

状态码:400

表6 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_msg

String

错误消息。

状态码:500

表7 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_msg

String

错误消息。

请求示例

响应示例

状态码:400

bad request

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

状态码:500

server error

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

状态码

状态码

描述

200

ok

400

bad request

500

server error

错误码

请参见错误码

相关文档