# 获取可删除副本 - ValidateDeletableReplica
#### 功能介绍
获取可删除的副本。
#### 调用方法
请参见[如何调用API](https://support.huaweicloud.com/api-dcs/api-call-process.html)。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-dcs/api-grant-policy.html)。
- 如果使用身份策略授权，需具备如下身份策略权限。
  
  | 授权项                | 访问级别  | 资源类型（\*为必须） | 条件键                                                                                                                                                                                                                                                                                                                                                                                                            | 别名 | 依赖的授权项 |
  |:---|:---|:---|:---|:---|:---|
  | dcs:instance:scale | Write | instance \* | - g:EnterpriseProjectId   - g:ResourceTag/\<tag-key\>    | -  | -      |
     
  
 
#### URI
GET /v2/{project_id}/instances/{instance_id}/deletable-replication
表1路径参数 
| 参数          | 是否必选 | 参数类型   | 描述                                                                                  |
|:---|:---|:---|:---|
| instance_id | 是    | String | 实例ID。                                                                               |
| project_id  | 是    | String | 项目ID。获取方法请参见[获取项目ID](https://support.huaweicloud.com/api-dcs/dcs-api-0312045.html)。 |
   
#### 请求参数
无
#### 响应参数
**状态码：200**
表2响应Body参数 
| 参数               | 参数类型                                                                                    | 描述               |
|:---|:---|:---|
| check_result     | Boolean                                                                                 | 是否有可供选择的副本组进行删除。 |
| available_zone   | String                                                                                  | 可选的可用区ID列表。      |
| replication_list | Array of [ReplicationInfo] objects | 可选的保留节点列表。       |
   
 表3ReplicationInfo 
| 参数             | 参数类型   | 描述        |
|:---|:---|:---|
| 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 | **参数解释**： 错误码。 **取值范围**： 请参见[错误码](https://support.huaweicloud.com/api-dcs/ErrorCode.html)。 |
| error_ext_msg | String | **参数解释**： 扩展错误信息（暂未使用，不返回）。 **取值范围**： 不涉及。                                                 |
   
**状态码：500**
表5响应Body参数 
| 参数            | 参数类型   | 描述                                                                                                                                                                                                                             |
|:---|:---|:---|
| error_msg     | String | **参数解释**： 错误信息。 **取值范围**： 不涉及。                                                             |
| error_code    | String | **参数解释**： 错误码。 **取值范围**： 请参见[错误码](https://support.huaweicloud.com/api-dcs/ErrorCode.html)。 |
| error_ext_msg | String | **参数解释**： 扩展错误信息（暂未使用，不返回）。 **取值范围**： 不涉及。                                                 |
   
#### 请求示例
```
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 | 内部服务错误。     |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-dcs/ErrorCode.html)。