Todos os produtos
Search
Central de documentação

Container Service for Kubernetes:nodepool

Última atualização: Aug 21, 2026

Parâmetro

Tipo

Descrição

Exemplo

object

O pool de nós.

auto_scaling

object

A configuração do pool de nós com escalonamento automático.

enable

boolean

Especifica se o escalonamento automático deve ser ativado.

  • true: Ativa o recurso de escalonamento automático para o pool de nós.

  • false: Desativa o escalonamento automático. Se este parâmetro for definido como false, outros parâmetros de configuração em auto_scaling não terão efeito.

Valor padrão: false.

true

max_instances

integer

O número máximo de instâncias no grupo de escalonamento automático.

10

min_instances

integer

O número mínimo de instâncias no grupo de escalonamento automático.

0

type

string

O tipo de escalonamento automático, classificado por tipo de instância. Valores válidos:

  • cpu: tipo de instância regular.

  • gpu: tipo de instância GPU.

  • gpushare: tipo de compartilhamento de GPU.

  • spot: tipo de instância spot.

Valor padrão: cpu.

cpu

is_bond_eip

boolean

[Descontinuado]

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

[Descontinuado]

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

  • PayByBandwidth: pagamento por largura de banda.

  • PayByTraffic: pagamento por tráfego.

Valor padrão: PayByBandwidth.

PayByBandwidth

eip_bandwidth

integer

[Descontinuado]

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 sobre as instâncias ECS criadas no console do CloudMonitor. Recomendamos que você ative este 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 clusters da versão 1.12.6 ou posterior:

  • 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 que oferece maior isolamento. Suporta clusters da versão 1.24 ou anterior.

  • docker: Suporta clusters da versão 1.22 ou anterior.

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 escalonamento 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 ciclo de renovação automática do 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 do disco de dados em nuvem para os nós no pool de nós.

data_disk

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

disk_init

array

A configuração de inicialização do 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. Mutuamente exclusivo com login_password.

Nota

Se você criar um pool de nós gerenciado, apenas key_pair é suportado.

np-key

login_password

string

A senha de logon SSH. Mutuamente exclusiva com key_pair. A senha deve ter de 8 a 30 caracteres e 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 a instância ECS expandida usa um usuário não root para logon.

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

A unidade do período 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 mês é suportado como unidade.

Month

platform

string

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

  • CentOS

  • AliyunLinux

  • Windows

  • WindowsCore

Valor padrão: AliyunLinux.

AliyunLinux

instance_patterns

array

Os atributos da instância.

instance_patterns

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 faz lances automaticamente pelo preço de mercado atual.

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

NoSpot

spot_price_limit

array

As configurações de faixa de preço para uma única instância spot do tipo de instância atual.

object

instance_type

string

O tipo de instância spot.

ecs.c6.large

price_limit

string

O preço máximo para uma única instância.

0.39

scaling_policy

string

O padrão do grupo de escalonamento. Valores válidos:

  • release: padrão standard. Escalona horizontalmente criando ou liberando instâncias ECS com base no uso de recursos de computação.

  • recycle: padrão swift. Escalona horizontalmente criando, parando ou iniciando instâncias ECS, o que melhora a velocidade das operações de escalonamento subsequentes. Instâncias paradas não incorrem em cobranças de recursos de computação, mas as cobranças de armazenamento ainda se aplicam, exceto para instâncias com discos locais.

Valor padrão: release.

release

security_group_id

string

O ID do grupo de segurança do pool de nós. Use este parâmetro ou security_group_ids. Recomendamos que você use security_group_ids.

sg-2zeihch86ooz9io4****

security_group_ids

array

A lista de IDs de grupos de segurança. Use este parâmetro ou security_group_id. Recomendamos que você use security_group_ids. Se ambos security_group_id e security_group_ids forem especificados, security_group_ids terá precedência.

string

O ID do grupo de segurança.

sg-2zeihch86ooz9io4****

system_disk_category

string

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

  • cloud_efficiency: disco em nuvem ultra.

  • cloud_ssd: SSD padrão.

  • cloud_essd: ESSD.

  • cloud_auto: ESSD AutoPL.

  • cloud_essd_entry: disco ESSD Entry.

Valor padrão: cloud_efficiency.

cloud_efficiency

system_disk_categories

array

Múltiplos tipos de disco para o disco de sistema em nuvem. Se o 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 do nó.

cloud_essd

system_disk_size

integer

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

Valores válidos: [40,500].

120

system_disk_performance_level

string

O nível de desempenho do disco de sistema em nuvem do nó. Este parâmetro entra em vigor apenas para discos ESSD.

  • PL0: desempenho moderado de E/S simultânea máxima com latência de leitura/gravação relativamente estável.

  • PL1: desempenho moderado de E/S simultânea máxima com latência de leitura/gravação relativamente estável.

  • PL2: alto desempenho de E/S simultânea máxima com latência de leitura/gravação estável.

  • PL3: desempenho ultra-alto de E/S simultânea máxima 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: criptografar. false: não criptografar.

system_disk_kms_key_id

string

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

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

system_disk_encrypt_algorithm

string

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

aes-256

system_disk_provisioned_iops

integer

Os IOPS de leitura/gravação provisionados para o disco em nuvem do sistema do nó. Valores válidos: 0~min{50.000, 1000*capacidade-desempenho base}. Desempenho 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 deve ativar o burst (burst de desempenho) para o disco em nuvem do sistema do nó. Valores válidos:

  • true: Ativar.

  • false: Desativar.

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

Tags adicionadas apenas a instâncias ECS.

As chaves de tag não podem ser duplicadas e têm um comprimento máximo de 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.

chave

value

string

O valor da tag.

valor

vswitch_ids

array

Os IDs dos vSwitches.

string

Os IDs dos vSwitches.

vsw-2ze0fmpbwo140ahni****

multi_az_policy

string

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

  • PRIORITY: Escalona com base nos vSwitches (VSwitchIds.N) que você define. Quando não é possível criar instâncias ECS na zona de um vSwitch de maior prioridade, o sistema usa automaticamente o próximo vSwitch por prioridade para criar as instâncias ECS.

  • COST_OPTIMIZED: Tenta criar instâncias em ordem crescente de preço unitário de vCPU. Quando a configuração de escalonamento define vários tipos de instância com métodos 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 não for possível criar instâncias spot devido a estoque insuficiente.

    Nota

    COST_OPTIMIZED entra em vigor apenas quando vários tipos de instância são definidos na configuração de escalonamento ou quando instâncias spot são selecionadas.

  • BALANCE: Distribui instâncias ECS uniformemente entre as múltiplas zonas ativas especificadas no grupo de escalonamento. Se as zonas ficarem desbalanceadas devido a estoque insuficiente, você pode chamar a operação de API 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 necessário no grupo de escalonamento. Valores válidos: [0,1000]. Quando o número de instâncias pay-as-you-go for inferior a 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) no grupo de escalonamento. Valores válidos: [0,100].

20

spot_instance_pools

integer

O número de tipos de instância disponíveis. O grupo de escalonamento cria instâncias spot entre vários tipos com o menor custo. Valores válidos: [1,10].

5

spot_instance_remedy

boolean

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

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

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

false

compensate_with_on_demand

boolean

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

  • true: Permitir 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 permitir 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 tipo de cobrança para endereços IP públicos. Valores válidos:

  • PayByBandwidth: Cobrado por largura de banda fixa.

  • PayByTraffic: Cobrado pelo uso de tráfego.

PayByBandwidth

internet_max_bandwidth_out

integer

A largura de banda de saída máxima para o IP público do nó. Unidade: Mbps (Megabit por segundo). Valores válidos: [1,100].

10

image_type

string

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

  • AliyunLinux: Imagem Alinux2.

  • AliyunLinux3: Imagem Alinux3.

  • AliyunLinux3Arm64: Imagem Alinux3 para 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 do pool de nós privado.

id

string

O ID do pool de nós privado.

eap-bp67acfmxazb4****

match_criteria

string

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

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

  • Target: Modo direcionado. Usa a capacidade do pool privado especificado para iniciar instâncias. Se a capacidade do pool privado especificado não estiver disponível, a inicialização da instância falhará.

  • None: Modo não utilizar. A inicialização da instância não utiliza a capacidade do pool privado.

Open

ram_role_name

string

O nome da função RAM do Worker.

Importante Apenas clusters gerenciados ACK versão 1.22 ou posterior 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 contas na lista de permissões. Envie um ticket para solicitar acesso.

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âncias. 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 se a capacidade do pool privado especificado for insuficiente, pools privados do tipo aberto serão correspondidos automaticamente. Se nenhum pool privado correspondente estiver disponível, os recursos do pool público serão usados para criar instâncias. 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 inicialização da instância falhará. None: Não usar 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 no modo Target podem ser passados. Valores válidos de N: 1 a 20.

string

O ID do pool privado, que é o ID da 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 deve ativar a virtualização aninhada. Valores válidos: disabled: Desativa a virtualização aninhada. enabled: Ativa a virtualização aninhada.

enabled

tee_config

object

A configuração do 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 do 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. Valores válidos:

  • true: Ativa o reparo automático.

  • false: Desativa o reparo automático.

false

upgrade_config

object

A configuração de atualização automática. 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: Ativa a atualização automática.

  • false: Desativa a 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ó deve ser permitida.

true

max_parallel_repairing_nodes

string

O número máximo de nós que podem ser reparados em paralelo quando existe um grande número de nós anormais no pool de nós. Você pode especificar um número (como 5, valores válidos: 1 a 100000) ou uma porcentagem (como 10%, valores válidos: 1% a 100%). Valor padrão: 1.

5

max_unhealthy_nodes_threshold

string

O limite de disjuntor de autocorreção. Quando o número ou a porcentagem de nós com falha excede esse limite, a autocorreção entra em estado de disjuntor e para de iniciar novas ações de reparo. Você pode especificar um número (como 10, valores válidos: 1 a 100000) ou uma porcentagem (como 20%, valores válidos: 1% a 100%). Valor padrão: 100%.

20%

auto_vul_fix

boolean

Especifica se a correção automática de CVE deve ser ativada.

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ó deve ser permitida.

true

vul_level

string

Os níveis de vulnerabilidade permitidos para correção automática, separados por vírgulas.

asap,nntf

auto_upgrade

boolean

Especifica se a atualização automática deve ser ativada.

true

auto_upgrade_policy

object

A política de atualização automática.

auto_upgrade_kubelet

boolean

Especifica se a atualização automática do kubelet deve ser permitida.

true

auto_fault_diagnosis

boolean

Especifica se a detecção de falhas de ECS para autocorreção de nós deve ser ativada.

drift_enabled

boolean

Especifica se a rotação de nós deve ser ativada. Apenas pools de nós gerenciados inteligentes suportam esse recurso, e ele é ativado por padrão. Pools de nós comuns não suportam esse recurso.

count

integer

[Deprecated] Use desired_size em vez disso.

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

1

interconnect_mode

string

O tipo de rede do pool de nós de borda. Este parâmetro é válido apenas para pools de nós cujo type é edge. Valores válidos:

  • basic: básico.

  • private: dedicado. Suportado na versão 1.22 e posteriores.

basic

interconnect_config

object

[Deprecated]

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

cen_id

string

[Deprecated]

O ID da instância da Cloud Enterprise Network (CEN) anexada ao pool de nós de borda aprimorado.

cen-ey9k9nfhz0f*******

ccn_id

string

[Deprecated]

O ID da instância da Cloud Connect Network (CCN) anexada ao pool de nós de borda aprimorado.

ccn-qm5i0i0q9yi*******

ccn_region_id

string

[Deprecated]

A região da instância da Cloud Connect Network (CCN) vinculada ao pool de nós de borda aprimorado.

cn-shanghai

bandwidth

integer

[Deprecated]

A largura de banda da rede do pool de nós de borda aprimorado. Unidade: Mbps.

10

improved_period

string

[Deprecated]

A duração da compra do pool de nós de borda aprimorado. Unidade: meses.

1

max_nodes

integer

O número máximo de nós permitidos no pool de nós de borda. Este parâmetro deve ser maior ou igual a 0. Um valor de 0 indica nenhum limite adicional (limitado apenas pelo número máximo de nós que o cluster pode acomodar, sem limite adicional no próprio pool de nós). Este parâmetro é tipicamente maior que 0 para pools de nós de borda. Para pools de nós do tipo ess e pools de nós de borda padrão, este parâmetro é 0.

10

node_config

object

A configuração do nó.

kubelet_configuration kubelet_config

As configurações de parâmetros do Kubelet.

node_components

array

A lista de componentes do nó.

object

O componente do nó.

name

string

O nome do componente do nó.

kubelet

version

string

A versão do componente do nó.

1.33.3-aliyun.1

config

object

A configuração do componente do nó.

custom_config

object

A configuração personalizada do componente do nó.

{"cpuManagerPolicy":"static"}

any

A string de configuração personalizada do componente do nó.

cpuManagerPolicy

envs

array

As variáveis de ambiente do componente do nó.

object

name

string

O nome da variável de ambiente.

LOG_LEVEL

value

string

O valor da variável de ambiente.

info