Container Service for Kubernetes：CreateClusterNodePool

節點池名稱。

節點池型別，取值範圍：

• ess：普通節點池（包含託管功能和自動彈性伸縮功能）。

• edge：邊緣節點池。

• lingjun：靈駿節點池。

• hybrid：混合雲節點池。

節點池的資源組 ID，節點池彈出的例項將屬於該資源組內。

一個資源只能歸屬於一個資源組。根據不同的業務場景，您可以將資源組對映為專案、應用或組織等概念。

是否啟用自動伸縮，取值：

• true：開啟節點池自動伸縮功能。當叢集的容量規劃無法滿足應用 Pod 排程時，ACK 會根據配置的最小和最大例項數自動擴縮節點資源。1.24 及以上版本的叢集預設啟用節點即時彈性； 1.24 以下版本的叢集預設啟用節點自動伸縮。更多資訊，請參見節點伸縮。

• false：不開啟自動伸縮，ACK 會根據配置的期望節點數調整節點池中的節點數，將節點數始終維持在期望節點數。

當取值為 false 時，auto_scaling內的其他配置引數將不生效。

預設值：false。

自動彈性伸縮例項型別。僅當enable=true生效，取值：

• cpu：普通例項型。

• gpu：GPU 例項型。

• gpushare：GPU 共享型。

• spot：搶佔式例項型。

預設值：cpu。

節點池中可伸縮的最大例項數，不包含您已有的例項。僅當enable=true生效。

取值範圍[min_instances, 2000]，預設值為 0。

節點池中可伸縮的最小例項數，不包含您已有的例項。僅當enable=true生效。

取值範圍[0, max_instances]，預設值為 0。

【該欄位已廢棄】該欄位已廢棄，請使用 internet_charge_type 和 internet_max_bandwidth_out 替代。

是否繫結 EIP。取值：

• true：繫結 EIP。

• false：不繫結 EIP。

預設值：false。

【該欄位已廢棄】請使用 internet_charge_type 和 internet_max_bandwidth_out 替代。

EIP 計費型別。取值：

• PayByBandwidth：按固定頻寬計費。

• PayByTraffic：按使用流量計費。

預設值：PayByBandwidth。

【該欄位已廢棄】請使用 internet_charge_type 和 internet_max_bandwidth_out 替代。

EIP 頻寬峰值。單位：Mbps。

是否開啟節點池的託管功能，取值：

• true：開啟託管功能。

• false：不開啟託管功能，只有當 enable=true 時，其他相關配置才生效。

預設值：false。

是否自動修復節點，僅當enable=true時生效。

• true：自動修復

• false：不自動修復

預設值為true

是否自動修復 CVE 漏洞，僅當enable=true時生效。

• true：允許自動修復 CVE。

• false：不允許自動修復 CVE。

預設值為true。

是否自動升級節點，僅當enable=true時生效。

• true：啟用自動升級。

• false：不啟用自動升級。

預設值為true。

節點池節點付費型別，取值：

• PrePaid：預付費例項。

• PostPaid：按量付費例項。

預設值：PostPaid。

節點池節點包年包月時長，僅當instance_charge_type取值為PrePaid時生效，且為必選值。

• 當period_unit=Week時，period取值範圍：{ 1、2、3、4}。

• 當period_unit=Month時，period 取值範圍：{1、2、3、4、5、6、7、8、9、12、24、36、48、60}。

節點池節點付費週期，僅當instance_charge_type取值為PrePaid時生效，且為必選值。

• Month：以月為計時單位。

• Week：以周為計算單位。

預設值：Month。

節點池節點是否開啟自動續費，當instance_charge_type取值為PrePaid時才生效。取值：

• true：自動續費。

• false：不自動續費。

預設值：false。

單次自動續費的續費時長。取值範圍：

• PeriodUnit=Week 時：1、2、3。

• PeriodUnit=Month 時：1、2、3、6、12、24、36、48、60。

預設值：1。

搶佔式例項型別。取值：

• NoSpot：非搶佔式例項。

• SpotWithPriceLimit：設定搶佔例項價格上限。

• SpotAsPriceGo：系統自動出價，跟隨當前市場實際價格。

更多資訊，請參見搶佔式例項。

作業系統映象型別，取值範圍：

• AliyunLinux：Alinux2 映象。

• AliyunLinuxSecurity：Alinux2 映象 UEFI 版。

• AliyunLinux3：Alinux3 映象。

• AliyunLinux3Arm64：Alinux3 映象 ARM 版。

• AliyunLinux3Security：Alinux3 映象 UEFI 版。

• CentOS：CentOS 映象。

• Windows：Windows 映象。

• WindowsCore：WindowsCore 映象。

• ContainerOS：容器最佳化映象。

• AliyunLinux3ContainerOptimized: Alinux3 映象容器最佳化版。

自定義映象 ID，預設使用系統提供的映象。

節點系統盤型別，取值：

• cloud_efficiency：高效雲盤。

• cloud_ssd：SSD 雲盤。

• cloud_essd：ESSD 雲盤。

• cloud_auto：ESSD AutoPL 雲盤。

• cloud_essd_entry：ESSD Entry 雲盤。

預設值：cloud_efficiency。

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

取值範圍：[20,2048]。

節點系統盤磁碟效能，只對 ESSD 磁碟生效。磁碟效能等級和磁碟大小有關。更多資訊，請參見 ESSD 雲盤。

• PL0：併發極限 I/O 效能中等，讀寫時延較為穩定。

• PL1：併發極限 I/O 效能中等，讀寫時延較為穩定。

• PL2：併發極限 I/O 效能較高，讀寫時延穩定。

• PL3：併發極限 I/O 效能極高，讀寫時延極穩定。

是否加密系統盤。取值範圍：

• true：加密。

• false：不加密。

系統盤使用的 KMS 金鑰 ID。

系統盤採用的加密演算法。取值範圍：aes-256。

節點系統盤是否開啟 Burst（效能突發）。 取值：

• true：是。

• false：否。

當system_disk_category取值為cloud_auto時才支援設定該引數。更多資訊，請參見ESSD AutoPL 雲盤。

節點系統盤預配置的讀寫 IOPS。

可能值：0~min{50,000, 1000*容量-基準效能}。 基準效能=min{1,800+50*容量, 50000}。

當system_disk_category取值為cloud_auto時才支援設定該引數。更多資訊，請參見ESSD AutoPL 雲盤。

免密登入金鑰對名稱，和login_password二選一。

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

彈出的 ECS 例項是否使用以非 root 使用者登入。

• true：以非 root 使用者（ecs-user）登入。

• false：以 root 使用者登入。

【已廢棄】請使用引數 security_hardening_os 替代。

是否開啟等保加固，僅當系統映象選擇 Alibaba Cloud Linux 2 或 Alibaba Cloud Linux 3 時，可為節點開啟等保加固。阿里云為 Alibaba Cloud Linux 2 和 Alibaba Cloud Linux 3 等保 2.0 三級版映象提供等保合規的基線檢查標準和掃描程式。

阿里雲 OS 安全加固。取值：

• true：開啟阿里雲 OS 安全加固。

• false：不開啟阿里雲 OS 安全加固。

預設值：false。

公網 IP 收費型別。取值：

• PayByBandwidth：按固定頻寬計費。

• PayByTraffic：按使用流量計費。

節點公網 IP 出頻寬最大值，單位為 Mbps（Mega bit per second），取值範圍：[1,100]

節點池期望節點數量。

節點池應該維持的總節點數量，建議至少配置 2 個節點，以確保叢集元件正常執行。您可以透過調整期望節點數，達到擴容或縮容節點池的目的。

如無需建立節點，可填寫為 0，後續再手動調整，增加節點數。

多可用區伸縮組 ECS 例項擴縮容策略。取值：

• PRIORITY：根據您定義的虛擬交換機（VSwitchIds.N）擴縮容。當優先順序較高的虛擬交換機所在可用區無法建立 ECS 例項時，自動使用下一優先順序的虛擬交換機建立 ECS 例項。

• COST_OPTIMIZED：按 vCPU 單價從低到高進行嘗試建立。當伸縮配置設定了搶佔式計費方式的多例項規格時，優先建立對應搶佔式例項。您可以繼續透過CompensateWithOnDemand引數指定當搶佔式例項由於庫存等原因無法建立時，是否自動嘗試以按量付費的方式建立。

  說明

  COST_OPTIMIZED僅在伸縮配置設定了多例項規格或者選用了搶佔式例項的情況下生效。

• BALANCE：在伸縮組指定的多可用區之間均勻分配 ECS 例項。如果由於庫存不足等原因可用區之間變得不平衡，您可以透過 API RebalanceInstances 平衡資源。

預設值：PRIORITY。

伸縮組模式，取值：

• release：標準模式，根據申請資源值的使用量，透過建立、釋放 ECS 的方式進行伸縮。

• recycle：極速模式，透過建立、停機、啟動的方式進行伸縮，提高再次伸縮的速度（停機時計算資源不收費，只收取儲存費用，本地盤機型除外）。

預設值：release。

伸縮組所需要按量例項個數的最小值，取值範圍：[0,1000]。當按量例項個數少於該值時，將優先建立按量例項。

伸縮組滿足最小按量例項數（on_demand_base_capacity）要求後，超出的例項中按量例項應占的比例。取值範圍：[0,100]。

指定可用例項規格的個數，伸縮組將按成本最低的多個規格均衡建立搶佔式例項。取值範圍：[1,10]。

是否開啟補齊搶佔式例項。開啟後，當收到搶佔式例項將被回收的系統訊息時，伸縮組將嘗試建立新的例項，替換掉將被回收的搶佔式例項。取值：

• true：開啟補齊搶佔式例項。

• false：不開啟補齊搶佔式例項。

當multi_az_policy取值為COST_OPTIMIZED時，如果因價格、庫存等原因無法建立足夠的搶佔式例項，是否允許自動嘗試建立按量例項滿足 ECS 例項數量要求。取值：

• true：允許自動嘗試建立按量例項滿足 ECS 例項數量要求。

• false：不允許自動嘗試建立按量例項滿足 ECS 例項數量要求。

部署集 ID。您可以使用部署集將節點池彈出的 ECS 例項分散部署在不同的物理伺服器上，以保證業務的高可用性和底層容災能力。在部署集內建立 ECS 例項時，根據事先設定的部署策略，分散啟動指定地域下的 ECS 例項。

節點池安全組 ID，與security_group_ids二選一，推薦使用security_group_ids。

【該欄位已廢棄】請使用image_type引數代替。

作業系統發行版。取值：

• CentOS

• AliyunLinux

• Windows

• WindowsCore

預設值：AliyunLinux。

Worker RAM 角色名稱。

• 為空時，將使用叢集預設建立的 Worker RAM 角色。

• 不為空時，指定的 RAM 角色必須是一個普通服務角色，並且它的可信服務配置必須是雲伺服器，更多資訊，請參見建立普通服務角色。當指定的 RAM 角色不是叢集預設建立的 Worker RAM 角色時，角色的名稱不能以KubernetesMasterRole-或KubernetesWorkerRole-開頭。

ECS 例項後設資料訪問配置。

系統盤快照策略。

Kubelet 引數配置。

容器執行時名稱，ACK 支援以下三種容器執行時。

• containerd：推薦使用，支援所有叢集版本。

• Sandboxed-Container.runv：安全沙箱容器，提供更高的隔離性，支援 1.31 及以下版本叢集。

• docker：已停止維護，支援 1.22 及以下版本叢集。

預設值：containerd。

容器執行時版本。

節點 CPU 管理策略。當叢集版本在 1.12.6 及以上時支援以下兩種策略：

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

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

預設值：none。

例項自定義資料。節點加入叢集后，將執行您指定的例項自定義資料指令碼。請參見User-Data 指令碼。

擴容後的節點是否不可排程。

• true：不可排程。

• false：可排程。

是否在 ECS 節點上安裝雲監控，安裝後可以在雲監控控制檯檢視所建立 ECS 例項的監控資訊，推薦開啟。取值：

• true：在 ECS 節點上安裝雲監控。

• false：不在 ECS 節點上安裝雲監控。

預設值：false。

自定義節點名稱。自定義節點名稱後，將同時更改節點名稱、ECS 例項名稱、ECS 例項 Hostname。

節點名稱由字首、節點 IP 地址及字尾三部分組成：

• 總長度為 2-64 個字元。節點名稱首尾必須為小寫字母和數字。

• 字首和字尾允許使用大小寫字母、數字、連字元（-）和點號（.）。必須以大小寫字母開頭，不能以連字元（-）或點號（.）開頭或結尾。不能連續使用連字元（-）或點號（.）。

• 字首必選（ECS 限制），字尾可選。

• 節點 IP 為完整的節點私網 IP 地址。

例如：節點 IP 地址為 192.XX.YY.55，指定字首為 aliyun.com，字尾為 test。

• 如果節點為 Linux 節點，則節點名稱、ECS 例項、ECS 例項 Hostname 均為 aliyun.com192.XX.YY.55test。

• 如果節點為 Windows 節點，則 ECS 例項 Hostname 為 192-XX-YY-55，節點名稱、ECS 例項名稱均為 aliyun.com192.XX.YY.55test。

例項預自定義資料。節點加入叢集前，將執行您指定的例項預自定義資料指令碼。請參見User-Data 指令碼。

是否開啟加密計算叢集。

• true：開啟加密計算。

• false：不開啟加密計算。

【該欄位已廢棄】

邊緣增強型節點池繫結的雲企業網例項 ID(CENID)。

【該欄位已廢棄】

邊緣增強型節點池繫結的雲連線網例項 ID(CCNID)。

【該欄位已廢棄】

邊緣增強型節點池繫結的雲連線網例項所屬的地域。

【該欄位已廢棄】

邊緣增強型節點池的網路頻寬，單位：Mbps。

【該欄位已廢棄】

邊緣增強型節點池的購買時長，單位：月。

建立靈駿節點池時需要關聯的靈駿叢集 ID。

建立靈駿節點池時需要關聯的靈駿叢集的靈駿分組 ID。

是否開啟智慧託管模式。 取值：

• true：開啟智慧託管模式，僅當叢集開啟智慧託管模式時可以開啟。

• false：不開啟智慧託管模式。