Container Service for Kubernetes：ModifyClusterNodePool - 修改節點池配置

節點池名稱。

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

節點池的資源群組 ID，節點池彈出的執行個體將屬於該資源群組內。

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

是否啟用自動調整，取值：

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

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

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

預設值：false。

自動調整類型，按照自動調整執行個體類型劃分。取值：

• 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 替代。

• true：綁定 EIP。

• false：不綁定 EIP。

預設值：false。

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

EIP 計費類型，取值：

• PayByBandwidth：按固定頻寬計費。

• PayByTraffic：按使用流量計費。

預設值：PayByBandwidth。

【該欄位已廢棄】請使用 internet_charge_type 和 internet_max_bandwidth_out 替代。 EIP 頻寬峰值。

取值範圍：[1,100]，單位：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。可通過DescribeKubernetesVersionMetadata查詢系統支援的鏡像，預設使用系統最新鏡像。

節點系統硬碟類型，取值：

• cloud_efficiency：高效雲端硬碟。

• cloud_ssd：SSD 雲端硬碟。

• cloud_essd：ESSD 雲端硬碟。

• cloud_auto：ESSD AutoPL 雲端硬碟。

• cloud_essd_entry：ESSD Entry 雲端硬碟。

預設值：cloud_efficiency。

節點系統硬碟大小，單位為 GiB。

取值範圍：[20,2048]。

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

預設值：max{40, 參數 ImageId 對應的鏡像大小}。

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

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

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

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

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

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

• true：加密。

• false：不加密。

系統硬碟使用的 KMS 金鑰識別碼。

系統硬碟採用的密碼編譯演算法。取值範圍：aes-256。

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

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

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

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

• true：開啟。開啟後，波動性業務面臨突發的資料讀寫壓力時，雲端硬碟會根據業務實際情況臨時提升雲端硬碟效能，直至業務恢複至平穩狀態。

• false：不開啟。

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

金鑰組名稱，和login_password二選一。當節點池為託管版節點池時，只支援key_pair。

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

公網 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平衡資源。更多資訊，請參見 RebalanceInstances 。

預設值：PRIORITY。

伸縮組模式，取值：

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

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

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

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

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

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

• true：開啟補齊搶佔式執行個體。

• false：不開啟補齊搶佔式執行個體。

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

• true：允許自動嘗試建立按量執行個體滿足 ECS 執行個體數量要求。

• false：不允許自動嘗試建立按量執行個體滿足 ECS 執行個體數量要求。

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

作業系統平台。取值：

• AliyunLinux

• CentOS

• Windows

• WindowsCore

節點池彈出 ECS 所屬的部署集，僅對增量節點生效，存量節點的部署集不會變更。

系統硬碟磁碟快照策略

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

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

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

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

預設值：containerd。

容器運行時版本。

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

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

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

預設值：none。

擴容後的節點是否不可調度。

• true：不可調度。

• false：可調度。

執行個體自訂資料。節點加入叢集後，將運行您指定的執行個體自訂資料指令碼。請參見User-Data 指令碼。

是否在 ECS 節點上安裝CloudMonitor，安裝後可以在CloudMonitor控制台查看所建立 ECS 執行個體的監控資訊，推薦開啟。取值：

• true：在 ECS 節點上安裝CloudMonitor。

• false：不在 ECS 節點上安裝CloudMonitor。

預設值：false。

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

自訂節點名稱參數。節點名稱由三部分組成：首碼 + 節點 IP + 尾碼

首碼和尾碼均可由“.”分隔的一個或多個部分構成，每個部分可以使用小寫字母、數字和“-”，節點名稱首尾必須為小寫字母和數字；節點 IP 為完整的節點私網 IP 位址；

傳參包含四個部分，由逗號分隔，例如：參數傳入"customized,aliyun,ip,com"字串（其中“customized”和"ip"為固定的字串，aliyun 為首碼，com 為尾碼），則節點的名稱為：aliyun.192.168.xxx.xxx.com。

是否開啟加密計算叢集，取值：

• true：開啟。

• false：不開啟。

預設值：false。