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 執行個體數量要求。 [parameters

部署集 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：不开启智能托管模式。