更新时间：2026-05-25 GMT+08:00
指定id删除集群实例 - DeleteClusterById
功能介绍
指定id删除集群实例。
URI
DELETE /v1/clusters/{cluster_id}
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| cluster_id | 是 | String | 参数解释 EMS集群的id。 约束限制 不涉及。 取值范围 必须为UUID格式。 默认取值 不涉及。 |
请求参数
无
响应参数
状态码：202
| 参数 | 参数类型 | 描述 |
|---|---|---|
| job_id | String | 参数解释 任务ID，可以通过任务查询接口查询任务执行详情。 取值范围 必须为以“short-”或“long-”开头，后跟字母、数字、连字符和下划线组成的字符串，长度为1-48个字符。 |
状态码：400
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 参数解释 错误码，用于标识具体的错误类型。 取值范围 不涉及。 |
| error_msg | String | 参数解释 错误描述，用于说明具体的错误信息。 取值范围 不涉及。 |
请求示例
删除ID为“620ac47b-718a-405a-8534-295582e8dc02”的集群，并释放相关ems资源
DELETE https://{endpoint}/v1/clusters/620ac47b-718a-405a-8534-295582e8dc02 响应示例
状态码：202
参数解释
指定id删除集群实例成功返回响应体。
取值范围
不涉及。
{
"job_id" : "short-123456"
} 状态码：400
参数解释
错误响应体。
取值范围
不涉及。
{
"error_code" : "EMS.00004000",
"error_msg" : "invalid parameter"
} 状态码
| 状态码 | 描述 |
|---|---|
| 202 | 参数解释 指定id删除集群实例成功返回响应体。 取值范围 不涉及。 |
| 400 | 参数解释 错误响应体。 取值范围 不涉及。 |
错误码
请参见错误码。
父主题： 生命周期管理
