文档首页/ 灵衢智算集群/ API参考/ API/ 集群管理/ 删除集群-DeleteCluster
更新时间:2026-10-08 GMT+08:00
分享

删除集群-DeleteCluster

功能介绍

通过集群ID删除用户的集群。适用于以下场景:用户删除超节点资源后,如果不继续使用该集群,可以调用此接口删除。删除前需保证集群下没有任何其他关联资源。

调试

您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。

授权信息

账号根用户具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备如下身份策略权限,更多的权限说明请参见权限和授权项。

授权项

访问级别

资源类型(*为必须)

条件键

别名

依赖的授权项

aics::deleteCluster

Write

-

-

-

-

URI

DELETE /v2/{project_id}/clusters/{cluster_id}

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

参数解释:

项目ID,获取方法请参见获取项目ID。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

cluster_id

是

String

参数解释:

集群唯一标识UUID。

约束限制:

不涉及。

取值范围:

UUID格式,[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}。

默认取值:

不涉及。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

否

String

参数解释:

用户Token,通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

响应参数

状态码:204

成功删除集群。

无

请求示例

删除集群请求示例。使用场景:用户删除超节点资源后,不再需要该集群时,通过集群ID删除集群。删除前需保证集群下没有任何关联资源。

DELETE https://{endpoint}/v2/0605767a3300d5762fb7c0186d9e1779/clusters/c69808bd-6832-49d4-8c04-fe631f7640c5

响应示例

无

状态码

状态码

描述

204

成功删除集群。

错误码

请参见错误码。

相关文档