# 创建集群 - CreateCluster #### 功能介绍 该API用于创建一个空集群（即只有控制节点Master，没有工作节点Node）。请在调用本接口完成集群创建之后，通过[创建节点](https://support.huaweicloud.com/api-cce/cce_02_0242.html)添加节点。 ![](https://support.huaweicloud.com/api-cce/public_sys-resources/note_3.0-zh-cn.png) - 集群管理的URL格式为：https://Endpoint/uri。其中uri为资源路径，也即API访问的路径。 - 调用该接口创建集群时，默认不安装ICAgent，若需安装ICAgent，可在请求Body参数的annotations中加入"cluster.install.addons.external/install":"\[{"addonTemplateName":"icagent"}\]"的集群注解，将在创建集群时自动安装ICAgent。ICAgent是应用性能管理APM的采集代理，运行在应用所在的服务器上，用于实时采集探针所获取的数据，安装ICAgent是使用应用性能管理APM的前提。 #### 接口约束 调用CCE接口创建集群之前，请检查是否已满足如下条件： - 创建集群之前，您必须先确保已存在**虚拟私有云** ，否则无法创建集群。若您已有虚拟私有云，可重复使用，无需重复创建。虚拟私有云为CCE集群提供一个隔离的、用户自主配置和管理的虚拟网络环境。若您没有虚拟私有云，请先进行创建，详情请参见[创建VPC](https://support.huaweicloud.com/api-vpc/vpc_api01_0001.html)。 - 创建集群之前，请提前规划好容器网段和服务网段。容器隧道网络模式的集群在创建之后，无法修改网段参数；vpc网络模式/云原生网络模式的集群在创建后可以新增网段参数/子网参数，不可修改已有网段参数/子网参数，需要重新创建集群才能调整，请谨慎选择。 - 请确保已正确创建委托，并确保委托未被删除，委托校验失败将导致集群创建失败。建议登录CCE控制台，如没有创建委托，会提示您创建，如已经创建则无提示。 - 默认情况下，一个账户只能创建5个集群（每个Region下），如果您需要创建更多的集群，请申请增加配额。详情请参见[如何申请扩大配额](https://support.huaweicloud.com/cce_faq/cce_faq_00154.html#section2)。 #### 调用方法 请参见[如何调用API](https://support.huaweicloud.com/api-cce/cce_02_0099.html)。 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。 - 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-cce/cce_02_0395.html)。 - 如果使用身份策略授权，需具备如下身份策略权限。 | 授权项 | 访问级别 | 资源类型（\*为必须） | 条件键 | 别名 | 依赖的授权项 | |:---|:---|:---|:---|:---|:---| | cce:cluster:createCluster | Write | cluster \* | - | cce:cluster:create | - | | cce:cluster:createCluster | Write | - | - g:EnterpriseProjectId - g:TagKeys - g:RequestTag/\ - cce:AssociatePublicIp - cce:VpcId - cce:SubnetId | cce:cluster:create | - | #### URI POST /api/v3/projects/{project_id}/clusters 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | project_id | 是 | String | **参数解释：** 项目ID，获取方式请参见[如何获取接口URI中参数](https://support.huaweicloud.com/api-cce/cce_02_0271.html)。 **约束限制：** 不涉及 **取值范围：** 账号的项目ID **默认取值：** 不涉及 | #### 请求参数 表2请求Header参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | Content-Type | 是 | String | **参数解释：** 消息体的类型（格式），默认为application/json，有其他取值时会在具体接口中专门说明。 **约束限制：** GET方法不做校验 **取值范围：** 不涉及 **默认取值：** 不涉及 | | X-Auth-Token | 是 | String | **参数解释：** 调用接口的认证方式分为Token和AK/SK两种，如果您使用的Token方式，此参数为必填，请填写Token的值，获取方式请参见[获取token](https://support.huaweicloud.com/api-cce/cce_02_0004.html)。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 | 表3请求Body参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | kind | 是 | String | **参数解释：** API类型。 **约束限制：** 该值不可修改 **取值范围：** - Cluster - cluster **默认取值：** 不涉及 | | apiVersion | 是 | String | **参数解释：** API版本。 **约束限制：** 该值不可修改 **取值范围：** - v3 **默认取值：** 不涉及 | | metadata | 是 | [ClusterMetadata] object | **参数解释：** 集群的基本信息，为集合类的元素类型，包含一组由不同名称定义的属性。 **约束限制：** 不涉及 | | spec | 是 | [CreateClusterRequestSpec] object | **参数解释：** spec是集合类的元素类型，您对需要管理的集群对象进行详细描述的主体部分都在spec中给出。CCE通过spec的描述来创建或更新对象。 **约束限制：** 不涉及 | 表4ClusterMetadata | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | name | 是 | String | **参数解释：** 集群名称。 **约束限制：** 不涉及 **取值范围：** 以小写字母开头，由小写字母、数字、中划线(-)组成，长度范围4-128位，且不能以中划线(-)结尾。 **默认取值：** 不涉及 | | uid | 否 | String | **参数解释：** 集群ID，资源唯一标识。 **约束限制：** 创建成功后自动生成，填写无效。在创建包周期集群时，响应体不返回集群ID。 **取值范围：** 不涉及 **默认取值：** 不涉及 | | alias | 否 | String | **参数解释：** 集群显示名，用于在 CCE 界面显示，该名称创建后可修改。显示名和其他集群的名称、显示名不可以重复。 **约束限制：** 在创建集群、更新集群请求体中，集群显示名alias未指定或取值为空，表示与集群名称name一致。在创建集群等响应体中，集群显示名alias未配置时将不返回。 **取值范围：** 以中文或英文字符开头，由数字、中文、英文字符、中划线（-）组成，长度范围 4-128位，且不能以中划线（-）开头和结尾。 **默认取值：** 不涉及 | | annotations | 否 | Map\ | **参数解释：** 集群注解，由key/value组成： ``` "annotations": { "key1" : "value1", "key2" : "value2" } ``` **约束限制：** 该字段不会被数据库保存，当前仅用于指定集群待安装插件。 **取值范围：** 不涉及 **默认取值：** 不涉及 说明： - Annotations不用于标识和选择对象。Annotations中的元数据可以是small或large，structured或unstructured，并且可以包括标签不允许使用的字符。 - 可通过加入"cluster.install.addons.external/install": "\[{\\"addonTemplateName\\":\\"icagent\\"}\]"的键值对在创建集群时安装ICAgent。 | | labels | 否 | Map\ | **参数解释：** 集群标签，key/value对格式。 **约束限制：** 该字段值由系统自动生成，用于升级时前端识别集群支持的特性开关，用户指定无效。 **取值范围：** 不涉及 **默认取值：** 不涉及 | | creationTimestamp | 否 | String | **参数解释：** 集群创建时间。 **约束限制：** 创建集群时自动记录，不支持传入。 **取值范围：** 不涉及 **默认取值：** 不涉及 | | updateTimestamp | 否 | String | **参数解释：** 集群更新时间。 **约束限制：** 更新集群时自动记录，不支持传入。 **取值范围：** 不涉及 **默认取值：** 不涉及 | | timezone | 否 | String | **参数解释：** 集群时区。[IANA Time Zone Database](https://www.iana.org/time-zones)中收录的时区名称, 例如："Asia/Shanghai"。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 | 表5CreateClusterRequestSpec | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | category | 否 | String | **参数解释：** 集群类别。 **约束限制：** 不涉及 **取值范围：** - CCE：CCE集群 - Turbo: CCE Turbo集群。 CCE集群支持虚拟机与裸金属服务器混合、GPU、NPU等异构节点的混合部署，基于高性能网络模型提供全方位、多场景、安全稳定的容器运行环境。 全面基于云原生基础设施构建的云原生2.0的容器引擎服务，具备软硬协同、网络无损、安全可靠、调度智能的优势，为用户提供一站式、高性价比的全新容器服务体验。 **默认取值：** 容器网络参数设置非eni模式时，默认为CCE 容器网络参数设置为eni模式时，默认为Turbo | | agencyName | 否 | String | **参数解释：** 指定集群使用的委托。该委托用于生成集群中组件使用的临时访问凭证，在集群中自动创建其他相关云服务的资源时会使用该委托权限。当不传或为空时，集群将自动选择使用CCE的系统委托cce_admin_trust或cce_cluster_agency。 说明： 关于CCE系统委托的说明详情参见[系统委托说明](https://support.huaweicloud.com/usermanual-cce/cce_10_0556.html) **约束限制：** 仅1.27及以上版本集群支持该参数 **取值范围：** 不涉及 **默认取值：** 空 | | type | 否 | String | **参数解释：** 集群Master节点架构 **约束限制：** 不涉及 **取值范围：** - VirtualMachine：Master节点为x86架构服务器 - ARM64: Master节点为鲲鹏（ARM架构）服务器 **默认取值：** VirtualMachine，如若VirtualMachine资源不足，取值为ARM64 | | flavor | 否 | String | **参数解释：** 集群规格，当集群为v1.15及以上版本时支持创建后变更，详情请参见[变更集群规格](https://support.huaweicloud.com/api-cce/ResizeClusterFlavor.html)。请按实际业务需求进行选择 **约束限制：** 不涉及 **取值范围：** - cce.s1.small: 小规模单控制节点CCE集群（最大50节点） - cce.s1.medium: 中等规模单控制节点CCE集群（最大200节点） - cce.s1.large: 大规模单控制节点CCE集群（最大1000节点） - cce.s2.small: 小规模三控制节点CCE集群（最大50节点） - cce.s2.medium: 中等规模三控制节点CCE集群（最大200节点） - cce.s2.large: 大规模三控制节点CCE集群（最大1000节点） - cce.s2.xlarge: 超大规模三控制节点CCE集群（最大2000节点） 专属云特殊规格如下： - cce.dec.s1.small: 小规模单控制节点的专属云CCE集群（最大50节点） - cce.dec.s1.medium: 中等规模单控制节点的专属云CCE集群（最大200节点） - cce.dec.s1.large: 大规模单控制节点的专属云CCE集群（最大1000节点） - cce.dec.s1.xlarge: 超大规模单控制节点的专属云CCE集群（最大2000节点） - cce.dec.s2.small: 小规模三控制节点的专属云CCE集群（最大50节点） - cce.dec.s2.medium: 中等规模三控制节点的专属云CCE集群（最大200节点） - cce.dec.s2.large: 大规模三控制节点的专属云CCE集群（最大1000节点） - cce.dec.s2.xlarge: 超大规模三控制节点的专属云CCE集群（最大2000节点） **默认取值：** cce.s1.small 专属云场景默认为cce.dec.s1.small 说明： 关于规格参数中的字段说明如下： - s1：单控制节点的集群，控制节点数为1。单控制节点故障后，集群将不可用，但已运行工作负载不受影响。 - s2：三控制节点的集群，即高可用集群，控制节点数为3。当某个控制节点故障时，集群仍然可用。 - dec：表示专属云的CCE集群规格。例如cce.dec.s1.small表示小规模单控制节点的专属云CCE集群（最大50节点）。 - small：表示集群支持管理的最大节点规模为50节点。 - medium：表示集群支持管理的最大节点规模为200节点。 - large：表示集群支持管理的最大节点规模为1000节点。 - xlarge：表示集群支持管理的最大节点规模为2000节点。 | | version | 否 | String | **参数解释：** 集群版本，与Kubernetes社区基线版本保持一致，建议选择最新商用版本。 说明： 关于Kubernetes版本策略，请参见[Kubernetes版本策略](https://support.huaweicloud.com/bulletin-cce/cce_bulletin_0033.html) - Turbo集群支持1.19及以上版本商用。 在CCE控制台支持创建三种最新版本的集群。可登录CCE控制台创建集群，在"版本"处获取到集群版本。 其它集群版本，当前仍可通过api创建，但后续会逐渐下线，具体下线策略请关注CCE官方公告。 **约束限制：** 格式必须为：vX.Y\[.Z\[-rN\]\]，例如 v1.30，v1.30.0，v1.30.0-r0 都将创建1.30版本的集群 - X: 对应社区Kubernetes的主要版本 - Y: 对应社区Kubernetes的次要版本 - Z: 对应社区Kubernetes的补丁版本 - N: 对应CCE补丁版本，关于CCE补丁版本详情，请参见[补丁版本发布记录](https://support.huaweicloud.com/bulletin-cce/cce_10_0405.html) **取值范围：** 不涉及 **默认取值：** - 若不配置，默认创建最新版本的集群。 - 若指定集群基线版本但是不指定具体r版本，则系统默认选择对应集群版本的最新r版本。建议不指定具体r版本由系统选择最新版本。 | | platformVersion | 否 | String | **参数解释：** CCE集群平台版本号，表示集群版本(version)下的内部版本。用于跟踪某一集群版本内的迭代，集群版本内唯一，跨集群版本重新计数。 **约束限制：** 不支持用户指定，集群创建时自动选择对应集群版本的最新平台版本。 **取值范围：** platformVersion格式为：cce.X.Y - X: 表示内部特性版本。集群版本中特性或者补丁修复，或者OS支持等变更场景。其值从1开始单调递增。 - Y: 表示内部特性版本的补丁版本。仅用于特性版本上线后的软件包更新，不涉及其他修改。其值从0开始单调递增。 **默认取值：** 不涉及 | | legacyVersion | 否 | String | **参数解释：** CCE集群旧版本（已废弃），无实际功能，仅用于集群version与platformVersion组合展示，该版本号全局内唯一。如集群version为va.b, platformVersion为cce.X.Y，则legacyVersion值为va.b.X-rY。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 | | description | 否 | String | **参数解释：** 集群描述，对于集群使用目的的描述，可根据实际情况自定义，默认为空。集群创建成功后可通过接口[更新指定的集群](https://support.huaweicloud.com/api-cce/cce_02_0240.html)来做出修改，也可在CCE控制台中对应集群的"集群详情"下的"描述"处进行修改。 **约束限制：** 仅支持utf-8编码，长度必须小于等于200个字节 **取值范围：** 不涉及 **默认取值：** 不涉及 | | customSan | 否 | Array of strings | **参数解释：** 集群的API Server服务端证书中的自定义SAN（Subject Alternative Name）字段，遵从SSL标准X509定义的格式规范。 **约束限制：** 不允许出现同名重复。 **取值范围：** 格式符合IP和域名格式。 **默认取值：** 不涉及 示例: ``` 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版本及以上支持。 **约束限制：** 开启IPv6后不支持iptables转发模式；VPC网络模式不支持IPv4/IPv6双栈网络。 **取值范围：** - true: 开启IPv4/IPv6双栈模式 - false: 仅使用IPv4模式 **默认取值：** false | | hostNetwork | 是 | [HostNetwork] object | **参数解释：** 节点网络参数，包含了虚拟私有云VPC和子网的ID信息，而VPC是集群内节点之间的通信依赖，所以是必选的参数集。 **约束限制：** 不涉及 | | containerNetwork | 是 | [ContainerNetwork] object | **参数解释：** 容器网络参数，包含了容器网络类型和容器网段的信息。 **约束限制：** 不涉及 | | eniNetwork | 否 | [EniNetwork] object | **参数解释：** 云原生网络2.0网络配置，创建CCE Turbo集群时指定。 **约束限制：** 不涉及 | | serviceNetwork | 否 | [ServiceNetwork] object | **参数解释：** 服务网段参数，包含IPv4 CIDR。 **约束限制：** 不涉及 | | publicAccess | 否 | [PublicAccess] object | **参数解释：** 集群API访问控制。 **约束限制：** 不涉及 | | authentication | 否 | [Authentication] object | **参数解释：** 集群认证方式相关配置。 **约束限制：** 不涉及 | | billingMode | 否 | Integer | **参数解释：** 集群的计费方式。 **约束限制：** 不涉及 **取值范围：** - 0: 按需计费 - 1: 包周期 **默认取值：** 默认0。 | | masters | 否 | Array of [MasterSpec] objects | **参数解释：** 集群控制节点的高级配置，支持指定控制节点的可用区。 **约束限制：** 该参数未配置时将不返回。 | | kubernetesSvcIpRange | 否 | String | **参数解释：** 服务网段参数，kubernetes clusterIP取值范围，1.11.7版本及以上支持。创建集群时如若未传参，默认为"10.247.0.0/16"。该参数废弃中，推荐使用新字段serviceNetwork，包含IPv4服务网段。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 | | clusterTags | 否 | Array of [ResourceTag] objects | **参数解释：** 集群资源标签。 **约束限制：** 不涉及 | | kubeProxyMode | 否 | String | **参数解释：** 服务转发模式。 **约束限制：** 不涉及 **取值范围：** - nftables：仅1.35集群及以上版本支持。替代iptables的新一代转发模式，规则管理高效、性能更优，原生支持IPv6，适配各类Service规模与集群场景，兼顾高并发短链接与大规模集群需求。 - iptables：社区传统的kube-proxy模式，完全以iptables规则的方式来实现service负载均衡。该方式最主要的问题是在服务多的时候产生太多的iptables规则，非增量式更新会引入一定的时延，大规模情况下有明显的性能问题。 - ipvs：主导开发并在社区获得广泛支持的kube-proxy模式，采用增量式更新，吞吐更高，速度更快，并可以保证service更新期间连接保持不断开，适用于大规模场景。 **默认取值：** 1.35及以上版本默认使用nftables转发模式，1.35以下版本默认使用iptables转发模式。 | | az | 否 | String | **参数解释：** 可用区。 CCE支持的可用区请参考[地区和终端节点](https://console.huaweicloud.com/apiexplorer/#/endpoint/CCE)。 说明： 该字段将会废弃，推荐在**masters**字段中配置集群控制节点可用区 **约束限制：** 不涉及 | | extendParam | 否 | [ClusterExtendParam] object | **参数解释：** 集群扩展字段，可配置多可用区集群、专属CCE集群，以及将集群创建在特定的企业项目下等。 **约束限制：** 不涉及 | | enableDistMgt | 否 | Boolean | **参数解释：** 集群开启对分布式云支持。 **约束限制：** 目前只有Turbo集群支持。 **取值范围：** - true: 开启对分布式云支持 - false: 关闭对分布式云支持 **默认取值：** 默认false | | deletionProtection | 否 | Boolean | **参数解释：** 集群删除保护，如果开启后用户将无法删除该集群。 **约束限制：** 不涉及。 **取值范围：** - true: 开启集群删除保护 - false: 关闭集群删除保护 **默认取值：** 默认false | | configurationsOverride | 否 | Array of [PackageConfiguration] objects | **参数解释：** 覆盖集群默认组件配置。 当前支持的可配置组件及其参数详见[配置管理](https://support.huaweicloud.com/usermanual-cce/cce_10_0213.html)。 **约束限制：** 若指定了不支持的组件或组件不支持的参数，该配置项将被忽略。 | | clusterOps | 否 | [ClusterOps] object | **参数解释：** 集群运维相关配置。 **约束限制：** 不涉及 | | encryptionConfig | 否 | [EncryptionConfig] object | **参数解释**： secret资源落盘加密配置，当前仅支持配置一种加密方式。默认使用cce托管密钥（用户侧不感知该密钥）进行加密。 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及 | | secretConfig | 否 | [SecretConfig] object | **参数解释**： secret禁用配置，控制是否在集群中禁用以Secret形式静态存储的临时凭据。 **约束限制**： 支持的集群版本如下： - v1.28.15-r90及以上版本 - v1.29.15-r50及以上版本 - v1.30.14-r50及以上版本 - v1.31.14-r10及以上版本 - v1.32.9-r10及以上版本 - v1.33.7-r10及以上版本 - v1.34.3-r0及以上版本 **取值范围**： 不涉及 **默认取值**： 不涉及 | 表6HostNetwork | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | vpc | 是 | String | **参数解释：** 用于创建节点的VPC的ID。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 获取方法如下： - 方法1：登录虚拟私有云服务的控制台界面，在虚拟私有云的详情页面查找VPC ID。 - 方法2：通过虚拟私有云服务的API接口查询。 链接请参见[查询VPC列表](https://support.huaweicloud.com/api-vpc/vpc_api01_0003.html)。 | | subnet | 是 | String | **参数解释：** 用于创建节点的子网的网络ID。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 获取方法如下： - 方法1：登录虚拟私有云服务的控制台界面，单击VPC下的子网，进入子网详情页面，查找网络ID。 - 方法2：通过虚拟私有云服务的查询子网列表接口查询，获取响应中neutron_network_id字段的值。 链接请参见[查询子网列表](https://support.huaweicloud.com/api-vpc/vpc_subnet01_0003.html)。 | | SecurityGroup | 否 | String | **参数解释：** 集群默认的Node节点安全组ID。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** - 不指定该字段系统将自动为用户创建默认Node节点安全组。 - 指定该字段时集群将绑定指定的安全组。 说明： 指定Node节点安全组需要放通部分端口来保证正常通信。详细设置请参考[集群安全组规则配置](https://support.huaweicloud.com/cce_faq/cce_faq_00265.html)。 | | controlPlaneSecurityGroup | 否 | String | **参数解释：** 集群控制面节点安全组ID。 **约束限制：** 创建成功后自动生成，填写无效。 **取值范围：** 不涉及 **默认取值：** 不涉及 | | autoGenerateSecurityGroupHardeningConfig | 否 | [AutoGenerateSecurityGroupHardeningConfigSpec] object | **参数解释：** 自动创建安全组时的安全加固策略。 **约束限制：** 若指定了节点安全组SecurityGroup，该配置项将被忽略。 只针对CCE Standard和Turbo集群的node安全组生效，不支持master安全组，不支持eni安全组。 **取值范围：** 不涉及 **默认取值：** 不涉及 | 表7AutoGenerateSecurityGroupHardeningConfigSpec | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | portsToDisable | 否 | Array of strings | **参数解释：** 自动创建安全组时可选择不开放node节点相关端口，支持单端口和端口段两种形式。示例如下： ``` "portsToDisable": ["22", "4090-4099"] ``` **约束限制：** 若指定了节点安全组SecurityGroup，该配置项将被忽略。 只针对CCE Standard和Turbo集群的node安全组生效，不支持master安全组，不支持eni安全组。 **取值范围：** 端口号仅支持整数，范围\[1-65535\] **默认取值：** 不涉及 | 表8ContainerNetwork | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | mode | 是 | String | **参数解释：** 容器网络类型。 **约束限制：** 只可选择一个容器网络类型。 **取值范围：** - overlay_l2：容器隧道网络，通过OVS（OpenVSwitch）为容器构建的overlay_l2网络。 - vpc-router：VPC网络，使用ipvlan和自定义VPC路由为容器构建的Underlay的l2网络。 - eni：云原生网络2.0，深度整合VPC原生ENI弹性网卡能力，采用VPC网段分配容器地址，支持ELB直通容器，享有高性能，创建CCE Turbo集群时指定。 **默认取值：** 不涉及 | | cidr | 否 | String | **参数解释：** 容器网络网段，建议使用网段10.0.0.0/12\~19，172.16.0.0/16\~19，192.168.0.0/16\~19，如存在网段冲突，将会报错。 **约束限制：** 此参数在集群创建后不可更改，请谨慎选择。（已废弃，如填写cidrs将忽略该cidr） vpc网络模式的集群在创建后可以新增网段参数，不可修改已有网段参数，需要重新创建集群才能调整。 **取值范围：** 满足IPv4 CIDR格式 **默认取值：** 不填此参数时，将从172.(16 \~ 31).0.0/16、10.(0 \| 16 \| 32 \| 48 \| 64 \| 80 \| 96 \| 112).0.0/12中随机分配一个不冲突的网段供用户使用。 | | cidrs | 否 | Array of [ContainerCIDR] objects | **参数解释：** 容器网络网段列表。1.21及新版本集群使用cidrs字段，当集群网络类型为vpc-router类型时，支持多个容器网段，最多配置20个；1.21之前版本若使用cidrs字段，则取值cidrs数组中的第一个cidr元素作为容器网络网段地址。 **约束限制：** 容器隧道网络模式的集群在创建之后，无法修改网段参数； vpc网络模式的集群在创建后可以新增网段参数，不可修改已有网段参数，需要重新创建集群才能调整。 | | enableContainerCIDRsReservation | 否 | Boolean | **参数解释**： VPC容器网段预留。在VPC的默认路由表中添加容器网段路由，避免创建与容器网段冲突的子网。支持的集群版本如下： - v1.28.15-r70及以上版本 - v1.29.15-r30及以上版本 - v1.30.14-r30及以上版本 - v1.31.10-r30及以上版本 - v1.32.6-r30及以上版本 - v1.33.5-r20及以上版本 **约束限制**： 仅支持VPC网络模型集群。不支持集群设置不生效。 **取值范围**： - false：不开启VPC容器网段预留 - true：开启VPC容器网段预留 **默认取值**： false | 表9ContainerCIDR | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | cidr | 是 | String | **参数解释：** 容器网络网段，建议使用网段10.0.0.0/12\~19，172.16.0.0/16\~19，192.168.0.0/16\~19。 **约束限制：** 如存在网段冲突，将会报错。 **取值范围：** 不涉及 **默认取值：** 不涉及 | 表10EniNetwork | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | eniSubnetId | 否 | String | **参数解释：** ENI所在子网的IPv4子网ID。 **约束限制：** 暂不支持IPv6。该字段将会被废弃，推荐使用新字段subnets。 **取值范围：** 不涉及 **默认取值：** 不涉及 获取方法如下： - 方法1：登录虚拟私有云服务的控制台界面，单击VPC下的子网，进入子网详情页面，查找IPv4子网ID。 - 方法2：通过虚拟私有云服务的查询子网列表接口查询，获取响应中neutron_subnet_id字段的值。 链接请参见[查询子网列表](https://support.huaweicloud.com/api-vpc/vpc_subnet01_0003.html)。 | | eniSubnetCIDR | 否 | String | **参数解释：** ENI子网CIDR。 **约束限制：** 废弃中，推荐使用新字段subnets。 **取值范围：** 不涉及 **默认取值：** 不涉及 | | subnets | 是 | Array of [NetworkSubnet] objects | **参数解释：** IPv4子网ID列表。 **约束限制：** 不涉及 | 表11NetworkSubnet | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | subnetID | 是 | String | **参数解释：** 用于创建容器网卡的子网的IPv4子网ID。 **约束限制：** 暂不支持IPv6 **取值范围：** 不涉及 **默认取值：** 不涉及 获取方法如下： - 方法1：登录虚拟私有云服务的控制台界面，单击VPC下的子网，进入子网详情页面，查找IPv4子网ID。 - 方法2：通过虚拟私有云服务的查询子网列表接口查询，获取响应中neutron_subnet_id字段的值。 链接请参见[查询子网列表](https://support.huaweicloud.com/api-vpc/vpc_subnet01_0003.html)。 | 表12ServiceNetwork | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | IPv4CIDR | 否 | String | **参数解释：** kubernetes clusterIP IPv4 CIDR取值范围。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 默认为"10.247.0.0/16"。 | | IPv6CIDR | 否 | String | **参数解释：** kubernetes clusterIP IPv6 CIDR取值范围。 **约束限制：** 仅开启IPV6双栈的Turbo集群支持配置IPv6服务网段。 **取值范围：** 不涉及 **默认取值：** Turbo集群默认为"fc00::/112" CCE集群默认为"fd00:1234::/120" | 表13PublicAccess | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | cidrs | 否 | Array of strings | **参数解释：** 允许访问集群API的白名单网段列表，建议对VPC网段、容器网段放通。 **约束限制：** 该字段仅支持创建集群时传入，更新时指定无效 **取值范围：** 不涉及 **默认取值：** 默认无白名单配置，为\["0.0.0.0/0"\]。 | 表14Authentication | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | mode | 否 | String | **参数解释：** 集群认证模式。 **约束限制：** 不涉及 **取值范围：** - kubernetes 1.11及之前版本的集群支持"x509"、"rbac"和"authenticating_proxy"，默认取值为"x509"。 - kubernetes 1.13版本的集群支持"rbac"和"authenticating_proxy"，默认取值为"rbac"。 - kubernetes 1.15及以上版本的集群支持"x509"、"rbac"和"authenticating_proxy"，默认取值为"rbac"。 **默认取值：** - kubernetes 1.11及之前版本的集群默认取值为"x509"。 - kubernetes 1.13及以上版本的集群默认取值为"rbac"。 | | authenticatingProxy | 否 | [AuthenticatingProxy] object | **参数解释：** authenticatingProxy模式相关配置。 **约束限制：** 认证模式为authenticating_proxy时必选。 | 表15AuthenticatingProxy | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | ca | 否 | String | **参数解释：** authenticating_proxy模式配置的x509格式CA证书(base64编码)。 **约束限制：** 当集群认证模式为authenticating_proxy时，此项必须填写。 **取值范围：** 最大长度：1M。 **默认取值：** 不涉及 | | cert | 否 | String | **参数解释：** authenticating_proxy模式配置的x509格式CA证书签发的客户端证书，用于kube-apiserver到扩展apiserver的认证。(base64编码)。 **约束限制：** 当集群认证模式为authenticating_proxy时，此项必须填写。 **取值范围：** 最大长度：1M。 **默认取值：** 不涉及 | | privateKey | 否 | String | **参数解释：** authenticating_proxy模式配置的x509格式CA证书签发的客户端证书时对应的私钥，用于kube-apiserver到扩展apiserver的认证。Kubernetes集群使用的私钥尚不支持密码加密，请使用未加密的私钥。(base64编码)。 **约束限制：** 当集群认证模式为authenticating_proxy时，此项必须填写。 **取值范围：** 最大长度：1M。 **默认取值：** 不涉及 | 表16MasterSpec | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | availabilityZone | 否 | String | **参数解释：** 控制节点所在的可用区，需要指定可用区（AZ）的名称。 CCE支持的可用区请参考[地区和终端节点](https://console.huaweicloud.com/apiexplorer/#/endpoint/CCE) **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 | 表17ResourceTag | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | key | 否 | String | **参数解释：** Key值。 **约束限制：** 不涉及 **取值范围：** - 不能为空且首尾不能包含空格，最多支持128个字符 - 可用UTF-8格式表示的任意语种字母、数字和空格 - 支持部分特殊字符：_.:=+-@ - 不能以"_sys_"开头 **默认取值：** 不涉及 | | value | 否 | String | **参数解释：** Value值。 **约束限制：** 不涉及 **取值范围：** - 可以为空但不能缺省，最多支持255个字符 - 可用UTF-8格式表示的汉字、字母、数字和空格 - 支持部分特殊字符：_.:/=+-@ **默认取值：** 不涉及 | 表18ClusterExtendParam | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | clusterAZ | 否 | String | **参数解释：** 集群控制节点可用区配置。 CCE支持的可用区请参考[地区和终端节点](https://console.huaweicloud.com/apiexplorer/#/endpoint/CCE)。 **约束限制：** 不涉及 **取值范围：** - 指定局点支持可用区。 - multi_az：多可用区，可选。仅使用多控制节点集群时才可以配置多可用区。 - 专属云计算池可用区：用于指定专属云可用区部署集群控制节点。如果需配置专属CCE集群，该字段为必选。 **默认取值：** 不指定默认随机分配可用区。 | | dssMasterVolumes | 否 | String | **参数解释：** 用于指定控制节点的系统盘和数据盘使用专属分布式存储，未指定或者值为空时，默认使用EVS云硬盘。 **约束限制：** 如果配置专属CCE集群，该字段为必选，请按照如下格式设置： ``` .;. ``` 字段说明： - rootVol为系统盘；dataVol为数据盘； - dssPoolID为专属分布式存储池ID； - volType为专属分布式存储池的存储类型，如SAS、SSD、SATA、ESSD、GPSSD、ESSD2、GPSSD2 **取值范围：** 不涉及 **默认取值：** 不涉及 样例：c950ee97-587c-4f24-8a74-3367e3da570f.sas;6edbc2f4-1507-44f8-ac0d-eed1d2608d38.ssd 说明： 非专属CCE集群不支持配置该字段。 | | enterpriseProjectId | 否 | String | **参数解释：** 集群所属的企业项目ID。 **约束限制：** 需要开通企业项目功能后才可配置企业项目。 **取值范围：** 不涉及 **默认取值：** 不涉及 | | kubeProxyMode | 否 | String | **参数解释：** 服务转发模式，支持以下两种实现： **约束限制：** 此参数已废弃，若同时指定此参数和ClusterSpec下的kubeProxyMode，以ClusterSpec下的为准。 **取值范围：** - nftables：仅1.35集群及以上版本支持。替代iptables的新一代转发模式，规则管理高效、性能更优，原生支持IPv6，适配各类Service规模与集群场景，兼顾高并发短链接与大规模集群需求。 - iptables：社区传统的kube-proxy模式，完全以iptables规则的方式来实现service负载均衡。该方式最主要的问题是在服务多的时候产生太多的iptables规则，非增量式更新会引入一定的时延，大规模情况下有明显的性能问题 - ipvs：主导开发并在社区获得广泛支持的kube-proxy模式，采用增量式更新，吞吐更高，速度更快，并可以保证service更新期间连接保持不断开，适用于大规模场景。 **默认取值：** 1.35及以上版本默认使用nftables转发模式，1.35以下版本默认使用iptables转发模式。 | | clusterExternalIP | 否 | String | **参数解释：** 集群控制节点弹性公网IP，绑定后可以通过该弹性公网IP访问集群管控面API。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 | | alpha.cce/fixPoolMask | 否 | String | **参数解释：** 容器网络固定IP池掩码位数，该参数决定节点可分配容器IP数量，与创建节点时设置的maxPods参数共同决定节点最多可以创建多少个Pod， 具体请参见[节点可创建的最大Pod数量说明](https://support.huaweicloud.com/api-cce/maxPods.html)。 **约束限制：** 仅vpc-router网络支持。 **取值范围：** 整数字符串取值范围: 24 \~ 28 **默认取值：** 默认值24 | | decMasterFlavor | 否 | String | **参数解释：** 专属CCE集群指定可控制节点的规格。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 | | dockerUmaskMode | 否 | String | **参数解释：** 集群默认Docker的UmaskMode配置。 **约束限制：** 不涉及 **取值范围：** - secure - normal **默认取值：** 默认normal | | kubernetes.io/cpuManagerPolicy | 否 | String | **参数解释：** 集群CPU管理策略。 **约束限制：** 不涉及 **取值范围：** - none(或空值)：关闭工作负载实例独占CPU核的功能，优点是CPU共享池的可分配核数较多 - static：支持给节点上的工作负载实例配置CPU独占，适用于对CPU缓存和调度延迟敏感的工作负载，Turbo集群下仅对普通容器节点有效，安全容器节点无效。 **默认取值：** 默认none | | orderID | 否 | String | **参数解释：** 订单ID。 **约束限制：** 集群付费类型为自动付费包周期类型时，响应中会返回此字段(仅创建场景涉及)。 **取值范围：** 不涉及 **默认取值：** 不涉及 | | periodType | 否 | String | **参数解释：** 订购周期单位。 **约束限制：** 作为请求参数，billingMode为1（包周期）时生效，且为必选。 作为响应参数，仅在创建包周期集群时返回。 **取值范围：** - month：月 - year：年 **默认取值：** 不涉及 | | periodNum | 否 | Integer | **参数解释：** 订购周期数 **约束限制：** 作为请求参数，billingMode为1时生效，且为必选。 作为响应参数，仅在创建包周期集群时返回。 **取值范围：** - periodType=month（周期类型为月）时，取值为\[1-9\]。 - periodType=year（周期类型为年）时，取值为\[1-3\]。 **默认取值：** 不涉及 | | isAutoRenew | 否 | String | **参数解释：** 是否自动续订 **约束限制：** billingMode为1时生效。 **取值范围：** - "true"：自动续订 - "false"：不自动续订 **默认取值：** 默认false | | isAutoPay | 否 | String | **参数解释：** 是否自动扣款。 **约束限制：** billingMode为1时生效。 **取值范围：** - "true"：自动扣款 - "false"：不自动扣款 **默认取值：** 默认false | | upgradefrom | 否 | String | **参数解释：** 记录集群通过何种升级方式升级到当前版本。 **约束限制：** 仅查询接口返回该字段 **取值范围：** 不涉及 **默认取值：** 不涉及 | 表19PackageConfiguration | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | name | 否 | String | **参数解释：** 组件名称。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 | | configurations | 否 | Array of [ConfigurationItem] objects | **参数解释：** 组件配置项。 **约束限制：** 不涉及 | 表20ConfigurationItem | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | name | 否 | String | **参数解释：** 组件配置参数名称。 当前集群支持的可配置组件及其参数详见[修改CCE集群配置](https://support.huaweicloud.com/usermanual-cce/cce_10_0213.html)，当前节点池支持的可配置组件及其参数详见[修改节点池配置](https://support.huaweicloud.com/usermanual-cce/cce_10_0652.html)。 **约束限制：** 若指定了不支持的组件或组件不支持的参数，该配置项将被忽略。 **取值范围：** 不涉及 **默认取值：** 不涉及 | | value | 否 | Object | **参数解释：** 组件配置参数值。 当前集群支持的可配置组件及其参数详见[修改CCE集群配置](https://support.huaweicloud.com/usermanual-cce/cce_10_0213.html)，当前节点池支持的可配置组件及其参数详见[修改节点池配置](https://support.huaweicloud.com/usermanual-cce/cce_10_0652.html)。 **约束限制：** 若指定了不支持的组件或组件不支持的参数，该配置项将被忽略。 **取值范围：** 不涉及 **默认取值：** 不涉及 | 表21ClusterOps | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | alarm | 是 | [AlarmInfo] object | **参数解释：** 告警助手参数配置。基于AOM服务的告警能力实现，提供集群内的告警快速检索、告警快速配置的能力，告警中心的指标类告警规则依赖云原生监控插件上报数据到AOM实例。 **约束限制：** 不涉及 | 表22AlarmInfo | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | topics | 是 | Array of strings | **参数解释：** 联系组列表。填写SMN主题名称，通过配置告警联系组，分组管理订阅终端，接收告警信息。 **约束限制：** 不涉及 | | alarmRuleTemplateId | 否 | String | **参数解释：** 开启告警助手时传入告警模板ID。默认采用容器场景下的告警规则模板。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 | | promInstanceID | 否 | String | **参数解释：** 开启告警助手时传入AOM普罗实例的id。若未安装普罗插件或者未对接AOM实例，此参数无需指定，告警中心将不会创建指标类告警规则。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 | | promEnterpriseProjectID | 否 | String | **参数解释：** 开启告警助手时传入AOM普罗实例的企业项目id。若未安装普罗插件或者未对接AOM实例，此参数无需指定，告警中心将不会创建指标类告警规则。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 | 表23EncryptionConfig | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | mode | 否 | String | **参数解释**： 加密模式，可以配置为使用cce本地密钥加密或KMS加密。 **约束限制**： 不涉及 **取值范围**： - Default：使用cce本地密钥加密 - KMS：使用KMS加密模式 **默认取值**： Default | | kmsKeyID | 否 | String | **参数解释**： kms密钥ID - 集群创建API中，如果mode字段设置为Default，无需填写该字段；如果mode字段设置为KMS，则支持填写该字段。若字段为空，则默认使用KMS默认密钥进行填充，默认密钥不存在时云服务将自动为用户创建cce/default默认密钥。 用户需使用真实存在的KMS密钥，并且在集群生命周期结束前，禁止删除、禁用密钥等操作，防止集群功能异常（集群设置该密钥后不允许修改）。 - 集群查询API中，如果mode字段设置为Default，则该字段返回为空；若mode字段设置为KMS，则该字段为具体的密钥ID。 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及 | 表24SecretConfig | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | disableDefaultAddonCredSecret | 否 | Boolean | **参数解释：** 是否在集群中禁用默认插件凭证（paas.elb、paas.aksk secret）。该Secret的data内容是临时AK/SK数据，部分插件在未配置自定义委托时会使用它作为IAM凭证访问其他云服务。 更多信息请参见[禁用集群中静态存储的临时凭据说明](https://support.huaweicloud.com/usermanual-cce/cce_10_1111.html)。 **约束限制：** 仅当集群中所有需要访问云服务的插件均已配置自定义委托后，才能禁用该Secret。 **取值范围：** - true: 禁用 - false: 启用 **默认取值：** 新建集群默认true | | disableNodeAgencyCredSecret | 否 | Boolean | **参数解释：** 是否在集群中禁用节点凭证（node-agency-cred secret）。该Secret的data内容是临时AK/SK数据，节点上安装的系统组件默认使用该凭证。 更多信息请参见[禁用集群中静态存储的临时凭据说明](https://support.huaweicloud.com/usermanual-cce/cce_10_1111.html)。 **约束限制：** 需确保已为每个节点/节点池配置委托，且委托至少具备cce:node:get、cce::assumeAgencyForPodIdentity权限，否则禁用该Secret会导致节点安装、运行异常。 **取值范围：** - true: 禁用 - false: 启用 **默认取值：** false | | disableDefaultImagePullSecret | 否 | Boolean | **参数解释：** 是否在集群中禁用默认镜像访问凭证（default-secret secret）。该Secret的data内容是SWR临时登录指令，用于SWR的私有镜像拉取。 更多信息请参见[禁用集群中静态存储的临时凭据说明](https://support.huaweicloud.com/usermanual-cce/cce_10_1111.html)。 **约束限制：** 需确保集群中的工作负载不使用default-secret作为镜像拉取凭证（配置了镜像免密下载或者使用自定义镜像拉取凭证），否则禁用该Secret后可能会导致镜像拉取失败。 **取值范围：** - true: 禁用 - false: 启用 **默认取值：** false | #### 响应参数 **状态码：201** 表25响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | kind | String | **参数解释：** API类型。 **取值范围：** - Cluster - cluster | | apiVersion | String | **参数解释：** API版本。 **取值范围：** - v3 | | metadata | [ClusterMetadata] object | **参数解释：** 集群的基本信息，为集合类的元素类型，包含一组由不同名称定义的属性。 | | spec | [ClusterSpec] object | **参数解释：** spec是集合类的元素类型，您对需要管理的集群对象进行详细描述的主体部分都在spec中给出。CCE通过spec的描述来创建或更新对象。 | | status | [ClusterStatus] object | **参数解释：** 不涉及集合类的元素类型，用于记录对象在系统中的当前状态信息，包含了集群状态和本次创建集群作业的jobID | 表26ClusterMetadata | 参数 | 参数类型 | 描述 | |:---|:---|:---| | name | String | **参数解释：** 集群名称。 **取值范围：** 以小写字母开头，由小写字母、数字、中划线(-)组成，长度范围4-128位，且不能以中划线(-)结尾。 | | uid | String | **参数解释：** 集群ID，资源唯一标识。 **取值范围：** 不涉及 | | alias | String | **参数解释：** 集群显示名，用于在 CCE 界面显示，该名称创建后可修改。显示名和其他集群的名称、显示名不可以重复。 **取值范围：** 以中文或英文字符开头，由数字、中文、英文字符、中划线（-）组成，长度范围 4-128位，且不能以中划线（-）开头和结尾。 | | annotations | Map\ | **参数解释：** 集群注解，由key/value组成： ``` "annotations": { "key1" : "value1", "key2" : "value2" } ``` **取值范围：** 不涉及 | | labels | Map\ | **参数解释：** 集群标签，key/value对格式。 **取值范围：** 不涉及 | | creationTimestamp | String | **参数解释：** 集群创建时间。 **取值范围：** 不涉及 | | updateTimestamp | String | **参数解释：** 集群更新时间。 **取值范围：** 不涉及 | | timezone | String | **参数解释：** 集群时区。[IANA Time Zone Database](https://www.iana.org/time-zones)中收录的时区名称, 例如："Asia/Shanghai"。 **取值范围：** 不涉及 | 表27ClusterSpec | 参数 | 参数类型 | 描述 | |:---|:---|:---| | category | String | **参数解释：** 集群类别。 **取值范围：** - CCE：CCE集群 - Turbo: CCE Turbo集群。 CCE集群支持虚拟机与裸金属服务器混合、GPU、NPU等异构节点的混合部署，基于高性能网络模型提供全方位、多场景、安全稳定的容器运行环境。 全面基于云原生基础设施构建的云原生2.0的容器引擎服务，具备软硬协同、网络无损、安全可靠、调度智能的优势，为用户提供一站式、高性价比的全新容器服务体验。 | | agencyName | String | **参数解释：** 指定集群使用的委托。该委托用于生成集群中组件使用的临时访问凭证，在集群中自动创建其他相关云服务的资源时会使用该委托权限。当不传或为空时，集群将自动选择使用CCE的系统委托cce_admin_trust或cce_cluster_agency。 说明： 关于CCE系统委托的说明详情参见[系统委托说明](https://support.huaweicloud.com/usermanual-cce/cce_10_0556.html) **取值范围：** 不涉及 | | type | String | **参数解释：** 集群Master节点架构 **取值范围：** - VirtualMachine：Master节点为x86架构服务器 - ARM64: Master节点为鲲鹏（ARM架构）服务器 | | flavor | String | **参数解释：** 集群规格，当集群为v1.15及以上版本时支持创建后变更，详情请参见[变更集群规格](https://support.huaweicloud.com/api-cce/ResizeClusterFlavor.html)。请按实际业务需求进行选择 **取值范围：** - cce.s1.small: 小规模单控制节点CCE集群（最大50节点） - cce.s1.medium: 中等规模单控制节点CCE集群（最大200节点） - cce.s1.large: 大规模单控制节点CCE集群（最大1000节点） - cce.s2.small: 小规模三控制节点CCE集群（最大50节点） - cce.s2.medium: 中等规模三控制节点CCE集群（最大200节点） - cce.s2.large: 大规模三控制节点CCE集群（最大1000节点） - cce.s2.xlarge: 超大规模三控制节点CCE集群（最大2000节点） 专属云特殊规格如下： - cce.dec.s1.small: 小规模单控制节点的专属云CCE集群（最大50节点） - cce.dec.s1.medium: 中等规模单控制节点的专属云CCE集群（最大200节点） - cce.dec.s1.large: 大规模单控制节点的专属云CCE集群（最大1000节点） - cce.dec.s1.xlarge: 超大规模单控制节点的专属云CCE集群（最大2000节点） - cce.dec.s2.small: 小规模三控制节点的专属云CCE集群（最大50节点） - cce.dec.s2.medium: 中等规模三控制节点的专属云CCE集群（最大200节点） - cce.dec.s2.large: 大规模三控制节点的专属云CCE集群（最大1000节点） - cce.dec.s2.xlarge: 超大规模三控制节点的专属云CCE集群（最大2000节点） | | version | String | **参数解释：** 集群版本，与Kubernetes社区基线版本保持一致，建议选择最新商用版本。 说明： 关于Kubernetes版本策略，请参见[Kubernetes版本策略](https://support.huaweicloud.com/bulletin-cce/cce_bulletin_0033.html) 在CCE控制台支持创建三种最新版本的集群。可登录CCE控制台创建集群，在"版本"处获取到集群版本。 其它集群版本，当前仍可通过api创建，但后续会逐渐下线，具体下线策略请关注CCE官方公告。 **取值范围：** 不涉及 | | platformVersion | String | **参数解释：** CCE集群平台版本号，表示集群版本(version)下的内部版本。用于跟踪某一集群版本内的迭代，集群版本内唯一，跨集群版本重新计数。 **取值范围：** platformVersion格式为：cce.X.Y - X: 表示内部特性版本。集群版本中特性或者补丁修复，或者OS支持等变更场景。其值从1开始单调递增。 - Y: 表示内部特性版本的补丁版本。仅用于特性版本上线后的软件包更新，不涉及其他修改。其值从0开始单调递增。 | | legacyVersion | String | **参数解释：** CCE集群旧版本（已废弃），无实际功能，仅用于集群version与platformVersion组合展示，该版本号全局内唯一。如集群version为va.b, platformVersion为cce.X.Y，则legacyVersion值为va.b.X-rY。 **取值范围：** 不涉及 | | description | String | **参数解释：** 集群描述，对于集群使用目的的描述，可根据实际情况自定义，默认为空。集群创建成功后可通过接口[更新指定的集群](https://support.huaweicloud.com/api-cce/cce_02_0240.html)来做出修改，也可在CCE控制台中对应集群的"集群详情"下的"描述"处进行修改。 **取值范围：** 不涉及 | | customSan | Array of strings | **参数解释：** 集群的API Server服务端证书中的自定义SAN（Subject Alternative Name）字段，遵从SSL标准X509定义的格式规范。 **取值范围：** 格式符合IP和域名格式。 | | ipv6enable | Boolean | **参数解释：** 集群是否使用IPv6模式，1.15版本及以上支持。 **取值范围：** - true: 开启IPv4/IPv6双栈模式 - false: 仅使用IPv4模式 | | hostNetwork | [HostNetwork] object | **参数解释：** 节点网络参数，包含了虚拟私有云VPC和子网的ID信息，而VPC是集群内节点之间的通信依赖，所以是必选的参数集。 | | containerNetwork | [ContainerNetwork] object | **参数解释：** 容器网络参数，包含了容器网络类型和容器网段的信息。 | | eniNetwork | [EniNetwork] object | **参数解释：** 云原生网络2.0网络配置，创建CCE Turbo集群时指定。 | | serviceNetwork | [ServiceNetwork] object | **参数解释：** 服务网段参数，包含IPv4 CIDR。 | | publicAccess | [PublicAccess] object | **参数解释：** 集群API访问控制。 | | authentication | [Authentication] object | **参数解释：** 集群认证方式相关配置。 | | billingMode | Integer | **参数解释：** 集群的计费方式。 **取值范围：** - 0: 按需计费 - 1: 包周期 | | masters | Array of [MasterSpec] objects | **参数解释：** 集群控制节点的高级配置，支持指定控制节点的可用区。 | | kubernetesSvcIpRange | String | **参数解释：** 服务网段参数，kubernetes clusterIP取值范围，1.11.7版本及以上支持。创建集群时如若未传参，默认为"10.247.0.0/16"。该参数废弃中，推荐使用新字段serviceNetwork，包含IPv4服务网段。 **取值范围：** 不涉及 | | clusterTags | Array of [ResourceTag] objects | **参数解释：** 集群资源标签。 | | kubeProxyMode | String | **参数解释：** 服务转发模式。 **取值范围：** - nftables：仅1.35集群及以上版本支持。替代iptables的新一代转发模式，规则管理高效、性能更优，原生支持IPv6，适配各类Service规模与集群场景，兼顾高并发短链接与大规模集群需求。 - iptables：社区传统的kube-proxy模式，完全以iptables规则的方式来实现service负载均衡。该方式最主要的问题是在服务多的时候产生太多的iptables规则，非增量式更新会引入一定的时延，大规模情况下有明显的性能问题。 - ipvs：主导开发并在社区获得广泛支持的kube-proxy模式，采用增量式更新，吞吐更高，速度更快，并可以保证service更新期间连接保持不断开，适用于大规模场景。 | | az | String | **参数解释：** 可用区（废弃中）。 CCE支持的可用区请参考[地区和终端节点](https://console.huaweicloud.com/apiexplorer/#/endpoint/CCE)。 | | extendParam | [ClusterExtendParam] object | **参数解释：** 集群扩展字段，可配置多可用区集群、专属CCE集群，以及将集群创建在特定的企业项目下等。 | | supportIstio | Boolean | **参数解释：** 支持Istio。 **取值范围：** - true: 支持istio - false: 不支持istio | | enableDistMgt | Boolean | **参数解释：** 集群开启对分布式云支持。 **取值范围：** - true: 开启对分布式云支持 - false: 关闭对分布式云支持 | | deletionProtection | Boolean | **参数解释：** 集群删除保护，如果开启后用户将无法删除该集群。 **取值范围：** - true: 开启集群删除保护 - false: 关闭集群删除保护 | | configurationsOverride | Array of [PackageConfiguration] objects | **参数解释：** 覆盖集群默认组件配置。 当前支持的可配置组件及其参数详见[配置管理](https://support.huaweicloud.com/usermanual-cce/cce_10_0213.html)。 | | clusterOps | [ClusterOps] object | **参数解释：** 集群运维相关配置。 | | encryptionConfig | [EncryptionConfig] object | **参数解释**： secret资源落盘加密配置，当前仅支持配置一种加密方式。默认使用cce托管密钥（用户侧不感知该密钥）进行加密。 **取值范围**： 不涉及 | | secretConfig | [SecretConfig] object | **参数解释**： secret禁用配置，控制是否在集群中禁用以Secret形式静态存储的临时凭据。 **取值范围**： 不涉及 | | certificateAuthority | [CertificateAuthority] object | **参数解释**： CCE集群的证书信息 **取值范围**： 不涉及 | 表28HostNetwork | 参数 | 参数类型 | 描述 | |:---|:---|:---| | vpc | String | **参数解释：** 用于创建节点的VPC的ID。 **取值范围：** 不涉及 | | subnet | String | **参数解释：** 用于创建节点的子网的网络ID。 **取值范围：** 不涉及 | | SecurityGroup | String | **参数解释：** 集群默认的Node节点安全组ID。 **取值范围：** 不涉及 | | controlPlaneSecurityGroup | String | **参数解释：** 集群控制面节点安全组ID。 **取值范围：** 不涉及 | | autoGenerateSecurityGroupHardeningConfig | [AutoGenerateSecurityGroupHardeningConfigSpec] object | **参数解释：** 自动创建安全组时的安全加固策略。 **取值范围：** 不涉及 | 表29AutoGenerateSecurityGroupHardeningConfigSpec | 参数 | 参数类型 | 描述 | |:---|:---|:---| | portsToDisable | Array of strings | **参数解释：** 自动创建安全组时可选择不开放node节点相关端口，支持单端口和端口段两种形式。示例如下： ``` "portsToDisable": ["22", "4090-4099"] ``` **取值范围：** 端口号仅支持整数，范围\[1-65535\] | 表30ContainerNetwork | 参数 | 参数类型 | 描述 | |:---|:---|:---| | mode | String | **参数解释：** 容器网络类型。 **取值范围：** - overlay_l2：容器隧道网络，通过OVS（OpenVSwitch）为容器构建的overlay_l2网络。 - vpc-router：VPC网络，使用ipvlan和自定义VPC路由为容器构建的Underlay的l2网络。 - eni：云原生网络2.0，深度整合VPC原生ENI弹性网卡能力，采用VPC网段分配容器地址，支持ELB直通容器，享有高性能，创建CCE Turbo集群时指定。 | | cidr | String | **参数解释：** 容器网络网段，建议使用网段10.0.0.0/12\~19，172.16.0.0/16\~19，192.168.0.0/16\~19，如存在网段冲突，将会报错。 **取值范围：** 满足IPv4 CIDR格式 | | cidrs | Array of [ContainerCIDR] objects | **参数解释：** 容器网络网段列表。1.21及新版本集群使用cidrs字段，当集群网络类型为vpc-router类型时，支持多个容器网段，最多配置20个；1.21之前版本若使用cidrs字段，则取值cidrs数组中的第一个cidr元素作为容器网络网段地址。 | | enableContainerCIDRsReservation | Boolean | **参数解释**： VPC容器网段预留。在VPC的默认路由表中添加容器网段路由，避免创建与容器网段冲突的子网。支持的集群版本如下： - v1.28.15-r70及以上版本 - v1.29.15-r30及以上版本 - v1.30.14-r30及以上版本 - v1.31.10-r30及以上版本 - v1.32.6-r30及以上版本 - v1.33.5-r20及以上版本 **取值范围**： - false：不开启VPC容器网段预留 - true：开启VPC容器网段预留 | 表31ContainerCIDR | 参数 | 参数类型 | 描述 | |:---|:---|:---| | cidr | String | **参数解释：** 容器网络网段，建议使用网段10.0.0.0/12\~19，172.16.0.0/16\~19，192.168.0.0/16\~19。 **取值范围：** 不涉及 | 表32EniNetwork | 参数 | 参数类型 | 描述 | |:---|:---|:---| | eniSubnetId | String | **参数解释：** ENI所在子网的IPv4子网ID。 **取值范围：** 不涉及 | | eniSubnetCIDR | String | **参数解释：** ENI子网CIDR。 **取值范围：** 不涉及 | | subnets | Array of [NetworkSubnet] objects | **参数解释：** IPv4子网ID列表。 | 表33NetworkSubnet | 参数 | 参数类型 | 描述 | |:---|:---|:---| | subnetID | String | **参数解释：** 用于创建容器网卡的子网的IPv4子网ID。 **取值范围：** 不涉及 | 表34ServiceNetwork | 参数 | 参数类型 | 描述 | |:---|:---|:---| | IPv4CIDR | String | **参数解释：** kubernetes clusterIP IPv4 CIDR取值范围。 **取值范围：** 不涉及 | | IPv6CIDR | String | **参数解释：** kubernetes clusterIP IPv6 CIDR取值范围。 **取值范围：** 不涉及 | 表35PublicAccess | 参数 | 参数类型 | 描述 | |:---|:---|:---| | cidrs | Array of strings | **参数解释：** 允许访问集群API的白名单网段列表，建议对VPC网段、容器网段放通。 **取值范围：** 不涉及 | 表36Authentication | 参数 | 参数类型 | 描述 | |:---|:---|:---| | mode | String | **参数解释：** 集群认证模式。 **取值范围：** - kubernetes 1.11及之前版本的集群支持"x509"、"rbac"和"authenticating_proxy"，默认取值为"x509"。 - kubernetes 1.13版本的集群支持"rbac"和"authenticating_proxy"，默认取值为"rbac"。 - kubernetes 1.15及以上版本的集群支持"x509"、"rbac"和"authenticating_proxy"，默认取值为"rbac"。 | | authenticatingProxy | [AuthenticatingProxy] object | **参数解释：** authenticatingProxy模式相关配置。 | 表37AuthenticatingProxy | 参数 | 参数类型 | 描述 | |:---|:---|:---| | ca | String | **参数解释：** authenticating_proxy模式配置的x509格式CA证书(base64编码)。 **取值范围：** 最大长度：1M。 | | cert | String | **参数解释：** authenticating_proxy模式配置的x509格式CA证书签发的客户端证书，用于kube-apiserver到扩展apiserver的认证。(base64编码)。 **取值范围：** 最大长度：1M。 | | privateKey | String | **参数解释：** authenticating_proxy模式配置的x509格式CA证书签发的客户端证书时对应的私钥，用于kube-apiserver到扩展apiserver的认证。Kubernetes集群使用的私钥尚不支持密码加密，请使用未加密的私钥。(base64编码)。 **取值范围：** 最大长度：1M。 | 表38MasterSpec | 参数 | 参数类型 | 描述 | |:---|:---|:---| | availabilityZone | String | **参数解释：** 控制节点所在的可用区，需要指定可用区（AZ）的名称。 CCE支持的可用区请参考[地区和终端节点](https://console.huaweicloud.com/apiexplorer/#/endpoint/CCE) **取值范围：** 不涉及 | 表39ResourceTag | 参数 | 参数类型 | 描述 | |:---|:---|:---| | key | String | **参数解释：** Key值。 **取值范围：** - 不能为空且首尾不能包含空格，最多支持128个字符 - 可用UTF-8格式表示的任意语种字母、数字和空格 - 支持部分特殊字符：_.:=+-@ - 不能以"_sys_"开头 | | value | String | **参数解释：** Value值。 **取值范围：** - 可以为空但不能缺省，最多支持255个字符 - 可用UTF-8格式表示的汉字、字母、数字和空格 - 支持部分特殊字符：_.:/=+-@ | 表40ClusterExtendParam | 参数 | 参数类型 | 描述 | |:---|:---|:---| | clusterAZ | String | **参数解释：** 集群控制节点可用区配置。 CCE支持的可用区请参考[地区和终端节点](https://console.huaweicloud.com/apiexplorer/#/endpoint/CCE)。 **取值范围：** - 指定局点支持可用区。 - multi_az：多可用区，可选。仅使用多控制节点集群时才可以配置多可用区。 - 专属云计算池可用区：用于指定专属云可用区部署集群控制节点。如果需配置专属CCE集群，该字段为必选。 | | dssMasterVolumes | String | **参数解释：** 用于指定控制节点的系统盘和数据盘使用专属分布式存储，未指定或者值为空时，默认使用EVS云硬盘。 **取值范围：** 不涉及 | | enterpriseProjectId | String | **参数解释：** 集群所属的企业项目ID。 **取值范围：** 不涉及 | | kubeProxyMode | String | **参数解释：** 服务转发模式，支持以下两种实现： **取值范围：** - nftables：仅1.35集群及以上版本支持。替代iptables的新一代转发模式，规则管理高效、性能更优，原生支持IPv6，适配各类Service规模与集群场景，兼顾高并发短链接与大规模集群需求。 - iptables：社区传统的kube-proxy模式，完全以iptables规则的方式来实现service负载均衡。该方式最主要的问题是在服务多的时候产生太多的iptables规则，非增量式更新会引入一定的时延，大规模情况下有明显的性能问题 - ipvs：主导开发并在社区获得广泛支持的kube-proxy模式，采用增量式更新，吞吐更高，速度更快，并可以保证service更新期间连接保持不断开，适用于大规模场景。 | | clusterExternalIP | String | **参数解释：** 集群控制节点弹性公网IP，绑定后可以通过该弹性公网IP访问集群管控面API。 **取值范围：** 不涉及 | | alpha.cce/fixPoolMask | String | **参数解释：** 容器网络固定IP池掩码位数，该参数决定节点可分配容器IP数量，与创建节点时设置的maxPods参数共同决定节点最多可以创建多少个Pod， 具体请参见[节点可创建的最大Pod数量说明](https://support.huaweicloud.com/api-cce/maxPods.html)。 **取值范围：** 整数字符串取值范围: 24 \~ 28 | | decMasterFlavor | String | **参数解释：** 专属CCE集群指定可控制节点的规格。 **取值范围：** 不涉及 | | dockerUmaskMode | String | **参数解释：** 集群默认Docker的UmaskMode配置。 **取值范围：** - secure - normal | | kubernetes.io/cpuManagerPolicy | String | **参数解释：** 集群CPU管理策略。 **取值范围：** - none(或空值)：关闭工作负载实例独占CPU核的功能，优点是CPU共享池的可分配核数较多 - static：支持给节点上的工作负载实例配置CPU独占，适用于对CPU缓存和调度延迟敏感的工作负载，Turbo集群下仅对普通容器节点有效，安全容器节点无效。 | | orderID | String | **参数解释：** 订单ID。 **取值范围：** 不涉及 | | periodType | String | **参数解释：** 订购周期单位。 **取值范围：** - month：月 - year：年 | | periodNum | Integer | **参数解释：** 订购周期数 **取值范围：** - periodType=month（周期类型为月）时，取值为\[1-9\]。 - periodType=year（周期类型为年）时，取值为\[1-3\]。 | | isAutoRenew | String | **参数解释：** 是否自动续订 **取值范围：** - "true"：自动续订 - "false"：不自动续订 | | isAutoPay | String | **参数解释：** 是否自动扣款。 **取值范围：** - "true"：自动扣款 - "false"：不自动扣款 | | upgradefrom | String | **参数解释：** 记录集群通过何种升级方式升级到当前版本。 **取值范围：** 不涉及 | 表41PackageConfiguration | 参数 | 参数类型 | 描述 | |:---|:---|:---| | name | String | **参数解释：** 组件名称。 **取值范围：** 不涉及 | | configurations | Array of [ConfigurationItem] objects | **参数解释：** 组件配置项。 | 表42ConfigurationItem | 参数 | 参数类型 | 描述 | |:---|:---|:---| | name | String | **参数解释：** 组件配置参数名称。 当前集群支持的可配置组件及其参数详见[修改CCE集群配置](https://support.huaweicloud.com/usermanual-cce/cce_10_0213.html)，当前节点池支持的可配置组件及其参数详见[修改节点池配置](https://support.huaweicloud.com/usermanual-cce/cce_10_0652.html)。 **取值范围：** 不涉及 | | value | Object | **参数解释：** 组件配置参数值。 当前集群支持的可配置组件及其参数详见[修改CCE集群配置](https://support.huaweicloud.com/usermanual-cce/cce_10_0213.html)，当前节点池支持的可配置组件及其参数详见[修改节点池配置](https://support.huaweicloud.com/usermanual-cce/cce_10_0652.html)。 **取值范围：** 不涉及 | 表43ClusterOps | 参数 | 参数类型 | 描述 | |:---|:---|:---| | alarm | [AlarmInfo] object | **参数解释：** 告警助手参数配置。基于AOM服务的告警能力实现，提供集群内的告警快速检索、告警快速配置的能力，告警中心的指标类告警规则依赖云原生监控插件上报数据到AOM实例。 | 表44AlarmInfo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | topics | Array of strings | **参数解释：** 联系组列表。填写SMN主题名称，通过配置告警联系组，分组管理订阅终端，接收告警信息。 | | alarmRuleTemplateId | String | **参数解释：** 开启告警助手时传入告警模板ID。默认采用容器场景下的告警规则模板。 **取值范围：** 不涉及 | | promInstanceID | String | **参数解释：** 开启告警助手时传入AOM普罗实例的id。若未安装普罗插件或者未对接AOM实例，此参数无需指定，告警中心将不会创建指标类告警规则。 **取值范围：** 不涉及 | | promEnterpriseProjectID | String | **参数解释：** 开启告警助手时传入AOM普罗实例的企业项目id。若未安装普罗插件或者未对接AOM实例，此参数无需指定，告警中心将不会创建指标类告警规则。 **取值范围：** 不涉及 | 表45EncryptionConfig | 参数 | 参数类型 | 描述 | |:---|:---|:---| | mode | String | **参数解释**： 加密模式，可以配置为使用cce本地密钥加密或KMS加密。 **取值范围**： - Default：使用cce本地密钥加密 - KMS：使用KMS加密模式 | | kmsKeyID | String | **参数解释**： kms密钥ID - 集群创建API中，如果mode字段设置为Default，无需填写该字段；如果mode字段设置为KMS，则支持填写该字段。若字段为空，则默认使用KMS默认密钥进行填充，默认密钥不存在时云服务将自动为用户创建cce/default默认密钥。 用户需使用真实存在的KMS密钥，并且在集群生命周期结束前，禁止删除、禁用密钥等操作，防止集群功能异常（集群设置该密钥后不允许修改）。 - 集群查询API中，如果mode字段设置为Default，则该字段返回为空；若mode字段设置为KMS，则该字段为具体的密钥ID。 **取值范围**： 不涉及 | 表46SecretConfig | 参数 | 参数类型 | 描述 | |:---|:---|:---| | disableDefaultAddonCredSecret | Boolean | **参数解释：** 是否在集群中禁用默认插件凭证（paas.elb、paas.aksk secret）。该Secret的data内容是临时AK/SK数据，部分插件在未配置自定义委托时会使用它作为IAM凭证访问其他云服务。 更多信息请参见[禁用集群中静态存储的临时凭据说明](https://support.huaweicloud.com/usermanual-cce/cce_10_1111.html)。 **取值范围：** - true: 禁用 - false: 启用 | | disableNodeAgencyCredSecret | Boolean | **参数解释：** 是否在集群中禁用节点凭证（node-agency-cred secret）。该Secret的data内容是临时AK/SK数据，节点上安装的系统组件默认使用该凭证。 更多信息请参见[禁用集群中静态存储的临时凭据说明](https://support.huaweicloud.com/usermanual-cce/cce_10_1111.html)。 **取值范围：** - true: 禁用 - false: 启用 | | disableDefaultImagePullSecret | Boolean | **参数解释：** 是否在集群中禁用默认镜像访问凭证（default-secret secret）。该Secret的data内容是SWR临时登录指令，用于SWR的私有镜像拉取。 更多信息请参见[禁用集群中静态存储的临时凭据说明](https://support.huaweicloud.com/usermanual-cce/cce_10_1111.html)。 **取值范围：** - true: 禁用 - false: 启用 | 表47CertificateAuthority | 参数 | 参数类型 | 描述 | |:---|:---|:---| | data | String | **参数解释：** Base64编码的CCE集群根证书 **取值范围：** 不涉及 | 表48ClusterStatus | 参数 | 参数类型 | 描述 | |:---|:---|:---| | phase | String | **参数解释：** 集群状态。 **取值范围：** - Available：可用，表示集群处于正常状态。 - Unavailable：不可用，表示集群异常，需手动删除。 - ScalingUp：扩容中，表示集群正处于扩容过程中。 - ScalingDown：缩容中，表示集群正处于缩容过程中。 - Creating：创建中，表示集群正处于创建过程中。 - Deleting：删除中，表示集群正处于删除过程中。 - Upgrading：升级中，表示集群正处于升级过程中。 - Resizing：规格变更中，表示集群正处于变更规格中。 - ResizeFailed：规格变更异常，表示集群变更规格异常。 - RollingBack：回滚中，表示集群正处于回滚过程中。 - RollbackFailed：回滚异常，表示集群回滚异常。 - Hibernating：休眠中，表示集群正处于休眠过程中。 - Hibernation：已休眠，表示集群正处于休眠状态。 - Freezing：冻结中，表示集群正处于冻结过程中。 - Frozen：已冻结，表示集群正处于冻结状态。 - UnFreezing：解冻中，表示集群正处于解冻过程中。 - Awaking：唤醒中，表示集群正处于从休眠状态唤醒的过程中。 - Empty：集群无任何资源（已废弃） - Error：错误，表示集群资源异常，可尝试手动删除。 | | jobID | String | **参数解释：** 任务ID，集群当前状态关联的任务ID。当前支持: - 创建集群时返回关联的任务ID，可通过任务ID查询创建集群的附属任务信息； - 删除集群或者删除集群失败时返回关联的任务ID，此字段非空时，可通过任务ID查询删除集群的附属任务信息。 **取值范围：** 不涉及 说明： 任务信息具有一定时效性，仅用于短期跟踪任务进度，请勿用于集群状态判断等额外场景。 | | reason | String | **参数解释：** 集群变为当前状态的原因，在集群在非"Available"状态下时，会返回此参数。 **取值范围：** 不涉及 | | message | String | **参数解释：** 集群变为当前状态的原因的详细信息，在集群在非"Available"状态下时，会返回此参数。 **取值范围：** 不涉及 | | endpoints | Array of [ClusterEndpoints] objects | **参数解释：** 集群中 kube-apiserver 的访问地址。 | | isLocked | Boolean | **参数解释：** CBC资源锁定 **取值范围：** - true: 是CBC锁定资源 - false: 非CBC锁定资源 | | lockScene | String | **参数解释：** CBC资源锁定场景 **取值范围：** 不涉及 | | lockSource | String | **参数解释：** 锁定资源 **取值范围：** 不涉及 | | lockSourceId | String | **参数解释：** 锁定的资源ID **取值范围：** 不涉及 | | deleteOption | Object | **参数解释：** 删除配置状态（仅删除请求响应包含） **取值范围：** 不涉及 | | deleteStatus | Object | **参数解释：** 删除状态信息（仅删除请求响应包含） **取值范围：** 不涉及 | | conditions | Array of [ClusterCondition] objects | **参数解释**： 集群当前详细状态列表，详情参见Condition类型定义。 | 表49ClusterEndpoints | 参数 | 参数类型 | 描述 | |:---|:---|:---| | url | String | **参数解释：** 集群中 kube-apiserver 的访问地址。 **取值范围：** 不涉及 | | type | String | **参数解释：** 集群访问地址的类型。 **取值范围：** - Internal：用户子网内访问的地址 - External：公网访问的地址 | 表50ClusterCondition | 参数 | 参数类型 | 描述 | |:---|:---|:---| | type | String | **参数解释**： 状态类型。 **取值范围**： - "AgencyAvailable": CCE集群自定义委托的状态。 - "ClusterCertificate": CCE集群证书的状态。 - "ClusterCustomCertificate": CCE集群自有证书的状态。 - "CertificateRotation": CCE集群证书更新的状态。 - "CustomCertificateRotation": CCE集群自有证书更新的状态。 - "OpenIDConnectProcessing": CCE集群开启OIDC特性处理中状态。 - "OpenIDConnectProcessSuccess": CCE集群开启OIDC特性成功状态。 - "OpenIDConnectProcessFailed": CCE集群开启OIDC特性失败状态。 | | status | String | **参数解释**： Condition当前状态。 **取值范围**： - "True" - "False" | | lastProbeTime | String | **参数解释**： 上次状态检查时间。 **取值范围**： 不涉及 | | lastTransitTime | String | **参数解释**： 上次状态变更时间。 **取值范围**： 不涉及 | | reason | String | **参数解释**： 上次状态变更原因。 **取值范围**： - type为ClusterCertificate、ClusterCustomCertificate时取值范围： - CertificateValid：证书状态正常 - CertificateExpiringWithin180Days：证书有效期低于180天 - CertificateExpiringWithin30Days：证书有效期低于30天 - CertificateExpired：证书已过期 - type为CertificateRotation、CustomCertificateRotation时取值范围： - RotationInProgress：更新中 - RotationSucceeded：更新成功 - RotationFailed：更新失败 | | message | String | **参数解释**： Condition详细描述。 **取值范围**： 不涉及 | #### 请求示例 - 创建一个v1.29版本的CCE集群，计费模式为按需计费，集群规模为50节点，且为三控制节点高可用集群。 ``` /api/v3/projects/{project_id}/clusters { "kind" : "Cluster", "apiVersion" : "v3", "metadata" : { "name" : "cluster" }, "spec" : { "category" : "CCE", "flavor" : "cce.s2.small", "version" : "v1.29", "hostNetwork" : { "vpc" : "030bfb19-5fa7-42ad-8a0d-c0721d268867", "subnet" : "ca964acf-8468-4735-8229-97940ef6c881" }, "containerNetwork" : { "mode" : "vpc-router", "cidr" : "10.0.0.0/16" }, "kubernetesSvcIpRange" : "10.247.0.0/16", "description" : "", "billingMode" : 0, "extendParam" : { "kubeProxyMode" : "iptables", "alpha.cce/fixPoolMask" : "25", "enterpriseProjectId" : "0" }, "authentication" : { "mode" : "rbac" }, "ipv6enable" : false } } ``` - 创建一个v1.29版本的CCE集群，计费模式为按需计费，集群规模为50节点，且为三控制节点高可用集群，并在集群中安装ICAgent。 ``` /api/v3/projects/{project_id}/clusters { "kind" : "Cluster", "apiVersion" : "v3", "metadata" : { "name" : "cluster", "annotations" : { "cluster.install.addons.external/install" : "[{\"addonTemplateName\":\"icagent\"}]" } }, "spec" : { "category" : "CCE", "flavor" : "cce.s2.small", "version" : "v1.29", "hostNetwork" : { "vpc" : "030bfb19-5fa7-42ad-8a0d-c0721d268867", "subnet" : "ca964acf-8468-4735-8229-97940ef6c881" }, "containerNetwork" : { "mode" : "vpc-router", "cidr" : "10.0.0.0/16" }, "kubernetesSvcIpRange" : "10.247.0.0/16", "description" : "", "billingMode" : 0, "extendParam" : { "kubeProxyMode" : "iptables", "alpha.cce/fixPoolMask" : "25", "enterpriseProjectId" : "0" }, "authentication" : { "mode" : "rbac" }, "ipv6enable" : false } } ``` - 创建一个v1.29版本的CCE集群，计费模式为按需计费，集群规模为50节点，且为三控制节点高可用集群，并指定自定义的节点默认安全组。 ``` /api/v3/projects/{project_id}/clusters { "kind" : "Cluster", "apiVersion" : "v3", "metadata" : { "name" : "cluster" }, "spec" : { "category" : "CCE", "flavor" : "cce.s2.small", "version" : "v1.29", "hostNetwork" : { "vpc" : "030bfb19-5fa7-42ad-8a0d-c0721d268867", "subnet" : "ca964acf-8468-4735-8229-97940ef6c881", "SecurityGroup" : "a4ef108c-2ec6-492f-a6c4-7b64e25ae490" }, "containerNetwork" : { "mode" : "vpc-router", "cidr" : "10.0.0.0/16" }, "kubernetesSvcIpRange" : "10.247.0.0/16", "description" : "", "billingMode" : 0, "extendParam" : { "kubeProxyMode" : "iptables", "alpha.cce/fixPoolMask" : "25", "enterpriseProjectId" : "0" }, "authentication" : { "mode" : "rbac" }, "ipv6enable" : false } } ``` - 创建一个v1.25版本的CCE Turbo集群，计费模式为按需计费，集群规模为50节点，且为三控制节点高可用集群。 ``` /api/v3/projects/{project_id}/clusters { "kind" : "Cluster", "apiVersion" : "v3", "metadata" : { "name" : "cluster" }, "spec" : { "category" : "Turbo", "flavor" : "cce.s2.small", "version" : "v1.25", "type" : "VirtualMachine", "hostNetwork" : { "vpc" : "030bfb19-5fa7-42ad-8a0d-c0721d268867", "subnet" : "ca964acf-8468-4735-8229-97940ef6c881" }, "containerNetwork" : { "mode" : "eni" }, "eniNetwork" : { "eniSubnetId" : "861fb11d-2f0e-4c10-a98a-166dc26e4ff7", "eniSubnetCIDR" : "192.168.0.0/24", "subnets" : [ { "subnetID" : "861fb11d-2f0e-4c10-a98a-166dc26e4ff7" } ] }, "serviceNetwork" : { "IPv4CIDR" : "10.247.0.0/16" }, "description" : "", "billingMode" : 0, "extendParam" : { "kubeProxyMode" : "iptables", "enterpriseProjectId" : "0" }, "authentication" : { "mode" : "rbac" }, "ipv6enable" : false } } ``` - 创建集群时配置允许访问集群API白名单网段 ``` /api/v3/projects/{project_id}/clusters { "kind" : "Cluster", "apiVersion" : "v3", "metadata" : { "name" : "cluster" }, "spec" : { "category" : "CCE", "flavor" : "cce.s2.small", "version" : "v1.19", "hostNetwork" : { "vpc" : "030bfb19-5fa7-42ad-8a0d-c0721d268867", "subnet" : "ca964acf-8468-4735-8229-97940ef6c881" }, "publicAccess" : { "cidrs" : [ "192.168.0.0/16" ] }, "containerNetwork" : { "mode" : "vpc-router", "cidr" : "10.0.0.0/16" }, "serviceNetwork" : { "IPv4CIDR" : "10.247.0.0/16", "IPv6CIDR" : "fc00::/112" }, "kubernetesSvcIpRange" : "10.247.0.0/16", "description" : "", "billingMode" : 0, "extendParam" : { "kubeProxyMode" : "iptables", "alpha.cce/fixPoolMask" : "25", "enterpriseProjectId" : "0" }, "authentication" : { "mode" : "rbac" }, "ipv6enable" : false } } ``` #### 响应示例 **状态码：201** 表示创建集群作业下发成功。 ``` { "kind" : "Cluster", "apiVersion" : "v3", "metadata" : { "name" : "cluster", "uid" : "1df09f9a-5b9e-11ef-8f52-0255ac10003e", "creationTimestamp" : "2024-08-16 07:06:53.704389459 +0000 UTC", "updateTimestamp" : "2024-08-16 07:06:53.704389529 +0000 UTC", "annotations" : { "jobid" : "1e50bfbe-5b9e-11ef-8f52-0255ac10003e", "resourceJobId" : "1df0ec6b-5b9e-11ef-8f52-0255ac10003e" }, "timezone" : "Asia/Shanghai" }, "spec" : { "publicAccess" : { }, "category" : "CCE", "type" : "VirtualMachine", "flavor" : "cce.s1.small", "version" : "v1.29", "platformVersion" : "cce.4.0", "configurationsOverride" : [ { "name" : "kube-apiserver", "configurations" : [ { "name" : "support-overload", "value" : true } ] } ], "hostNetwork" : { "vpc" : "0538a5d0-9a65-4c1d-a8bf-e9acee237980", "subnet" : "bc81be88-6e34-4b02-83bd-df0a1f7672c5" }, "containerNetwork" : { "mode" : "vpc-router", "cidr" : "172.17.0.0/16", "cidrs" : [ { "cidr" : "172.17.0.0/16" } ] }, "eniNetwork" : { }, "serviceNetwork" : { "IPv4CIDR" : "10.247.0.0/16" }, "authentication" : { "mode" : "rbac", "authenticatingProxy" : { } }, "billingMode" : 0, "kubernetesSvcIpRange" : "10.247.0.0/16", "kubeProxyMode" : "iptables", "extendParam" : { "alpha.cce/fixPoolMask" : "25", "enterpriseProjectId" : "0", "orderID" : "" } }, "status" : { "phase" : "Creating", "jobID" : "1e50bfbe-5b9e-11ef-8f52-0255ac10003e" } } ``` #### SDK代码示例 SDK代码示例如下。 - [Java] - 创建一个v1.29版本的CCE集群，计费模式为按需计费，集群规模为50节点，且为三控制节点高可用集群。 ``` package com.huaweicloud.sdk.test; import com.huaweicloud.sdk.core.auth.ICredential; import com.huaweicloud.sdk.core.auth.BasicCredentials; import com.huaweicloud.sdk.core.exception.ConnectionException; import com.huaweicloud.sdk.core.exception.RequestTimeoutException; import com.huaweicloud.sdk.core.exception.ServiceResponseException; import com.huaweicloud.sdk.cce.v3.region.CceRegion; import com.huaweicloud.sdk.cce.v3.*; import com.huaweicloud.sdk.cce.v3.model.*; public class CreateClusterSolution { public static void main(String[] args) { // The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security. // In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment String ak = System.getenv("CLOUD_SDK_AK"); String sk = System.getenv("CLOUD_SDK_SK"); String projectId = "{project_id}"; ICredential auth = new BasicCredentials() .withProjectId(projectId) .withAk(ak) .withSk(sk); CceClient client = CceClient.newBuilder() .withCredential(auth) .withRegion(CceRegion.valueOf("")) .build(); CreateClusterRequest request = new CreateClusterRequest(); Cluster body = new Cluster(); ClusterExtendParam extendParamSpec = new ClusterExtendParam(); extendParamSpec.withEnterpriseProjectId("0") .withKubeProxyMode("iptables") .withAlphaCceFixPoolMask("25"); Authentication authenticationSpec = new Authentication(); authenticationSpec.withMode("rbac"); ContainerNetwork containerNetworkSpec = new ContainerNetwork(); containerNetworkSpec.withMode(ContainerNetwork.ModeEnum.fromValue("vpc-router")) .withCidr("10.0.0.0/16"); HostNetwork hostNetworkSpec = new HostNetwork(); hostNetworkSpec.withVpc("030bfb19-5fa7-42ad-8a0d-c0721d268867") .withSubnet("ca964acf-8468-4735-8229-97940ef6c881"); ClusterSpec specbody = new ClusterSpec(); specbody.withCategory(ClusterSpec.CategoryEnum.fromValue("CCE")) .withFlavor("cce.s2.small") .withVersion("v1.29") .withDescription("") .withIpv6enable(false) .withHostNetwork(hostNetworkSpec) .withContainerNetwork(containerNetworkSpec) .withAuthentication(authenticationSpec) .withBillingMode(0) .withKubernetesSvcIpRange("10.247.0.0/16") .withExtendParam(extendParamSpec); ClusterMetadata metadatabody = new ClusterMetadata(); metadatabody.withName("cluster"); body.withSpec(specbody); body.withMetadata(metadatabody); body.withApiVersion("v3"); body.withKind("Cluster"); request.withBody(body); try { CreateClusterResponse response = client.createCluster(request); System.out.println(response.toString()); } catch (ConnectionException e) { e.printStackTrace(); } catch (RequestTimeoutException e) { e.printStackTrace(); } catch (ServiceResponseException e) { e.printStackTrace(); System.out.println(e.getHttpStatusCode()); System.out.println(e.getRequestId()); System.out.println(e.getErrorCode()); System.out.println(e.getErrorMsg()); } } } ``` - 创建一个v1.29版本的CCE集群，计费模式为按需计费，集群规模为50节点，且为三控制节点高可用集群，并在集群中安装ICAgent。 ``` package com.huaweicloud.sdk.test; import com.huaweicloud.sdk.core.auth.ICredential; import com.huaweicloud.sdk.core.auth.BasicCredentials; import com.huaweicloud.sdk.core.exception.ConnectionException; import com.huaweicloud.sdk.core.exception.RequestTimeoutException; import com.huaweicloud.sdk.core.exception.ServiceResponseException; import com.huaweicloud.sdk.cce.v3.region.CceRegion; import com.huaweicloud.sdk.cce.v3.*; import com.huaweicloud.sdk.cce.v3.model.*; import java.util.Map; import java.util.HashMap; public class CreateClusterSolution { public static void main(String[] args) { // The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security. // In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment String ak = System.getenv("CLOUD_SDK_AK"); String sk = System.getenv("CLOUD_SDK_SK"); String projectId = "{project_id}"; ICredential auth = new BasicCredentials() .withProjectId(projectId) .withAk(ak) .withSk(sk); CceClient client = CceClient.newBuilder() .withCredential(auth) .withRegion(CceRegion.valueOf("")) .build(); CreateClusterRequest request = new CreateClusterRequest(); Cluster body = new Cluster(); ClusterExtendParam extendParamSpec = new ClusterExtendParam(); extendParamSpec.withEnterpriseProjectId("0") .withKubeProxyMode("iptables") .withAlphaCceFixPoolMask("25"); Authentication authenticationSpec = new Authentication(); authenticationSpec.withMode("rbac"); ContainerNetwork containerNetworkSpec = new ContainerNetwork(); containerNetworkSpec.withMode(ContainerNetwork.ModeEnum.fromValue("vpc-router")) .withCidr("10.0.0.0/16"); HostNetwork hostNetworkSpec = new HostNetwork(); hostNetworkSpec.withVpc("030bfb19-5fa7-42ad-8a0d-c0721d268867") .withSubnet("ca964acf-8468-4735-8229-97940ef6c881"); ClusterSpec specbody = new ClusterSpec(); specbody.withCategory(ClusterSpec.CategoryEnum.fromValue("CCE")) .withFlavor("cce.s2.small") .withVersion("v1.29") .withDescription("") .withIpv6enable(false) .withHostNetwork(hostNetworkSpec) .withContainerNetwork(containerNetworkSpec) .withAuthentication(authenticationSpec) .withBillingMode(0) .withKubernetesSvcIpRange("10.247.0.0/16") .withExtendParam(extendParamSpec); Map listMetadataAnnotations = new HashMap<>(); listMetadataAnnotations.put("cluster.install.addons.external/install", "[{"addonTemplateName":"icagent"}]"); ClusterMetadata metadatabody = new ClusterMetadata(); metadatabody.withName("cluster") .withAnnotations(listMetadataAnnotations); body.withSpec(specbody); body.withMetadata(metadatabody); body.withApiVersion("v3"); body.withKind("Cluster"); request.withBody(body); try { CreateClusterResponse response = client.createCluster(request); System.out.println(response.toString()); } catch (ConnectionException e) { e.printStackTrace(); } catch (RequestTimeoutException e) { e.printStackTrace(); } catch (ServiceResponseException e) { e.printStackTrace(); System.out.println(e.getHttpStatusCode()); System.out.println(e.getRequestId()); System.out.println(e.getErrorCode()); System.out.println(e.getErrorMsg()); } } } ``` - 创建一个v1.29版本的CCE集群，计费模式为按需计费，集群规模为50节点，且为三控制节点高可用集群，并指定自定义的节点默认安全组。 ``` package com.huaweicloud.sdk.test; import com.huaweicloud.sdk.core.auth.ICredential; import com.huaweicloud.sdk.core.auth.BasicCredentials; import com.huaweicloud.sdk.core.exception.ConnectionException; import com.huaweicloud.sdk.core.exception.RequestTimeoutException; import com.huaweicloud.sdk.core.exception.ServiceResponseException; import com.huaweicloud.sdk.cce.v3.region.CceRegion; import com.huaweicloud.sdk.cce.v3.*; import com.huaweicloud.sdk.cce.v3.model.*; public class CreateClusterSolution { public static void main(String[] args) { // The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security. // In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment String ak = System.getenv("CLOUD_SDK_AK"); String sk = System.getenv("CLOUD_SDK_SK"); String projectId = "{project_id}"; ICredential auth = new BasicCredentials() .withProjectId(projectId) .withAk(ak) .withSk(sk); CceClient client = CceClient.newBuilder() .withCredential(auth) .withRegion(CceRegion.valueOf("")) .build(); CreateClusterRequest request = new CreateClusterRequest(); Cluster body = new Cluster(); ClusterExtendParam extendParamSpec = new ClusterExtendParam(); extendParamSpec.withEnterpriseProjectId("0") .withKubeProxyMode("iptables") .withAlphaCceFixPoolMask("25"); Authentication authenticationSpec = new Authentication(); authenticationSpec.withMode("rbac"); ContainerNetwork containerNetworkSpec = new ContainerNetwork(); containerNetworkSpec.withMode(ContainerNetwork.ModeEnum.fromValue("vpc-router")) .withCidr("10.0.0.0/16"); HostNetwork hostNetworkSpec = new HostNetwork(); hostNetworkSpec.withVpc("030bfb19-5fa7-42ad-8a0d-c0721d268867") .withSubnet("ca964acf-8468-4735-8229-97940ef6c881") .withSecurityGroup("a4ef108c-2ec6-492f-a6c4-7b64e25ae490"); ClusterSpec specbody = new ClusterSpec(); specbody.withCategory(ClusterSpec.CategoryEnum.fromValue("CCE")) .withFlavor("cce.s2.small") .withVersion("v1.29") .withDescription("") .withIpv6enable(false) .withHostNetwork(hostNetworkSpec) .withContainerNetwork(containerNetworkSpec) .withAuthentication(authenticationSpec) .withBillingMode(0) .withKubernetesSvcIpRange("10.247.0.0/16") .withExtendParam(extendParamSpec); ClusterMetadata metadatabody = new ClusterMetadata(); metadatabody.withName("cluster"); body.withSpec(specbody); body.withMetadata(metadatabody); body.withApiVersion("v3"); body.withKind("Cluster"); request.withBody(body); try { CreateClusterResponse response = client.createCluster(request); System.out.println(response.toString()); } catch (ConnectionException e) { e.printStackTrace(); } catch (RequestTimeoutException e) { e.printStackTrace(); } catch (ServiceResponseException e) { e.printStackTrace(); System.out.println(e.getHttpStatusCode()); System.out.println(e.getRequestId()); System.out.println(e.getErrorCode()); System.out.println(e.getErrorMsg()); } } } ``` - 创建一个v1.25版本的CCE Turbo集群，计费模式为按需计费，集群规模为50节点，且为三控制节点高可用集群。 ``` package com.huaweicloud.sdk.test; import com.huaweicloud.sdk.core.auth.ICredential; import com.huaweicloud.sdk.core.auth.BasicCredentials; import com.huaweicloud.sdk.core.exception.ConnectionException; import com.huaweicloud.sdk.core.exception.RequestTimeoutException; import com.huaweicloud.sdk.core.exception.ServiceResponseException; import com.huaweicloud.sdk.cce.v3.region.CceRegion; import com.huaweicloud.sdk.cce.v3.*; import com.huaweicloud.sdk.cce.v3.model.*; import java.util.List; import java.util.ArrayList; public class CreateClusterSolution { public static void main(String[] args) { // The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security. // In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment String ak = System.getenv("CLOUD_SDK_AK"); String sk = System.getenv("CLOUD_SDK_SK"); String projectId = "{project_id}"; ICredential auth = new BasicCredentials() .withProjectId(projectId) .withAk(ak) .withSk(sk); CceClient client = CceClient.newBuilder() .withCredential(auth) .withRegion(CceRegion.valueOf("")) .build(); CreateClusterRequest request = new CreateClusterRequest(); Cluster body = new Cluster(); ClusterExtendParam extendParamSpec = new ClusterExtendParam(); extendParamSpec.withEnterpriseProjectId("0") .withKubeProxyMode("iptables"); Authentication authenticationSpec = new Authentication(); authenticationSpec.withMode("rbac"); ServiceNetwork serviceNetworkSpec = new ServiceNetwork(); serviceNetworkSpec.withIpv4CIDR("10.247.0.0/16"); List listEniNetworkSubnets = new ArrayList<>(); listEniNetworkSubnets.add( new NetworkSubnet() .withSubnetID("861fb11d-2f0e-4c10-a98a-166dc26e4ff7") ); EniNetwork eniNetworkSpec = new EniNetwork(); eniNetworkSpec.withEniSubnetId("861fb11d-2f0e-4c10-a98a-166dc26e4ff7") .withEniSubnetCIDR("192.168.0.0/24") .withSubnets(listEniNetworkSubnets); ContainerNetwork containerNetworkSpec = new ContainerNetwork(); containerNetworkSpec.withMode(ContainerNetwork.ModeEnum.fromValue("eni")); HostNetwork hostNetworkSpec = new HostNetwork(); hostNetworkSpec.withVpc("030bfb19-5fa7-42ad-8a0d-c0721d268867") .withSubnet("ca964acf-8468-4735-8229-97940ef6c881"); ClusterSpec specbody = new ClusterSpec(); specbody.withCategory(ClusterSpec.CategoryEnum.fromValue("Turbo")) .withType(ClusterSpec.TypeEnum.fromValue("VirtualMachine")) .withFlavor("cce.s2.small") .withVersion("v1.25") .withDescription("") .withIpv6enable(false) .withHostNetwork(hostNetworkSpec) .withContainerNetwork(containerNetworkSpec) .withEniNetwork(eniNetworkSpec) .withServiceNetwork(serviceNetworkSpec) .withAuthentication(authenticationSpec) .withBillingMode(0) .withExtendParam(extendParamSpec); ClusterMetadata metadatabody = new ClusterMetadata(); metadatabody.withName("cluster"); body.withSpec(specbody); body.withMetadata(metadatabody); body.withApiVersion("v3"); body.withKind("Cluster"); request.withBody(body); try { CreateClusterResponse response = client.createCluster(request); System.out.println(response.toString()); } catch (ConnectionException e) { e.printStackTrace(); } catch (RequestTimeoutException e) { e.printStackTrace(); } catch (ServiceResponseException e) { e.printStackTrace(); System.out.println(e.getHttpStatusCode()); System.out.println(e.getRequestId()); System.out.println(e.getErrorCode()); System.out.println(e.getErrorMsg()); } } } ``` - 创建集群时配置允许访问集群API白名单网段 ``` package com.huaweicloud.sdk.test; import com.huaweicloud.sdk.core.auth.ICredential; import com.huaweicloud.sdk.core.auth.BasicCredentials; import com.huaweicloud.sdk.core.exception.ConnectionException; import com.huaweicloud.sdk.core.exception.RequestTimeoutException; import com.huaweicloud.sdk.core.exception.ServiceResponseException; import com.huaweicloud.sdk.cce.v3.region.CceRegion; import com.huaweicloud.sdk.cce.v3.*; import com.huaweicloud.sdk.cce.v3.model.*; import java.util.List; import java.util.ArrayList; public class CreateClusterSolution { public static void main(String[] args) { // The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security. // In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment String ak = System.getenv("CLOUD_SDK_AK"); String sk = System.getenv("CLOUD_SDK_SK"); String projectId = "{project_id}"; ICredential auth = new BasicCredentials() .withProjectId(projectId) .withAk(ak) .withSk(sk); CceClient client = CceClient.newBuilder() .withCredential(auth) .withRegion(CceRegion.valueOf("")) .build(); CreateClusterRequest request = new CreateClusterRequest(); Cluster body = new Cluster(); ClusterExtendParam extendParamSpec = new ClusterExtendParam(); extendParamSpec.withEnterpriseProjectId("0") .withKubeProxyMode("iptables") .withAlphaCceFixPoolMask("25"); List listPublicAccessCidrs = new ArrayList<>(); listPublicAccessCidrs.add("192.168.0.0/16"); PublicAccess publicAccessSpec = new PublicAccess(); publicAccessSpec.withCidrs(listPublicAccessCidrs); Authentication authenticationSpec = new Authentication(); authenticationSpec.withMode("rbac"); ServiceNetwork serviceNetworkSpec = new ServiceNetwork(); serviceNetworkSpec.withIpv4CIDR("10.247.0.0/16") .withIpv6CIDR("fc00::/112"); ContainerNetwork containerNetworkSpec = new ContainerNetwork(); containerNetworkSpec.withMode(ContainerNetwork.ModeEnum.fromValue("vpc-router")) .withCidr("10.0.0.0/16"); HostNetwork hostNetworkSpec = new HostNetwork(); hostNetworkSpec.withVpc("030bfb19-5fa7-42ad-8a0d-c0721d268867") .withSubnet("ca964acf-8468-4735-8229-97940ef6c881"); ClusterSpec specbody = new ClusterSpec(); specbody.withCategory(ClusterSpec.CategoryEnum.fromValue("CCE")) .withFlavor("cce.s2.small") .withVersion("v1.19") .withDescription("") .withIpv6enable(false) .withHostNetwork(hostNetworkSpec) .withContainerNetwork(containerNetworkSpec) .withServiceNetwork(serviceNetworkSpec) .withAuthentication(authenticationSpec) .withPublicAccess(publicAccessSpec) .withBillingMode(0) .withKubernetesSvcIpRange("10.247.0.0/16") .withExtendParam(extendParamSpec); ClusterMetadata metadatabody = new ClusterMetadata(); metadatabody.withName("cluster"); body.withSpec(specbody); body.withMetadata(metadatabody); body.withApiVersion("v3"); body.withKind("Cluster"); request.withBody(body); try { CreateClusterResponse response = client.createCluster(request); System.out.println(response.toString()); } catch (ConnectionException e) { e.printStackTrace(); } catch (RequestTimeoutException e) { e.printStackTrace(); } catch (ServiceResponseException e) { e.printStackTrace(); System.out.println(e.getHttpStatusCode()); System.out.println(e.getRequestId()); System.out.println(e.getErrorCode()); System.out.println(e.getErrorMsg()); } } } ``` - [Python] - 创建一个v1.29版本的CCE集群，计费模式为按需计费，集群规模为50节点，且为三控制节点高可用集群。 ``` # coding: utf-8 import os from huaweicloudsdkcore.auth.credentials import BasicCredentials from huaweicloudsdkcce.v3.region.cce_region import CceRegion from huaweicloudsdkcore.exceptions import exceptions from huaweicloudsdkcce.v3 import * if __name__ == "__main__": # The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security. # In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment ak = os.environ["CLOUD_SDK_AK"] sk = os.environ["CLOUD_SDK_SK"] projectId = "{project_id}" credentials = BasicCredentials(ak, sk, projectId) client = CceClient.new_builder() \ .with_credentials(credentials) \ .with_region(CceRegion.value_of("")) \ .build() try: request = CreateClusterRequest() extendParamSpec = ClusterExtendParam( enterprise_project_id="0", kube_proxy_mode="iptables", alpha_cce_fix_pool_mask="25" ) authenticationSpec = Authentication( mode="rbac" ) containerNetworkSpec = ContainerNetwork( mode="vpc-router", cidr="10.0.0.0/16" ) hostNetworkSpec = HostNetwork( vpc="030bfb19-5fa7-42ad-8a0d-c0721d268867", subnet="ca964acf-8468-4735-8229-97940ef6c881" ) specbody = ClusterSpec( category="CCE", flavor="cce.s2.small", version="v1.29", description="", ipv6enable=False, host_network=hostNetworkSpec, container_network=containerNetworkSpec, authentication=authenticationSpec, billing_mode=0, kubernetes_svc_ip_range="10.247.0.0/16", extend_param=extendParamSpec ) metadatabody = ClusterMetadata( name="cluster" ) request.body = Cluster( spec=specbody, metadata=metadatabody, api_version="v3", kind="Cluster" ) response = client.create_cluster(request) print(response) except exceptions.ClientRequestException as e: print(e.status_code) print(e.request_id) print(e.error_code) print(e.error_msg) ``` - 创建一个v1.29版本的CCE集群，计费模式为按需计费，集群规模为50节点，且为三控制节点高可用集群，并在集群中安装ICAgent。 ``` # coding: utf-8 import os from huaweicloudsdkcore.auth.credentials import BasicCredentials from huaweicloudsdkcce.v3.region.cce_region import CceRegion from huaweicloudsdkcore.exceptions import exceptions from huaweicloudsdkcce.v3 import * if __name__ == "__main__": # The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security. # In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment ak = os.environ["CLOUD_SDK_AK"] sk = os.environ["CLOUD_SDK_SK"] projectId = "{project_id}" credentials = BasicCredentials(ak, sk, projectId) client = CceClient.new_builder() \ .with_credentials(credentials) \ .with_region(CceRegion.value_of("")) \ .build() try: request = CreateClusterRequest() extendParamSpec = ClusterExtendParam( enterprise_project_id="0", kube_proxy_mode="iptables", alpha_cce_fix_pool_mask="25" ) authenticationSpec = Authentication( mode="rbac" ) containerNetworkSpec = ContainerNetwork( mode="vpc-router", cidr="10.0.0.0/16" ) hostNetworkSpec = HostNetwork( vpc="030bfb19-5fa7-42ad-8a0d-c0721d268867", subnet="ca964acf-8468-4735-8229-97940ef6c881" ) specbody = ClusterSpec( category="CCE", flavor="cce.s2.small", version="v1.29", description="", ipv6enable=False, host_network=hostNetworkSpec, container_network=containerNetworkSpec, authentication=authenticationSpec, billing_mode=0, kubernetes_svc_ip_range="10.247.0.0/16", extend_param=extendParamSpec ) listAnnotationsMetadata = { "cluster.install.addons.external/install": "[{"addonTemplateName":"icagent"}]" } metadatabody = ClusterMetadata( name="cluster", annotations=listAnnotationsMetadata ) request.body = Cluster( spec=specbody, metadata=metadatabody, api_version="v3", kind="Cluster" ) response = client.create_cluster(request) print(response) except exceptions.ClientRequestException as e: print(e.status_code) print(e.request_id) print(e.error_code) print(e.error_msg) ``` - 创建一个v1.29版本的CCE集群，计费模式为按需计费，集群规模为50节点，且为三控制节点高可用集群，并指定自定义的节点默认安全组。 ``` # coding: utf-8 import os from huaweicloudsdkcore.auth.credentials import BasicCredentials from huaweicloudsdkcce.v3.region.cce_region import CceRegion from huaweicloudsdkcore.exceptions import exceptions from huaweicloudsdkcce.v3 import * if __name__ == "__main__": # The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security. # In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment ak = os.environ["CLOUD_SDK_AK"] sk = os.environ["CLOUD_SDK_SK"] projectId = "{project_id}" credentials = BasicCredentials(ak, sk, projectId) client = CceClient.new_builder() \ .with_credentials(credentials) \ .with_region(CceRegion.value_of("")) \ .build() try: request = CreateClusterRequest() extendParamSpec = ClusterExtendParam( enterprise_project_id="0", kube_proxy_mode="iptables", alpha_cce_fix_pool_mask="25" ) authenticationSpec = Authentication( mode="rbac" ) containerNetworkSpec = ContainerNetwork( mode="vpc-router", cidr="10.0.0.0/16" ) hostNetworkSpec = HostNetwork( vpc="030bfb19-5fa7-42ad-8a0d-c0721d268867", subnet="ca964acf-8468-4735-8229-97940ef6c881", security_group="a4ef108c-2ec6-492f-a6c4-7b64e25ae490" ) specbody = ClusterSpec( category="CCE", flavor="cce.s2.small", version="v1.29", description="", ipv6enable=False, host_network=hostNetworkSpec, container_network=containerNetworkSpec, authentication=authenticationSpec, billing_mode=0, kubernetes_svc_ip_range="10.247.0.0/16", extend_param=extendParamSpec ) metadatabody = ClusterMetadata( name="cluster" ) request.body = Cluster( spec=specbody, metadata=metadatabody, api_version="v3", kind="Cluster" ) response = client.create_cluster(request) print(response) except exceptions.ClientRequestException as e: print(e.status_code) print(e.request_id) print(e.error_code) print(e.error_msg) ``` - 创建一个v1.25版本的CCE Turbo集群，计费模式为按需计费，集群规模为50节点，且为三控制节点高可用集群。 ``` # coding: utf-8 import os from huaweicloudsdkcore.auth.credentials import BasicCredentials from huaweicloudsdkcce.v3.region.cce_region import CceRegion from huaweicloudsdkcore.exceptions import exceptions from huaweicloudsdkcce.v3 import * if __name__ == "__main__": # The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security. # In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment ak = os.environ["CLOUD_SDK_AK"] sk = os.environ["CLOUD_SDK_SK"] projectId = "{project_id}" credentials = BasicCredentials(ak, sk, projectId) client = CceClient.new_builder() \ .with_credentials(credentials) \ .with_region(CceRegion.value_of("")) \ .build() try: request = CreateClusterRequest() extendParamSpec = ClusterExtendParam( enterprise_project_id="0", kube_proxy_mode="iptables" ) authenticationSpec = Authentication( mode="rbac" ) serviceNetworkSpec = ServiceNetwork( i_pv4_cidr="10.247.0.0/16" ) listSubnetsEniNetwork = [ NetworkSubnet( subnet_id="861fb11d-2f0e-4c10-a98a-166dc26e4ff7" ) ] eniNetworkSpec = EniNetwork( eni_subnet_id="861fb11d-2f0e-4c10-a98a-166dc26e4ff7", eni_subnet_cidr="192.168.0.0/24", subnets=listSubnetsEniNetwork ) containerNetworkSpec = ContainerNetwork( mode="eni" ) hostNetworkSpec = HostNetwork( vpc="030bfb19-5fa7-42ad-8a0d-c0721d268867", subnet="ca964acf-8468-4735-8229-97940ef6c881" ) specbody = ClusterSpec( category="Turbo", type="VirtualMachine", flavor="cce.s2.small", version="v1.25", description="", ipv6enable=False, host_network=hostNetworkSpec, container_network=containerNetworkSpec, eni_network=eniNetworkSpec, service_network=serviceNetworkSpec, authentication=authenticationSpec, billing_mode=0, extend_param=extendParamSpec ) metadatabody = ClusterMetadata( name="cluster" ) request.body = Cluster( spec=specbody, metadata=metadatabody, api_version="v3", kind="Cluster" ) response = client.create_cluster(request) print(response) except exceptions.ClientRequestException as e: print(e.status_code) print(e.request_id) print(e.error_code) print(e.error_msg) ``` - 创建集群时配置允许访问集群API白名单网段 ``` # coding: utf-8 import os from huaweicloudsdkcore.auth.credentials import BasicCredentials from huaweicloudsdkcce.v3.region.cce_region import CceRegion from huaweicloudsdkcore.exceptions import exceptions from huaweicloudsdkcce.v3 import * if __name__ == "__main__": # The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security. # In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment ak = os.environ["CLOUD_SDK_AK"] sk = os.environ["CLOUD_SDK_SK"] projectId = "{project_id}" credentials = BasicCredentials(ak, sk, projectId) client = CceClient.new_builder() \ .with_credentials(credentials) \ .with_region(CceRegion.value_of("")) \ .build() try: request = CreateClusterRequest() extendParamSpec = ClusterExtendParam( enterprise_project_id="0", kube_proxy_mode="iptables", alpha_cce_fix_pool_mask="25" ) listCidrsPublicAccess = [ "192.168.0.0/16" ] publicAccessSpec = PublicAccess( cidrs=listCidrsPublicAccess ) authenticationSpec = Authentication( mode="rbac" ) serviceNetworkSpec = ServiceNetwork( i_pv4_cidr="10.247.0.0/16", i_pv6_cidr="fc00::/112" ) containerNetworkSpec = ContainerNetwork( mode="vpc-router", cidr="10.0.0.0/16" ) hostNetworkSpec = HostNetwork( vpc="030bfb19-5fa7-42ad-8a0d-c0721d268867", subnet="ca964acf-8468-4735-8229-97940ef6c881" ) specbody = ClusterSpec( category="CCE", flavor="cce.s2.small", version="v1.19", description="", ipv6enable=False, host_network=hostNetworkSpec, container_network=containerNetworkSpec, service_network=serviceNetworkSpec, authentication=authenticationSpec, public_access=publicAccessSpec, billing_mode=0, kubernetes_svc_ip_range="10.247.0.0/16", extend_param=extendParamSpec ) metadatabody = ClusterMetadata( name="cluster" ) request.body = Cluster( spec=specbody, metadata=metadatabody, api_version="v3", kind="Cluster" ) response = client.create_cluster(request) print(response) except exceptions.ClientRequestException as e: print(e.status_code) print(e.request_id) print(e.error_code) print(e.error_msg) ``` - [Go] - 创建一个v1.29版本的CCE集群，计费模式为按需计费，集群规模为50节点，且为三控制节点高可用集群。 ``` package main import ( "fmt" "github.com/huaweicloud/huaweicloud-sdk-go-v3/core/auth/basic" cce "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/cce/v3" "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/cce/v3/model" region "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/cce/v3/region" ) func main() { // The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security. // In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment ak := os.Getenv("CLOUD_SDK_AK") sk := os.Getenv("CLOUD_SDK_SK") projectId := "{project_id}" auth, err := basic.NewCredentialsBuilder(). WithAk(ak). WithSk(sk). WithProjectId(projectId). SafeBuild() if err != nil { fmt.Println(err) return } hcClient, err := cce.CceClientBuilder(). WithRegion(region.ValueOf("")). WithCredential(auth). SafeBuild() if err != nil { fmt.Println(err) return } client := cce.NewCceClient(hcClient) request := &model.CreateClusterRequest{} enterpriseProjectIdExtendParam:= "0" kubeProxyModeExtendParam:= "iptables" alphaCceFixPoolMaskExtendParam:= "25" extendParamSpec := &model.ClusterExtendParam{ EnterpriseProjectId: &enterpriseProjectIdExtendParam, KubeProxyMode: &kubeProxyModeExtendParam, AlphaCceFixPoolMask: &alphaCceFixPoolMaskExtendParam, } modeAuthentication:= "rbac" authenticationSpec := &model.Authentication{ Mode: &modeAuthentication, } cidrContainerNetwork:= "10.0.0.0/16" containerNetworkSpec := &model.ContainerNetwork{ Mode: model.GetContainerNetworkModeEnum().VPC_ROUTER, Cidr: &cidrContainerNetwork, } hostNetworkSpec := &model.HostNetwork{ Vpc: "030bfb19-5fa7-42ad-8a0d-c0721d268867", Subnet: "ca964acf-8468-4735-8229-97940ef6c881", } categorySpec:= model.GetClusterSpecCategoryEnum().CCE flavorSpec:= "cce.s2.small" versionSpec:= "v1.29" descriptionSpec:= "" ipv6enableSpec:= false billingModeSpec:= int32(0) kubernetesSvcIpRangeSpec:= "10.247.0.0/16" specbody := &model.ClusterSpec{ Category: &categorySpec, Flavor: &flavorSpec, Version: &versionSpec, Description: &descriptionSpec, Ipv6enable: &ipv6enableSpec, HostNetwork: hostNetworkSpec, ContainerNetwork: containerNetworkSpec, Authentication: authenticationSpec, BillingMode: &billingModeSpec, KubernetesSvcIpRange: &kubernetesSvcIpRangeSpec, ExtendParam: extendParamSpec, } metadatabody := &model.ClusterMetadata{ Name: "cluster", } request.Body = &model.Cluster{ Spec: specbody, Metadata: metadatabody, ApiVersion: "v3", Kind: "Cluster", } response, err := client.CreateCluster(request) if err == nil { fmt.Printf("%+v\n", response) } else { fmt.Println(err) } } ``` - 创建一个v1.29版本的CCE集群，计费模式为按需计费，集群规模为50节点，且为三控制节点高可用集群，并在集群中安装ICAgent。 ``` package main import ( "fmt" "github.com/huaweicloud/huaweicloud-sdk-go-v3/core/auth/basic" cce "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/cce/v3" "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/cce/v3/model" region "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/cce/v3/region" ) func main() { // The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security. // In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment ak := os.Getenv("CLOUD_SDK_AK") sk := os.Getenv("CLOUD_SDK_SK") projectId := "{project_id}" auth, err := basic.NewCredentialsBuilder(). WithAk(ak). WithSk(sk). WithProjectId(projectId). SafeBuild() if err != nil { fmt.Println(err) return } hcClient, err := cce.CceClientBuilder(). WithRegion(region.ValueOf("")). WithCredential(auth). SafeBuild() if err != nil { fmt.Println(err) return } client := cce.NewCceClient(hcClient) request := &model.CreateClusterRequest{} enterpriseProjectIdExtendParam:= "0" kubeProxyModeExtendParam:= "iptables" alphaCceFixPoolMaskExtendParam:= "25" extendParamSpec := &model.ClusterExtendParam{ EnterpriseProjectId: &enterpriseProjectIdExtendParam, KubeProxyMode: &kubeProxyModeExtendParam, AlphaCceFixPoolMask: &alphaCceFixPoolMaskExtendParam, } modeAuthentication:= "rbac" authenticationSpec := &model.Authentication{ Mode: &modeAuthentication, } cidrContainerNetwork:= "10.0.0.0/16" containerNetworkSpec := &model.ContainerNetwork{ Mode: model.GetContainerNetworkModeEnum().VPC_ROUTER, Cidr: &cidrContainerNetwork, } hostNetworkSpec := &model.HostNetwork{ Vpc: "030bfb19-5fa7-42ad-8a0d-c0721d268867", Subnet: "ca964acf-8468-4735-8229-97940ef6c881", } categorySpec:= model.GetClusterSpecCategoryEnum().CCE flavorSpec:= "cce.s2.small" versionSpec:= "v1.29" descriptionSpec:= "" ipv6enableSpec:= false billingModeSpec:= int32(0) kubernetesSvcIpRangeSpec:= "10.247.0.0/16" specbody := &model.ClusterSpec{ Category: &categorySpec, Flavor: &flavorSpec, Version: &versionSpec, Description: &descriptionSpec, Ipv6enable: &ipv6enableSpec, HostNetwork: hostNetworkSpec, ContainerNetwork: containerNetworkSpec, Authentication: authenticationSpec, BillingMode: &billingModeSpec, KubernetesSvcIpRange: &kubernetesSvcIpRangeSpec, ExtendParam: extendParamSpec, } var listAnnotationsMetadata = map[string]string{ "cluster.install.addons.external/install": "[{"addonTemplateName":"icagent"}]", } metadatabody := &model.ClusterMetadata{ Name: "cluster", Annotations: listAnnotationsMetadata, } request.Body = &model.Cluster{ Spec: specbody, Metadata: metadatabody, ApiVersion: "v3", Kind: "Cluster", } response, err := client.CreateCluster(request) if err == nil { fmt.Printf("%+v\n", response) } else { fmt.Println(err) } } ``` - 创建一个v1.29版本的CCE集群，计费模式为按需计费，集群规模为50节点，且为三控制节点高可用集群，并指定自定义的节点默认安全组。 ``` package main import ( "fmt" "github.com/huaweicloud/huaweicloud-sdk-go-v3/core/auth/basic" cce "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/cce/v3" "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/cce/v3/model" region "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/cce/v3/region" ) func main() { // The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security. // In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment ak := os.Getenv("CLOUD_SDK_AK") sk := os.Getenv("CLOUD_SDK_SK") projectId := "{project_id}" auth, err := basic.NewCredentialsBuilder(). WithAk(ak). WithSk(sk). WithProjectId(projectId). SafeBuild() if err != nil { fmt.Println(err) return } hcClient, err := cce.CceClientBuilder(). WithRegion(region.ValueOf("")). WithCredential(auth). SafeBuild() if err != nil { fmt.Println(err) return } client := cce.NewCceClient(hcClient) request := &model.CreateClusterRequest{} enterpriseProjectIdExtendParam:= "0" kubeProxyModeExtendParam:= "iptables" alphaCceFixPoolMaskExtendParam:= "25" extendParamSpec := &model.ClusterExtendParam{ EnterpriseProjectId: &enterpriseProjectIdExtendParam, KubeProxyMode: &kubeProxyModeExtendParam, AlphaCceFixPoolMask: &alphaCceFixPoolMaskExtendParam, } modeAuthentication:= "rbac" authenticationSpec := &model.Authentication{ Mode: &modeAuthentication, } cidrContainerNetwork:= "10.0.0.0/16" containerNetworkSpec := &model.ContainerNetwork{ Mode: model.GetContainerNetworkModeEnum().VPC_ROUTER, Cidr: &cidrContainerNetwork, } securityGroupHostNetwork:= "a4ef108c-2ec6-492f-a6c4-7b64e25ae490" hostNetworkSpec := &model.HostNetwork{ Vpc: "030bfb19-5fa7-42ad-8a0d-c0721d268867", Subnet: "ca964acf-8468-4735-8229-97940ef6c881", SecurityGroup: &securityGroupHostNetwork, } categorySpec:= model.GetClusterSpecCategoryEnum().CCE flavorSpec:= "cce.s2.small" versionSpec:= "v1.29" descriptionSpec:= "" ipv6enableSpec:= false billingModeSpec:= int32(0) kubernetesSvcIpRangeSpec:= "10.247.0.0/16" specbody := &model.ClusterSpec{ Category: &categorySpec, Flavor: &flavorSpec, Version: &versionSpec, Description: &descriptionSpec, Ipv6enable: &ipv6enableSpec, HostNetwork: hostNetworkSpec, ContainerNetwork: containerNetworkSpec, Authentication: authenticationSpec, BillingMode: &billingModeSpec, KubernetesSvcIpRange: &kubernetesSvcIpRangeSpec, ExtendParam: extendParamSpec, } metadatabody := &model.ClusterMetadata{ Name: "cluster", } request.Body = &model.Cluster{ Spec: specbody, Metadata: metadatabody, ApiVersion: "v3", Kind: "Cluster", } response, err := client.CreateCluster(request) if err == nil { fmt.Printf("%+v\n", response) } else { fmt.Println(err) } } ``` - 创建一个v1.25版本的CCE Turbo集群，计费模式为按需计费，集群规模为50节点，且为三控制节点高可用集群。 ``` package main import ( "fmt" "github.com/huaweicloud/huaweicloud-sdk-go-v3/core/auth/basic" cce "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/cce/v3" "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/cce/v3/model" region "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/cce/v3/region" ) func main() { // The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security. // In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment ak := os.Getenv("CLOUD_SDK_AK") sk := os.Getenv("CLOUD_SDK_SK") projectId := "{project_id}" auth, err := basic.NewCredentialsBuilder(). WithAk(ak). WithSk(sk). WithProjectId(projectId). SafeBuild() if err != nil { fmt.Println(err) return } hcClient, err := cce.CceClientBuilder(). WithRegion(region.ValueOf("")). WithCredential(auth). SafeBuild() if err != nil { fmt.Println(err) return } client := cce.NewCceClient(hcClient) request := &model.CreateClusterRequest{} enterpriseProjectIdExtendParam:= "0" kubeProxyModeExtendParam:= "iptables" extendParamSpec := &model.ClusterExtendParam{ EnterpriseProjectId: &enterpriseProjectIdExtendParam, KubeProxyMode: &kubeProxyModeExtendParam, } modeAuthentication:= "rbac" authenticationSpec := &model.Authentication{ Mode: &modeAuthentication, } iPv4CIDRServiceNetwork:= "10.247.0.0/16" serviceNetworkSpec := &model.ServiceNetwork{ IPv4CIDR: &iPv4CIDRServiceNetwork, } var listSubnetsEniNetwork = []model.NetworkSubnet{ { SubnetID: "861fb11d-2f0e-4c10-a98a-166dc26e4ff7", }, } eniSubnetIdEniNetwork:= "861fb11d-2f0e-4c10-a98a-166dc26e4ff7" eniSubnetCIDREniNetwork:= "192.168.0.0/24" eniNetworkSpec := &model.EniNetwork{ EniSubnetId: &eniSubnetIdEniNetwork, EniSubnetCIDR: &eniSubnetCIDREniNetwork, Subnets: &listSubnetsEniNetwork, } containerNetworkSpec := &model.ContainerNetwork{ Mode: model.GetContainerNetworkModeEnum().ENI, } hostNetworkSpec := &model.HostNetwork{ Vpc: "030bfb19-5fa7-42ad-8a0d-c0721d268867", Subnet: "ca964acf-8468-4735-8229-97940ef6c881", } categorySpec:= model.GetClusterSpecCategoryEnum().TURBO typeSpec:= model.GetClusterSpecTypeEnum().VIRTUAL_MACHINE flavorSpec:= "cce.s2.small" versionSpec:= "v1.25" descriptionSpec:= "" ipv6enableSpec:= false billingModeSpec:= int32(0) specbody := &model.ClusterSpec{ Category: &categorySpec, Type: &typeSpec, Flavor: &flavorSpec, Version: &versionSpec, Description: &descriptionSpec, Ipv6enable: &ipv6enableSpec, HostNetwork: hostNetworkSpec, ContainerNetwork: containerNetworkSpec, EniNetwork: eniNetworkSpec, ServiceNetwork: serviceNetworkSpec, Authentication: authenticationSpec, BillingMode: &billingModeSpec, ExtendParam: extendParamSpec, } metadatabody := &model.ClusterMetadata{ Name: "cluster", } request.Body = &model.Cluster{ Spec: specbody, Metadata: metadatabody, ApiVersion: "v3", Kind: "Cluster", } response, err := client.CreateCluster(request) if err == nil { fmt.Printf("%+v\n", response) } else { fmt.Println(err) } } ``` - 创建集群时配置允许访问集群API白名单网段 ``` package main import ( "fmt" "github.com/huaweicloud/huaweicloud-sdk-go-v3/core/auth/basic" cce "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/cce/v3" "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/cce/v3/model" region "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/cce/v3/region" ) func main() { // The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security. // In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment ak := os.Getenv("CLOUD_SDK_AK") sk := os.Getenv("CLOUD_SDK_SK") projectId := "{project_id}" auth, err := basic.NewCredentialsBuilder(). WithAk(ak). WithSk(sk). WithProjectId(projectId). SafeBuild() if err != nil { fmt.Println(err) return } hcClient, err := cce.CceClientBuilder(). WithRegion(region.ValueOf("")). WithCredential(auth). SafeBuild() if err != nil { fmt.Println(err) return } client := cce.NewCceClient(hcClient) request := &model.CreateClusterRequest{} enterpriseProjectIdExtendParam:= "0" kubeProxyModeExtendParam:= "iptables" alphaCceFixPoolMaskExtendParam:= "25" extendParamSpec := &model.ClusterExtendParam{ EnterpriseProjectId: &enterpriseProjectIdExtendParam, KubeProxyMode: &kubeProxyModeExtendParam, AlphaCceFixPoolMask: &alphaCceFixPoolMaskExtendParam, } var listCidrsPublicAccess = []string{ "192.168.0.0/16", } publicAccessSpec := &model.PublicAccess{ Cidrs: &listCidrsPublicAccess, } modeAuthentication:= "rbac" authenticationSpec := &model.Authentication{ Mode: &modeAuthentication, } iPv4CIDRServiceNetwork:= "10.247.0.0/16" iPv6CIDRServiceNetwork:= "fc00::/112" serviceNetworkSpec := &model.ServiceNetwork{ IPv4CIDR: &iPv4CIDRServiceNetwork, IPv6CIDR: &iPv6CIDRServiceNetwork, } cidrContainerNetwork:= "10.0.0.0/16" containerNetworkSpec := &model.ContainerNetwork{ Mode: model.GetContainerNetworkModeEnum().VPC_ROUTER, Cidr: &cidrContainerNetwork, } hostNetworkSpec := &model.HostNetwork{ Vpc: "030bfb19-5fa7-42ad-8a0d-c0721d268867", Subnet: "ca964acf-8468-4735-8229-97940ef6c881", } categorySpec:= model.GetClusterSpecCategoryEnum().CCE flavorSpec:= "cce.s2.small" versionSpec:= "v1.19" descriptionSpec:= "" ipv6enableSpec:= false billingModeSpec:= int32(0) kubernetesSvcIpRangeSpec:= "10.247.0.0/16" specbody := &model.ClusterSpec{ Category: &categorySpec, Flavor: &flavorSpec, Version: &versionSpec, Description: &descriptionSpec, Ipv6enable: &ipv6enableSpec, HostNetwork: hostNetworkSpec, ContainerNetwork: containerNetworkSpec, ServiceNetwork: serviceNetworkSpec, Authentication: authenticationSpec, PublicAccess: publicAccessSpec, BillingMode: &billingModeSpec, KubernetesSvcIpRange: &kubernetesSvcIpRangeSpec, ExtendParam: extendParamSpec, } metadatabody := &model.ClusterMetadata{ Name: "cluster", } request.Body = &model.Cluster{ Spec: specbody, Metadata: metadatabody, ApiVersion: "v3", Kind: "Cluster", } response, err := client.CreateCluster(request) if err == nil { fmt.Printf("%+v\n", response) } else { fmt.Println(err) } } ``` - [更多] 更多编程语言的SDK代码示例，请参见[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/CCE/sdk?api=CreateCluster)的代码示例页签，可生成自动对应的SDK代码示例。 #### 状态码 | 状态码 | 描述 | |:---|:---| | 201 | 表示创建集群作业下发成功。 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-cce/ErrorCode.html)。