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