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，取值：

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

自动修复 CVE 策略。

是否启用自动升级，取值：

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

自动升级策略。

【该字段已废弃】请使用上层的auto_upgrade参数替代。

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

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

抢占实例市场价格区间配置。

操作系统发行版类型，推荐使用该字段指定节点操作系统。取值：

• 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 密钥 ID。

系统盘采用的加密算法。取值范围：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 云盘。

节点数据盘配置，取值范围[0,10]。最多支持添加 10 块数据盘。

密钥对名称，和login_password二选一。当节点池为托管版节点池时，只支持key_pair。

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

公网 IP 收费类型。取值：

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

节点公网 IP 出带宽最大值，单位为 Mbps（Mega bit per second），取值范围：[1,100]。

仅为 ECS 实例添加标签。

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

节点池期望节点数量。

节点池应该维持的总节点数量，建议至少配置 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 实例数量要求。

RDS 实例列表。

私有节点池配置。

【该字段已废弃】请使用image_type参数代替。

操作系统平台。取值：

• AliyunLinux
• CentOS
• Windows
• WindowsCore

实例属性配置。

节点池弹出 ECS 所属的部署集，仅对增量节点生效，存量节点的部署集不会变更。

安全组 ID 列表。

节点标签，为 Kubernetes 集群节点添加标签。标签定义规则：

• 标签由区分大小写的键值对组成，您最多可以设置 20 个标签。
• 标签键不可以重复，最长为 64 个字符；标签值可以为空，最长为 128 个字符。标签键和标签值都不能以aliyun、acs:、https://或http://开头。更多信息，请参见Labels and Selectors。

节点污点配置。

容器运行时名称，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 节点上安装云监控，安装后可以在云监控控制台查看所创建 ECS 实例的监控信息，推荐开启。取值：

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

默认值：false。

实例预自定义数据。节点加入集群前，将运行您指定的实例预自定义数据脚本。请参见User-Data 脚本。

是否开启加密计算集群，取值：

• true：开启。
• false：不开启。

默认值：false。