全部產品
Search

搜尋本產品

    ENS：CreateCluster - 建立邊緣容器叢集

    文件中心

    ENS：CreateCluster - 建立邊緣容器叢集

    更新時間：Apr 21, 2026

    建立邊緣容器叢集。

    介面說明

    • 單使用者調用頻率： 10 次/秒。

    • 建立叢集是一個非同步操作，調用介面返回之後，需要等待 10~20 分鐘不等，等待叢集初始化完成。這個過程中可以調用 DescribeClustersV1 介面查詢叢集建立狀態。叢集建立成功之後，可以調用 DescribeClusterUserKubeconfig 擷取叢集認證。

    調試

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

    調試

    授權資訊

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

    • 操作：是指具體的許可權點。

    • 存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。

    • 資源類型：是指操作中支援授權的資源類型。具體說明如下：

      • 對於必選的資源類型，用前面加 * 表示。

      • 對於不支援資源級授權的操作，用全部資源表示。

    • 條件關鍵字：是指雲產品自身定義的條件關鍵字。

    • 關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    ens:CreateCluster

    create

    *全部資源

    *

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    Name

    string

    否

    叢集名稱。

    mycluster-1
    ClusterType

    string

    是

    Kubernetes or ManagedKubernetes，前者為 eck 叢集，後者為 serverles vc 必須與 profile 參數一起使用。

    Kubernetes
    Profile

    string

    是

    Default or Serverless，前者為 eck 叢集，後者為 serverless vc 必須與 cluster_type 參數一起使用。

    Default
    EnsRegionId

    string

    否

    叢集所在的 ENS Region ID 。

    cn-beijing
    KubernetesVersion

    string

    否

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

    1.32.1
    VpcId

    string

    否

    叢集使用的專用網路。

    vpc-xxxx
    VswitchIds

    array

    否

    叢集節點所在虛擬交換器 id。vswitch_ids 所處 ENS Region 必須與 ens_region_id 一致。

    ["vsw-xxx", "vsw-yyy"]

    string

    否

    虛擬交換器 ID 列表。

    vsw-xxxxxxxxx
    PodVswitchIds

    array

    否

    每個 Pod 虛擬交換器分別對應一個 Worker 節點的虛擬交換器，Pod 虛擬交換器和 Worker 節點的虛擬交換器的可用性區域需保持一致。如果不填，預設使用 vswitch_ids。

    string

    否

    Pod 虛擬交換器 ID 列表。

    vsw-xxxxxxxx
    ContainerCidr

    string

    否

    Pod 網路位址區段，必須是有效私人網段，即以下網段及其子網：10.0.0.0/8、172.16-31.0.0/12-16、192.168.0.0/16。不能與 VPC 及 VPC 內已有 Kubernetes 叢集使用的網段重複，建立成功後不能修改。

    172.20.0.0/16
    ServiceCidr

    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
    PublicAccess

    boolean

    否

    是否開啟公網訪問。通過 EIP 暴露 API Server，實現叢集公網訪問。 ● true：開啟公網訪問。 ● false：不開啟公網訪問。選擇不開放時，則無法通過外網訪問叢集 API Server。 預設值：false。

    true
    LoadBalancerId

    string

    否

    指定用於 APIServer 訪問的 CLB 執行個體 ID。指定該參數時，將不再自動建立 APIServer CLB。

    lb-wz9t256gqa3vbouk****
    ControlPlaneConfig

    object

    否

    控制平面配置。

    InstanceSpec

    string

    否

    節點執行個體類型。

    ens.esk.sn1.medium
    ImageId

    string

    否

    控制面虛擬機器鏡像 ID。

    m-5ul335umat4e2y9ynwi84p3f9
    SystemDiskCategory

    string

    否

    節點系統硬碟類型，可選類型："local_ssd", "cloud_ssd", "cloud_efficiency", "local_hdd"。

    cloud_efficiency
    SystemDiskSize

    integer

    否

    節點系統硬碟大小。

    120
    Runtime

    string

    否

    控制面節點運行時名稱。

    containerd
    NodePortRange

    string

    否

    節點服務連接埠範圍。

    30000-32767
    Size

    integer

    否

    控制面節點數量，可選值 3 或 5。

    3
    LoginPassword

    string

    否

    叢集控制面機器登入密碼。

    ThisIsAPassword

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    響應結構體。

    RequestId

    string

    請求 ID。

    C0003E8B-B930-4F59-ADC0-0E209A9012A8
    ClusterId

    string

    執行個體 ID。

    c34b69b095f8241c5a91cc2252dceb976

    樣本

    正常返回樣本

    JSON格式

    {
  "RequestId": "C0003E8B-B930-4F59-ADC0-0E209A9012A8",
  "ClusterId": "c34b69b095f8241c5a91cc2252dceb976"
}

    錯誤碼

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

    變更歷史

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