文档首页/ 弹性内存存储 EMS/ API参考/ API/ 生命周期管理/ 缩容EMS数据面集群 - ShrinkCluster
更新时间：2026-05-25 GMT+08:00
查看PDF
分享

缩容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

参数解释

错误响应体。

取值范围

不涉及。

错误码

请参见错误码。

父主题： 生命周期管理

相关文档