Parameter | Type | Description | Example |
---|---|---|---|
object | The node pool. | ||
auto_scaling | object | The auto scaling configurations of the node pool. | |
enable | boolean | Specifies whether to enable auto scaling for the node pool. Valid values:
Default value: | true |
max_instances | long | The maximum number of instances that can be created in a scaling group. | 10 |
min_instances | long | The minimum number of instances that must be kept in a scaling group. | 0 |
type | string | The instance types that can be used for the auto scaling of the node pool. Valid values:
Default value: | cpu |
is_bond_eipdeprecated | boolean | This parameter is deprecated. Specifies whether to associate an elastic IP Address (EIP) with the node pool. Valid values:
Default value: | true |
eip_internet_charge_typedeprecated | string | This parameter is deprecated. The metering method of the EIP. Valid values:
Default value: PayByBandwidth. | PayByBandwidth |
eip_bandwidthdeprecated | long | This parameter is deprecated. The maximum bandwidth of the EIP. Unit: Mbit/s. | 5 |
kubernetes_config | object | The configurations of the cluster. | |
cms_enabled | boolean | Specifies whether to install the CloudMonitor agent on Elastic Compute Service (ECS) nodes. After the CloudMonitor agent is installed on ECS nodes, you can view the monitoring information about the instances in the CloudMonitor console. We recommend that you install the CloudMonitor agent. Valid values:
Default value: | true |
cpu_policy | string | The CPU management policy of nodes in the node pool. The following policies are supported if the Kubernetes version of the cluster is 1.12.6 or later:
Default value: | none |
labels | array | The labels of the nodes in the node pool. You can add labels to the nodes in a Kubernetes cluster. | |
tag | The node label. | ||
runtime | string | The container runtime. Valid values:
Default value: | containerd |
runtime_version | string | The version of the container runtime. | 1.6.20 |
taints | array | The configurations of the taints. | |
taint | The configurations of the taints. | ||
user_data | string | The user data on the node. | MXM= |
node_name_mode | string | The custom node name. A custom node name consists of a prefix, a node IP address, and a suffix.
Set the parameter to a value that is in the customized,aliyun,ip,com format. The value consists of four parts that are separated by commas (,). customized and ip are fixed content. aliyun is the prefix and com is the suffix. Example: aliyun.192.168.xxx.xxx.com. | customized,aliyun,ip,com |
nodepool_info | object | The configuration of a node pool. | |
name | string | The name of the node pool. | np-test |
resource_group_id | string | The ID of the resource group to which the node pool belongs. | rg-acfmyvw3wjm**** |
type | string | The type of node pool. Valid values:
| ess |
scaling_group | object | The configurations of the scaling group that is used by the node pool. | |
auto_renew | boolean | Specifies whether to enable auto-renewal for the node pool. This parameter takes effect only if you set
Default value: | false |
auto_renew_period | long | The auto-renewal duration of the nodes in the node pool. This parameter is available and required only if you set If you set Default value: 1. | 0 |
data_disks | array | The configurations of the data disks that you want to attach to the nodes in the node pool. | |
data_disk | The configurations of the data disks that you want to attach to the nodes in the node pool. | ||
image_id | string | The custom image ID. By default, the image provided by ACK is used. | aliyun_2_1903_x64_20G_alibase_20200904.vhd |
instance_charge_type | string | The billing method of the nodes in the node pool. Valid values:
Default value: | PostPaid |
instance_types | array | The instance type. | |
string | The instance type. | ecs.n1.medium | |
key_pair | string | The name of the key pair. You must specify this parameter or the Note
If you want to create a managed node pool, you must specify key_pair .
| np-key |
login_password | string | The password for SSH logon. You must specify this parameter or the | Hello1234 |
login_as_non_root | boolean | Specifies whether to allow a non-root user to log on to an ECS instance that is added to the node pool. | |
period | long | The subscription duration of the nodes in the node pool. This parameter takes effect and is required only if you set Default value: 1. | 0 |
period_unit | string | The billing cycle of the nodes in the node pool. This parameter is required if you set Valid value: | Month |
platformdeprecated | string | The distribution of the operating system. Valid values:
Default value: | AliyunLinux |
rds_instances | array | A list of ApsaraDB RDS instances. | |
string | The ID of the ApsaraDB RDS instance. | rm-2zey3t89t6280**** | |
spot_strategy | string | The type of preemptible instance. Valid values:
For more information, see Preemptible Instance. | NoSpot |
spot_price_limit | array<object> | The instance type of preemptible instances and the price cap for the instance type. | |
object | |||
instance_type | string | The instance type of preemptible instances. | ecs.c6.large |
price_limit | string | The price cap of a preemptible instance. | 0.39 |
scaling_policy | string | The scaling mode of the scaling group. Valid values:
Default value: | release |
security_group_id | string | The ID of the security group to which you want to add the node pool. You must specify this parameter or the | sg-2zeihch86ooz9io4**** |
security_group_ids | array | The IDs of security groups. You must specify this parameter or | |
string | The ID of the security group. | sg-2zeihch86ooz9io4**** | |
system_disk_category | string | The type of the system disk. Valid values:
Default value: | cloud_efficiency |
system_disk_categories | array | The system disk types. The system creates system disks of a disk type with a lower priority if the disk type with a higher priority is unavailable. Valid values: cloud (basic disk), cloud_efficiency (ultra disk), cloud_ssd (standard SSD), and cloud_essd: (ESSD). | |
string | The system disk type. | ||
system_disk_size | long | The size of the system disk. Unit: GiB. Valid values: 40 to 500. | 120 |
system_disk_performance_level | string | The performance level (PL) of the system disk. This parameter takes effect only for an ESSD. Valid values:
| PL1 |
system_disk_encrypted | boolean | Specifies whether to encrypt the system disk. Valid values: true: encrypts the system disk. false: does not encrypt the system disk. | |
system_disk_kms_key_id | string | The ID of the Key Management Service (KMS) key that is used to encrypt the system disk. | 0e478b7a-4262-4802-b8cb-00d3fb40**** |
system_disk_encrypt_algorithm | string | The algorithm that you want to use to encrypt the system disk. Set the value to aes-256. | aes-256 |
system_disk_provisioned_iops | long | The preset read/write IOPS of the system disk. Valid values: 0 to min{50,000, 1,000 × Capacity - Baseline IOPS} Baseline IOPS = min{1,800 + 50 × Capacity, 50,000}. This parameter is available only if | 1000 |
system_disk_bursting_enabled | boolean | Specifies whether to enable the burst feature for the system disk. Valid values:
This parameter is available only if | true |
tags | array<object> | The labels that you want to add only to ECS instances. The tag key must be unique and can be up to 128 characters in length. The tag key and value must not start with aliyun or acs: or contain https:// or http://. | |
object | |||
key | string | The key of the label. | |
value | string | The value of the label. | |
vswitch_ids | array | The IDs of vSwitches. | |
string | The IDs of vSwitches. | vsw-2ze0fmpbwo140ahni**** | |
multi_az_policy | string | The ECS instance scaling policy for the multi-zone scaling group. Valid values:
Default value: | COST_OPTIMIZED |
on_demand_base_capacity | long | The minimum number of pay-as-you-go instances that must be kept in the scaling group. Valid values: 0 to 1000. If the number of pay-as-you-go instances is smaller than the value of this parameter, Auto Scaling preferably creates pay-as-you-go instances. | 0 |
on_demand_percentage_above_base_capacity | long | The percentage of pay-as-you-go instances among the extra instances that exceed the number specified by | 20 |
spot_instance_pools | long | The number of instance types that are available for creating preemptible instances. Auto Scaling creates preemptible instances of multiple instance types that are available at the lowest cost. Valid values: 1 to 10. | 5 |
spot_instance_remedy | boolean | Indicates whether preemptible instances can be supplemented. If you set this parameter to true, when the scaling group receives a system message indicating that a preemptible instance is to be reclaimed, the scaling group creates a new instance to replace this instance. Valid values:
| false |
compensate_with_on_demand | boolean | Specifies whether to automatically create pay-as-you-go instances to meet the required number of ECS instances if preemptible instances cannot be created due to reasons such as cost or insufficient inventory. This parameter takes effect if you set
| true |
internet_charge_type | string | The billing method of the public IP address. Valid values:
| PayByBandwidth |
internet_max_bandwidth_out | long | The maximum outbound bandwidth of the public IP address. Unit: Mbit/s. Valid values: 1 to 100. | 10 |
image_type | string | The type of the operating system image. You must specify this parameter or the platform parameter. Valid values:
| AliyunLinux |
deploymentset_id | string | The ID of the deployment set. | ds-bp1d19mmbsv3jf6xxxxx |
desired_size | long | The expected number of nodes in the node pool. | 2 |
private_pool_options | object | The configurations of the private node pool. | |
id | string | The ID of the private node pool. | eap-bp67acfmxazb4**** |
match_criteria | string | The type of the private node pool. This parameter specifies the type of the private node pool that you want to use to create instances. A private pool is generated when an elasticity assurance or a capacity reservation takes effect. The system selects a private pool to start instances. Valid values:
| Open |
ram_role_name | string | The name of the worker Resource Access Management (RAM) role. This parameter is available only to users in the whitelist. To use this parameter, submit a ticket. Note
You can configure this parameter when you create a node pool only for an ACK managed cluster that runs Kubernetes 1.22 or later.
| example-role |
tee_config | object | The configurations of confidential computing. | |
tee_enable | boolean | Specifies whether to enable confidential computing for the node pool. | false |
management | object | The configurations of the managed node pool feature. | |
enable | boolean | Indicates whether the managed node pool feature is enabled. Valid values:
| false |
auto_repair | boolean | Specifies whether to enable auto repair. This parameter takes effect only when you specify
| false |
upgrade_configdeprecated | object | The configurations of auto update. This parameter takes effect only if | |
auto_upgrade | boolean | Specifies whether to enable auto update. Valid values:
| false |
surge | long | The number of additional nodes. | 0 |
surge_percentage | long | The percentage of additional nodes to the nodes in the node pool. You must specify this parameter or the | 0 |
max_unavailable | long | The maximum number of unavailable nodes. Valid values: 1 to 1000. Default value: 1. | |
auto_repair_policy | object | The auto node repair policy. | |
restart_node | boolean | Indicates whether node restart is allowed. | true |
auto_vul_fix | boolean | Indicates whether CVE vulnerabilities are automatically patched. | true |
auto_vul_fix_policy | object | The automatic CVE patching policy. | |
restart_node | boolean | Indicates whether node restart is allowed. | true |
vul_level | string | The severity level of CVEs that can be automatically patched. Separate multiple levels with commas (,). | asap,nntf |
auto_upgrade | boolean | Indicates whether auto update is enabled. | true |
auto_upgrade_policy | object | The auto update policy. | |
auto_upgrade_kubelet | boolean | Indicates whether the kubelet is automatically updated. | true |
countdeprecated | long | This parameter is deprecated. Use desired_size instead. The number of nodes in the node pool. | 1 |
interconnect_mode | string | The network type of the edge node pool. This parameter takes effect only if you set the
| basic |
interconnect_configdeprecated | object | This parameter is deprecated. The configurations of the edge node pool. | |
cen_iddeprecated | string | This parameter is deprecated. The ID of the Cloud Enterprise Network (CEN) instance that is associated with the enhanced edge node pool. | cen-ey9k9nfhz0f******* |
ccn_iddeprecated | string | This parameter is deprecated. The ID of the Cloud Connect Network (CCN) instance that is associated with the enhanced edge node pool. | ccn-qm5i0i0q9yi******* |
ccn_region_iddeprecated | string | This parameter is deprecated. The region in which the CCN instance that is associated with the enhanced edge node pool resides. | cn-shanghai |
bandwidthdeprecated | long | This parameter is deprecated. The bandwidth of the enhanced edge node pool. Unit: Mbit/s. | 10 |
improved_perioddeprecated | string | This parameter is deprecated. The subscription duration of the enhanced edge node pool. The duration is measured in months. | 1 |
max_nodes | long | The maximum number of nodes that can be created in the edge node pool. The value of this parameter must be greater than or equal to 0. A value of 0 indicates that the number of nodes in the node pool is limited only by the quota of nodes in the cluster. In most cases, this parameter is set to a value larger than 0 for edge node pools. This parameter is set to 0 for node pools whose type is ess or default edge node pools. | 10 |
node_config | object | The node configurations. | |
kubelet_configuration | kubelet_config | The parameter settings of the kubelet. |