错误码
5.2.5 删除集群
"containerNetwork" : { "mode" : "overlay_l2", "cidr" : "172.17.0.0/16"
},
"authentication" : { "mode" : "x509",
"authenticatingProxy" : { } },
"billingMode" : 0 }, "status" : {
"phase" : "Available", "endpoints" : [ {
"url" : "https://192.168.0.11:5443", "type" : "Internal"
} ] }}
状态码
状态码 描述
200 表示更新指定集群成功。
错误码
请参见错误码。
5.2.5 删除集群
功能介绍
该API用于删除一个指定的集群。
说明
集群管理的URL格式为：https://Endpoint/uri。其中uri为资源路径，也即API访问的路径。
调试
您可以在API Explorer中调试该接口。
URI
API 参考 5 API
表5-92 路径参数
参数 是否必选 参数类型 描述
project_id 是 String 项目ID，获取方式请参见如何获 取接口URI中参数
cluster_id 是 String 集群 ID，获取方式请参见如何 获取接口URI中参数
正则匹配：^[0-9a-z]{8}-[0-9a- z]{4}-[0-9a-z]{4}-[0-9a-z]{4}-[0-9a-z]{12}$
表5-93 Query 参数
参数 是否必选 参数类型 描述
delete_efs 否 String 是否删除SFS Turbo（极速文件 存储卷）， 枚举取值：
● true或block (执行删除流 程，失败则阻塞后续流程)
● try (执行删除流程，失败则 忽略，并继续执行后续流程)
● false或skip (跳过删除流程，
默认选项) 缺省值：false 枚举值：
● true
● block
● try
● false
● skip
API 参考 5 API
参数 是否必选 参数类型 描述
delete_eni 否 String 是否删除eni ports（原生弹性网 卡）， 枚举取值：
● true或block (执行删除流 程，失败则阻塞后续流程，
默认选项)
● try (执行删除流程，失败则 忽略，并继续执行后续流程)
● false或skip (跳过删除流程) 缺省值：block
枚举值：
● true
● block
● try
● false
● skip
delete_evs 否 String 是否删除evs（云硬盘）， 枚举 取值：
● true或block (执行删除流 程，失败则阻塞后续流程)
● try (执行删除流程，失败则 忽略，并继续执行后续流程)
● false或skip (跳过删除流程，
默认选项) 缺省值：false 枚举值：
● true
● block
● try
● false
● skip
API 参考 5 API
参数 是否必选 参数类型 描述
delete_net 否 String 是否删除elb（弹性负载均衡）
等集群Service/Ingress相关资 源。 枚举取值：
● true或block (执行删除流 程，失败则阻塞后续流程，
默认选项)
● try (执行删除流程，失败则 忽略，并继续执行后续流程)
● false或skip (跳过删除流程) 缺省值：block
枚举值：
● true
● block
● try
● false
● skip
delete_obs 否 String 是否删除obs（对象存储卷），
枚举取值：
● true或block (执行删除流 程，失败则阻塞后续流程)
● try (执行删除流程，失败则 忽略，并继续执行后续流程)
● false或skip (跳过删除流程，
默认选项) 缺省值：false 枚举值：
● true
● block
● try
● false
● skip
API 参考 5 API
参数 是否必选 参数类型 描述
delete_sfs 否 String 是否删除sfs（文件存储卷），
枚举取值：
● true或block (执行删除流 程，失败则阻塞后续流程)
● try (执行删除流程，失败则 忽略，并继续执行后续流程)
● false或skip (跳过删除流程，
默认选项) 缺省值：false 枚举值：
● true
● block
● try
● false
● skip
tobedeleted 否 String 是否使用包周期集群删除参数预 置模式（仅对包周期集群生 效）。 需要和其他删除选项参 数一起使用，未指定的参数，则 使用默认值。 使用该参数，集 群不执行真正的删除，仅将本次 请求的全部query参数都预置到 集群数据库中，用于包周期集群 退订时识别用户要删除的资源。
允许重复执行，覆盖预置的删除 参数。 枚举取值：
● true (预置模式，仅预置 query参数，不执行删除) 枚举值：
● true
请求参数
表5-94 请求 Header 参数
参数 是否必选 参数类型 描述
Content-Type 是 String 消息体的类型（格式）
缺省值：application/json
API 参考 5 API
参数 是否必选 参数类型 描述
X-Auth-Token 是 String "调用接口的认证方式分为 Token和AK/SK两种，如果您使 用的Token方式，此参数为必 填，请填写Token的值，获取方 式请参见获取token。"
最大长度：16384
响应参数
状态码： 200
表5-95 响应 Body 参数
参数 参数类型 描述
kind String API类型，固定值“Cluster”或“cluster”，该 值不可修改。
缺省值：Cluster
apiVersion String API版本，固定值“v3”，该值不可修改。
缺省值：v3 metadata ClusterMetad
ata object 集群的基本信息，为集合类的元素类型，包含一
组由不同名称定义的属性。
spec ClusterSpec
object spec是集合类的元素类型，您对需要管理的集群 对象进行详细描述的主体部分都在spec中给出。
CCE通过spec的描述来创建或更新对象。
status ClusterStatus
object 集合类的元素类型，用于记录对象在系统中的当 前状态信息，包含了集群状态和本次创建集群作 业的jobID
表5-96 ClusterMetadata
参数 参数类型 描述
name String 集群名称。
命名规则：以小写字母开头，由小写字母、数 字、中划线(-)组成，长度范围4-128位，且不能 以中划线(-)结尾。
最小长度：4 最大长度：128
API 参考 5 API
参数 参数类型 描述
uid String 资源唯一标识，创建成功后自动生成，填写无效 正则匹配：^[0-9a-z]{8}-[0-9a-z]{4}-[0-9a-z]
{4}-[0-9a-z]{4}-[0-9a-z]{12}$
annotations Map<String,St
ring> 集群注解，由key/value组成：
"annotations": { "key1" : "value1", "key2" : "value2"
} 说明
● Annotations不用于标识和选择对象。Annotations 中的元数据可以是small 或large，structured 或 unstructured，并且可以包括标签不允许使用的字 符。
● 该字段不会被数据库保存，当前仅用于指定集群待 安装插件。
labels Map<String,St
ring> 集群标签，key/value对格式。
说明
该字段值由系统自动生成，用于升级时前端识别集群支 持的特性开关，用户指定无效。
creationTimes
tamp String 集群创建时间
updateTimest
amp String 集群更新时间
表5-97 ClusterSpec
参数 参数类型 描述
category String 集群类别：
● CCE：CCE集群
CCE集群支持虚拟机与裸金属服务器混合、
GPU、NPU等异构节点的混合部署，基于高性 能网络模型提供全方位、多场景、安全稳定的 容器运行环境。
● Turbo: CCE Turbo集群
全面基于云原生基础设施构建的云原生2.0的
参数 参数类型 描述
type String 集群管控面节点架构：
● VirtualMachine：管控面节点为x86架构服务 器
● ARM64: 管控面节点为鲲鹏（ARM架构）服务 器
枚举值：
● VirtualMachine
● ARM64
flavor String 字段默认值：创建CCE集群或鲲鹏集群时，如果 是非专属云为 cce.s1.small，专属云则为 cce.dec.s1.small；
集群规格，集群创建完成后规格不可再变更，请 按实际业务需求进行选择：
● cce.s1.small: 小规模单控制节点CCE集群（最 大50节点）
● cce.s1.medium: 中等规模单控制节点CCE集群
（最大200节点）
● cce.s2.small: 小规模多控制节点CCE集群（最 大50节点）
● cce.s2.medium: 中等规模多控制节点CCE集群
（最大200节点）
● cce.s2.large: 大规模多控制节点CCE集群（最 大1000节点）
● cce.s2.xlarge: 超大规模多控制节点CCE集群
（最大2000节点）
说明
● s1：单控制节点CCE集群。
● s2：多控制节点CCE集群。
● dec：专属CCE集群规格。如cce.dec.s1.small为小规 模单控制节点专属CCE集群（最大50节点）。
● 最大节点数：当前集群支持管理的最大节点规模，
请根据业务需求选择。
● 单控制节点集群：普通集群是单控制节点，控制节 点故障后，集群将不可用，但已运行工作负载不受 影响。
● 多控制节点集群：即高可用集群，当某个控制节点 故障时，集群仍然可用。查看集群模式请参见如何 排查已创建的集群是否为高可用集群？
API 参考 5 API
参数 参数类型 描述
version String 集群版本，与Kubernetes社区基线版本保持一 致，建议选择最新版本。
on String CCE集群平台版本号，仅供查看，不支持创建指 定，集群创建时自动选择对应集群版本的最新平 台版本。
description String 集群描述，对于集群使用目的的描述，可根据实 际情况自定义，默认为空。集群创建成功后可通
customSan Array of
strings 集群的API Server服务端证书中的自定义SAN
（Subject Alternative Name）字段，遵从SSL标 准X509定义的格式规范。
1. 不允许出现同名重复。
2. 格式符合IP和域名格式。
example: SAN 1: DNS Name=example.com SAN 2: DNS Name=www.example.com SAN 3:
DNS Name=example.net SAN 4: IP Address=93.184.216.34
ipv6enable Boolean 集群是否使用IPv6模式，1.15版本及以上支持。
hostNetwork HostNetwork
object 节点网络参数，包含了虚拟私有云VPC和子网的 ID信息，而VPC是集群内节点之间的通信依赖，
所以是必选的参数集。
containerNet
work ContainerNet
work object 容器网络参数，包含了容器网络类型和容器网段
的信息。
eniNetwork EniNetwork
object 云原生网络2.0网络配置，创建CCE Turbo集群
（公测中）时指定。
API 参考 5 API
参数 参数类型 描述 authenticatio
n Authenticati
on object 集群认证方式相关配置。
billingMode Integer 集群的计费方式。计费方式为“按需计费”时，
取值为“0”；计费方式为“包周期”时，取值为
“1”。若不填，则默认为“按需计费”。
缺省值：0 masters Array of
MasterSpec objects
控制节点的高级配置
kubernetesSvc
IpRange String 服务网段参数，kubernetes clusterIp取值范围，
1.11.7版本及以上支持。
clusterTags Array of ResourceTag objects
集群资源标签
kubeProxyMo
de String 服务转发模式，支持以下两种实现：
● iptables：社区传统的kube-proxy模式，完全 以iptables规则的方式来实现service负载均
● iptables
● ipvs
az String 可用区（仅查询返回字段）, CCE支持的可用区请 参考地区和终端节点获取。
extendParam ClusterExten dParam object
集群扩展字段，可配置多可用区集群、专属CCE 集群，以及将集群创建在特定的企业项目下等。
supportIstio Boolean 支持Istio
API 参考 5 API
表5-98 HostNetwork
参数 参数类型 描述
vpc String 用于创建控制节点的VPC的ID。该值在创建VPC 和子网中获取。
获取方法如下：
● 方法1：登录虚拟私有云服务的控制台界面，
在虚拟私有云的详情页面查找VPC ID。
● 方法2：通过虚拟私有云服务的API接口查询，
具体操作可参考查询VPC列表 说明
● 当前vpc-router容器网络模型不支持对接含拓展网段 的VPC。
● 若您的用户类型为企业用户，则需要保证vpc所属的 企业项目ID和集群创建时选择的企业项目ID一致。
集群所属的企业项目ID通过extendParam字段下的 enterpriseProjectId体现，该值默认为"0"，表示默 认的企业项目。
最小长度：0 最大长度：64
subnet String 用于创建控制节点的subnet的网络ID。获取方法 如下：
● 方法1：登录虚拟私有云服务的控制台界面，
单击VPC下的子网，进入子网详情页面，查找 网络ID。
方法2：通过虚拟私有云服务的API接口查询，具 体操作可参考查询子网列表
最小长度：0 最大长度：64
SecurityGroup String 节点安全组ID，创建时指定无效
API 参考 5 API
表5-99 ContainerNetwork
参数 参数类型 描述
mode String 容器网络类型（只可选择其一）
● overlay_l2：通过OVS（OpenVSwitch）为容 器构建的overlay_l2网络。
● vpc-router：使用ipvlan和自定义VPC路由为容 器构建的Underlay的l2网络。
● eni：云原生网络2.0，深度整合VPC原生ENI弹 性网卡能力，采用VPC网段分配容器地址，支 持ELB直通容器，享有高性能，创建CCE Turbo集群（公测中）时指定。
说明
● 容器隧道网络（Overlay）：基于VXLAN技术实现的 Overlay容器网络。VXLAN是将以太网报文封装成
● VPC网络：基于VPC网络的自定义路由，直接将容器 网络承载于VPC网络之中。每个节点将会被分配固
● VPC网络：基于VPC网络的自定义路由，直接将容器 网络承载于VPC网络之中。每个节点将会被分配固