Todos os produtos
Search
Central de documentação

Container Service for Kubernetes:nodepool

Última atualização: Jul 17, 2026

Parâmetro

Tipo

Descrição

Exemplo

object

O pool de nós.

auto_scaling

object

A configuração de auto scaling para o pool de nós.

enable

boolean

Especifica se o auto scaling deve ser ativado.

  • true: Ativa o auto scaling para o pool de nós.

  • false: Desativa o auto scaling. Quando definido como false, outros parâmetros de configuração em auto_scaling não entram em vigor.

Valor padrão: false.

true

max_instances

integer

O número máximo de instâncias no grupo de auto scaling.

10

min_instances

integer

O número mínimo de instâncias no grupo de auto scaling.

0

type

string

O tipo de auto scaling, classificado por tipo de instância. Valores válidos:

  • cpu: tipo de instância regular.

  • gpu: tipo de instância GPU.

  • gpushare: tipo compartilhado de GPU.

  • spot: tipo de instância spot.

Valor padrão: cpu.

cpu

is_bond_eip

boolean

[Este campo está obsoleto]

Especifica se um EIP deve ser associado. Valores válidos:

  • true: Associa um EIP.

  • false: Não associa um EIP.

Valor padrão: false.

true

eip_internet_charge_type

string

[Este campo está obsoleto]

O método de cobrança do EIP. Valores válidos:

  • PayByBandwidth: cobrança por largura de banda.

  • PayByTraffic: cobrança por transferência de dados.

Valor padrão: PayByBandwidth.

PayByBandwidth

eip_bandwidth

integer

[Este campo está obsoleto]

A largura de banda de pico do EIP. Unidade: Mbit/s.

5

kubernetes_config

object

A configuração relacionada ao cluster.

cms_enabled

boolean

Especifica se o agente do CloudMonitor deve ser instalado nos nós ECS. Após a instalação, você pode visualizar informações de monitoramento das instâncias ECS criadas no console do CloudMonitor. Recomendamos que você ative esse recurso. Valores válidos:

  • true: Instala o agente do CloudMonitor nos nós ECS.

  • false: Não instala o agente do CloudMonitor nos nós ECS.

Valor padrão: false.

true

cpu_policy

string

A política de gerenciamento de CPU para nós. As duas políticas a seguir são suportadas para versões de cluster 1.12.6 e posteriores:

  • static: Permite que pods com determinadas características de recursos no nó recebam afinidade e exclusividade aprimoradas de CPU.

  • none: Habilita o esquema de afinidade de CPU padrão existente.

Valor padrão: none.

none

labels

array

As labels de nó. Adiciona labels aos nós do cluster Kubernetes.

tag

A label de nó.

runtime

string

O runtime de contêiner. Valores válidos:

  • containerd: Recomendado. Suporta todas as versões de cluster.

  • Sandboxed-Container.runv: Contêiner em sandbox. Oferece maior isolamento. Suporta versões de cluster até a 1.24.

  • docker: Suporta versões de cluster até a 1.22.

Valor padrão: containerd

containerd

runtime_version

string

A versão do runtime de contêiner.

1.6.20

taints

array

A configuração de taint.

taint

A configuração de taint.

user_data

string

Os dados personalizados do nó.

MXM=

node_name_mode

string

O nome do nó consiste em três partes: prefixo + IP do nó + sufixo:

  • Tanto o prefixo quanto o sufixo podem consistir em uma ou mais partes separadas por ".". Cada parte pode conter letras minúsculas, dígitos e hifens (-). O nome do nó deve começar e terminar com uma letra minúscula ou dígito.

  • O IP do nó é o endereço IP privado completo do nó.

O parâmetro contém quatro partes separadas por vírgulas. Por exemplo, se você passar a string "customized,aliyun,ip,com" (onde "customized" e "ip" são strings fixas, "aliyun" é o prefixo e "com" é o sufixo), o nome do nó será: aliyun.192.168.xxx.xxx.com.

customized,aliyun,ip,com

nodepool_info

object

A configuração do pool de nós.

name

string

O nome do pool de nós.

np-test

resource_group_id

string

O ID do grupo de recursos ao qual o pool de nós pertence.

rg-acfmyvw3wjm****

type

string

O tipo de pool de nós. Valores válidos:

  • ess: pool de nós.

  • edge: pool de nós de borda.

ess

scaling_group

object

A configuração do grupo de scaling para o pool de nós.

auto_renew

boolean

Especifica se a renovação automática deve ser ativada para o pool de nós. Este parâmetro entra em vigor apenas quando instance_charge_type está definido como PrePaid. Valores válidos:

  • true: Ativa a renovação automática.

  • false: Desativa a renovação automática.

Valor padrão: true.

false

auto_renew_period

integer

O período de renovação automática para o pool de nós. Este parâmetro entra em vigor e é obrigatório apenas quando instance_charge_type está definido como PrePaid.

Quando PeriodUnit=Month, valores válidos: {1, 2, 3, 6, 12}.

Valor padrão: 1.

0

data_disks

array

A configuração de disco de dados em nuvem para os nós no pool de nós.

data_disk

A configuração de disco de dados em nuvem para os nós no pool de nós.

disk_init

array

A configuração de inicialização de dispositivo de bloco.

DiskInit

A configuração DiskInit.

image_id

string

O ID da imagem personalizada. A imagem fornecida pelo sistema é usada por padrão.

aliyun_2_1903_x64_20G_alibase_20200904.vhd

instance_charge_type

string

O método de cobrança para os nós no pool de nós. Valores válidos:

  • PrePaid: assinatura.

  • PostPaid: pay-as-you-go.

Valor padrão: PostPaid.

PostPaid

instance_types

array

Os tipos de instância.

string

Os tipos de instância.

ecs.n1.medium

key_pair

string

O nome do par de chaves. Especifique este parâmetro ou login_password.

Nota

Para pools de nós gerenciados, apenas key_pair é suportado.

np-key

login_password

string

A senha de logon SSH. Especifique este parâmetro ou key_pair. A senha deve ter de 8 a 30 caracteres e deve conter pelo menos três dos seguintes tipos de caracteres: letras maiúsculas, letras minúsculas, dígitos e caracteres especiais.

Hello1234

login_as_non_root

boolean

Especifica se as instâncias ECS expandidas fazem logon como um usuário não root.

period

integer

A duração da assinatura para os nós no pool de nós. Este parâmetro entra em vigor e é obrigatório apenas quando instance_charge_type está definido como PrePaid. Quando period_unit está definido como Month, valores válidos para period: {1, 2, 3, 6, 12}.

Valor padrão: 1.

0

period_unit

string

O ciclo de cobrança para os nós no pool de nós. Este parâmetro deve ser especificado quando instance_charge_type está definido como PrePaid.

Month: Atualmente, apenas a cobrança mensal é suportada.

Month

platform

string

A distribuição do sistema operacional. Valores válidos:

  • CentOS

  • AliyunLinux

  • Windows

  • WindowsCore

Valor padrão: AliyunLinux.

AliyunLinux

rds_instances

array

A lista de instâncias RDS.

string

O ID da instância RDS.

rm-2zey3t89t6280****

spot_strategy

string

O tipo de instância spot. Valores válidos:

  • NoSpot: instância não spot.

  • SpotWithPriceLimit: instância spot com limite de preço.

  • SpotAsPriceGo: o sistema oferece lances automaticamente pelo preço de mercado atual.

Para mais informações, consulte Instâncias spot.

NoSpot

spot_price_limit

array

A configuração de faixa de preço de mercado para um único tipo de instância spot.

object

instance_type

string

O tipo de instância spot.

ecs.c6.large

price_limit

string

O preço máximo por instância.

0.39

scaling_policy

string

O modo do grupo de scaling. Valores válidos:

  • release: modo padrão. Realiza scale-in ou scale-out criando ou liberando instâncias ECS com base no uso de recursos.

  • recycle: modo rápido. Realiza scale-in ou scale-out criando, parando ou iniciando instâncias ECS, o que melhora a velocidade das operações de scaling subsequentes. (Os recursos de computação não são cobrados durante o período de parada. Apenas taxas de armazenamento são cobradas, exceto para tipos de instância com disco local.)

Valor padrão: release.

release

security_group_id

string

O ID do grupo de segurança para o pool de nós. Especifique este parâmetro ou security_group_ids. Recomenda-se o uso de security_group_ids.

sg-2zeihch86ooz9io4****

security_group_ids

array

A lista de IDs de grupos de segurança. Especifique este parâmetro ou security_group_id. Recomenda-se o uso de security_group_ids. Quando ambos security_group_id e security_group_ids são especificados, security_group_ids tem precedência.

string

O ID do grupo de segurança.

sg-2zeihch86ooz9io4****

system_disk_category

string

O tipo do disco de sistema em nuvem para os nós. Valores válidos:

  • cloud_efficiency: disco em nuvem ultra.

  • cloud_ssd: SSD padrão.

  • cloud_essd: ESSD.

  • cloud_auto: disco em nuvem ESSD AutoPL.

  • cloud_essd_entry: disco ESSD Entry.

Valor padrão: cloud_efficiency.

cloud_efficiency

system_disk_categories

array

Os múltiplos tipos de disco para o disco de sistema em nuvem. Quando um tipo de disco de maior prioridade estiver indisponível, o sistema tentará automaticamente o próximo tipo de disco prioritário para criar o disco de sistema em nuvem. Valores válidos:

  • cloud: disco em nuvem básico.

  • cloud_efficiency: disco em nuvem ultra.

  • cloud_ssd: SSD padrão.

  • cloud_essd: ESSD.

string

O tipo do disco de sistema em nuvem para os nós.

cloud_essd

system_disk_size

integer

O tamanho do disco de sistema em nuvem para os nós. Unidade: GiB.

Valores válidos: [40,500].

120

system_disk_performance_level

string

O nível de desempenho do disco de sistema em nuvem para os nós. Aplica-se apenas a discos em nuvem ESSD.

  • PL0: desempenho moderado de I/O simultâneo máximo com latência de leitura/gravação relativamente estável.

  • PL1: desempenho moderado de I/O simultâneo máximo com latência de leitura/gravação relativamente estável.

  • PL2: alto desempenho de I/O simultâneo máximo com latência de leitura/gravação estável.

  • PL3: desempenho ultra-alto de I/O simultâneo máximo com latência de leitura/gravação extremamente estável.

PL1

system_disk_encrypted

boolean

Especifica se o disco de sistema em nuvem deve ser criptografado. Valores válidos: true: criptografado. false: não criptografado.

system_disk_kms_key_id

string

O ID da chave KMS usado para o disco de sistema em nuvem do nó.

0e478b7a-4262-4802-b8cb-00d3fb40****

system_disk_encrypt_algorithm

string

O algoritmo de criptografia para o disco de sistema em nuvem do nó. Valores válidos: aes-256.

aes-256

system_disk_provisioned_iops

integer

Os IOPS de leitura/gravação provisionados para o disco de sistema em nuvem do nó. Valores válidos: 0 a min{50.000, 1000 × capacidade - desempenho de linha de base}. Desempenho de linha de base = min{1.800 + 50 × capacidade, 50000}.

Este parâmetro é suportado apenas quando SystemDiskCategory está definido como cloud_auto. Para mais informações, consulte Discos em nuvem ESSD AutoPL.

1000

system_disk_bursting_enabled

boolean

Especifica se o burst (burst de desempenho) deve ser ativado para o disco de sistema em nuvem do nó. Valores válidos:

  • true: Ativado.

  • false: Desativado.

Este parâmetro é suportado apenas quando SystemDiskCategory está definido como cloud_auto. Para mais informações, consulte Discos em nuvem ESSD AutoPL.

true

tags

array

As tags que são adicionadas apenas às instâncias ECS.

As chaves de tag não podem ser duplicadas e podem ter até 128 caracteres. As chaves de tag e os valores de tag não podem começar com "aliyun" ou "acs:", nem conter "https://" ou "http://".

object

key

string

A chave da tag.

key

value

string

O valor da tag.

value

vswitch_ids

array

Os IDs de vSwitch.

string

Os IDs de vSwitch.

vsw-2ze0fmpbwo140ahni****

multi_az_policy

string

A política de scaling multizona para instâncias ECS no grupo de scaling. Valores válidos:

  • PRIORITY: Realiza scaling com base nos vSwitches (VSwitchIds.N) que você define. Quando instâncias ECS não puderem ser criadas na zona de um vSwitch de maior prioridade, o sistema usará automaticamente o próximo vSwitch prioritário para criar instâncias ECS.

  • COST_OPTIMIZED: Tenta criar instâncias em ordem de preço unitário de vCPU do menor para o maior. Quando a configuração de scaling especifica múltiplos tipos de instância com o método de cobrança spot, as instâncias spot são criadas primeiro. Você pode usar o parâmetro CompensateWithOnDemand para especificar se deve tentar automaticamente criar instâncias pay-as-you-go quando instâncias spot não puderem ser criadas devido a estoque insuficiente.

    Nota

    COST_OPTIMIZED entra em vigor apenas quando a configuração de scaling especifica múltiplos tipos de instância ou usa instâncias spot.

  • BALANCE: Distribui instâncias ECS uniformemente entre as zonas especificadas no grupo de scaling. Se as zonas ficarem desequilibradas devido a estoque insuficiente, você pode chamar a operação RebalanceInstances para reequilibrar os recursos. Para mais informações, consulte RebalanceInstances.

Valor padrão: PRIORITY.

COST_OPTIMIZED

on_demand_base_capacity

integer

O número mínimo de instâncias pay-as-you-go exigido pelo grupo de scaling. Valores válidos: [0,1000]. Quando o número de instâncias pay-as-you-go for menor que este valor, as instâncias pay-as-you-go serão criadas primeiro.

0

on_demand_percentage_above_base_capacity

integer

A porcentagem de instâncias pay-as-you-go entre as instâncias que excedem o número mínimo de instâncias pay-as-you-go (on_demand_base_capacity). Valores válidos: [0,100].

20

spot_instance_pools

integer

O número de tipos de instância disponíveis. O grupo de scaling cria instâncias spot entre os tipos de instância de menor custo de maneira equilibrada. Valores válidos: [1,10].

5

spot_instance_remedy

boolean

Especifica se a suplementação de instâncias spot deve ser ativada. Quando ativado, o grupo de scaling tenta criar novas instâncias para substituir instâncias spot que estão prestes a ser recuperadas. Valores válidos:

  • true: Ativa a suplementação de instâncias spot.

  • false: Desativa a suplementação de instâncias spot.

false

compensate_with_on_demand

boolean

Quando multi_az_policy está definido como COST_OPTIMIZED, especifica se permite a criação automática de instâncias pay-as-you-go para atender aos requisitos de quantidade de instâncias ECS quando instâncias spot não puderem ser criadas devido a motivos de preço ou estoque. Valores válidos:

  • true: Permite a criação automática de instâncias pay-as-you-go para atender aos requisitos de quantidade de instâncias ECS.

  • false: Não permite a criação automática de instâncias pay-as-you-go para atender aos requisitos de quantidade de instâncias ECS.

true

internet_charge_type

string

O método de cobrança para endereços IP públicos. Valores válidos:

  • PayByBandwidth: cobrança por largura de banda.

  • PayByTraffic: cobrança por transferência de dados.

PayByBandwidth

internet_max_bandwidth_out

integer

A largura de banda de saída máxima para endereços IP públicos do nó. Unidade: Mbit/s. Valores válidos: [1,100].

10

image_type

string

O tipo de imagem do sistema operacional. Especifique este parâmetro ou o parâmetro platform. Valores válidos:

  • AliyunLinux: Imagem Alinux2.

  • AliyunLinux3: Imagem Alinux3.

  • AliyunLinux3Arm64: Imagem Alinux3 ARM.

  • AliyunLinuxUEFI: Imagem Alinux2 UEFI.

  • CentOS: Imagem CentOS.

  • Windows: Imagem Windows.

  • WindowsCore: Imagem WindowsCore.

  • ContainerOS: Imagem otimizada para contêineres.

AliyunLinux

deploymentset_id

string

O ID do conjunto de implantação.

ds-bp1d19mmbsv3jf6xxxxx

desired_size

integer

O número desejado de nós no pool de nós.

2

private_pool_options

object

A configuração de pool privado de nós.

id

string

O ID do pool privado de nós.

eap-bp67acfmxazb4****

match_criteria

string

O tipo de pool privado de nós. A opção de capacidade de pool privado para inicialização de instância. Após uma garantia de elasticidade ou reserva de capacidade entrar em vigor, um pool privado é gerado para inicialização de instância. Valores válidos:

  • Open: modo aberto. Corresponde automaticamente à capacidade de pool privado do tipo aberto. Se nenhuma capacidade de pool privado correspondente estiver disponível, recursos de pool público são usados para inicialização de instância.

  • Target: modo direcionado. Usa a capacidade de pool privado especificada para inicialização de instância. Se a capacidade de pool privado especificada estiver indisponível, a instância falhará ao iniciar.

  • None: modo nenhum. A instância não usa capacidade de pool privado para inicialização.

Open

ram_role_name

string

O nome da função RAM Worker.

Importante Apenas clusters gerenciados ACK da versão 1.22 e posteriores suportam a configuração deste parâmetro ao criar um pool de nós.

example-role

instance_metadata_options InstanceMetadataOptions

A configuração de acesso a metadados para instâncias ECS. Este parâmetro está atualmente disponível apenas para usuários na whitelist. Abra um ticket para solicitar.

resource_pool_options

object

O pool de recursos e a política de pool de recursos usados ao criar instâncias. Observe o seguinte ao definir este parâmetro: Este parâmetro entra em vigor apenas ao criar instâncias pay-as-you-go. Este parâmetro não pode ser definido junto com private_pool_options.match_criteria ou private_pool_options.id.

strategy

string

A política de pool de recursos usada ao criar instâncias. Os pools de recursos incluem pools privados gerados após uma garantia de elasticidade ou reserva de capacidade entrar em vigor, e pools públicos, para inicialização de instância. Valores válidos: PrivatePoolFirst: pool privado primeiro. Quando esta política é selecionada e resource_pool_options.private_pool_ids é especificado, os pools privados especificados são usados primeiro. Se nenhum pool privado for especificado ou a capacidade do pool privado especificado for insuficiente, pools privados do tipo aberto são correspondidos automaticamente. Se nenhum pool privado correspondente estiver disponível, recursos de pool público são usados. PrivatePoolOnly: apenas pool privado. Quando esta política é selecionada, resource_pool_options.private_pool_ids deve ser especificado. Se a capacidade do pool privado especificado for insuficiente, a instância falhará ao iniciar. None: sem política de pool de recursos. Valor padrão: None.

PrivatePoolFirst

private_pool_ids

array

A lista de IDs de pool privado, que são IDs de garantia de elasticidade ou IDs de reserva de capacidade. Apenas IDs de pool privado do modo Target podem ser passados. Valores válidos de N: 1 a 20.

string

O ID do pool privado, que é o ID de uma garantia de elasticidade ou reserva de capacidade. Apenas IDs de pool privado no modo Target podem ser especificados para este parâmetro.

eap-bp67acfmxazb4****

cpu_options

object

As opções de configuração de CPU.

nested_virtualization

string

Especifica se a virtualização aninhada deve ser ativada. Valores válidos: disabled: Desativar virtualização aninhada. enabled: Ativar virtualização aninhada.

enabled

tee_config

object

A configuração de pool de nós de computação confidencial.

tee_enable

boolean

Especifica se o pool de nós é um pool de nós de computação confidencial.

false

management

object

A configuração de pool de nós gerenciado.

enable

boolean

Especifica se o pool de nós gerenciado deve ser ativado. Valores válidos:

  • true: Ativa o pool de nós gerenciado.

  • false: Desativa o pool de nós gerenciado. Outras configurações relacionadas entram em vigor apenas quando enable=true.

false

auto_repair

boolean

Especifica se o reparo automático deve ser ativado. Este parâmetro entra em vigor apenas quando enable=true.

  • true: Ativa o reparo automático.

  • false: Desativa o reparo automático.

false

upgrade_config

object

A configuração de upgrade automático. Este parâmetro entra em vigor apenas quando enable=true.

auto_upgrade

boolean

Especifica se a atualização automática deve ser ativada. Valores válidos:

  • true: Ativar atualização automática.

  • false: Desativar atualização automática.

false

surge

integer

O número de nós extras.

0

surge_percentage

integer

A porcentagem de nós extras. Este parâmetro é mutuamente exclusivo com surge.

0

max_unavailable

integer

O número máximo de nós indisponíveis. Valores válidos: [1,1000].

Valor padrão: 1.

0

auto_repair_policy

object

A política de reparo automático de nós.

restart_node

boolean

Especifica se a reinicialização do nó é permitida.

true

auto_vul_fix

boolean

Especifica se as CVEs devem ser corrigidas automaticamente.

true

auto_vul_fix_policy

object

A política de correção automática de CVE.

restart_node

boolean

Especifica se a reinicialização do nó é permitida.

true

vul_level

string

Os níveis de vulnerabilidade permitidos para.

asap,nntf

auto_upgrade

boolean

Especifica se o upgrade.

true

auto_upgrade_policy

object

The auto upgrade policy.

auto_upgrade_kubelet

boolean

Specifies whether to allow automatic kubelet upgrade.

true

auto_fault_diagnosis

boolean

Specifies whether to enable self-healing ECS fault detection for nodes.

drift_enabled

boolean

Specifies whether to enable node rotation. Only intelligent managed node pools support this feature, and it is enabled by default. Common node pools do not support this feature.

count

integer

This field 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 for node pools whose type is edge. Valid values:

  • basic: basic.

  • private: dedicated. Supported in version 1.22 and later.

basic

interconnect_config

object

This field is deprecated.

The edge node pool configuration.

cen_id

string

This field is deprecated.

The instance ID of the Cloud Enterprise Network (CEN) attached to the enhanced edge node pool.

cen-ey9k9nfhz0f*******

ccn_id

string

This field is deprecated.

The instance ID of the Cloud Connect Network (CCN) attached to the enhanced edge node pool.

ccn-qm5i0i0q9yi*******

ccn_region_id

string

This field is deprecated.

The region of the Cloud Connect Network (CCN) instance bound to the enhanced edge node pool.

cn-shanghai

bandwidth

integer

This field is deprecated.

The network bandwidth of the enhanced edge node pool. Unit: Mbps.

10

improved_period

string

This field is deprecated.

The purchase duration of the enhanced edge node pool. Unit: months.

1

max_nodes

integer

The maximum number of nodes allowed in the edge node pool. This value must be greater than or equal to 0. A value of 0 indicates no additional limit (the node pool is limited only by the maximum number of nodes the cluster can accommodate). Edge node pools typically have a value greater than 0. ESS-type node pools and default edge-type node pools have a value of 0.

10

node_config

object

The node configuration.

kubelet_configuration kubelet_config

The kubelet parameter settings.

node_components

array

The list of node components.

object

The node component.

name

string

The name of the node component.

kubelet

version

string

The version of the node component.

1.33.3-aliyun.1

config

object

The node component configuration.

custom_config

object

The custom node component configuration.

{"cpuManagerPolicy":"static"}

any

The custom node component configuration string.

cpuManagerPolicy