Container Service for Kubernetes：CreateCluster - 建立叢集

自訂叢集名稱。由數字、漢字、英文字元或短劃線（-）組成，長度範圍 1~63 個字元，且不能以短劃線（-）開頭。

叢集所在地區 ID。詳情請參見Container Service開服地區。

• Kubernetes: ACK 專有叢集。

• ManagedKubernetes：ACK 託管類的叢集，包括 ACK 託管叢集（Pro 版、基礎版）、ACK Serverless 叢集（Pro 版、基礎版）、ACK Edge 叢集（Pro 版、基礎版）、ACK 靈駿叢集（Pro 版）。

• ExternalKubernetes：註冊叢集。

選擇cluster_type為ManagedKubernetes並配置profile後，可進一步指定叢集的規格。取值：

• ack.standard：基礎版（取值為空白時預設選擇）

• ack.pro.small：Pro 版

• ack.pro.xlarge：Pro XL

• ack.pro.2xlarge：Pro 2XL

• ack.pro.4xlarge: Pro 4XL （需聯絡客服開通白名單）

Pro XL、Pro 2XL、Pro 4XL 為ACK Pro 預設控制面提供的三個檔位，通過預先分配並固化控制面資源，確保 API 並發與 Pod 調度能力始終處於確定的高水平狀態，適用於 AI 訓練推理、超大規模叢集及關鍵任務型業務。

Pro 版及預設控制面版本的叢集管理費用請參見叢集管理費用。

選擇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 Gateway並自動設定 SNAT 規則。叢集內的節點、應用等需要訪問公網需要設定為true。

• false：不建立 NAT Gateway及 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。

控制面組件日誌儲存天數。

控制平面組件Log Service Project，可以使用已有 Project 用於日誌儲存，也可以使用系統自動建立 Project 使用者日誌儲存。如果選擇自動建立Log Service Project 將會自動建立一個名稱為k8s-log-{ClusterID}的Log Service Project。

叢集本地區名。

命名規則：網域名稱由小數點（.）分隔的一個或多個部分構成，每個部分最長為 63 個字元，可以使用小寫字母、數字和短劃線（-），且首尾必須為小寫字母或數字。

KMS 金鑰識別碼，使用該金鑰組資料盤進行加密。更多詳情，請參見Key Management Service。

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參數代替。

叢集是否安裝CloudMonitor外掛程式。取值：

• true：安裝CloudMonitor外掛程式。

• false：不安裝CloudMonitor外掛程式。

預設值：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 節點系統硬碟類型。更多資訊，請參見Block Storage概述。

取值：

• 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時，該參數無效。

【該欄位已廢棄】叢集開啟Log Service，只針對 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。