名稱

類型

是否必選

示例值

描述

name

String

是

demo-edge-cluster

集群名稱。

命名規則：由數字、漢字、英文字符或短劃線（-）組成，長度范圍1~63個字符，且不能以短劃線（-）開頭。

cluster_type

String

是

ManagedKubernetes

集群類型。取值ManagedKubernetes創建邊緣托管版集群。

disable_rollback

Boolean

否

true

集群創建失敗是否回滾。取值：

• true：當集群創建失敗時，進行回滾操作。

• false：當集群創建失敗時，不進行回滾操作。

默認值：false。

timeout_mins

Long

否

60

集群資源棧創建超時時間，以分鐘為單位，默認值60分鐘。

kubernetes_version

String

否

1.30.1-aliyun.1

集群版本，與Kubernetes社區基線版本保持一致。建議選擇最新版本，若不指定，默認使用最新版本。

目前您可以在ACK控制臺創建兩種最新版本的集群。您可以通過API創建其他Kubernetes版本集群。關于ACK支持的Kubernetes版本，請參見Kubernetes版本概覽及機制。

runtime

Array of runtime

否

{"name": "containerd", "version": "1.6.20"}

容器運行時，支持containerd和docker兩種運行時。

包括以下信息：

• name：容器運行時名稱。

• version：容器運行時版本。

region_id

String

是

cn-beijing

集群所在地域ID。

key_pair

String

是

demo-key

密鑰對名稱，和login_password二選一。

login_password

String

是

HelloWorld123

SSH登錄密碼，和key_pair二選一。密碼規則為8~30個字符，且至少同時包含三項（大小寫字母、數字和特殊符號）。

num_of_nodes

Long

是

1

Worker節點數。范圍是[0,100]。

profile

String

是

Edge

ACK Edge集群標識，默認取值：Edge。

logging_type

String

否

SLS

集群開啟日志服務，只針對ACK Serverless集群生效，且取值必須是SLS。

snat_entry

Boolean

否

true

是否為網絡配置SNAT：

• 當已有VPC能訪問公網環境時，設置為false。

• 當已有VPC無法訪問公網環境時：

  • 設置為true，表示配置SNAT，此時可以訪問公網環境。

  • 設置為false，表示不配置SNAT，此時無法訪問公網環境。

如果您的應用需要訪問公網，建議配置為true。

默認值：false。

vswitch_ids

Array of String

是

vsw-2ze48rkq464rsdts1****

交換機ID。List長度范圍為[1,3]。

worker_system_disk_category

String

是

cloud_efficiency

Worker節點系統盤類型，取值：

• cloud_efficiency：高效云盤。

• cloud_ssd：SSD云盤。

默認值：cloud_ssd。

worker_system_disk_size

Long

是

100

Worker節點系統盤大小，單位為GiB。

取值范圍：[40,500]。

該參數的取值必須大于或者等于max{40, ImageSize}。

默認值：120。

container_cidr

String

否

172.20.0.0

Pod網絡地址段，不能和VPC網段沖突。當選擇系統自動創建VPC時，默認使用172.16.0.0/16網段。

cloud_monitor_flags

Boolean

否

true

集群是否安裝云監控插件。取值：

• true：安裝云監控插件。

• false：不安裝云監控插件。

默認值：false。

endpoint_public_access

Boolean

否

true

是否開啟公網API Server。取值：

• true：表示開放公網API Server。

• false：表示不會創建公網的API Server，僅創建私網的API Server。

默認值：true。

service_cidr

String

是

172.21.0.0

Service網絡地址段，不能和VPC網段及Pod網絡網段沖突。當選擇系統自動創建VPC時，默認使用172.19.0.0/20網段。

addons

Array of addon

否

[{"name":"flannel","config":""},{"name":"logtail-ds-docker","config":""},{"name":"alibaba-log-controller","config":"{"IngressDashboardEnabled":"false"}"}]

Kubernetes集群安裝的組件列表。組件的結構包括：

• name：必填，組件名稱。

• config：可選，取值為空時表示無需配置。

• disabled：可選，是否禁止默認安裝。

網絡組件：必選，包含Flannel和Terway兩種網絡類型，創建集群時二選一：

• Flannel網絡：[{"name":"flannel","config":""}]。

• Terway網絡：[{"name": "terway-eniip","config": ""}] 。

存儲組件：可選，支持csi類型：

csi：[{"name":"csi-plugin","config": ""},{"name": "csi-provisioner","config": ""}]。

日志組件：可選。

• 使用已有SLS Project：[{"name": "logtail-ds","config": "{\"IngressDashboardEnabled\":\"true\",\"sls_project_name\":\"your_sls_project_name\"}"}] 。

• 創建新的SLS Project：[{"name": "logtail-ds","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天內免費。關于免費策略的更多信息，請參見創建并使用K8s事件中心。

開啟事件中心：[{"name":"ack-node-problem-detector","config":"{\"sls_project_name\":\"

your_sls_project_name\"}"}]。

tags

Array of tag

否

[{"key": "env", "value": "prod"}]

給集群打tag標簽：

• key：標簽名稱。

• value：標簽值。

vpcid

String

是

vpc-2zeik9h3ahvv2zz95****

集群使用的專有網絡，創建集群時必須為集群提供。

worker_data_disks

Array of data_disk

否

Worker節點數據盤類型、大小等配置的組合。

deletion_protection

Boolean

否

true

集群刪除保護，防止通過控制臺或API誤刪除集群。取值：

• true：啟用集群刪除保護，將不能通過控制臺或API刪除集群。

• false：不啟用集群刪除保護，則能通過控制臺或API刪除集群。

默認值：false。

node_cidr_mask

String

否

25

節點IP數量，通過指定網絡的CIDR來確定IP的數量，只對于Flannel網絡類型集群生效。

默認值：25。

worker_instance_types

Array of String

是

ecs.n4.large

Worker節點實例規格，至少要指定一個實例規格。更多信息，請參見實例規格族。

worker_instance_charge_type

String

是

PrePaid

Worker節點付費類型，取值：

• PrePaid：包年包月。

• PostPaid：按量付費。

默認值：按量付費。

security_group_id

String

否

sg-bp1bdue0qc1g7k****

使用已有安全組創建集群時需要指定安全組ID，和is_enterprise_security_group二選一，集群節點會自動加入到此安全組。

is_enterprise_security_group

Boolean

否

true

自動創建企業級安全組，當security_group_id為空的時生效。

• true：創建并使用企業級安全組。

• false：不使用企業級安全組。

默認值：true。

rds_instances

rds_instances

否

rm-2zev748xi27xc****

RDS實例名稱。

cluster_spec

String

否

ack.pro.small

托管版集群類型，面向托管集群。取值：

• ack.pro.small：專業托管集群，即：ACK Edge集群Pro版。

• ack.standard：標準托管集群，即ACK Edge集群基礎版。

默認值：ack.standard。取值可以為空，為空時則創建邊緣基礎版集群。

更多信息，請參見ACK Edge集群Pro版介紹。

resource_group_id

String

否

rg-acfm3mkrure****

集群所屬資源組ID，實現不同資源的隔離。

名稱

類型

示例值

描述