容器服务 Kubernetes 版 ACK：CreateClusterNodePool - 创建节点池

节点池名称。

节点池类型，取值范围：

• ess：普通节点池（包含托管功能和自动弹性伸缩功能）。
• edge：边缘节点池。
• lingjun：灵骏节点池。

节点池的资源组 ID，节点池弹出的实例将属于该资源组内。

是否启用自动伸缩。取值：

• true：开启节点池自动伸缩功能。
• false：不开启自动伸缩，当取值为 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。

【该字段已废弃】

是否绑定 EIP。取值：

• true：绑定 EIP。

• false：不绑定 EIP。

默认值：false。

【该字段已废弃】

EIP 计费类型。取值：

• PayByBandwidth：按固定带宽计费。
• PayByTraffic：按使用流量计费。

默认值：PayByBandwidth。

【该字段已废弃】

EIP 带宽峰值。单位：Mbps。

是否开启节点池的托管功能，取值：

• true：开启托管功能。

• false：不开启托管功能，只有当 enable=true 时，其他相关配置才生效。

默认值：false。

是否自动修复节点，仅当enable=true时生效。

• true：自动修复。

• false：不自动修复。

当enable=true时，默认值为true，当enable=false时，默认值为false

自动修复节点策略。

是否自动修复 CVE 漏洞，仅当enable=true时生效。

• true：允许自动修复 CVE。
• false：不允许自动修复 CVE。

当enable=true时，默认值为true，当enable=false时，默认值为false

自动修复 CVE 策略。

是否自动升级节点，仅当enable=true时生效。

• true：启用自动升级。
• false：不启用自动升级。

当enable=true时，默认值为true，当enable=false时，默认值为false

自动升级节点策略。

自动升级配置，仅当enable=true时生效。

虚拟交换机 ID 列表，取值范围：[1,8]。

节点池节点实例规格列表，节点池弹出节点时，将从指定的实例规格列表中，挑选出符合要求的实例规格弹出实例。支持的实例规格数量范围：[1,10]

节点池节点付费类型，取值：

• 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：系统自动出价，跟随当前市场实际价格。

更多信息，请参见抢占式实例。

当前单台抢占式实例规格市场价格区间配置。

操作系统镜像类型，和platform参数二选一，取值范围：

• AliyunLinux：Alinux2 镜像。
• AliyunLinuxSecurity：Alinux2 镜像 UEFI 版。
• AliyunLinux3：Alinux3 镜像。
• AliyunLinux3Arm64：Alinux3 镜像 ARM 版。
• AliyunLinux3Security：Alinux3 镜像 UEFI 版。
• CentOS：CentOS 镜像。
• Windows：Windows 镜像。
• WindowsCore：WindowsCore 镜像。
• ContainerOS：容器优化镜像。

自定义镜像 ID，默认使用系统提供的镜像。

节点系统盘类型，取值：

• cloud：普通云盘。
• cloud_efficiency：高效云盘。
• cloud_ssd：SSD 云盘。
• cloud_essd：ESSD 云盘。
• cloud_auto：ESSD AutoPL 云盘。
• cloud_essd_entry：ESSD Entry 云盘。

默认值：cloud_efficiency

系统盘的多磁盘类型。当无法使用高优先级的磁盘类型时，自动尝试下一优先级的磁盘类型创建系统盘。取值范围：

• cloud：普通云盘。
• cloud_efficiency：高效云盘。
• cloud_ssd：SSD 云盘。
• cloud_essd：ESSD 云盘。
• cloud_auto：ESSD AutoPL 云盘。
• cloud_essd_entry：ESSD Entry 云盘。

节点系统盘大小，单位：GiB。

取值范围：[20,20248]。

节点系统盘磁盘性能，只对 ESSD 磁盘生效。

• PL0：并发极限 I/O 性能中等，读写时延较为稳定。
• PL1：并发极限 I/O 性能中等，读写时延较为稳定。
• PL2：并发极限 I/O 性能较高，读写时延稳定。
• PL3：并发极限 I/O 性能极高，读写时延极稳定。

是否加密系统盘。取值范围：true：加密。false：不加密。

系统盘使用的 KMS 密钥 ID。

系统盘采用的加密算法。取值范围：aes-256。

节点系统盘是否开启 Burst（性能突发）。 取值：

• true：是。
• false：否。

当SystemDiskCategory取值为cloud_auto时才支持设置该参数。更多信息，请参见ESSD AutoPL 云盘。

节点系统盘预配置的读写 IOPS。可能值：0~min{50,000, 1000*容量-基准性能}。 基准性能=min{1,800+50*容量, 50000}。

当SystemDiskCategory取值为cloud_auto时才支持设置该参数。更多信息，请参见ESSD AutoPL 云盘。

节点池节点数据盘配置。

安全组 ID 列表，与security_group_id二选一，推荐使用security_group_ids，当同时指定security_group_id和security_group_ids将优先使用security_group_ids。

免密登录密钥对名称，和login_password二选一。

SSH 登录密码，和key_pair 二选一。密码规则为 8~30 个字符，且至少同时包含三项（大小写字母、数字和特殊符号）。

弹出的 ECS 实例是否使用以非 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]

仅为 ECS 实例添加标签。

标签键不可以重复，最大长度为 128 个字符；标签键和标签值都不能以“aliyun”、“acs:”开头，或包含“https://”、“http://”。

节点池期望节点数量。

多可用区伸缩组 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。

RDS 实例列表。

私有节点池配置。

节点池安全组 ID，与security_group_ids二选一，推荐使用security_group_ids。

操作系统发行版。取值：

• CentOS
• AliyunLinux
• Windows
• WindowsCore

默认值：AliyunLinux。

实例属性

Worker RAM 角色名称。

• 为空时，将使用集群默认创建的 Worker RAM 角色。
• 不为空时，指定的 RAM 角色必须是一个普通服务角色，并且它的可信服务配置必须是云服务器，更多信息，请参见创建普通服务角色。当指定的 RAM 角色不是集群默认创建的 Worker RAM 角色时，角色的名称不能以KubernetesMasterRole-或KubernetesWorkerRole-开头。

该参数目前仅白名单开放，如需使用，请提交工单申请。

Kubelet 参数配置。

节点标签，为 Kubernetes 集群节点添加标签。

污点配置。

容器运行时名称，ACK 支持以下三种容器运行时。

• containerd：推荐使用，支持所有集群版本。
• Sandboxed-Container.runv：安全沙箱容器，提供更高的隔离性，支持 1.24 版本及以下集群。
• docker：支持 1.22 版本及以下集群。

默认值：containerd。

容器运行时版本。

节点 CPU 管理策略。当集群版本在 1.12.6 及以上时支持以下两种策略：

• static：允许为节点上具有某些资源特征 Pod 增强其 CPU 亲和性和独占性。
• none：表示启用现有的默认 CPU 亲和性方案。

默认值：none。

节点自定义数据，将在节点完成初始化之后执行的脚本。

扩容后的节点是否可调度。

是否在 ECS 节点上安装云监控，安装后可以在云监控控制台查看所创建 ECS 实例的监控信息，推荐开启。取值：

• true：在 ECS 节点上安装云监控。

• false：不在 ECS 节点上安装云监控。

默认值：false。

节点名称由三部分组成：前缀 + 节点 IP + 后缀：

• 前缀和后缀均可由“.”分隔的一个或多个部分构成，每个部分可以使用小写字母、数字和“-”，节点名称首尾必须为小写字母和数字；
• 节点 IP 为完整的节点私网 IP 地址；

传参包含四个部分，由逗号分隔，例如：参数传入"customized,aliyun,ip,com"字符串（其中“customized”和"ip"为固定的字符串，aliyun 为前缀，com 为后缀），则节点的名称为：aliyun192.168.xxx.xxxcom。

节点预自定义数据，将在节点初始化之前执行的脚本。

是否开启加密计算集群。

【该字段已废弃】

边缘增强型节点池绑定的云企业网实例 ID(CENID)。

【该字段已废弃】

边缘增强型节点池绑定的云连接网实例 ID(CCNID)。

【该字段已废弃】

边缘增强型节点池绑定的云连接网实例所属的地域。

【该字段已废弃】

边缘增强型节点池的网络带宽，单位：Mbps。

【该字段已废弃】

边缘增强型节点池的购买时长，单位：月。