ModifyClusterNodePool

您可以根据节点池ID，调用ModifyClusterNodePool接口更新目标节点池的配置。

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

PUT /clusters/{ClusterId}/nodepools/{NodepoolId}

集群 ID。

节点池 ID。

请求体参数。

节点池配置。

节点池名称。

命名规则：由数字、汉字、英文字符或短划线（-）组成，长度范围 1~63 个字符，且不能以短划线（-）开头。

资源组 ID。

自动伸缩配置。

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

默认值：false。

自动伸缩类型，按照自动伸缩实例类型划分。取值：

默认值：cpu。

最大实例数。

最小实例数。

是否绑定 EIP，取值：

默认值：false。

EIP 计费类型，取值：

默认值：PayByBandwidth。

EIP 带宽峰值。

托管节点池配置。

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

默认值：false。

是否自动修复，仅当enable=true时生效。取值：

默认值：true。

自动修复节点策略。

是否允许重启节点，取值：

是否自动修复 CVE，取值：

自动修复 CVE 策略。

是否允许重启节点，取值：

允许自动修复的漏洞级别，以逗号分隔。

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

自动升级策略。

是否允许自动升级 kubelet，取值：

是否允许自动升级运行时，仅当auto_upgrade=true时生效。取值：

默认值为false

是否允许自动升级操作系统，仅当auto_upgrade=true时生效。取值：

默认值为false

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

是否启用自动升级：

默认值：true。

额外节点数量。升级的时候节点会不可用，您可以创建额外节点补偿集群的负载。

额外节点比例，和surge二选一。

最大不可用节点数量。

取值范围：[1,1000]

默认值：1。

扩容组配置。

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

虚拟交换机 ID。

节点实例规格列表，您可以选择多个实例规格作为备选，每个节点创建时，将从第一个规格开始尝试购买，直到创建成功。最终购买的实例规格可能随库存变化而不同。

实例规格。更多信息，请参见实例规格族。

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

默认值：PostPaid。

节点包年包月时长，当instance_charge_type取值为PrePaid时才生效且为必选值。

当PeriodUnit=Month时，取值范围：{1, 2 , 3, 6, 12, 24, 36, 48, 60}。

节点付费周期，当instance_charge_type取值为PrePaid时时候需要指定周期。

目前只支持以月为计时单位。

默认值：Month。

节点是否开启自动续费，当instance_charge_type取值为PrePaid时才生效。取值：

默认值：true。

节点自动续费周期。当instance_charge_type取值为PrePaid时才生效，且为必选值。

当PeriodUnit=Month时，取值范围：{1, 2 , 3, 6, 12}。

抢占式实例类型，取值：

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

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

抢占式实例规格。

单台实例上限价格。

单位：元/小时。

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

自定义镜像 ID。可通过DescribeKubernetesVersionMetadata查询系统支持的镜像，默认使用系统最新镜像。

节点系统盘类型，取值：

默认值：cloud_ssd。

系统盘的多磁盘类型。当无法使用高优先级的磁盘类型时，自动尝试下一优先级的磁盘类型创建系统盘。取值范围：cloud：普通云盘。cloud_efficiency：高效云盘。cloud_ssd：SSD 云盘。cloud_essd：ESSD 云盘。

节点系统盘类型

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

取值范围：[20,500]。

该参数的取值必须大于或者等于 max{20, ImageSize}。

默认值：max{40, 参数 ImageId 对应的镜像大小}。

节点系统盘磁盘性能等级， 仅对 ESSD 磁盘生效。磁盘性能等级和磁盘大小有关。更多信息，请参见 ESSD 云盘

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

系统盘使用的 KMS 密钥 ID。

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

节点系统盘预配置的读写 IOPS，磁盘类型为 cloud_auto 时配置。

节点系统盘是否开启 Burst（性能突发），磁盘类型为 cloud_auto 时配置。

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

节点数据盘配置。

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

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

公网 IP 收费类型。取值：

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

仅为 ECS 实例添加标签。

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

ECS 实例标签。

节点池期望节点数。

多可用区伸缩组 ECS 实例扩缩容策略。取值：

PRIORITY：根据您定义的虚拟交换机（VSwitchIds.N）扩缩容。当优先级较高的虚拟交换机所在可用区无法创建 ECS 实例时，自动使用下一优先级的虚拟交换机创建 ECS 实例。

COST_OPTIMIZED：按 vCPU 单价从低到高进行尝试创建。当伸缩配置设置了抢占式计费方式的多实例规格时，优先创建对应抢占式实例。您可以继续通过CompensateWithOnDemand参数指定当抢占式实例由于库存等原因无法创建时，是否自动尝试以按量付费的方式创建。

BALANCE：在伸缩组指定的多可用区之间均匀分配 ECS 实例。如果由于库存不足等原因可用区之间变得不平衡，您可以通过 API RebalanceInstances平衡资源。更多信息，请参见 RebalanceInstances 。

默认值：PRIORITY。

伸缩组模式，取值：

伸缩组所需要按量实例个数的最小值，取值范围：[0,1000]。当按量实例个数少于该值时，将优先创建按量实例。

伸缩组满足最小按量实例数（on_demand_base_capacity）要求后，超出的实例中按量实例应占的比例。取值范围：[0,100]。

指定可用实例规格的个数，伸缩组将按成本最低的多个规格均衡创建抢占式实例。取值范围：[1,10]。

是否开启补齐抢占式实例。开启后，当收到抢占式实例将被回收的系统消息时，伸缩组将尝试创建新的实例，替换掉将被回收的抢占式实例。取值：

当multi_az_policy取值为COST_OPTIMIZED时，如果因价格、库存等原因无法创建足够的抢占式实例，是否允许自动尝试创建按量实例满足 ECS 实例数量要求。取值：

RDS 实例列表。

RDS 实例 ID。如果指定了 RDS 实例列表，集群节点 ECS 会自动加入 RDS 访问白名单。

私有节点池配置。

私有节点池 ID。

私有节点池类型，实例启动的私有池容量选项。弹性保障服务或容量预定服务在生效后会生成私有池容量，供实例启动时选择。取值：

操作系统平台。取值：

集群相关配置。

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

节点标签。

节点污点配置。

节点污点配置。

容器运行时名称。

容器运行时版本。

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

默认值：none。

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

节点池自定义数据。更多信息，请参见生成实例自定义数据。

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

默认值：false。

加密计算集群配置。

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

默认值：false。

同步更新节点标签及污点。

是否并发。

返回体数据。

任务 ID。

节点池 ID。

请求 ID。

正常返回示例

JSON格式

访问错误中心查看更多错误码。