CreateCluster - Container Service for Kubernetes

您可以透過 OpenAPI 建立 ACK 叢集，包含 ACK 託管叢集、ACK Serverless 叢集、ACK Edge 叢集以及註冊叢集。建立叢集時，您將完成叢集資訊、叢集元件以及 ACK 相關雲端資源的設定。

介面說明

透過控制台產生 OpenAPI 請求參數

呼叫 CreateCluster 介面建立叢集時，如果由於請求參數組合不正確導致介面呼叫失敗，您可以透過控制台產生建立叢集所需的請求參數組合。具體操作如下：

登入容器服務管理控制台，在左側導覽列選擇叢集列表。
在叢集列表頁面，點擊叢集範本。
在對話方塊中，選擇需要建立的叢集類型，並點擊建立，然後在叢集設定頁面設定叢集資訊。
設定完成後，在確認設定頁面，點擊右上角的等效程式碼。對話方塊將展示您建立叢集時所需的參數組合，您可以複製使用。

重要自 2026 年 07 月 04 日起，部分請求輸入參數不再生效。變更詳情及替代參數說明，請參閱關於 ACK 叢集管理相關的 OpenAPI 出入參變化及 OpenAPI 下線的公告。

調試

您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

操作：是指具體的許可權點。
存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。
資源類型：是指操作中支援授權的資源類型。具體說明如下：
- 對於必選的資源類型，用前面加 * 表示。
- 對於不支援資源級授權的操作，用全部資源表示。
條件關鍵字：是指雲產品自身定義的條件關鍵字。
關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

cs:CreateCluster

create

*Cluster

acs:cs:{#regionId}:{#accountId}:cluster/*

cs:ClusterType
cs:ClusterSpec
cs:ClusterProfile
cs:EnableSecretEncryption
cs:EnableApiServerEip
cs:EnableAddonLogtailDs
cs:EnableCoreControlPlaneComponentsLog
cs:AddonNames
cs:EnableSNAT
cs:EnableNodePoolPublicIP

無

請求文法

POST /clusters HTTP/1.1

請求參數

名稱	類型	必填	描述	樣本值
body	object	否	請求主體參數。	cluster-demo
access_control_list `deprecated`	array	否	【該欄位已棄用】註冊叢集 API Server SLB 存取控制清單。
	string	否	註冊叢集 API Server SLB 存取控制清單。	192.168.XX.XX/24
addons	array	否	叢集元件清單，建立叢集時透過`addons`指定想要安裝的叢集元件。網路元件：必選，包含 Flannel 和 Terway 兩種網路類型，建立叢集時二選一： Flannel 網路：[{"name":"flannel","config":""}]。 Terway 網路：[{"name": "terway-eniip","config": ""}] 。儲存元件：可選，僅支援`csi`類型： `csi`：[{"name":"csi-plugin","config": ""},{"name": "csi-provisioner","config": ""}]。日誌元件：可選。建議開啟，如果不開啟日誌服務時，將無法使用叢集稽核功能。使用現有`SLS Project`：[{"name": "loongcollector","config": "{"IngressDashboardEnabled":"true","sls_project_name":"your_sls_project_name"}"}] 。建立新的`SLS Project`：[{"name": "loongcollector","config": "{"IngressDashboardEnabled":"true"}"}] 。 Ingress 元件：可選，ACK 專屬版叢集預設安裝 Ingress 元件`nginx-ingress-controller`。安裝 Ingress 並且開啟公網：[{"name":"nginx-ingress-controller","config":"{"IngressSlbNetworkType":"internet"}"}] 。禁止預設安裝 Ingress：[{"name": "nginx-ingress-controller","config": "","disabled": true}] 。事件中心：可選，預設開啟。事件中心提供對 Kubernetes 事件的儲存、查詢、警示等能力。Kubernetes 事件中心關聯的 Logstore 在 90 天內免費。關於免費策略的更多資訊，請參閱建立並使用 Kubernetes 事件中心。開啟事件中心範例：[{"name":"ack-node-problem-detector","config":"{"sls_project_name":"your_sls_project_name"}"}]。
	addon	否	叢集元件清單，建立叢集時透過`addons`指定想要安裝的叢集元件。
api_audiences	string	否	ServiceAccount 是 Pod 和叢集 API Server 通訊的存取憑證，而`api-audiences`是合法的請求`token`身份，用於`apiserver`伺服器端認證請求`token`是否合法。支援設定多個`audience`，透過英文半形逗號（,）分隔。關於`ServiceAccount`更多詳情，請參閱部署服務帳戶權杖磁碟區投影。	kubernetes.default.svc
audit_log_config	object	否	叢集稽核日誌設定。
enabled	boolean	否	是否開啟叢集稽核日誌功能。 true：開啟。 false：不開啟。	true
sls_project_name	string	否	叢集稽核日誌 Logstore 所在的SLS Project。預設值為`k8s-log-{clusterid}`。開啟叢集稽核日誌功能後會在指定的 SLS Project 下建立叢集稽核日誌對應的 Logstore。	k8s-log-c2345xxxxxxxxxxxx
auto_mode	object	否	智慧託管模式設定。
enable	boolean	否	是否開啟智慧託管模式。 true：開啟。 false：不開啟。	true
auto_renew `deprecated`	boolean	否	【該欄位已棄用】是否開啟自動續費，當`charge_type`取值為`PrePaid`時才生效。取值： `true`：自動續費。 `false`：不自動續費。預設值：`false`。該欄位於 2024 年 10 月 15 日存在變更，更多資訊，請參閱關於叢集建立介面 CreateCluster 參數行為變更的公告。	true
auto_renew_period `deprecated`	integer	否	【該欄位已棄用】自動續費週期，當選擇預付費和自動續費時才生效。當`PeriodUnit=Month`時，取值範圍：{1, 2, 3, 6, 12}。預設值：1。該欄位於 2024 年 10 月 15 日存在變更，更多資訊，請參閱關於叢集建立介面 CreateCluster 參數行為變更的公告。	1
charge_type `deprecated`	string	否	【該欄位已棄用】 API Server 所使用的 CLB 執行個體的付費類型，預設值為 PostPaid。取值： PostPaid：按量付費。 PrePaid：包年包月，新建 CLB 付費類型已不支援，存量不影響。重要該欄位於 2024 年 10 月 15 日存在變更，更多資訊，請參閱關於叢集建立介面 CreateCluster 參數行為變更的公告。自 2024 年 12 月 01 日起，新建立的 CLB 執行個體不再支援包年包月付費類型，同時將新增收取執行個體費。詳細資訊請參閱傳統型負載平衡 CLB 計費項目調整公告。	PostPaid
cis_enabled `deprecated`	boolean	否	【該欄位已棄用】叢集控制面設定請使用`control_plane_config`下的`security_hardening_os`參數代替；節點集區設定請使用`nodepool`中`scaling_group`下的`security_hardening_os`參數代替。	false
client_token	string	否	用戶端 Token。	0a287651-1277-4c0d-80d2-623a4*****
cloud_monitor_flags `deprecated`	boolean	否	【該欄位已棄用】叢集控制面節點設定請使用`control_plane_config`下的`cloud_monitor_flags`參數代替；節點集區設定請使用 nodepool 中`kubernetes_config`下的`cms_enabled`參數代替。叢集是否安裝雲端監控外掛程式。取值： `true`：安裝雲端監控外掛程式。 `false`：不安裝雲端監控外掛程式。預設值：`false`。	false
cluster_domain	string	否	叢集本地網域。命名規則：網域由小數點（.）分隔的一個或多個部分構成，每個部分最長為 63 個字元，可以使用小寫字母、數字和短橫線（-），且首尾必須為小寫字母或數字。	cluster.local
cluster_spec	string	否	選擇`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 版及預設控制面版本的叢集管理費用請參閱叢集管理費用。	ack.pro.small
cluster_type	string	否	`Kubernetes`: ACK 專屬叢集。 `ManagedKubernetes`：ACK 託管類的叢集，包括 ACK 託管叢集（Pro 版、基礎版）、ACK Serverless 叢集（Pro 版、基礎版）、ACK Edge 叢集（Pro 版、基礎版）、ACK 靈駿叢集（Pro 版）。 `ExternalKubernetes`：註冊叢集。	Kubernetes
container_cidr	string	否	Pod 網路位址段，必須是有效的私有網段，即以下網段及其子網路：10.0.0.0/8、172.16-31.0.0/12-16、192.168.0.0/16。不能與 VPC 及 VPC 內現有 Kubernetes 叢集使用的網段重複，建立成功後不能修改。關於叢集網路規劃，請參閱 ACK 託管叢集網路規劃。說明 Flannel 叢集中，此欄位必填。	172.20.0.0/16
control_plane_config	object	否	ACK 專屬叢集控制面設定。
auto_renew	boolean	否	控制面節點是否自動續費。當付費類型為`PrePaid`時有效。 true：開啟自動續費。 false：不開啟自動續費。預設值：true。	true
auto_renew_period	integer	否	控制面節點自動續費時長。取值範圍：{1, 2, 3, 6, 12}，單位：月。預設值：1。	1
charge_type	string	否	控制面節點付費類型。 `PrePaid`：包年包月。 `PostPaid`：按量付費。預設值：`PostPaid`。	PostPaid
cloud_monitor_flags	boolean	否	是否為節點安裝雲端監控。 true：安裝雲端監控外掛程式。 false：不安裝雲端監控外掛程式。預設值：false。	false
cpu_policy	string	否	節點 CPU 管理策略。 static：允許為節點上具有某些資源特徵 Pod 增強其 CPU 親和性和獨佔性。 none：表示啟用現有的預設 CPU 親和性方案。預設值：none。	none
deploymentset_id	string	否	部署集 ID。	ds-bp10b35imuam5amw****
image_id	string	否	映像 ID。	aliyun_3_x64_20G_alibase_20240819.vhd
image_type	string	否	作業系統映像類型。	AliyunLinux3
instance_metadata_options	InstanceMetadataOptions	否	ECS 執行個體中繼資料存取設定。
instance_types	array	否	節點執行個體類型。
	string	否	節點執行個體規格類型。	ecs.g6.large
key_pair	string	否	金鑰對名稱，和 login_password 二選一。	ack
login_password	string	否	SSH 登入密碼。密碼規則為 8~30 個字元，且至少同時包含三項（大小寫字母、數字和特殊符號），和 key_pair 二選一。	********
node_port_range	string	否	【該欄位已棄用】節點服務連接埠範圍。	30000-32767
period	integer	否	控制面節點包年包月的時長。當付費類型為`PrePaid`時有效且為必選值。取值範圍：{1, 2, 3, 6, 12, 24, 36, 48, 60}，單位：月。預設值：1。	1
period_unit	string	否	控制面節點包年包月時間單位。當付費類型為`PrePaid`時有效且為必選值。取值：`Month`，當前僅支援以月為週期。	Month
runtime	string	否	【該欄位已棄用】控制面節點執行環境名稱。取值： containerd：Containerd 執行環境，支援所有叢集版本。	containerd
security_hardening_os	boolean	否	是否開啟阿里雲 OS 安全性加固。 true：開啟阿里雲 OS 安全性加固。 false：不開啟阿里雲 OS 安全性加固。預設值：false。	false
size	integer	否	控制面節點數量。可選值`3`或`5`。	3
soc_enabled	boolean	否	是否開啟等保安全性加固。 true：開啟等保加固。 false：不開啟等保加固。預設值：false。	false
system_disk_bursting_enabled	boolean	否	節點系統磁碟是否開啟 Burst（效能突增）。 true：開啟。 false：不開啟。當`system_disk_category`取值為`cloud_auto`時才支援設定該參數。	true
system_disk_category	string	否	節點系統磁碟類型。 `cloud_efficiency`：高效雲端硬碟。 `cloud_ssd`：SSD 雲端硬碟。 `cloud_essd`：ESSD 雲端硬碟。 `cloud_auto`：ESSD AutoPL 雲端硬碟。 `cloud_essd_entry`：ESSD Entry 雲端硬碟。預設值：`cloud_ssd`。不同可用區，預設值可能會有所差異。	cloud_ssd
system_disk_performance_level	string	否	節點系統磁碟效能，只針對 ESSD 雲端硬碟生效。磁碟效能等級和磁碟大小有關，更多資訊，請參閱 ESSD 雲端硬碟。	PL1
system_disk_provisioned_iops	integer	否	節點系統磁碟預先配置的讀寫 IOPS。可能值：0~min{50,000, 1000容量-基準效能}。基準效能=min{1,800+50容量, 50000}。當 `system_disk_category` 取值為 `cloud_auto` 時才支援設定該參數。	1000
system_disk_size	integer	否	節點系統磁碟大小。取值範圍 [40,500]，單位：GiB。預設值：`120`。	120
system_disk_snapshot_policy_id	string	否	節點自動快照備份策略。	sp-2zej1nogjvovnz4z****
control_plane_endpoints_config	object	否	叢集連線設定。
internal_dns_config	object	否	叢集內部網域設定，適用於 ACK 託管叢集。叢集內部網域用於 kubelet、kube-proxy 等節點端系統元件存取 API Server；未開啟叢集內部網域存取時，節點端系統元件將透過 CLB IP 方式存取。
bind_vpcs	array	否	叢集內部網域記錄解析生效的 VPC。
	string	否	叢集內部網域記錄解析生效的 VPC。	vpc-xxxx
load_balancers_config	array<object>	否	叢集連線設定，指定該欄位時，endpoint_public_access、load_balancer_id 參數不生效。 ACK 僅支援自動建立 NLB 執行個體，如需要指定 CLB/NLB，需要使用 load_balancers_config 指定對應執行個體 ID。
	object	否	叢集存取負載平衡設定。
endpoint_type	string	否	端點類型。	private
load_balancer_id	string	否	NLB 執行個體 ID。	nlb-0ogk9aaxxxxxxx
controlplane_log_components	array	否	元件名稱清單，指定採集哪些控制面元件的日誌。預設採集 kube-apiserver、kube-controller-manager、kube-scheduler、cloud-controller-manager 的日誌。
	string	否	元件名稱清單，指定採集哪些控制面元件的日誌。預設採集 kube-apiserver、kube-controller-manager、kube-scheduler、cloud-controller-manager 的日誌。	["apiserver","kcm","scheduler"]
controlplane_log_project	string	否	控制面元件日誌服務 Project，可以使用已有 Project 用於日誌儲存，也可以使用系統自動建立 Project 用於日誌儲存。如果選擇自動建立日誌服務 Project，將會自動建立一個名稱為 `k8s-log-{ClusterID}` 的日誌服務 Project。	k8s-log-xxx
controlplane_log_ttl	string	否	控制面元件日誌保留天數。	30
cpu_policy `deprecated`	string	否	【該欄位已棄用】叢集控制面設定請使用 `control_plane_config` 下的 `cpu_policy` 參數代替；節點集區設定請使用 `nodepool` 中 `kubernetes_config` 下的 `cpu_policy` 參數代替。節點 CPU 管理策略。當叢集版本在 1.12.6 及以上時支援以下兩種策略： `static`：允許為節點上具有某些資源特徵 Pod 增強其 CPU 親和性和獨佔性。 `none`：表示啟用現有的預設 CPU 親和性方案。預設值：`none`。	none
custom_san `deprecated`	string	否	【該欄位已棄用】請使用參數 `extra_sans` 代替。自訂憑證 SAN，多個 IP 或網域以英文逗號（,）分隔。	cs.aliyun.com
deletion_protection	boolean	否	叢集刪除保護，防止透過控制台或 API 誤刪除叢集。取值： `true`：啟用叢集刪除保護，將不能透過控制台或 API 刪除叢集。 `false`：不啟用叢集刪除保護，則能透過控制台或 API 刪除叢集。預設值：`false`。	true
disable_rollback `deprecated`	boolean	否	【該欄位已棄用】叢集建立失敗時預設不會進行回滾，您需要自行清理建立失敗的叢集。叢集建立失敗是否回滾。取值： `true`：當叢集建立失敗時，進行回滾操作。 `false`：當叢集建立失敗時，不進行回滾操作。預設值：`true`。	true
enable_rrsa `deprecated`	boolean	否	【該欄位已棄用】請使用參數 `rrsa_config` 代替。是否啟用 RRSA 功能。 true：開啟。 false：不開啟。	false
encryption_provider_key	string	否	KMS 金鑰 ID，使用該金鑰對資料磁碟進行加密。更多詳情，請參見金鑰管理服務。說明該功能只在專業託管版叢集（ACK Pro 版叢集）中生效。	0fe64791-55eb-4fc7-84c5-c6c7cdca****
endpoint_public_access	boolean	否	是否開啟公網存取。透過 EIP 公開 API Server，實現叢集公網存取。 `true`：開啟公網存取。 `false`：不開啟公網存取。選擇不開放時，則無法透過外網存取叢集 API Server。預設值：`false`。	true
extra_sans	array	否	自訂 API Server 憑證 SAN（Subject Alternative Name）。
	string	否	憑證 SAN。支援自訂 IP 位址或網域。	192.168.xx.xx
format_disk `deprecated`	boolean	否	【該欄位已棄用】建立叢集時不支援選擇既有節點，如需新增既有節點至叢集，請先建立節點集區，並呼叫 AttachInstancesToNodePool 介面操作。使用既有執行個體建立叢集時，是否對執行個體進行資料磁碟掛載，取值： `true`：將容器和映像儲存在資料磁碟，資料磁碟內原有資料將遺失，請注意備份資料。 `false`：不將容器和映像儲存在資料磁碟。預設值：`false`。資料磁碟掛載規則：如果 ECS 已掛載資料磁碟，且最後一塊資料磁碟的檔案系統未初始化，系統會自動將該資料磁碟格式化為 ext4，用來存放內容 /var/lib/docker、/var/lib/kubelet。如果 ECS 未掛載資料磁碟，則不會掛載新的資料磁碟。	false
image_id `deprecated`	string	否	【該欄位已棄用】叢集控制面設定請使用 `control_plane_config` 下的 `image_id` 參數代替；節點集區設定請使用 `nodepool` 中 `scaling_group` 下的 `image_id` 參數代替。節點自訂映像，預設使用系統映像。當選擇自訂映像時，將取代預設系統映像。請參見自訂映像。	m-bp16z7xko3vvv8gt****
image_type `deprecated`	string	否	【該欄位已棄用】叢集控制面設定請使用 `control_plane_config` 下的 `image_type` 參數代替；節點集區設定請使用 `nodepool` 中 `scaling_group` 下的 `image_type` 參數代替。作業系統發行版類型，推薦使用該欄位指定節點作業系統。取值： CentOS AliyunLinux AliyunLinux Qboot AliyunLinuxUEFI AliyunLinux3 Windows WindowsCore AliyunLinux3Arm64 ContainerOS 預設值：`CentOS`。	AliyunLinux
instances `deprecated`	array	否	【該欄位已棄用】建立叢集時不支援選擇既有節點，如需新增既有節點至叢集，請先建立節點集區，並呼叫 AttachInstancesToNodePool 介面操作。使用既有節點建立叢集時，需要指定 ECS 執行個體列表，該執行個體會作為 Worker 節點加入叢集。說明使用既有執行個體建立叢集時，該欄位為必填。
	string	否	使用既有節點建立叢集時，需要指定 ECS 執行個體列表，該執行個體會作為 Worker 節點加入叢集。說明使用既有執行個體建立叢集時，該欄位為必填。	i-2ze4zxnm36vq00xn****
ip_stack	string	否	叢集 ip_stack。	可選值： ipv4（單堆疊） dual（雙堆疊），預設值為 ipv4
is_enterprise_security_group	boolean	否	自動建立企業級安全性群組，當 `security_group_id` 為空時生效。說明使用普通安全性群組時，叢集內節點與 Terway Pod 數量之和不能超過 2000。因此建立 Terway 網路類型叢集時，建議使用企業級安全性群組。 `true`：建立並使用企業級安全性群組。 `false`：使用普通安全性群組。預設值：`true`。	true
keep_instance_name `deprecated`	boolean	否	【該欄位已棄用】建立叢集時不支援選擇既有節點，如需新增既有節點至叢集，請先建立節點集區，並呼叫 AttachInstancesToNodePool 介面操作。使用既有執行個體建立叢集時，是否保留執行個體名稱。 `true`：保留。 `false`：不保留，會用系統規則進行取代。預設值：`true`。	true
key_pair `deprecated`	string	否	【該欄位已棄用】叢集控制面設定請使用 `control_plane_config` 下的 `key_pair` 參數代替；節點集區設定請使用 `nodepool` 中 `scaling_group` 下的 `key_pair` 參數代替。金鑰對名稱，和 `login_password` 二選一。	security-key
kubernetes_version	string	否	叢集版本，與 Kubernetes 社群基線版本保持一致。建議選擇最新版本。若不指定，預設使用最新版本。支援建立最近三個版本的叢集，可透過 DescribeKubernetesVersionMetadata 介面查詢支援的叢集版本。關於 ACK 支援的 Kubernetes 版本，請參見 Kubernetes 版本發佈概覽。	1.32.1-aliyun.1
load_balancer_id	string	否	指定用於 API Server 存取的 CLB 執行個體 ID。指定該參數時，將不再自動建立 API Server CLB。說明請確保該 CLB 執行個體無其他相依性（如存在監聽、後端伺服器等），不支援共用型、公網類型的 CLB 指定。	lb-wz9t256gqa3vbouk****
load_balancer_spec `deprecated`	string	否	【該參數已棄用】CLB 按使用量計費，該參數不生效。負載平衡規格，取值： slb.s1.small slb.s2.small slb.s2.medium slb.s3.small slb.s3.medium slb.s3.large 預設值：`slb.s2.small`。	slb.s2.small
logging_type `deprecated`	string	否	【該欄位已棄用】叢集開啟日誌服務，只針對 ACK Serverless 叢集生效，且取值必須是 `SLS`。	SLS
login_password `deprecated`	string	否	【該欄位已棄用】叢集控制面設定請使用 `control_plane_config` 下的 `login_password` 參數代替；節點集區設定請使用 `nodepool` 中 `scaling_group` 下的 `login_password` 參數代替。 SSH 登入密碼，和 `key_pair` 二選一。密碼規則為 8~30 個字元，且至少同時包含三項（大小寫字母、數字和特殊符號）。	null
maintenance_window	maintenance_window	否	叢集維護時段。
master_auto_renew `deprecated`	boolean	否	【該欄位已棄用】叢集控制面設定請使用 `control_plane_config` 下的 `auto_renew` 參數代替。 Master 節點是否開啟自動續費，當 `master_instance_charge_type` 取值為 `PrePaid` 時才生效，可選值為： `true`：自動續費。 `false`：不自動續費。預設值：`true`。	true
master_auto_renew_period `deprecated`	integer	否	【該欄位已廢棄】叢集控制面設定請使用 `control_plane_config` 下的 `auto_renew_period` 參數代替。 Master 節點自動續費週期，當選擇包年包月付費類型時才生效，且為必選值。取值範圍：{1, 2, 3, 6, 12}。預設值：1。	1
master_count `deprecated`	integer	否	【該欄位已廢棄】叢集控制面設定請使用 `control_plane_config` 下的 `size` 參數代替。 Master 節點數量，可選值 `3` 或 `5`。預設值：`3`。	3
master_instance_charge_type `deprecated`	string	否	【該欄位已廢棄】叢集控制面設定請使用 `control_plane_config` 下的 `instance_charge_type` 參數代替。 Master 節點付費類型，取值： `PrePaid`：包年包月。 `PostPaid`：按量付費。預設值：`PostPaid`。	PrePaid
master_instance_types `deprecated`	array	否	【該欄位已廢棄】叢集控制面設定請使用 `control_plane_config` 下的 `instance_types` 參數代替。 Master 節點執行個體類型。更多資訊，請參見執行個體規格族。
	string	否	Master 節點執行個體類型。指定的執行個體規格數量需要和 `master_count` 保持一致，和 `master_instance_types` 中的元素一一對應。更多資訊，請參見執行個體規格族。	ecs.n4.xlarge
master_period `deprecated`	integer	否	【該欄位已廢棄】叢集控制面設定請使用 `control_plane_config` 下的 `unit` 參數代替。 Master 節點包年包月時長，當 `master_instance_charge_type` 取值為 `PrePaid` 時才生效且為必選值。取值範圍：{1, 2, 3, 6, 12, 24, 36, 48, 60}。預設值：1。	1
master_period_unit `deprecated`	string	否	【該欄位已廢棄】叢集控制面設定請使用 `control_plane_config` 下的 `period_unit` 參數代替。 Master 節點付費週期，當付費類型為 `PrePaid` 的時候必須指定週期。取值：`Month`，當前僅支援以月為週期。	Month
master_system_disk_category `deprecated`	string	否	【該欄位已廢棄】叢集控制面設定請使用 `control_plane_config` 下的 `system_disk_category` 參數代替。 Master 節點系統磁碟類型，取值： `cloud_efficiency`：高效雲端硬碟。 `cloud_ssd`：SSD 雲端硬碟。 `cloud_essd`：ESSD 雲端硬碟。預設值：`cloud_ssd`。不同可用區，預設值可能會有所差異。	cloud_ssd
master_system_disk_performance_level `deprecated`	string	否	【該欄位已廢棄】叢集控制面設定請使用 `control_plane_config` 下的 `system_disk_performance_level` 參數代替。叢集 Master 節點系統磁碟磁碟效能等級，僅對 ESSD 磁碟生效。磁碟效能等級和磁碟大小有關，更多資訊，請參見 ESSD 雲端硬碟。	PL1
master_system_disk_size `deprecated`	integer	否	【該欄位已廢棄】叢集控制面設定請使用 `control_plane_config` 下的 `system_disk_size` 參數代替。 Master 節點系統磁碟大小，取值範圍 [40,500]，單位：GiB。預設值：`120`。	120
master_system_disk_snapshot_policy_id `deprecated`	string	否	【該欄位已廢棄】叢集控制面設定請使用 `control_plane_config` 下的 `system_disk_snapshot_policy_id` 參數代替。 Master 節點系統磁碟採用的自動快照策略 ID。	sp-2zej1nogjvovnz4z****
master_vswitch_ids `deprecated`	array	否	【該欄位已廢棄】請使用 `vswitch_ids` 參數代替。 Master 節點交換器 ID 清單，交換器個數取值範圍為 [1,3]。為確保叢集的高可用性，建議您選擇 3 個交換器，且分佈在不同的可用區。指定的執行個體規格數量需要和 `master_count` 保持一致，和 `master_vswitch_ids` 中的元素一一對應。
	string	否	Master 節點交換器 ID 清單，交換器個數取值範圍為 [1,3]。為確保叢集的高可用性，建議您選擇 3 個交換器，且分佈在不同的可用區。指定的執行個體規格數量需要和 `master_count` 保持一致，和 `master_vswitch_ids` 中的元素一一對應。	vsw-2ze3ds0mdip0hdz8i****
name	string	是	自訂叢集名稱。由數字、中文字元、英文字元或連字號（-）組成，長度範圍 1~63 個字元，且不能以連字號（-）開頭。	cluster-demo
nat_gateway `deprecated`	boolean	否	【該欄位已廢棄】請使用參數 `snat_entry` 代替。	true
node_cidr_mask	string	否	節點 IP 數量，透過指定網路的 CIDR 來確定 IP 的數量，只對於 Flannel 網路類型叢集生效。預設值：`26`。	25
node_name_mode `deprecated`	string	否	【該欄位已廢棄】節點集區設定請使用 `nodepool` 中 `kubernetes_config` 下的 `node_name_mode` 參數代替。	null
node_port_range `deprecated`	string	否	節點服務連接埠，可選連接埠範圍：[30000,65535]。預設值：`30000-32767`。	30000~32767
nodepools	array	否	節點集區清單。
	nodepool	否	節點集區設定。
num_of_nodes `deprecated`	integer	否	【該欄位已廢棄】節點集區設定請使用`nodepool`中`scaling_group`下的`desired_size`參數代替。 Worker 節點數。範圍是[0，100]。	3
operation_policy	object	否	叢集自動維運策略。
cluster_auto_upgrade	object	否	叢集自動升級。
channel	string	否	叢集自動升級頻率。可取值： patch：目前次要版本存在可用的修補版本時，自動升級到該修補版本，新的 Kubernetes 版本不會帶有破壞性變更（Breaking Changes）。 stable：自動升級至次要版本為次新的最新修補版本。新的 Kubernetes 版本可能涉及 API 和功能特性的變更，但其穩定性已經過廣泛驗證。 rapid：自動升級至最新次要版本的最新修補版本，以更快獲取 Kubernetes 社群的新特性。	stable
enabled	boolean	否	是否開啟叢集自動升級。 true：開啟。 false：不開啟。	true
os_type `deprecated`	string	否	【該欄位已廢棄】叢集控制面節點設定請使用`control_plane_config`下的`image_type`參數代替；節點集區設定請使用`nodepool`中`scaling_group`下的`image_type`參數代替。作業系統平台類型。取值： Windows Linux 預設值：`Linux`。	Linux
period `deprecated`	integer	否	【該欄位已廢棄】購買時長。包年包月時長，當 charge_type 取值為 PrePaid 時才生效，且為必選值。取值範圍：{1, 2, 3, 6, 12, 24, 36, 48, 60}。預設值：1。該欄位於 2024 年 10 月 15 日存在變更，更多資訊，請參見關於叢集建立介面 CreateCluster 參數行為變更的公告。	1
period_unit `deprecated`	string	否	【該欄位已廢棄】付費週期，當付費類型為 PrePaid 的時候，需要指定週期。取值：Month，目前僅支援以月為週期。該欄位於 2024 年 10 月 15 日存在變更，更多資訊，請參見關於叢集建立介面 CreateCluster 參數行為變更的公告。	Month
platform `deprecated`	string	否	【該欄位已廢棄】節點集區設定請使用`nodepool`中`scaling_group`下的`platform`參數代替。作業系統發行版。取值： CentOS AliyunLinux QbootAliyunLinux Qboot Windows WindowsCore 預設值：`CentOS`。	CentOS
pod_vswitch_ids `deprecated`	array	否	【該欄位已廢棄】網路外掛程式選擇 Terway 時，您需要為 Pod 分配 IP 的虛擬交換器。每個 Pod 虛擬交換器分別對應一個 Worker 節點的虛擬交換器，Pod 虛擬交換器和 Worker 節點的虛擬交換器的可用區需保持一致。說明 Pod 虛擬交換器的網段遮罩建議不超過 19，最大不超過 25，否則叢集網路可分配的 Pod IP 位址非常有限，會影響叢集的正常使用。
	string	否	網路外掛程式選擇 Terway 時，您需要為 Pod 分配 IP 的虛擬交換器。每個 Pod 虛擬交換器分別對應一個 Worker 節點的虛擬交換器，Pod 虛擬交換器和 Worker 節點的虛擬交換器的可用區需保持一致。說明 Pod 虛擬交換器的網段遮罩建議不超過 19，最大不超過 25，否則叢集網路可分配的 Pod IP 位址非常有限，會影響叢集的正常使用。	vsw-2ze97jwri7cei0mpw****
profile	string	否	選擇`cluster_type`為`ManagedKubernetes`時，即 ACK 託管類的叢集時，可進一步指定叢集的子類型。 `Default`：ACK 託管叢集，包括 ACK 叢集（Pro 版、基礎版）。 `Edge`：ACK Edge 叢集，包括 ACK Edge 叢集（Pro 版、基礎版）。 `Serverless`：ACK Serverless 叢集，包括 ACK Serverless 叢集（Pro 版、基礎版）。 `Lingjun`：ACK 靈駿叢集，提供 Pro 版。	Default
proxy_mode	string	否	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`。	ipvs
rds_instances `deprecated`	array	否	【該欄位已廢棄】節點集區設定請使用`nodepool`中`scaling_group`下的`rds_instances`參數代替。 RDS 執行個體清單，選擇您想要新增白名單的 RDS 執行個體。建議前往 RDS 加入容器 Pod 網段與 Node 網段，設定 RDS 執行個體會由於執行個體非執行的狀態導致無法彈出。
	string	否	RDS 執行個體清單，選擇您想要新增白名單的 RDS 執行個體。建議前往 RDS 加入容器 Pod 網段與 Node 網段，設定 RDS 執行個體會由於執行個體非執行的狀態導致無法彈出。	rm-2zev748xi27xc****
region_id	string	是	叢集所在地域 ID。詳情請參見容器服務開服地域。	cn-beijing
resource_group_id	string	否	叢集所屬資源群組 ID，實現不同資源的隔離。	rg-acfm3mkrure****
rrsa_config	object	否	RRSA 功能設定。
enabled	boolean	否	是否開啟 RRSA 功能。 true：開啟。 false：不開啟。	true
runtime `deprecated`	runtime	否	叢集內容器執行環境。支援 containerd、安全沙箱和 Docker。說明 Kubernetes 1.24 不再支援將 Docker 作為內建容器執行環境。更多資訊，請參見Docker、containerd、安全沙箱執行環境的對比。
security_group_id	string	否	使用現有安全性群組建立叢集時需要指定安全性群組 ID，和`is_enterprise_security_group`二選一，叢集節點自動加入到此安全性群組。	sg-bp1bdue0qc1g7k****
security_hardening_os `deprecated`	boolean	否	【該欄位已廢棄】叢集控制面設定請使用`control_plane_config`下的`security_hardening_os`參數代替；節點集區設定請使用`nodepool`中`scaling_group`下的`security_hardening_os`參數代替。阿里雲 OS 安全性加固。取值： `true`：開啟阿里雲 OS 安全性加固。 `false`：不開啟阿里雲 OS 安全性加固。預設值：`false`。	false
service_account_issuer	string	否	ServiceAccount 是 Pod 和叢集 API Server 通訊的存取憑證。而`service-account-issuer`是`serviceaccount token`中的簽發身分，即`token payload`中的`iss`欄位。關於`ServiceAccount`更多詳情，請參見部署服務帳戶權杖磁碟區投影。	kubernetes.default.svc
service_cidr	string	否	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 網段。	172.21.0.0/20
service_discovery_types `deprecated`	array	否	【該欄位已廢棄】叢集內服務發現類型，用於在`ACK Serverless`叢集中指定服務發現方式。 `CoreDNS`：使用 Kubernetes 原生標準服務發現元件 CoreDNS，需要在叢集部署一組容器用於 DNS 解析。預設採用兩個 0.25 Core 512 MiB 規格的 ECI 執行個體。 `PrivateZone`：使用阿里雲 PrivateZone 產品提供服務發現能力，需要開啟 PrivateZone 服務。預設值：不開啟。
	string	否	叢集內服務發現類型，用於在`ACK Serverless`叢集中指定服務發現方式。 `CoreDNS`：使用 Kubernetes 原生標準服務發現元件 CoreDNS，需要在叢集部署一組容器用於 DNS 解析。預設採用兩個 0.25 Core 512 MiB 規格的 ECI 執行個體。 `PrivateZone`：使用阿里雲 PrivateZone 產品提供服務發現能力，需要開啟 PrivateZone 服務。預設值：不開啟。	PrivateZone
snat_entry	boolean	否	為專有網路設定 SNAT。取值： `true`：自動建立 NAT 閘道器並自動設定 SNAT 規則。叢集內的節點、應用程式等需要存取公網需要設定為`true`。 `false`：不建立 NAT 閘道器及 SNAT 規則。叢集內節點及應用程式將不能存取公網。說明如果建立叢集時未開啟，後續業務需要存取公網，可手動開啟。預設值：`false`。	false
soc_enabled `deprecated`	boolean	否	【該欄位已廢棄】叢集控制面節點設定請使用`control_plane_config`下的`soc_enabled`參數代替；節點池設定請使用`nodepool`中`scaling_group`下的`soc_enabled`參數代替。等保加固。更多資訊，請參見 ACK 等保加固使用說明。取值： `true`：開啟等保加固。 `false`：不開啟等保加固。預設值：`false`。	false
ssh_flags	boolean	否	是否開放公網 SSH 登入。用於登入 ACK 專有叢集的 Master 節點。託管叢集中，該參數不生效。 `true`：開放。 `false`：不開放。預設值：`false`。	true
tags	array	否	節點標籤。標籤定義規則：標籤由區分大小寫的鍵值對組成，您最多可以設定 20 個標籤。標籤鍵不可以重複，最長為 64 個字元；標籤值可以為空，最長為 128 個字元。標籤鍵和標籤值都不能以「aliyun」、「acs:」、「https://」或「http://」開頭。詳情請參見Labels and Selectors。
	tag	否	節點標籤。標籤定義規則：標籤由區分大小寫的鍵值對組成，您最多可以設定 20 個標籤。標籤鍵不可以重複，最長為 64 個字元；標籤值可以為空，最長為 128 個字元。標籤鍵和標籤值都不能以「aliyun」、「acs:」、「https://」或「http://」開頭。詳情請參見Labels and Selectors。
taints `deprecated`	array	否	【該欄位已廢棄】節點池設定請使用`nodepool`中`kubernetes_config`下的`taints`參數代替。節點污點資訊。污點和容忍度（Toleration）相互配合，可以用來避免 Pod 被分配到不合適的節點上。更多資訊，請參見taint-and-toleration。
	taint	否	節點污點資訊。污點和容忍度（Toleration）相互配合，可以用來避免 Pod 被分配到不合適的節點上。更多資訊，請參見taint-and-toleration。
timeout_mins `deprecated`	integer	否	【該欄位已廢棄】叢集建立失敗時預設不會進行回滾，您需要自行清理建立失敗的叢集。叢集建立逾時時間，單位分鐘。預設值：`60`。	60
timezone	string	否	叢集使用的時區。請參見支援時區。	Asia/Shanghai
user_ca	string	否	自訂叢集 CA。	-----BEGIN CERTIFICATE-----****
user_data `deprecated`	string	否	【該欄位已廢棄】自訂節點資料。	IyEvdXNyL2Jpbi9iYXNoCmVjaG8gIkhlbGxvIEFD****
vpcid	string	否	叢集使用的專有網路，建立叢集時必須為叢集提供。	vpc-2zeik9h3ahvv2zz95****
vswitch_ids	array	否	叢集節點所在虛擬交換器，當建立零節點的託管版叢集時，該欄位必填。
	string	否	叢集節點所在虛擬交換器，當建立零節點的託管版叢集時，該欄位必填。	vsw-2ze3ds0mdip0hdz8i****
worker_auto_renew `deprecated`	boolean	否	【該欄位已廢棄】節點池設定請使用`nodepool`中`scaling_group`下的`auto_renew`參數代替。 Worker 節點是否開啟自動續費，當`worker_instance_charge_type`取值為`PrePaid`時才生效，取值： `true`：自動續費。 `false`：不自動續費。預設值：`true`。	true
worker_auto_renew_period `deprecated`	integer	否	【該欄位已廢棄】節點池設定請使用`nodepool`中`scaling_group`下的`auto_renew_period`參數代替。 Worker 節點自動續費週期，當選擇包年包月付費類型時才生效，且為必選值。取值範圍：{1, 2, 3, 6, 12}。	1
worker_data_disks `deprecated`	array<object>	否	【該欄位已廢棄】節點池設定請使用`nodepool`中`scaling_group`下的`data_disks`參數代替。 Worker 節點資料磁碟類型、大小等設定的組合。
	object	否	資料磁碟設定集合。
category	string	是	資料磁碟類型。	cloud_essd
encrypted	string	否	是否對資料磁碟加密。取值： `true`：對資料磁碟加密。 `false`：不對資料磁碟加密。預設值：`false`。	true
performance_level	string	否	節點資料磁碟效能等級，僅針對 ESSD 雲端硬碟生效。	PL1
size	string	是	資料磁碟大小，取值範圍：40～32767。單位：GiB。	120
worker_instance_charge_type `deprecated`	string	否	【該欄位已廢棄】節點池設定請使用`nodepool`中`scaling_group`下的`instance_charge_type`參數代替。 Worker 節點付費類型，取值： `PrePaid`：包年包月。 `PostPaid`：按量付費。預設值：按量付費。	PrePaid
worker_instance_types `deprecated`	array	否	【該欄位已廢棄】節點池設定請使用`nodepool`中`scaling_group`下的`instance_types`參數代替。 Worker 節點執行個體設定。
	string	否	Worker 節點執行個體規格，至少要指定一個執行個體規格。更多資訊，請參見執行個體規格族。說明執行個體規格優先順序隨著在資料中的位置增大依次降低。當無法根據優先順序較高的執行個體規格建立出執行個體時，會自動選擇下一優先順序的執行個體規格來建立執行個體。	ecs.n4.large
worker_period `deprecated`	integer	否	【該欄位已廢棄】節點池設定請使用`nodepool`中`scaling_group`下的`period`參數代替。 Worker 節點包年包月時長，當`worker_instance_charge_type`取值為`PrePaid`時才生效且為必選值。取值範圍：{1, 2, 3, 6, 12, 24, 36, 48, 60}。預設值：1。	1
worker_period_unit `deprecated`	string	否	【該欄位已廢棄】節點池設定請使用`nodepool`中`scaling_group`下的`period_unit`參數代替。 Worker 節點付費週期，當付費類型為`PrePaid`的時候需要指定週期。取值：`Month`，當前只支援以月為週期。	Month
worker_system_disk_category `deprecated`	string	否	【該欄位已廢棄】節點池設定請使用`nodepool`中`scaling_group`下的`system_disk_category`參數代替。 Worker 節點系統磁碟類型。更多資訊，請參見區塊儲存概述。取值： `cloud_efficiency`：高效雲端硬碟。 `cloud_ssd`：SSD 雲端硬碟。預設值：`cloud_ssd`。	cloud_efficiency
worker_system_disk_performance_level `deprecated`	string	否	【該欄位已廢棄】節點池設定請使用`nodepool`中`scaling_group`下的`system_disk_performance_level`參數代替。當系統磁碟為 ESSD 雲端硬碟時，可設定 ESSD 雲端硬碟的效能級別 PL（Performance Level）。更多資訊，請參見 ESSD 雲端硬碟。取值： PL0 PL1 PL2 PL3	PL1
worker_system_disk_size `deprecated`	integer	否	【該欄位已廢棄】節點池設定請使用`nodepool`中`scaling_group`下的`system_disk_size`參數代替。 Worker 節點系統磁碟大小，單位為 GiB。取值範圍：[40,500]。該參數的取值必須大於或者等於 max{40, ImageSize}。預設值：`120`。	120
worker_system_disk_snapshot_policy_id `deprecated`	string	否	【該欄位已廢棄】節點池設定請使用`nodepool`中`scaling_group`下的`system_disk_snapshot_policy_id`參數代替。 Worker 節點系統磁碟採用的自動快照策略 ID。	sp-2zej1nogjvovnz4z****
worker_vswitch_ids `deprecated`	array	否	【該欄位已廢棄】節點池設定請使用`nodepool`中`scaling_group`下的`vswitch_ids`參數代替。叢集節點使用的虛擬交換器清單，一個節點對應一個值。當建立零節點的託管版叢集時，欄位`worker_vswitch_ids` 非必填，但是需要提供`vswitch_ids`。
	string	否	Worker 節點虛擬交換器清單，取值範圍：[1,20]。為保證高可用性，建議選擇不同可用區的虛擬交換器。當建立零節點的託管版叢集時，欄位`worker_vswitch_ids` 非必填，但是需要提供`vswitch_ids`。	vsw-2ze3ds0mdip0hdz8i****
zone_id `deprecated`	string	否	【該欄位已廢棄】請使用`zone_ids`參數代替。叢集所屬地域的可用區 ID。此參數為 ACK 託管類的叢集特有參數。當建立 ACK 託管類的叢集時，如果未指定`vpc_id`和`vswitch_ids`，必須為叢集指定`zone_id`，用於自動在該可用區建立 VPC 網路資源；指定`vpc_id`和`vswitch_ids`時，該參數無效。	cn-beiji****
zone_ids	array	否	叢集所屬地域的多個可用區 ID。此參數為 ACK 託管類的叢集特有參數。
	string	否	叢集所屬地域的可用區 ID，將在該可用區自動建立虛擬交換器。當建立 ACK 託管類的叢集時，如果未指定`vpc_id`和`vswitch_ids`，為叢集指定`zone_ids`，用於自動在多個可用區內建立 VPC 網路資源；指定`vpc_id`和`vswitch_ids`時，該參數無效。	cn-beijing-h

返回參數

名稱	類型	描述	樣本值
	object	回應主體。
cluster_id	string	叢集 ID。	cb95aa626a47740afbf6aa099b650****
request_id	string	請求 ID。	687C5BAA-D103-4993-884B-C35E4314****
task_id	string	任務 ID。	T-5a54309c80282e39ea****

樣本

正常返回樣本

JSON格式

{
  "cluster_id": "cb95aa626a47740afbf6aa099b650****",
  "request_id": "687C5BAA-D103-4993-884B-C35E4314****",
  "task_id": "T-5a54309c80282e39ea****"
}

錯誤碼

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊，參考變更詳情。