Container Service for Kubernetes:nodepool

Specifies whether to enable auto scaling.

• true: Enables the auto scaling feature for the node pool.

• false: Disables auto scaling. When set to false, other configuration parameters in auto_scaling do not take effect.

Default value: false.

The maximum number of instances in the auto scaling group.

The minimum number of instances in the auto scaling group.

The auto scaling type, classified by instance type. Valid values:

• cpu: regular instance type.

• gpu: GPU instance type.

• gpushare: GPU shared type.

• spot: spot instance type.

Default value: cpu.

[This field is deprecated]

Specifies whether to associate an EIP. Valid values:

• true: Associates an EIP.

• false: Does not associate an EIP.

Default value: false.

[This field is deprecated]

The billing method of the EIP. Valid values:

• PayByBandwidth: pay-by-bandwidth.

• PayByTraffic: pay-by-traffic.

Default value: PayByBandwidth.

[This field is deprecated]

The peak bandwidth of the EIP. Unit: Mbit/s.

Specifies whether to install the CloudMonitor agent on ECS nodes. After installation, you can view monitoring information of the created ECS instances in the CloudMonitor console. We recommend that you enable this feature. Valid values:

• true: Installs the CloudMonitor agent on ECS nodes.

• false: Does not install the CloudMonitor agent on ECS nodes.

Default value: false.

The CPU management policy for nodes. The following two policies are supported for cluster versions 1.12.6 and later:

• static: Allows pods with certain resource characteristics on the node to be granted enhanced CPU affinity and exclusivity.

• none: Enables the existing default CPU affinity scheme.

Default value: none.

The container runtime. Valid values:

• containerd: Recommended. Supports all cluster versions.

• Sandboxed-Container.runv: Sandboxed container that provides higher isolation. Supports cluster versions 1.24 and earlier.

• docker: Supports cluster versions 1.22 and earlier.

Default value: containerd

The container runtime version.

The node custom data.

The node name consists of three parts: prefix + node IP + suffix:

• Both the prefix and suffix can consist of one or more parts separated by ".". Each part can contain lowercase letters, digits, and hyphens (-). The node name must start and end with a lowercase letter or digit.

• The node IP is the complete private IP address of the node.

The parameter contains four parts separated by commas. For example, if you pass in the string "customized,aliyun,ip,com" (where "customized" and "ip" are fixed strings, "aliyun" is the prefix, and "com" is the suffix), the node name is: aliyun.192.168.xxx.xxx.com.

The node pool name.

The resource group ID of the node pool.

The node pool type. Valid values:

• ess: node pool.

• edge: edge node pool.

Specifies whether to enable auto-renewal for the node pool. This parameter takes effect only when instance_charge_type is set to PrePaid. Valid values:

• true: Enables auto-renewal.

• false: Disables auto-renewal.

Default value: true.

The auto-renewal period of the node pool. This parameter takes effect and is required only when instance_charge_type is set to PrePaid.

When PeriodUnit=Month, valid values: {1, 2, 3, 6, 12}.

Default value: 1.

The custom image ID. The system-provided image is used by default.

The billing method for nodes in the node pool. Valid values:

• PrePaid: subscription.

• PostPaid: pay-as-you-go.

Default value: PostPaid.

The key pair name. Choose either this or login_password.

The SSH logon password. Choose either this or key_pair. The password must be 8 to 30 characters in length and must contain at least three of the following character types: uppercase letters, lowercase letters, digits, and special characters.

Specifies whether the scaled-out ECS instance uses a non-root user for logon.

The subscription duration for nodes in the node pool. This parameter takes effect and is required only when instance_charge_type is set to PrePaid. When period_unit is set to Month, valid values for period: {1, 2, 3, 6, 12}.

Default value: 1.

The subscription period unit for nodes in the node pool. This parameter must be specified when instance_charge_type is set to PrePaid.

Month: Currently only month is supported as the unit.

The operating system distribution. Valid values:

• CentOS

• AliyunLinux

• Windows

• WindowsCore

Default value: AliyunLinux.

The type of spot instance. Valid values:

• NoSpot: non-spot instance.

• SpotWithPriceLimit: spot instance with a price limit.

• SpotAsPriceGo: system automatically bids at the current market price.

For more information, see Spot instances.

The scaling group mode. Valid values:

• release: standard mode. Scales by creating and releasing ECS instances based on resource usage.

• recycle: rapid mode. Scales by creating, stopping, and starting instances to improve subsequent scaling speed (compute resources are not charged during stop, only storage fees apply, except for local disk instance types).

Default value: release.

The security group ID of the node pool. Choose either this or security_group_ids. We recommend that you use security_group_ids.

The system cloud disk type for nodes. Valid values:

• cloud_efficiency: ultra cloud disk.

• cloud_ssd: standard SSD.

• cloud_essd: ESSD.

• cloud_auto: ESSD AutoPL cloud disk.

• cloud_essd_entry: ESSD Entry disk.

Default value: cloud_efficiency.

The node system cloud disk size. Unit: GiB.

Valid values: [40,500].

The performance level of the node system cloud disk. Only applies to ESSD cloud disks.

• PL0: moderate maximum concurrent I/O performance with relatively stable read/write latency.

• PL1: moderate maximum concurrent I/O performance with relatively stable read/write latency.

• PL2: high maximum concurrent I/O performance with stable read/write latency.

• PL3: ultra-high maximum concurrent I/O performance with extremely stable read/write latency.

Specifies whether to encrypt the system cloud disk. Valid values: true: encrypted. false: not encrypted.

The KMS key ID used for the node system cloud disk.

The encryption algorithm for the node system cloud disk. Valid values: aes-256.

The provisioned read/write IOPS for the node system cloud disk. Valid values: 0~min{50,000, 1000*capacity-baseline performance}. Baseline performance=min{1,800+50*capacity, 50000}.

This parameter is supported only when SystemDiskCategory is set to cloud_auto. For more information, see ESSD AutoPL cloud disks.

Specifies whether to enable burst (performance burst) for the node system cloud disk. Valid values:

• true: Enabled.

• false: Disabled.

This parameter is supported only when SystemDiskCategory is set to cloud_auto. For more information, see ESSD AutoPL cloud disks.

The multi-zone scaling policy for ECS instances in the scaling group. Valid values:

• PRIORITY: Scales based on the vSwitches (VSwitchIds.N) that you define. When ECS instances cannot be created in the zone of a higher-priority vSwitch, the system automatically uses the next-priority vSwitch to create ECS instances.

• COST_OPTIMIZED: Attempts to create instances in order of vCPU unit price from lowest to highest. When the scaling configuration specifies multiple instance types with spot billing methods, spot instances are created first. You can use the CompensateWithOnDemand parameter to specify whether to automatically attempt to create pay-as-you-go instances when spot instances cannot be created due to insufficient inventory or other reasons.

  Note

  COST_OPTIMIZED takes effect only when the scaling configuration specifies multiple instance types or uses spot instances.

• BALANCE: Evenly allocates ECS instances across the multiple active zones specified in the scaling group. If zones become unbalanced due to insufficient inventory or other reasons, you can use the API RebalanceInstances to rebalance resources. For more information, see RebalanceInstances.

Default value: PRIORITY.

The minimum number of pay-as-you-go instances required in the scaling group. Valid values: [0,1000]. When the number of pay-as-you-go instances is less than this value, pay-as-you-go instances are created first.

The percentage of pay-as-you-go instances among the instances that exceed the minimum number of pay-as-you-go instances (on_demand_base_capacity) in the scaling group. Valid values: [0,100].

The number of available instance types. The scaling group creates spot instances across the lowest-cost instance types in a balanced manner. Valid values: [1,10].

Specifies whether to enable supplementation of spot instances. When enabled, the scaling group attempts to create new instances to replace spot instances that are about to be reclaimed upon receiving a system notification. Valid values:

• true: Enables supplementation of spot instances.

• false: Disables supplementation of spot instances.

When multi_az_policy is set to COST_OPTIMIZED, specifies whether to allow automatic creation of pay-as-you-go instances to meet ECS instance quantity requirements when spot instances cannot be created due to price or inventory reasons. Valid values:

• true: Allows automatic creation of pay-as-you-go instances to meet ECS instance quantity requirements.

• false: Does not allow automatic creation of pay-as-you-go instances to meet ECS instance quantity requirements.

The billing method for public IP addresses. Valid values:

• PayByBandwidth: pay-by-bandwidth.

• PayByTraffic: pay-by-traffic.

The maximum outbound bandwidth for node public IP addresses. Unit: Mbit/s. Valid values: [1,100].

The operating system image type. Choose either this or the platform parameter. Valid values:

• AliyunLinux: Alinux2 image.

• AliyunLinux3: Alinux3 image.

• AliyunLinux3Arm64: Alinux3 image for ARM.

• AliyunLinuxUEFI: Alinux2 UEFI image.

• CentOS: CentOS image.

• Windows: Windows image.

• WindowsCore: WindowsCore image.

• ContainerOS: container-optimized image.

The deployment set ID.

The desired number of nodes in the node pool.

The Worker RAM role name.

The ECS instance metadata access configuration. Currently available only to accounts on the whitelist. Submit a ticket to apply for access.

Specifies whether this is a confidential computing node pool.

Specifies whether to enable the managed node pool. Valid values:

• true: Enables the managed node pool.

• false: Disables the managed node pool. Other related configurations take effect only when enable=true.

Specifies whether to enable auto repair. Takes effect only when enable=true.

• true: Enables auto repair.

• false: Disables auto repair.

Specifies whether to enable automatic CVE fix.

是否自动升级。

【该字段已废弃】

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

【该字段已废弃】

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

【该字段已废弃】

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

【该字段已废弃】

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

【该字段已废弃】

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

Kubelet 参数配置。