使用 CreateClusterNodePool API 建立ENS節點池 - 邊緣節點服務 ENS - 阿里雲 - ENS

節點池是具有相同屬性的一組節點的邏輯集合，允許對節點進行統一的管理和維運，例如節點升級、彈性伸縮等。您可以進一步使用節點池的自動化維運能力，使用 OS CVE 漏洞自動修復、故障節點自動恢復、kubelet 和 containerd 版本自動升級等功能，降低維運成本。您可以呼叫 CreateClusterNodePool 為叢集建立節點池。

介面說明

單一使用者呼叫頻率：每秒 10 次。
建立叢集是一個非同步操作，呼叫介面返回之後，需要等待 10~20 分鐘不等，等待叢集初始化完成。這個過程中可以呼叫 DescribeClustersV1 介面查詢叢集建立狀態。叢集建立成功之後，可以呼叫 DescribeClusterUserKubeconfig 取得叢集憑證。

調試

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

調試

授權資訊

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

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

操作

存取層級

資源類型

條件關鍵字

關聯操作

ens:CreateClusterNodePool

create

*全部資源。

*

無

請求參數

名稱	類型	必填	描述	樣本值
ClusterId	string	是	叢集 ID。	eck-xxxxxxxx
NodepoolInfo	object	是	節點池設定。
Name	string	是	節點池名稱。	test1
ScalingGroup	object	是	伸縮群組設定。
DesiredSize	integer	否	期望執行個體數。	3
KeyPairName	string	否	執行個體金鑰對（與 password 二選一）。	key-pair-name
VswitchIds	array	是	執行個體使用的 vswitch。
	string	否	叢集節點所在虛擬交換器 ID。vswitch_ids 所處 ENS Region 必須與 ens_region_id 一致。	vsw-58eu2p6v64qw8ihhit1wz7wgv
InstanceChargeType	string	否	執行個體計費類型。枚舉值： PostPaid : 按量付費。 PrePaid : 預付費。	PostPaid
InstanceTypes	array	是	節點池節點執行個體規格清單。
	string	否	執行個體規格。	ens.sn1.small
SystemDiskCategory	string	否	系統磁碟類型，列舉值：local_ssd、local_hdd、cloud_efficiency、cloud_ssd。枚舉值： cloud_efficiency : 高效雲端硬碟。 cloud_ssd : SSD 雲端硬碟。 local_hdd : 本機 HDD 磁碟。 local_ssd : 本機 SSD 磁碟。	cloud_efficiency
SystemDiskSize	integer	否	系統磁碟規格（單位 GB，最小 20，必須是 10 的倍數）。	80
ImageId	string	是	執行個體映像 ID。	m-6734fzvcwcv2o8jj201cpa7ox
DataDisks	array<object>	否	資料磁碟大小。
	object	否	磁碟類型。
Category	string	否	磁碟類型。枚舉值： cloud_efficiency : 高效雲端硬碟。 cloud_ssd : SSD 雲端硬碟。 local_hdd : 本機 HDD 磁碟。 local_ssd : 本機 SSD 磁碟。	cloud_efficiency
Size	integer	否	資料磁碟大小（單位 GB，最小 20G，以 10 為步長遞增）。	80
Password	string	否	節點池建立執行個體時使用的密碼，與金鑰對二選一。	some-test-password
KubernetesConfig	object	否	叢集相關設定。
PreUserData	string	否	機器建立後，接入叢集前執行的指令碼，內容需要 base64。	ZWNobyBvawo=
UserData	string	否	機器建立後，接入叢集後執行的指令碼，內容需要 base64。	ZWNobyBvawo=

返回參數

名稱	類型	描述	樣本值
	object	Schema of Response
Nodepool	object	節點池設定。
ClusterId	string	執行個體 ID。	eck-d2666c5f
NodepoolInfo	object	節點集區資訊。
Name	string	叢集名稱。	test1
EnsRegionId	string	叢集所在的 ENS Region ID	cn-guiyang-14
NodepoolId	string	節點池 ID。	np1176939548ac49e59febe82dcbf1ad56
ScalingGroup	object	新建立的伸縮群組所屬的資源群組 ID。
VswitchIds	array	叢集節點所在虛擬交換器 id。
	string	叢集節點所在虛擬交換器 id。	vsw-58eu2p6v64qw8ihhit1wz7wgv
DataDisks	array<object>	節點資料盤資訊。
	object	節點資料盤資訊。
Category	string	磁碟種類。	cloud_efficiency
Size	integer	資料盤大小規格，單位：GB。	80
InstanceChargeType	string	執行個體付費方式。	PrePaid
InstanceTypes	array	節點池節點執行個體規格列表。
	string	節點池節點執行個體規格。	ens.sn1.small
SystemDiskCategory	string	節點系統硬碟類型。	cloud_efficiency
SystemDiskSize	integer	系統硬碟大小規格，單位：GB。	80
ImageId	string	控制面虛擬機器鏡像 ID	m-67bdk1kpu1ylmt7k33h5dbiov
KeyPairName	string	金鑰組名稱。	key-pair-name
Password	string	執行個體登入密碼。	**********
KubernetesConfig	object	Kubernetes 相關設定。
PreUserData	string	執行個體建立後，接入叢集前執行的指令碼，內容需要 base64。	ZWNobyBvawo=
UserData	string	執行個體建立後，接入叢集後執行的指令碼，內容需要 base64。	ZWNobyBvawo=
Status	object	節點集區狀態資訊。
State	string	節點池狀態 active：已達終態 scaling：擴容中 removing_nodes：縮容中	active
TotalNodes	integer	總執行個體數（包含建立中、使用中、刪除中的）。	10
DesiredNodes	integer	期望執行個體數。	10
ServingNodes	integer	使用中的執行個體數。	10
InitialNodes	integer	建立中的執行個體數。	0
RemovingNodes	integer	刪除中的執行個體數。	0
FailedNodes	integer		0
RequestId	string	請求 ID。	C0003E8B-B930-4F59-ADC0-0E209A9012A8

樣本

正常返回樣本

JSON格式

{
  "Nodepool": {
    "ClusterId": "eck-d2666c5f",
    "NodepoolInfo": {
      "Name": "test1",
      "EnsRegionId": "cn-guiyang-14",
      "NodepoolId": "np1176939548ac49e59febe82dcbf1ad56"
    },
    "ScalingGroup": {
      "VswitchIds": [
        "vsw-58eu2p6v64qw8ihhit1wz7wgv"
      ],
      "DataDisks": [
        {
          "Category": "cloud_efficiency",
          "Size": 80
        }
      ],
      "InstanceChargeType": "PrePaid",
      "InstanceTypes": [
        "ens.sn1.small"
      ],
      "SystemDiskCategory": "cloud_efficiency",
      "SystemDiskSize": 80,
      "ImageId": "m-67bdk1kpu1ylmt7k33h5dbiov",
      "KeyPairName": "key-pair-name",
      "Password": "**********"
    },
    "KubernetesConfig": {
      "PreUserData": "ZWNobyBvawo=",
      "UserData": "ZWNobyBvawo="
    },
    "Status": {
      "State": "active",
      "TotalNodes": 10,
      "DesiredNodes": 10,
      "ServingNodes": 10,
      "InitialNodes": 0,
      "RemovingNodes": 0,
      "FailedNodes": 0
    }
  },
  "RequestId": "C0003E8B-B930-4F59-ADC0-0E209A9012A8"
}

錯誤碼

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

變更歷史

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