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

获取可删除副本 - ValidateDeletableReplica

功能介绍

获取可删除的副本。

调用方法

请参见如何调用API。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。

  • 如果使用角色与策略授权，具体权限要求请参见权限和授权项。
  • 如果使用身份策略授权，需具备如下身份策略权限。

    授权项

    访问级别

    资源类型（*为必须）

    条件键

    别名

    依赖的授权项

    dcs:instance:scale

    Write

    instance *

    g:EnterpriseProjectId

    -

    -

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

参数解释：

错误信息。

取值范围：

不涉及。

error_code

String

参数解释：

错误码。

取值范围：

请参见错误码。

error_ext_msg

String

参数解释：

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

取值范围：

不涉及。

状态码：500

表5 响应Body参数

参数

参数类型

描述

error_msg

String

参数解释：

错误信息。

取值范围：

不涉及。

error_code

String

参数解释：

错误码。

取值范围：

请参见错误码。

error_ext_msg

String

参数解释：

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

取值范围：

不涉及。

请求示例

GET https://{dcs_endpoint}/v2/{project_id}/instances/{instance_id}/deletable-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

内部服务错误。

错误码

请参见错误码。

父主题： 生命周期管理