CreateCluster - 创建集群

自定义集群名称。由数字、汉字、英文字符或短划线（-）组成，长度范围 1~63 个字符，且不能以短划线（-）开头。

集群所在地域 ID。详情请参见容器服务开服地域。

• Kubernetes: ACK 专有集群。

• ManagedKubernetes：ACK 托管类的集群，包括 ACK 托管集群（Pro 版、基础版）、ACK Serverless 集群（Pro 版、基础版）、ACK Edge 集群（Pro 版、基础版）、ACK 灵骏集群（Pro 版）。

• ExternalKubernetes：注册集群。

当您选择cluster_type为ManagedKubernetes并配置profile后，您可以进一步指定集群的规格。

• ack.pro.small：Pro 版。

• ack.standard：基础版（取值为空时默认选择）。

选择cluster_type为ManagedKubernetes时，即 ACK 托管类的集群时，可进一步指定集群的子类型。

• Default：ACK 托管集群，包括 ACK 集群（Pro 版、基础版）。

• Edge：ACK Edge 集群，包括 ACK Edge 集群（Pro 版、基础版）。

• Serverless：ACK Serverless 集群，包括 ACK Serverless 集群（Pro 版、基础版）。

• Lingjun：ACK 灵骏集群，提供 Pro 版。

集群版本，与 Kubernetes 社区基线版本保持一致。建议选择最新版本。若不指定，默认使用最新版本。

支持创建最近三个版本的集群，可通过 DescribeKubernetesVersionMetadata 接口查询支持的集群版本。

关于 ACK 支持的 Kubernetes 版本，请参见 Kubernetes 版本发布概览。

集群所属资源组 ID，实现不同资源的隔离。

集群删除保护，防止通过控制台或 API 误删除集群。取值：

• true：启用集群删除保护，将不能通过控制台或 API 删除集群。

• false：不启用集群删除保护，则能通过控制台或 API 删除集群。

默认值：false。

集群使用的专有网络，创建集群时必须为集群提供。

集群 ip_stack。

Pod 网络地址段，必须是有效的私有网段，即以下网段及其子网：10.0.0.0/8、172.16-31.0.0/12-16、192.168.0.0/16。不能与 VPC 及 VPC 内已有 Kubernetes 集群使用的网段重复，创建成功后不能修改。

关于集群网络规划，请参见 ACK 托管集群网络规划。

Service 网络地址段，可选范围：10.0.0.0/16-24，172.16-31.0.0/16-24，192.168.0.0/16-24 不能与 VPC 网段 10.1.0.0/21 及 VPC 内已有 Kubernetes 集群使用的网段重复，创建成功后不能修改。

默认使用 172.19.0.0/20 网段。

使用已有安全组创建集群时需要指定安全组 ID，和is_enterprise_security_group二选一，集群节点自动加入到此安全组。

自动创建企业级安全组，当security_group_id为空时生效。

• true：创建并使用企业级安全组。

• false：使用普通安全组。

默认值：true。

为专有网络配置 SNAT。取值：

• true：自动创建 NAT 网关并自动配置 SNAT 规则。集群内的节点、应用等需要访问公网需要设置为true。

• false：不创建 NAT 网关及 SNAT 规则。集群内节点及应用将不能访问公网。

默认值：false。

是否开启公网访问。通过 EIP 暴露 API Server，实现集群公网访问。

• true：开启公网访问。

• false：不开启公网访问。选择不开放时，则无法通过外网访问集群 API Server。

默认值：false。

指定用于 API Server 访问的 CLB 实例 ID。指定该参数时，将不再自动创建 API Server CLB。

是否开放公网 SSH 登录。用于登录 ACK 专有集群的 Master 节点。托管集群中，该参数不生效。

• true：开放。

• false：不开放。

默认值：false。

集群使用的时区。请参见支持时区。

节点 IP 数量，通过指定网络的 CIDR 来确定 IP 的数量，只对于 Flannel 网络类型集群生效。

默认值：26。

kube-proxy 代理模式

• iptables: 成熟稳定的 kube-proxy 代理模式，Kubernetes Service 的服务发现和负载均衡使用 iptables 规则配置，但是性能一般，受规模影响较大，适用于集群存在少量的 Service。

• ipvs：高性能的 kube-proxy 代理模式，Kubernetes Service 的服务发现和负载均衡使用 Linux IPVS 模块进行配置，适用于集群存在大量的 Service，对负载均衡有高性能要求的场景。

• nftables：新一代 kube-proxy 代理模式，基于 Linux nftables 实现 Service 服务发现与负载均衡，是 iptables 的现代化替代方案。相比 iptables，nftables 在网络性能、规则更新效率和大规模 Service 场景下表现更优。
  仅支持 1.35 及以上版本的集群。Kubernetes 社区自 1.35 版本起废弃 IPVS，新建集群建议使用 nftables 以获得更长期的社区支持。

默认值：ipvs。

控制面组件日志保存天数。

控制平面组件日志服务 Project，可以使用已有 Project 用于日志存储，也可以使用系统自动创建 Project 用户日志存储。如果选择自动创建日志服务 Project 将会自动创建一个名称为k8s-log-{ClusterID}的日志服务 Project。

集群本地域名。

命名规则：域名由小数点（.）分隔的一个或多个部分构成，每个部分最长为 63 个字符，可以使用小写字母、数字和短划线（-），且首尾必须为小写字母或数字。

KMS 密钥 ID，使用该密钥对数据盘进行加密。更多详情，请参见密钥管理服务。

ServiceAccount 是 Pod 和集群 API Server 通讯的访问凭证。而service-account-issuer是serviceaccount token中的签发身份，即token payload中的iss字段。

关于ServiceAccount更多详情，请参见部署服务账户令牌卷投影。

ServiceAccount 是 Pod 和集群 API Server 通讯的访问凭证，而api-audiences是合法的请求token身份，用于apiserver服务端认证请求token是否合法。支持配置多个audience，通过英文半角逗号（,）分割。

关于ServiceAccount更多详情，请参见部署服务账户令牌卷投影。

集群维护窗口。

自定义集群 CA。

【该字段已废弃】请使用参数extra_sans代替。

自定义证书 SAN，多个 IP 或域名以英文逗号（,）分隔。

集群内容器运行时。支持 containerd、安全沙箱和 Docker。

更多信息，请参见Docker、containerd、安全沙箱运行时的对比。

【该字段已废弃】节点池配置请使用nodepool中kubernetes_config下的node_name_mode的参数代替。

【该字段已废弃】自定义节点数据。

【该字段已废弃】集群控制面配置请使用control_plane_config下的image_id参数代替；节点池配置请使用nodepool中scaling_group下的image_id参数代替。

节点自定义镜像，默认使用系统镜像。当选择自定义镜像时，将取代默认系统镜像。请参见自定义镜像。

【该字段已废弃】集群控制面节点配置请使用control_plane_config下的cloud_monitor_flags参数代替；节点池配置请使用 nodepool 中kubernetes_config下的cms_enabled参数代替。

集群是否安装云监控插件。取值：

• true：安装云监控插件。

• false：不安装云监控插件。

默认值：false。

【该字段已废弃】节点池配置请使用nodepool中scaling_group下的platform参数代替。

操作系统发行版。取值：

• CentOS

• AliyunLinux

• QbootAliyunLinux

• Qboot

• Windows

• WindowsCore

默认值：CentOS。

【该字段已废弃】集群控制面节点配置请使用control_plane_config下的image_type参数代替；节点池配置请使用nodepool中scaling_group下的image_type参数代替。

操作系统平台类型。取值：

• Windows

• Linux

默认值：Linux。

【该字段已废弃】集群控制面节点配置请使用control_plane_config下的soc_enabled参数代替；节点池配置请使用nodepool中scaling_group下的soc_enabled参数代替。

等保加固。更多信息，请参见 ACK 等保加固使用说明。

取值：

• true：开启等保加固。

• false：不开启等保加固。

默认值：false。

【该字段已废弃】集群控制面配置请使用control_plane_config下的security_hardening_os参数代替；节点池配置请使用nodepool中scaling_group下的security_hardening_os参数代替。

阿里云 OS 安全加固。取值：

• true：开启阿里云 OS 安全加固。

• false：不开启阿里云 OS 安全加固。

默认值：false。

【该字段已废弃】集群控制面配置请使用control_plane_config下的security_hardening_os参数代替；节点池配置请使用nodepool中scaling_group下的security_hardening_os参数代替。

【该字段已废弃】集群控制面配置请使用control_plane_config下的cpu_policy参数代替；节点池配置请使用nodepool中kubernetes_config下的cpu_policy参数代替。

节点 CPU 管理策略。当集群版本在 1.12.6 及以上时支持以下两种策略：

• static：允许为节点上具有某些资源特征 Pod 增强其 CPU 亲和性和独占性。

• none：表示启用现有的默认 CPU 亲和性方案。

默认值：none。

节点服务端口，可选端口范围：[30000,65535]。

默认值：30000-32767。

【该字段已废弃】集群控制面配置请使用control_plane_config下的key_pair参数代替；节点池配置请使用nodepool中scaling_group下的key_pair参数代替。

密钥对名称，和login_password二选一。

【该字段已废弃】集群控制面配置请使用control_plane_config下的login_password参数代替；节点池配置请使用nodepool中scaling_group下的login_password参数代替。

SSH 登录密码，和key_pair 二选一。密码规则为 8~30 个字符，且至少同时包含三项（大小写字母、数字和特殊符号）。

【该字段已废弃】集群控制面配置请使用control_plane_config下的size参数代替。

Master 节点数量，可选值3或5。

默认值：3。

【该字段已废弃】集群控制面配置请使用control_plane_config下的system_disk_category参数代替。

Master 节点系统盘类型，取值：

• cloud_efficiency：高效云盘。

• cloud_ssd：SSD 云盘。

• cloud_essd：ESSD 云盘。

默认值：cloud_ssd。不同可用区，默认值可能会有所差异。

【该字段已废弃】集群控制面配置请使用control_plane_config下的system_disk_size参数代替。

Master 节点系统盘大小，取值范围[40,500]，单位：GiB。

默认值：120。

【该字段已废弃】集群控制面配置请使用control_plane_config下的system_disk_performance_level参数代替。

集群 Master 节点系统盘磁盘性能等级， 仅对 ESSD 磁盘生效。磁盘性能等级和磁盘大小有关，更多信息，请参见 ESSD 云盘。

【该字段已废弃】集群控制面配置请使用control_plane_config下的system_disk_snapshot_policy_id参数代替。

Master 节点系统盘采用的自动快照策略 ID。

【该字段已废弃】集群控制面配置请使用control_plane_config下的instance_charge_type参数代替。

Master 节点付费类型，取值：

• PrePaid：包年包月。

• PostPaid：按量付费。

默认值：PostPaid。

【该字段已废弃】集群控制面配置请使用control_plane_config下的period_unit参数代替。

Master 节点付费周期，当付费类型为PrePaid的时候必须指定周期。

取值：Month，当前仅支持以月为周期。

【该字段已废弃】集群控制面配置请使用control_plane_config下的unit参数代替。

Master 节点包年包月时长，当master_instance_charge_type取值为PrePaid时才生效且为必选值。

取值范围：{1, 2, 3, 6, 12, 24, 36, 48, 60}。

默认值：1。

【该字段已废弃】集群控制面配置请使用control_plane_config下的auto_renew参数代替。

Master 节点是否开启自动续费，当master_instance_charge_type取值为PrePaid时才生效，可选值为：

• true：自动续费。

• false：不自动续费。

默认值：true。

【该字段已废弃】集群控制面配置请使用control_plane_config下的auto_renew_period参数代替。

Master 节点自动续费周期，当选择包年包月付费类型时才生效，且为必选值。

取值范围：{1, 2, 3, 6, 12}。

默认值：1。

【该字段已废弃】节点池配置请使用nodepool中scaling_group下的desired_size参数代替。

Worker 节点数。范围是[0，100]。

【该字段已废弃】节点池配置请使用nodepool中scaling_group下的system_disk_category参数代替。

Worker 节点系统盘类型。更多信息，请参见块存储概述。

取值：

• cloud_efficiency：高效云盘。

• cloud_ssd：SSD 云盘。

默认值：cloud_ssd。

【该字段已废弃】节点池配置请使用nodepool中scaling_group下的system_disk_size参数代替。

Worker 节点系统盘大小，单位为 GiB。

取值范围：[40,500]。

该参数的取值必须大于或者等于 max{40, ImageSize}。

默认值：120。

【该字段已废弃】节点池配置请使用nodepool中scaling_group下的system_disk_snapshot_policy_id参数代替。

Worker 节点系统盘采用的自动快照策略 ID。

【该字段已废弃】节点池配置请使用nodepool中scaling_group下的system_disk_performance_level参数代替。

当系统盘为 ESSD 云盘时，可设置 ESSD 云盘的性能级别 PL（Performance Level）。更多信息，请参见 ESSD 云盘。

取值：

• PL0

• PL1

• PL2

• PL3

【该字段已废弃】节点池配置请使用nodepool中scaling_group下的instance_charge_type参数代替。

Worker 节点付费类型，取值：

• PrePaid：包年包月。

• PostPaid：按量付费。

默认值：按量付费。

【该字段已废弃】节点池配置请使用nodepool中scaling_group下的period_unit参数代替。

Worker 节点付费周期，当付费类型为PrePaid的时候需要指定周期。

取值：Month，当前只支持以月为周期。

【该字段已废弃】节点池配置请使用nodepool中scaling_group下的period参数代替。

Worker 节点包年包月时长，当worker_instance_charge_type取值为PrePaid时才生效且为必选值。

取值范围：{1, 2, 3, 6, 12, 24, 36, 48, 60}。

默认值：1。

【该字段已废弃】节点池配置请使用nodepool中scaling_group下的auto_renew参数代替。

Worker 节点是否开启自动续费，当worker_instance_charge_type取值为PrePaid时才生效，取值：

• true：自动续费。

• false：不自动续费。

默认值：true。

【该字段已废弃】节点池配置请使用nodepool中scaling_group下的auto_renew_period参数代替。

Worker 节点自动续费周期，当选择包年包月付费类型时才生效，且为必选值。

取值范围：{1, 2, 3, 6, 12}。

【该字段已废弃】创建集群时不支持选择已有节点，如需添加已有节点到集群，请先创建节点池，并调用 AttachInstancesToNodePool 接口操作。

使用已有实例创建集群时，是否对实例进行数据盘挂载，取值：

• true：将容器和镜像存储在数据盘，数据盘内原有数据将丢失，请注意备份数据。

• false：不将容器和镜像存储在数据盘。

默认值：false。

数据盘挂载规则：

• 如果 ECS 已挂载数据盘，且最后一块数据盘的文件系统未初始化，系统会自动将该数据盘格式化为 ext4，用来存放内容/var/lib/docker、/var/lib/kubelet。

• 如果 ECS 未挂载数据盘，则不会挂载新的数据盘。

【该字段已废弃】创建集群时不支持选择已有节点，如需添加已有节点到集群，请先创建节点池，并调用 AttachInstancesToNodePool 接口操作。

使用已有实例创建集群时，是否保留实例名称。

• true：保留。

• false：不保留，会用系统规则进行替换。

默认值：true。

【该字段已废弃】请使用参数snat_entry代替。

【该字段已废弃】请使用zone_ids参数代替。

集群所属地域的可用区 ID。此参数为 ACK 托管类的集群特有参数。

当创建 ACK 托管类的集群时，如果未指定vpc_id和vswitch_ids，必须为集群指定zone_id，用于自动在该可用区创建 VPC 网络资源；指定vpc_id和vswitch_ids时，该参数无效。

【该字段已废弃】集群开启日志服务，只针对 ACK Serverless 集群生效，且取值必须是SLS。

【该字段已废弃】集群创建失败时默认不会进行回滚，您需要自行清理创建失败的集群。

集群创建失败是否回滚。取值：

• true：当集群创建失败时，进行回滚操作。

• false：当集群创建失败时，不进行回滚操作。

默认值：true。

【该字段已废弃】集群创建失败时默认不会进行回滚，您需要自行清理创建失败的集群。

集群创建超时时间，单位分钟。

默认值：60。

【该字段已废弃】集群控制面配置请使用control_plane_config下的image_type参数代替；节点池配置请使用nodepool中scaling_group下的image_type参数代替。

操作系统发行版类型，推荐使用该字段指定节点操作系统。取值：

• CentOS

• AliyunLinux

• AliyunLinux Qboot

• AliyunLinuxUEFI

• AliyunLinux3

• Windows

• WindowsCore

• AliyunLinux3Arm64

• ContainerOS

默认值：CentOS。

【该参数已废弃】CLB 按使用量计费，该参数不生效。

负载均衡规格，取值：

• slb.s1.small

• slb.s2.small

• slb.s2.medium

• slb.s3.small

• slb.s3.medium

• slb.s3.large

默认值：slb.s2.small。

【该字段已废弃】请使用参数rrsa_config代替。

是否启用 RRSA 功能。

• true：开启。

• false：不开启。

【该字段已废弃】

API Server 所使用的 CLB 实例的付费类型，默认值为 PostPaid。取值：

• PostPaid：按量付费。

• PrePaid：包年包月，新建 CLB 付费类型已不支持，存量不影响。

【该字段已废弃】

付费周期，当付费类型为 PrePaid 的时候，需要指定周期。

取值：Month，当前仅支持以月为周期。

该字段于 2024 年 10 月 15 日存在变更，更多信息，请参见关于集群创建接口 CreateCluster 参数行为变更的公告。

【该字段已废弃】

购买时长。包年包月时长，当 charge_type 取值为 PrePaid 时才生效，且为必选值。

取值范围：{1, 2, 3, 6, 12, 24, 36, 48, 60}。

默认值：1。

该字段于 2024 年 10 月 15 日存在变更，更多信息，请参见关于集群创建接口 CreateCluster 参数行为变更的公告。

【该字段已废弃】

是否开启自动续费，当charge_type取值为PrePaid时才生效。取值：

• true：自动续费。

• false：不自动续费。

默认值：false。

该字段于 2024 年 10 月 15 日存在变更，更多信息，请参见关于集群创建接口 CreateCluster 参数行为变更的公告。

【该字段已废弃】

自动续费周期，当选择预付费和自动续费时才生效。当PeriodUnit=Month时，取值范围：{1, 2, 3, 6, 12}。

默认值：1。

该字段于 2024 年 10 月 15 日存在变更，更多信息，请参见关于集群创建接口 CreateCluster 参数行为变更的公告。

集群 ID。

请求 ID。

任务 ID。