文档首页> 分布式缓存服务 DCS> API参考> API V2（推荐）> 生命周期管理> 获取可删除副本
更新时间：2023-12-12 GMT+08:00
在线调试
CLI示例
查看PDF

获取可删除副本

功能介绍

获取可删除的副本。

调用方法

请参见如何调用API。

URI

GET /v2/{project_id}/instances/{instance_id}/deletable-replication

表1 路径参数

参数

是否必选

参数类型

描述

instance_id

是

String

实例ID。

project_id

是

String

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

请求参数

无

响应参数

状态码： 200

表2 响应Body参数

参数

参数类型

描述

check_result

Boolean

是否有可供选择的副本组进行删除。

available_zone

String

可选的可用区ID列表。

replication_list

Array of ReplicationInfo objects

可选的保留节点列表。
表3 ReplicationInfo

参数

参数类型

描述

replication_id

String

副本ID。

node_id

String

节点ID。

replication_ip

String

副本的IP和端口。

group_id

String

分片ID。

group_name

String

分片名称。

available_zone

String

可用区ID。

状态码： 400

表4 响应Body参数

参数

参数类型

描述

error_msg

String

错误信息。

最大长度：1024

error_code

String

错误码。

最大长度：9

error_ext_msg

String

扩展错误信息（暂未使用，赋值为null）。

最大长度：1024

状态码： 500

表5 响应Body参数

参数

参数类型

描述

error_msg

String

错误信息。

最大长度：1024

error_code

String

错误码。

最大长度：9

error_ext_msg

String

扩展错误信息（暂未使用，赋值为null）。

最大长度：1024

请求示例

GET https://{dcs_endpoint}/v2/{project_id}/instances/{instance_id}/available-replication

响应示例

状态码： 200

获取可删除的副本成功。

{
  "check_result" : true,
  "available_zone" : "9f1c5806706d4c1fb0eb72f0a9b18c77",
  "replication_list" : [ {
    "replication_id" : "435a6322-0c64-4d0e-8bc2-8adefa2eca26",
    "node_id" : "8abf6e1e7fd3e695017fd4046bb9006b",
    "replication_ip" : "192.168.73.139:6379",
    "group_id" : "cbf8deba-d69f-41b8-8556-83337d32ad40",
    "group_name" : "group-2",
    "available_zone" : "9f1c5806706d4c1fb0eb72f0a9b18c77"
  }, {
    "replication_id" : "193683cf-f693-4a6a-950a-20f615ed6c47",
    "node_id" : "8abf6e1e7fd3e695017fd4046bb8006a",
    "replication_ip" : "192.168.67.86:6379",
    "group_id" : "7a153688-d31d-4541-b635-191885c71e93",
    "group_name" : "group-1",
    "available_zone" : "9f1c5806706d4c1fb0eb72f0a9b18c77"
  }, {
    "replication_id" : "ae38792f-60b7-4c8c-b1dc-175f2151f85f",
    "node_id" : "8abf6e1e7fd3e695017fd4046bb40069",
    "replication_ip" : "192.168.66.157:6379",
    "group_id" : "4f26a524-1525-4975-82fa-b2291091f9e7",
    "group_name" : "group-0",
    "available_zone" : "9f1c5806706d4c1fb0eb72f0a9b18c77"
  } ]
}

状态码： 400

非法请求。

{
  "error_code" : 111400800,
  "error_msg" : "Only native cluster supported."
}

状态码： 500

内部服务错误。

{
  "error_code" : 111500024,
  "error_msg" : "Query instance error."
}

状态码

状态码

描述

200

获取可删除的副本成功。

400

非法请求。

500

内部服务错误。

错误码

请参见错误码。

父主题： 生命周期管理