# 缩容EMS数据面集群 - ShrinkCluster
#### 功能介绍
缩容EMS数据面集群。支持EMS数据面集群粒度的并发扩缩容，任务进入队列等待调度执行，返回ems-custom-{uuid}格式的jobId。
#### URI
POST /v1/clusters/{cluster_id}/shrink
表1路径参数 
| 参数         | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                          |
|:---|:---|:---|:---|
| cluster_id | 是    | String | **参数解释** EMS集群的id。 **约束限制** 不涉及。 **取值范围** 必须为UUID格式。 **默认取值** 不涉及。 |
   
#### 请求参数
表2请求Header参数 
| 参数             | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                              |
|:---|:---|:---|:---|
| X-Client-Token | 否    | String | **参数解释** 幂等请求标识。 携带相同幂等请求标识的数据，必须确保和之前请求的集群id、缩容节点保持一致。 **约束限制** 不涉及。 **取值范围** 必须为UUID格式。 **默认取值** 不涉及。 |
   
表3请求Body参数 
| 参数             | 是否必选 | 参数类型             | 描述                                                                                                                                                                                                                                                                                           |
|:---|:---|:---|:---|
| node_name_list | 是    | Array of strings | **参数解释** 缩容节点名称列表。 **约束限制** 不涉及。 **取值范围** 缩容节点数不超过48。 **默认取值** 不涉及。 |
   
#### 响应参数
**状态码：202**
表4响应Body参数 
| 参数     | 参数类型   | 描述                                                                                                                                           |
|:---|:---|:---|
| job_id | String | **参数解释** 任务ID，可以通过任务查询接口查询任务执行详情。 **取值范围** 不涉及。 |
   
**状态码：400**
表5响应Body参数 
| 参数         | 参数类型   | 描述                                                                                                                                    |
|:---|:---|:---|
| error_code | String | **参数解释** 错误码，用于标识具体的错误类型。 **取值范围** 不涉及。  |
| error_msg  | String | **参数解释** 错误描述，用于说明具体的错误信息。 **取值范围** 不涉及。 |
   
#### 请求示例
缩容ID为"620ac47b-718a-405a-8534-295582e8dc02"的集群，缩减节点IP为"192.168.0.126"。
```
POST https://{endpoint}/v1/clusters/620ac47b-718a-405a-8534-295582e8dc02/shrink
{
  "node_name_list" : [ "192.168.0.126" ]
}
```
#### 响应示例
**状态码：202**
**参数解释**
缩容EMS数据面集群成功返回响应体。
**取值范围**
不涉及。
```
{
  "job_id" : "long-451496c1-41cb-44bc-a0c2-facbfd2ec311"
}
```
**状态码：400**
**参数解释**
错误响应体。
**取值范围**
不涉及。
```
{
  "error_code" : "EMS.00004000",
  "error_msg" : "invalid parameter"
}
```
#### 状态码
| 状态码 | 描述                                                                                                                                     |
|:---|:---|
| 202 | **参数解释** 缩容EMS数据面集群成功返回响应体。 **取值范围** 不涉及。 |
| 400 | **参数解释** 错误响应体。 **取值范围** 不涉及。             |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-ems/ems_04_0031.html)。