全部產品
Search

搜尋本產品

    Container Service for Kubernetes：CreateCluster

    文件中心

    Container Service for Kubernetes：CreateCluster

    更新時間：Aug 20, 2026

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

    介面說明

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

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

    1. 登入容器服務管理主控台，在左側導覽列選擇叢集列表。

    2. 在叢集列表頁面，按一下叢集範本。

    3. 在對話方塊中，選擇需要建立的叢集類型，並按一下建立，然後在叢集設定頁面設定叢集資訊。

    4. 設定完成後，在確認設定頁面，按一下右上角的同等程式碼。對話方塊將展示您建立叢集時所需的參數組合，您可以複製使用。

    重要 自 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
    name

    string

    是

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

    cluster-demo
    region_id

    string

    是

    叢集所在地域 ID。詳情請參見容器服務開服地域。

    cn-beijing
    cluster_type

    string

    否

    • Kubernetes：ACK 專屬叢集。

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

    • ExternalKubernetes：註冊叢集。

    Kubernetes
    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
    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
    kubernetes_version

    string

    否

    叢集版本，與 Kubernetes 社群基線版本保持一致。建議選擇最新版本。若未指定，預設使用最新版本。

    支援建立最近三個版本的叢集，可透過 DescribeKubernetesVersionMetadata 介面查詢支援的叢集版本。

    關於 ACK 支援的 Kubernetes 版本，請參閱 Kubernetes 版本發佈概覽。

    1.32.1-aliyun.1
    auto_mode

    object

    否

    智慧託管模式設定。

    enable

    boolean

    否

    是否開啟智慧託管模式。

    true
    tags

    array

    否

    節點標籤。標籤定義規則：

    • 標籤由區分大小寫的鍵值對組成，您最多可以設定 20 個標籤。

    • 標籤鍵不可以重複，最長為 64 個字元；標籤值可以為空，最長為 128 個字元。標籤鍵和標籤值都不能以「aliyun」、「acs:」、「https://」或「http://」開頭。詳情請參見Labels and Selectors。

    tag

    否

    節點標籤。標籤定義規則：

    • 標籤由區分大小寫的鍵值對組成，您最多可以設定 20 個標籤。

    • 標籤鍵不可以重複，最長為 64 個字元；標籤值可以為空，最長為 128 個字元。標籤鍵和標籤值都不能以「aliyun」、「acs:」、「https://」或「http://」開頭。詳情請參見Labels and Selectors。

    resource_group_id

    string

    否

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

    rg-acfm3mkrure****
    deletion_protection

    boolean

    否

    叢集刪除保護，防止透過主控台或 API 誤刪除叢集。取值：

    • true：啟用叢集刪除保護，將無法透過主控台或 API 刪除叢集。

    • false：不啟用叢集刪除保護，則能透過主控台或 API 刪除叢集。

    預設值：false。

    true
    zone_ids

    array

    否

    叢集所屬地域的多個可用區 ID。此參數為 ACK 託管類的叢集特有參數。

    string

    否

    叢集所屬地域的可用區 ID，將在該可用區自動建立虛擬交換器。

    當建立 ACK 託管版叢集時，若未指定 vpc_id 和 vswitch_ids，可為叢集指定 zone_ids，用於自動在多個可用區內建立 VPC 網路資源；若已指定 vpc_id 和 vswitch_ids，則此參數無效。

    cn-beijing-h
    vpcid

    string

    否

    叢集使用的專用網路，建立叢集時必須為叢集提供。

    vpc-2zeik9h3ahvv2zz95****
    vswitch_ids

    array

    否

    叢集節點所在虛擬交換器，當建立零節點的託管版叢集時，該欄位必填。

    string

    否

    叢集節點所在虛擬交換器，當建立零節點的託管版叢集時，該欄位必填。

    vsw-2ze3ds0mdip0hdz8i****
    ip_stack

    string

    否

    叢集 ip_stack。

    可選值：
    pod_vswitch_ids deprecated

    array

    否

    【該欄位已廢棄】網路外掛程式選擇 Terway 時，您需要為 Pod 分配 IP 的虛擬交換器。每個 Pod 虛擬交換器分別對應一個 Worker 節點的虛擬交換器，Pod 虛擬交換器和 Worker 節點的虛擬交換器的可用區需保持一致。

    string

    否

    當網路外掛程式選擇 Terway 時，您需要為 Pod 分配 IP 的虛擬交換器。每個 Pod 虛擬交換器分別對應一個 Worker 節點的虛擬交換器，Pod 虛擬交換器和 Worker 節點的虛擬交換器的可用區需保持一致。

    說明

    Pod 虛擬交換器的網段遮罩建議不超過 19，最大不超過 25，否則叢集網路可分配的 Pod IP 位址非常有限，會影響叢集的正常使用。

    vsw-2ze97jwri7cei0mpw****
    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
    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
    security_group_id

    string

    否

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

    sg-bp1bdue0qc1g7k****
    is_enterprise_security_group

    boolean

    否

    自動建立企業級安全性群組，當 security_group_id 為空時生效。

    說明

    使用普通安全性群組時，叢集內節點與 Terway Pod 數量之和不能超過 2000。因此建立 Terway 網路類型叢集時，建議使用企業級安全性群組。

    • true：建立並使用企業級安全性群組。

    • false：使用普通安全性群組。

    預設值：true。

    true
    snat_entry

    boolean

    否

    為專有網路設定 SNAT。取值：

    • true：自動建立 NAT 閘道器並自動設定 SNAT 規則。叢集內的節點、應用程式等需要存取公網時需設定為 true。

    • false：不建立 NAT 閘道器及 SNAT 規則。叢集內節點及應用程式將無法存取公網。

    說明

    如果建立叢集時未啟用，後續業務需要存取公網，可手動啟用。

    預設值：false。

    false
    control_plane_endpoints_config

    object

    否

    叢集連線設定。

    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
    internal_dns_config

    object

    否

    叢集內部網域名稱設定，適用於 ACK 託管叢集。叢集內部網域名稱用於 kubelet、kube-proxy 等節點側系統元件存取 API Server；未開啟叢集內部網域名稱存取時，節點側系統元件將透過 CLB IP 方式存取。

    bind_vpcs

    array

    否

    叢集內部網域名稱記錄解析生效的 VPC。

    string

    否

    叢集內部網域名稱記錄解析生效的 VPC。

    vpc-xxxx
    endpoint_public_access

    boolean

    否

    是否開啟公網存取。透過 EIP 公開 API Server，實現叢集公網存取。

    • true：開啟公網存取。

    • false：不開啟公網存取。選擇不開放時，則無法透過外網存取叢集 API Server。

    預設值：false。

    true
    load_balancer_id

    string

    否

    指定用於 API Server 存取的 CLB 執行個體 ID。指定該參數時，將不再自動建立 API Server CLB。

    說明

    請確保該 CLB 執行個體無其他依賴（如存在監聽、後端伺服器等），不支援共用型、公網類型的 CLB 指定。

    lb-wz9t256gqa3vbouk****
    ssh_flags

    boolean

    否

    是否開放公網 SSH 登入。用於登入 ACK 專屬叢集的 Master 節點。在託管叢集中，此參數不生效。

    • true：開放。

    • false：不開放。

    預設值：false。

    true
    timezone

    string

    否

    叢集使用的時區。請參見支援時區。

    Asia/Shanghai
    node_cidr_mask

    string

    否

    節點 IP 數量，透過指定網路的 CIDR 來確定 IP 的數量，僅對 Flannel 網路類型叢集生效。

    25
    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
    controlplane_log_ttl

    string

    否

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

    30
    controlplane_log_project

    string

    否

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

    k8s-log-xxx
    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"]
    audit_log_config

    object

    否

    叢集稽核日誌設定。

    enabled

    boolean

    否

    是否開啟叢集稽核日誌功能。

    true
    sls_project_name

    string

    否

    叢集稽核日誌 Logstore 所在的 SLS Project。

    • 預設值為 k8s-log-{clusterid}。

    • 啟用叢集稽核日誌功能後，會在指定的 SLS Project 下建立叢集稽核日誌對應的 Logstore。

    k8s-log-c2345xxxxxxxxxxxx
    rrsa_config

    object

    否

    RRSA 功能設定。

    enabled

    boolean

    否

    是否開啟 RRSA 功能。

    true
    cluster_domain

    string

    否

    叢集本機網域名稱。

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

    cluster.local
    encryption_provider_key

    string

    否

    KMS 金鑰 ID，使用該金鑰對資料磁碟進行加密。更多詳情，請參見金鑰管理服務。

    說明

    該功能僅在專業託管版叢集（ACK Pro 版叢集）中生效。

    0fe64791-55eb-4fc7-84c5-c6c7cdca****
    service_account_issuer

    string

    否

    ServiceAccount 是 Pod 和叢集 API Server 通訊的存取憑證。而 service-account-issuer 是 serviceaccount token 中的簽發身分，即 token payload 中的 iss 欄位。

    kubernetes.default.svc
    api_audiences

    string

    否

    ServiceAccount 是 Pod 與叢集 API Server 通訊的存取憑證，而 api-audiences 是合法的請求 token 身分，用於 apiserver 伺服器端認證請求 token 是否合法。支援設定多個 audience，透過英文半形逗號（,）分隔。

    關於 ServiceAccount 更多詳情，請參閱部署服務帳戶權杖卷投影。

    kubernetes.default.svc
    extra_sans

    array

    否

    自訂 API Server 憑證 SAN（Subject Alternative Name）。

    string

    否

    憑證 SAN。支援自訂 IP 地址或網域名稱。

    192.168.xx.xx
    maintenance_window maintenance_window

    否

    叢集維護時段。

    operation_policy

    object

    否

    叢集自動維運策略。

    cluster_auto_upgrade

    object

    否

    叢集自動升級。

    enabled

    boolean

    否

    是否開啟叢集自動升級。

    true
    channel

    string

    否

    叢集自動升級頻率。可取值：

    • patch：當目前次要版本有可用的修補程式版本時，自動升級至該修補程式版本，新的 Kubernetes 版本不會包含破壞性變更（Breaking Changes）。

    • stable：自動升級至次要版本為次新的最新修補程式版本。新的 Kubernetes 版本可能涉及 API 和功能特性的變更，但其穩定性已通過廣泛驗證。

    • rapid：自動升級至最新次要版本的最新修補程式版本，以更快取得 Kubernetes 社群的新特性。

    stable
    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 指定想要安裝的叢集元件。

    nodepools

    array

    否

    節點集區清單。

    nodepool

    否

    節點集區設定。

    user_ca

    string

    否

    自訂叢集 CA。

    -----BEGIN CERTIFICATE-----****
    control_plane_config

    object

    否

    ACK 專有叢集控制面設定。

    charge_type

    string

    否

    控制面節點付費類型。

    PostPaid
    period

    integer

    否

    控制面節點包年包月的時長。當付費類型為 PrePaid 時有效且為必選值。

    取值範圍：{1, 2, 3, 6, 12, 24, 36, 48, 60}，單位：月。

    預設值：1。

    1
    period_unit

    string

    否

    控制面節點包年包月時間單位。當付費類型為 PrePaid 時有效且為必選值。

    Month
    auto_renew

    boolean

    否

    控制面節點是否自動續費。當付費類型為 PrePaid 時有效。

    true
    auto_renew_period

    integer

    否

    控制面節點自動續費時長。

    1
    instance_types

    array

    否

    節點執行個體類型。

    string

    否

    節點執行個體規格類型。

    ecs.g6.large

    image_type

    string

    否

    作業系統映像類型。

    AliyunLinux3

    image_id

    string

    否

    映像 ID。

    aliyun_3_x64_20G_alibase_20240819.vhd

    key_pair

    string

    否

    金鑰對名稱，與 login_password 二擇一。

    ack
    login_password

    string

    否

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

    ********
    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_size

    integer

    否

    節點系統磁碟大小。

    120
    system_disk_snapshot_policy_id

    string

    否

    節點自動快照備份策略。

    sp-2zej1nogjvovnz4z****

    system_disk_performance_level

    string

    否

    節點系統磁碟效能，僅針對 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_bursting_enabled

    boolean

    否

    節點系統磁碟是否啟用 Burst（效能突發）。

    • true：啟用。

    • false：不啟用。

    當 system_disk_category 取值為 cloud_auto 時才支援設定此參數。

    true
    deploymentset_id

    string

    否

    部署集 ID。

    ds-bp10b35imuam5amw****

    cloud_monitor_flags

    boolean

    否

    是否為節點安裝雲端監控。

    false
    instance_metadata_options InstanceMetadataOptions

    否

    ECS 執行個體中繼資料存取設定。

    soc_enabled

    boolean

    否

    是否啟用等保安全性加固。

    false
    security_hardening_os

    boolean

    否

    是否啟用阿里雲 OS 安全性加固。

    false
    cpu_policy

    string

    否

    節點 CPU 管理策略。

    • static：允許為節點上具有某些資源特徵的 Pod 增強其 CPU 親和性和獨佔性。

    • none：表示啟用現有的預設 CPU 親和性方案。

    預設值：none。

    none
    runtime

    string

    否

    【此欄位已棄用】控制面節點執行階段名稱。取值：

    containerd
    node_port_range

    string

    否

    【此欄位已棄用】節點服務連接埠範圍。

    30000-32767

    size

    integer

    否

    控制面節點數量。

    3
    custom_san deprecated

    string

    否

    【該欄位已廢棄】請使用參數 extra_sans 代替。

    cs.aliyun.com
    runtime deprecated runtime

    否

    叢集內容器執行環境。支援 containerd、安全沙箱和 Docker。

    說明

    Kubernetes 1.24 不再支援將 Docker 作為內建容器執行環境。

    更多資訊，請參閱Docker、containerd、安全沙箱執行環境的比較。

    node_name_mode deprecated

    string

    否

    【此欄位已棄用】節點池設定請使用 nodepool 中 kubernetes_config 下的 node_name_mode 參數代替。

    null
    user_data deprecated

    string

    否

    【此欄位已棄用】自訂節點資料。

    IyEvdXNyL2Jpbi9iYXNoCmVjaG8gIkhlbGxvIEFD****
    image_id deprecated

    string

    否

    【此欄位已棄用】叢集控制面設定請使用 control_plane_config 下的 image_id 參數代替；節點池設定請使用 nodepool 中 scaling_group 下的 image_id 參數代替。

    m-bp16z7xko3vvv8gt****
    rds_instances deprecated

    array

    否

    【此欄位已棄用】節點池設定請使用 nodepool 中 scaling_group 下的 rds_instances 參數代替。

    string

    否

    RDS 執行個體清單，選擇您想要新增至白名單的 RDS 執行個體。建議前往 RDS 加入容器 Pod 網段與 Node 網段，若設定的 RDS 執行個體處於非運作狀態，將導致無法彈出。

    rm-2zev748xi27xc****
    taints deprecated

    array

    否

    【該欄位已廢棄】節點池設定請使用 nodepool 中 kubernetes_config 下的 taints 參數代替。

    節點污點資訊。污點與容忍度（Toleration）相互配合，可以用來避免 Pod 被分配到不合適的節點上。更多資訊，請參見 taint-and-toleration。

    taint

    否

    節點污點資訊。污點與容忍度（Toleration）相互配合，可以用來避免 Pod 被分配到不合適的節點上。更多資訊，請參見 taint-and-toleration。

    cloud_monitor_flags deprecated

    boolean

    否

    【此欄位已棄用】叢集控制面節點設定請使用 control_plane_config 下的 cloud_monitor_flags 參數代替；節點池設定請使用 nodepool 中 kubernetes_config 下的 cms_enabled 參數代替。

    false
    platform deprecated

    string

    否

    【此欄位已棄用】節點池設定請使用 nodepool 中 scaling_group 下的 platform 參數代替。

    CentOS
    os_type deprecated

    string

    否

    【此欄位已棄用】叢集控制面節點設定請使用 control_plane_config 下的 image_type 參數代替；節點池設定請使用 nodepool 中 scaling_group 下的 image_type 參數代替。

    Linux
    soc_enabled deprecated

    boolean

    否

    【此欄位已棄用】叢集控制面節點設定請使用 control_plane_config 下的 soc_enabled 參數代替；節點池設定請使用 nodepool 中 scaling_group 下的 soc_enabled 參數代替。

    false
    security_hardening_os deprecated

    boolean

    否

    【此欄位已棄用】叢集控制面設定請使用 control_plane_config 下的 security_hardening_os 參數代替；節點池設定請使用 nodepool 中 scaling_group 下的 security_hardening_os 參數代替。

    false
    cis_enabled deprecated

    boolean

    否

    【此欄位已棄用】叢集控制面設定請使用 control_plane_config 下的 security_hardening_os 參數代替；節點池設定請使用 nodepool 中 scaling_group 下的 security_hardening_os 參數代替。

    false
    cpu_policy deprecated

    string

    否

    【該欄位已廢棄】叢集控制面設定請使用 control_plane_config 下的 cpu_policy 參數代替；節點池設定請使用 nodepool 中 kubernetes_config 下的 cpu_policy 參數代替。

    none
    node_port_range deprecated

    string

    否

    節點服務連接埠，可選連接埠範圍：[30000,65535]。

    30000~32767

    master_vswitch_ids deprecated

    array

    否

    【該欄位已廢棄】請使用 vswitch_ids 參數代替。

    string

    否

    Master 節點交換器 ID 清單，交換器個數取值範圍為 [1,3]。為確保叢集的高可用性，建議您選擇 3 個交換器，且分佈在不同的可用區。

    指定的執行個體規格數量需要和 master_count 保持一致，並與 master_vswitch_ids 中的元素一一對應。

    vsw-2ze3ds0mdip0hdz8i****
    key_pair deprecated

    string

    否

    【該欄位已廢棄】叢集控制面設定請使用 control_plane_config 下的 key_pair 參數代替；節點池設定請使用 nodepool 中 scaling_group 下的 key_pair 參數代替。

    金鑰對名稱，與 login_password 二選一。

    security-key
    login_password deprecated

    string

    否

    【該欄位已廢棄】叢集控制面配置請使用 control_plane_config 下的 login_password 參數代替；節點池配置請使用 nodepool 中 scaling_group 下的 login_password 參數代替。

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

    null
    master_count deprecated

    integer

    否

    【該欄位已廢棄】叢集控制面設定請使用 control_plane_config 下的 size 參數代替。

    3
    master_instance_types deprecated

    array

    否

    【該欄位已廢棄】叢集控制面設定請使用 control_plane_config 下的 instance_types 參數代替。

    string

    否

    Master 節點執行個體類型。指定的執行個體規格數量需要和 master_count 保持一致，和 master_instance_types 中的元素一一對應。更多資訊，請參見執行個體規格族。

    ecs.n4.xlarge
    master_system_disk_category deprecated

    string

    否

    【該欄位已廢棄】叢集控制面設定請使用 control_plane_config 下的 system_disk_category 參數代替。

    cloud_ssd
    master_system_disk_size deprecated

    integer

    否

    【該欄位已廢棄】叢集控制面設定請使用 control_plane_config 下的 system_disk_size 參數代替。

    120
    master_system_disk_performance_level deprecated

    string

    否

    【該欄位已廢棄】叢集控制面配置請使用 control_plane_config 下的 system_disk_performance_level 參數代替。

    叢集 Master 節點系統磁碟效能等級，僅對 ESSD 磁碟生效。磁碟效能等級與磁碟大小有關，更多資訊，請參閱 ESSD 雲端硬碟。

    PL1
    master_system_disk_snapshot_policy_id deprecated

    string

    否

    【該欄位已廢棄】叢集控制面設定請使用 control_plane_config 下的 system_disk_snapshot_policy_id 參數代替。

    sp-2zej1nogjvovnz4z****
    master_instance_charge_type deprecated

    string

    否

    【該欄位已廢棄】叢集控制面設定請使用 control_plane_config 下的 instance_charge_type 參數代替。

    PrePaid
    master_period_unit deprecated

    string

    否

    【該欄位已廢棄】叢集控制面設定請使用 control_plane_config 下的 period_unit 參數代替。

    Month
    master_period deprecated

    integer

    否

    【該欄位已廢棄】叢集控制面設定請使用 control_plane_config 下的 unit 參數代替。

    1
    master_auto_renew deprecated

    boolean

    否

    【該欄位已廢棄】叢集控制面設定請使用 control_plane_config 下的 auto_renew 參數代替。

    true
    master_auto_renew_period deprecated

    integer

    否

    【該欄位已廢棄】叢集控制面設定請使用 control_plane_config 下的 auto_renew_period 參數代替。

    1
    num_of_nodes deprecated

    integer

    否

    【該欄位已廢棄】節點池設定請使用 nodepool 中 scaling_group 下的 desired_size 參數代替。

    3
    worker_vswitch_ids deprecated

    array

    否

    【該欄位已廢棄】節點池設定請使用 nodepool 中 scaling_group 下的 vswitch_ids 參數代替。

    string

    否

    Worker 節點虛擬交換器清單，取值範圍：[1,20]。為確保高可用性，建議選擇不同可用區的虛擬交換器。

    當建立零節點的託管版叢集時，欄位 worker_vswitch_ids 非必填，但是需要提供 vswitch_ids。

    vsw-2ze3ds0mdip0hdz8i****
    worker_instance_types deprecated

    array

    否

    【該欄位已廢棄】節點池設定請使用 nodepool 中 scaling_group 下的 instance_types 參數代替。

    string

    否

    Worker 節點執行個體規格，至少要指定一個執行個體規格。更多資訊，請參見執行個體規格族。

    說明

    執行個體規格優先順序隨著在資料中的位置增大依次降低。當無法根據優先順序較高的執行個體規格建立出執行個體時，會自動選擇下一優先順序的執行個體規格來建立執行個體。

    ecs.n4.large
    worker_system_disk_category deprecated

    string

    否

    【該欄位已廢棄】節點池設定請使用 nodepool 中 scaling_group 下的 system_disk_category 參數代替。

    cloud_efficiency
    worker_system_disk_size deprecated

    integer

    否

    【該欄位已廢棄】節點池設定請使用 nodepool 中 scaling_group 下的 system_disk_size 參數代替。

    120
    worker_system_disk_snapshot_policy_id deprecated

    string

    否

    【該欄位已廢棄】節點池設定請使用 nodepool 中 scaling_group 下的 system_disk_snapshot_policy_id 參數代替。

    sp-2zej1nogjvovnz4z****
    worker_system_disk_performance_level deprecated

    string

    否

    【該欄位已廢棄】節點池設定請使用 nodepool 中 scaling_group 下的 system_disk_performance_level 參數代替。

    PL1
    worker_data_disks deprecated

    array<object>

    否

    【該欄位已廢棄】節點池設定請使用 nodepool 中 scaling_group 下的 data_disks 參數代替。

    object

    否

    資料磁碟設定集合。

    category

    string

    是

    資料磁碟類型。

    cloud_essd
    encrypted

    string

    否

    是否對資料磁碟加密。取值：

    true
    size

    string

    是

    資料磁碟大小，取值範圍：40～32767。單位：GiB。

    120
    performance_level

    string

    否

    節點資料磁碟磁碟效能等級，僅針對 ESSD 雲端硬碟 生效。

    PL1
    worker_instance_charge_type deprecated

    string

    否

    【該欄位已廢棄】節點池設定請使用 nodepool 中 scaling_group 下的 instance_charge_type 參數代替。

    PrePaid
    worker_period_unit deprecated

    string

    否

    【該欄位已廢棄】節點池設定請使用 nodepool 中 scaling_group 下的 period_unit 參數代替。

    Month
    worker_period deprecated

    integer

    否

    【該欄位已廢棄】節點池設定請使用 nodepool 中 scaling_group 下的 period 參數代替。

    1
    worker_auto_renew deprecated

    boolean

    否

    【該欄位已廢棄】節點池設定請使用 nodepool 中 scaling_group 下的 auto_renew 參數代替。

    true
    worker_auto_renew_period deprecated

    integer

    否

    【該欄位已廢棄】節點池設定請使用 nodepool 中 scaling_group 下的 auto_renew_period 參數代替。

    Worker 節點自動續費週期，當選擇包年包月付費類型時才生效，且為必選值。

    取值範圍：{1, 2, 3, 6, 12}。

    1
    instances deprecated

    array

    否

    【該欄位已廢棄】建立叢集時不支援選擇既有節點，如需新增既有節點到叢集，請先建立節點池，並呼叫 AttachInstancesToNodePool 介面操作。

    string

    否

    使用現有節點建立叢集時，需要指定 ECS 執行個體清單，該執行個體會作為 Worker 節點加入叢集。

    i-2ze4zxnm36vq00xn****
    format_disk deprecated

    boolean

    否

    【該欄位已廢棄】建立叢集時不支援選擇既有節點，如需新增既有節點到叢集，請先建立節點池，並呼叫 AttachInstancesToNodePool 介面操作。

    false
    keep_instance_name deprecated

    boolean

    否

    【該欄位已廢棄】建立叢集時不支援選擇既有節點，如需新增既有節點到叢集，請先建立節點池，並呼叫 AttachInstancesToNodePool 介面操作。

    true
    service_discovery_types deprecated

    array

    否

    【該欄位已廢棄】叢集內服務探索類型，用於在 ACK Serverless 叢集中指定服務探索方式。

    string

    否

    叢集內服務探索類型，用於在 ACK Serverless 叢集中指定服務探索方式。

    • CoreDNS：使用 Kubernetes 原生標準服務探索元件 CoreDNS，需要在叢集部署一組容器用於 DNS 解析。預設採用兩個 0.25 Core 512 MiB 規格的 ECI 執行個體。

    • PrivateZone：使用阿里雲 PrivateZone 產品提供服務探索能力，需要啟用 PrivateZone 服務。

    預設值：不啟用。

    PrivateZone
    nat_gateway deprecated

    boolean

    否

    【該欄位已廢棄】請使用參數 snat_entry 代替。

    true
    zone_id deprecated

    string

    否

    【該欄位已廢棄】請使用 zone_ids 參數代替。

    cn-beiji****
    logging_type deprecated

    string

    否

    【該欄位已廢棄】叢集啟用日誌服務，僅針對 ACK Serverless 叢集生效，且取值必須是 SLS。

    SLS
    disable_rollback deprecated

    boolean

    否

    【該欄位已廢棄】叢集建立失敗時預設不會進行復原，您需要自行清理建立失敗的叢集。

    true
    timeout_mins deprecated

    integer

    否

    【該欄位已廢棄】叢集建立失敗時預設不會進行復原，您需要自行清理建立失敗的叢集。

    60
    image_type deprecated

    string

    否

    【該欄位已廢棄】叢集控制平面設定請使用 control_plane_config 下的 image_type 參數代替；節點池設定請使用 nodepool 中 scaling_group 下的 image_type 參數代替。

    AliyunLinux
    load_balancer_spec deprecated

    string

    否

    【該參數已廢棄】CLB 按使用量計費，該參數不生效。

    slb.s2.small
    enable_rrsa deprecated

    boolean

    否

    【該欄位已廢棄】請使用參數 rrsa_config 代替。

    false
    charge_type deprecated

    string

    否

    【該欄位已廢棄】

    API Server 所使用的 CLB 執行個體的付費類型，預設值為 PostPaid。取值：

    • PostPaid：按量付費。

    • PrePaid：包年包月，新建 CLB 付費類型已不支援，既有資源不受影響。

    重要

    詳細資訊請參閱傳統型負載平衡 CLB 計費項目調整公告。

    PostPaid
    period_unit deprecated

    string

    否

    【該欄位已廢棄】

    付費週期，當付費類型為 PrePaid 時，需要指定週期。

    取值：Month，目前僅支援以月為週期。

    該欄位於 2024 年 10 月 15 日存在變更，更多資訊，請參閱關於叢集建立介面 CreateCluster 參數行為變更的公告。

    Month
    period deprecated

    integer

    否

    【該欄位已廢棄】

    購買時長。包年包月時長，當 charge_type 取值為 PrePaid 時才生效，且為必選值。

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

    預設值：1。

    該欄位於 2024 年 10 月 15 日存在變更，更多資訊，請參見關於叢集建立介面 CreateCluster 參數行為變更的公告。

    1
    auto_renew deprecated

    boolean

    否

    【該欄位已廢棄】

    true
    auto_renew_period deprecated

    integer

    否

    【該欄位已廢棄】

    自動續約週期，當選擇預付費和自動續約時才生效。當 PeriodUnit=Month 時，取值範圍：{1, 2, 3, 6, 12}。

    預設值：1。

    該欄位於 2024 年 10 月 15 日存在變更，更多資訊，請參閱關於叢集建立介面 CreateCluster 參數行為變更的公告。

    1
    access_control_list deprecated

    array

    否

    【該欄位已廢棄】註冊叢集 API Server SLB 存取控制清單。

    string

    否

    註冊叢集 API Server SLB 存取控制清單。

    192.168.XX.XX/24

    返回參數

    名稱

    類型

    描述

    樣本值

    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****"
}

    錯誤碼

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

    變更歷史

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