Todos os produtos
Search
Central de documentação

:Parâmetros comuns

Última atualização: Jul 09, 2026

addon

Configurações dos componentes do cluster.

Parâmetro

Tipo

Exemplo

Descrição

name

String

nginx-ingress-controller

Nome do componente.

config

String

{\"IngressSlbNetworkType\":\"internet\"}

Configurações do componente.

disabled

Boolean

false

Define se um componente é instalado automaticamente em um novo cluster. Além dos componentes obrigatórios, alguns opcionais, como os do Simple Log Service, também são instalados durante a criação do cluster. Defina este parâmetro para desativar a instalação automática de um componente opcional. Posteriormente, instale o componente pelo console ou chamando a API após a criação do cluster. Valores válidos:

  • true: desativa a instalação automática do componente.
  • false: permite a instalação automática do componente.

data_disk

Configurações dos discos de dados dos nós.

Parâmetro

Tipo

Exemplo

Descrição

category

String

cloud_ssd

Tipo do disco de dados. Valores válidos:

  • cloud: disco básico.
  • cloud_efficiency: disco ultra.
  • cloud_ssd: SSD padrão.
  • cloud_essd: SSD aprimorado.
  • cloud_auto: ESSD AutoPL.

Valor padrão: cloud_efficiency.

size

Long

40

Tamanho do disco de dados. Unidade: GiB.

Valores válidos: 40 a 32768.

Valor padrão: 120.

encrypted

String

true

Indica se o disco de dados deve ser criptografado. Valores válidos:

  • true: criptografa o disco de dados.
  • false: não criptografa o disco de dados.

Valor padrão: false.

auto_snapshot_policy_id

String

sp-2zej1nogjvovnz4z****

ID da política de snapshot automático. O backup automático do disco ocorre conforme a política especificada.

Por padrão, este parâmetro está vazio, o que indica que o backup automático está desativado.

performance_level

String

PL1

Nível de desempenho (PL) do disco de dados. Este parâmetro aplica-se apenas a SSDs aprimorados. É possível especificar um PL mais alto ao aumentar o tamanho do disco. Para mais informações, consulte SSDs aprimorados.

provisioned_iops

Long

1000

IOPS predefinido do disco de dados. Valores válidos: 0 a min{50.000, 1.000 × Capacidade - IOPS de base}. IOPS de base = min{1.800 + 50 × Capacidade, 50.000}

Este parâmetro tem suporte apenas quando DiskCategory está definido como cloud_auto. Para mais informações, consulte Discos ESSD AutoPL.

bursting_enabled

Boolean

true

Define se o recurso de burst deve ser ativado para o disco de dados. Valores válidos:

  • true: ativa o recurso de burst para o disco de dados.
  • false: desativa o recurso de burst para o disco de dados.

Tem suporte apenas quando DiskCategory está definido como cloud_auto. Para mais informações, consulte Discos ESSD AutoPL.

maintenance_window

Configurações da janela de manutenção do cluster.

Parâmetro

Tipo

Exemplo

Descrição

enable

Boolean

false

Define se a janela de manutenção do cluster deve ser ativada. Valores válidos:

  • true: ativa a janela de manutenção do cluster.
  • false: desativa a janela de manutenção do cluster.

Valor padrão: false.

maintenance_time

String

03:00:00Z

Hora de início da janela de manutenção do cluster. O valor deve estar no formato de tempo padrão do Golang. Exemplo: 15:04:05Z.

duration

String

3h

Duração da janela de manutenção do cluster. Varia de 1 a 24 horas. Unidade: h.

Valor padrão: 3h.

weekly_period

String

Monday,Thursday

Dias da semana em que a manutenção ocorre. Separe vários dias por vírgulas (,). Valores válidos: Monday, Tuesday, Wednesday, Thursday, Friday, Saturday e Sunday.

Valor padrão: Thursday.

nodepool

Configurações dos pools de nós.

Parâmetro

Tipo

Exemplo

Descrição

auto_scaling

Object

Configuração de auto scaling do pool de nós.

enable

Boolean

true

Define se o auto scaling deve ser ativado para o pool de nós.

  • true: ativa o auto scaling para o pool de nós.
  • false: desativa o auto scaling para o pool de nós. Se definido como false, os demais parâmetros da seção auto_scaling não terão efeito.

Valor padrão: false.

max_instances

Long

10

Número máximo de instâncias do Elastic Compute Service (ECS) que podem ser criadas no pool de nós.

min_instances

Long

0

Número mínimo de instâncias ECS a serem mantidas no pool de nós.

type

String

cpu

Tipos de instância utilizáveis para o auto scaling do pool de nós. Valores válidos:

  • cpu: instância regular.
  • gpu: instância acelerada por GPU.
  • gpushare: instância acelerada por GPU compartilhada.
  • spot: instância preemptível.

Valor padrão: cpu.

is_bond_eip

Boolean

true

Este parâmetro foi descontinuado.

Define se um EIP deve ser associado ao pool de nós. Valores válidos:

  • true: associa um EIP ao pool de nós.
  • false: não associa um EIP ao pool de nós.

Valor padrão: false.

eip_internet_charge_type

String

PayByBandwidth

Este parâmetro foi descontinuado.

Método de medição do EIP. Valores válidos:

  • PayByBandwidth: pagamento por largura de banda.
  • PayByTraffic: pagamento por transferência de dados.

Valor padrão: PayByBandwidth.

eip_bandwidth

Long

5

Este parâmetro foi descontinuado.

Largura de banda máxima do EIP. Unidade: Mbit/s.

kubernetes_config

Object

Configuração do cluster onde o pool de nós está implantado.

cms_enabled

Boolean

true

Define se o agente do CloudMonitor deve ser instalado nos nós ECS. Após a instalação, é possível visualizar informações de monitoramento das instâncias no console do CloudMonitor. Recomendamos a instalação do agente. 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.

cpu_policy

String

none

Política de gerenciamento de CPU dos nós no pool. As políticas a seguir têm suporte se a versão do Kubernetes do cluster for 1.12.6 ou posterior.

  • static: concede afinidade e exclusividade aprimoradas de CPU a pods com características específicas de recursos no nó.
  • none: utiliza a afinidade de CPU padrão.

Valor padrão: none.

labels

Array of rótulo

Rótulos dos nós no pool de nós. Adicione rótulos aos nós do cluster.

runtime

String

containerd

Runtime de contêiner. Valores válidos:

  • containerd: tem suporte a todas as versões do Kubernetes. Recomendamos o uso do containerd.
  • Sandboxed-Container.runv: permite executar aplicações em contêineres sandbox, que oferecem maior segurança. Apenas o Kubernetes 1.24 e versões anteriores têm suporte ao Sandboxed-Container.
  • docker: tem suporte ao Kubernetes 1.22 e versões anteriores.

Valor padrão: containerd.

runtime_version

String

1.6.20

Versão do runtime de contêiner.

taints

Array of taint

Taints.

user_data

String

MXM=

Dados definidos pelo usuário no nó.

node_name_mode

String

customized,aliyun,ip,com

Um nome de nó personalizado consiste em um prefixo, um endereço IP do nó e um sufixo.

  • O prefixo e o sufixo podem conter várias partes separadas por pontos (.). Cada parte pode conter letras minúsculas, dígitos e hifens (-). Um nome de nó personalizado deve começar e terminar com um dígito ou letra minúscula.
  • O endereço IP do nó em um nome personalizado corresponde ao endereço IP privado do nó.

Defina o valor no formato customized,aliyun,ip,com. O valor consiste em quatro partes separadas por vírgulas (,). customized e ip são conteúdos fixos. aliyun é o prefixo e com é o sufixo. Exemplo: aliyun.192.168.xxx.xxx.com.

nodepool_info

Object

Configuração do pool de nós.

name

String

np-test

Nome do pool de nós.

resource_group_id

String

rg-acfmyvw3wjm****

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

type

String

ess

Tipo do pool de nós. Valores válidos:

  • ess: pool de nós.
  • edge: pool de nós de borda.

scaling_group

Object

Configuração do grupo de dimensionamento usado pelo pool de nós.

auto_renew

Boolean

false

Define se a renovação automática deve ser ativada para o pool de nós. Este parâmetro tem efeito 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.

auto_renew_period

Long

0

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

Se você especificar PeriodUnit=Month, os valores válidos são 1, 2, 3, 6 e 12.

Valor padrão: 1.

data_disks

Array of data_disk

Configurações dos discos de dados a serem anexados aos nós no pool de nós.

image_id

String

aliyun_2_1903_x64_20G_alibase_20200904.vhd

ID de uma imagem personalizada. Por padrão, a imagem fornecida pelo ACK é utilizada.

instance_charge_type

String

PostPaid

Método de faturamento dos nós no pool de nós. Valores válidos:

  • PrePaid: método de faturamento por assinatura.
  • PostPaid: método de pagamento conforme o uso.

Valor padrão: PostPaid.

instance_types

Array of String

ecs.n1.medium

Tipo da instância.

key_pair

String

np-key

Nome do par de chaves. Defina este parâmetro ou o parâmetro login_password.

Nota

É obrigatório definir key_pair se o pool de nós for gerenciado.

login_password

String

Hello1234

Senha para login SSH. Defina este parâmetro ou o parâmetro key_pair. A senha deve ter entre 8 e 30 caracteres e conter pelo menos três dos seguintes tipos: letras maiúsculas, letras minúsculas, dígitos e caracteres especiais.

period

Long

0

Duração da assinatura dos nós em um pool de nós. Este parâmetro entra em vigor e é obrigatório apenas quando instance_charge_type está definido como PrePaid. Os valores válidos para period são 1, 2, 3, 6 e 12 quando period_unit está definido como Month.

Valor padrão: 1.

period_unit

String

Month

Unidade da duração da assinatura. Este parâmetro é obrigatório quando instance_charge_type está definido como PrePaid.

Valor válido: Month.

platform

String

AliyunLinux

Versão do sistema operacional. Valores válidos:

  • CentOS
  • AliyunLinux
  • Windows
  • WindowsCore

Valor padrão: AliyunLinux.

rds_instances

Array of String

rm-2zey3t89t6280****

IDs das instâncias do ApsaraDB RDS.

spot_strategy

String

NoSpot

Tipo de instância preemptível. Valores válidos:

  • NoSpot: instância não preemptível.
  • SpotWithPriceLimit: instância preemptível configurada com o preço máximo de lance.
  • SpotAsPriceGo: instância preemptível na qual o sistema dá lances automaticamente com base no preço de mercado atual.

Para mais informações, consulte Instâncias preemptíveis.

spot_price_limit

Array

Tipo de instância para instâncias preemptíveis e limite de preço desse tipo.

instance_type

String

ecs.c6.large

Tipo de instância das instâncias preemptíveis.

price_limit

String

0,39

Preço máximo de lance de uma instância preemptível.

scaling_policy

String

release

Modo de dimensionamento do grupo de dimensionamento. Valores válidos:

  • release: modo padrão. Instâncias ECS são criadas e liberadas com base no uso de recursos.
  • recycle: modo rápido. Instâncias ECS são criadas, paradas ou iniciadas durante eventos de dimensionamento. Isso reduz o tempo necessário para o próximo evento de scale-out. Quando a instância está parada, cobra-se apenas pelo serviço de armazenamento. Não se aplica a instâncias ECS com discos locais anexados.

Valor padrão: release.

security_group_id

String

sg-2zeihch86ooz9io4****

Especifique o ID do grupo de segurança ao qual você deseja adicionar o pool de nós. Defina este parâmetro ou security_group_ids. Recomendamos definir security_group_ids.

security_group_ids

Array of String

sg-2zeihch86ooz9io4****

ID do grupo de segurança.

system_disk_category

String

cloud_efficiency

Tipo do disco do sistema. Valores válidos:

  • cloud_efficiency: disco ultra.
  • cloud_ssd: SSD padrão.
  • cloud_essd: SSD aprimorado.
  • cloud_auto: ESSD AutoPL.

Valor padrão: cloud_efficiency.

system_disk_size

Long

120

Tamanho do disco do sistema de um nó. Unidade: GiB.

Valores válidos: 40 a 500.

system_disk_performance_level

String

PL1

Nível de desempenho (PL) do disco do sistema a ser usado no nó. Este parâmetro tem efeito apenas para ESSDs.

  • PL0: desempenho máximo de E/S simultânea moderado e baixa latência de E/S.
  • PL1: desempenho máximo de E/S simultânea moderado e baixa latência de E/S.
  • PL2: alto desempenho máximo de E/S simultânea e baixa latência de E/S.
  • PL3: desempenho máximo de E/S simultânea ultra-alto e latência de E/S ultrabaixa.

system_disk_provisioned_iops

Long

1000

IOPS predefinido de um disco do sistema. Valores válidos: 0 a min{50.000, 1.000 × Capacidade - IOPS de base}. IOPS de base = min{1.800 + 50 × Capacidade, 50.000}

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

system_disk_bursting_enabled

Boolean

true

Define se o recurso de burst deve ser ativado para discos do sistema. Valores válidos:

  • true: ativa o recurso de burst.
  • false: desativa o recurso de burst.

Tem suporte apenas quando SystemDiskCategory está definido como cloud_auto. Para mais informações, consulte Discos ESSD AutoPL.

tags

Array

Rótulos a serem adicionados às instâncias ECS.

Cada chave deve ser única e não pode exceder 128 caracteres. Nem chaves nem valores podem começar com aliyun ou acs:. Nenhum deles pode conter https:// ou http://.

key

String

key

Chave de um rótulo.

value

String

value

Valor de um rótulo.

vswitch_ids

Array of String

vsw-2ze0fmpbwo140ahni****

IDs dos vSwitches.

multi_az_policy

String

COST_OPTIMIZED

Política de dimensionamento de instâncias ECS para um grupo de dimensionamento multizona. Valores válidos:

  • PRIORITY: o grupo de dimensionamento escala com base no parâmetro VSwitchIds.N. Se não for possível criar uma instância ECS na zona onde reside o vSwitch de maior prioridade, o Auto Scaling cria a instância ECS na zona do vSwitch com a próxima maior prioridade.

  • COST_OPTIMIZED: instâncias ECS são criadas com base no preço unitário da vCPU em ordem crescente. Instâncias preemptíveis têm preferência quando tipos de instância preemptível são especificados na configuração de dimensionamento. Defina o parâmetro CompensateWithOnDemand para especificar se instâncias de pagamento conforme o uso devem ser criadas automaticamente quando instâncias preemptíveis não puderem ser criadas devido a recursos insuficientes.

    Nota

    COST_OPTIMIZED é válido apenas quando vários tipos de instância são especificados ou pelo menos um tipo de instância preemptível é especificado.

  • BALANCE: instâncias ECS são distribuídas uniformemente entre várias zonas especificadas pelo grupo de dimensionamento. Se houver desequilíbrio de instâncias ECS entre várias zonas devido a estoque insuficiente, chame a operação RebalanceInstances do Auto Scaling para equilibrar a distribuição de instâncias entre as zonas. Para mais informações, consulte RebalanceInstances.

Valor padrão: PRIORITY.

on_demand_base_capacity

Long

0

Número mínimo de instâncias de pagamento conforme o uso a serem mantidas no grupo de dimensionamento. Valores válidos: 0 a 1000. Se o número de instâncias de pagamento conforme o uso for menor que o valor deste parâmetro, o Auto Scaling dará preferência à criação de instâncias de pagamento conforme o uso.

on_demand_percentage_above_base_capacity

Long

20

Percentual de instâncias de pagamento conforme o uso entre as instâncias extras que excedem o número especificado por on_demand_base_capacity. Valores válidos: 0 a 100.

spot_instance_pools

Long

5

Número de tipos de instância disponíveis para criar instâncias preemptíveis. O Auto Scaling cria instâncias preemptíveis de vários tipos de instância disponíveis com o menor custo. Valores válidos: 1 a 10.

spot_instance_remedy

Boolean

false

Define se instâncias preemptíveis devem ser suplementadas. Se definido como true, quando o grupo de dimensionamento recebe uma mensagem do sistema informando que uma instância preemptível será recuperada, ele tenta criar uma nova instância para substituí-la. Valores válidos:

  • true: ativa a suplementação de instâncias preemptíveis.
  • false: desativa a suplementação de instâncias preemptíveis.

compensate_with_on_demand

Boolean

true

Define se instâncias de pagamento conforme o uso devem ser criadas automaticamente para atender ao número necessário de instâncias ECS caso instâncias preemptíveis não possam ser criadas devido a custos ou estoque insuficiente. Este parâmetro tem efeito apenas quando multi_az_policy está definido como COST_OPTIMIZED. Valores válidos:

  • true: cria automaticamente instâncias de pagamento conforme o uso para atender ao número necessário de instâncias ECS se instâncias preemptíveis não puderem ser criadas.
  • false: não cria instâncias de pagamento conforme o uso para atender ao número necessário de instâncias ECS se instâncias preemptíveis não puderem ser criadas.

internet_charge_type

String

PayByBandwidth

Método de medição do endereço IP público. Valores válidos:

  • PayByBandwidth: pagamento por largura de banda.
  • PayByTraffic: pagamento por transferência de dados.

internet_max_bandwidth_out

Long

10

Largura de banda de saída máxima do endereço IP público do nó. Unidade: Mbit/s. Valores válidos: 1 a 100.

image_type

String

AliyunLinux

Tipo da imagem do SO. Especifique este parâmetro ou o parâmetro platform. Valores válidos:

  • AliyunLinux: Alinux2.
  • AliyunLinux3: Alinux3.
  • AliyunLinux3Arm64: Alinux3 ARM.
  • AliyunLinuxUEFI: Alinux2 UEFI.
  • CentOS: CentOS.
  • Windows: Windows.
  • WindowsCore: Windows Core.
  • ContainerOS: ContainerOS.

deploymentset_id

String

ds-bp1d19mmbsv3jf6xxxxx

ID do conjunto de implantação ao qual as instâncias ECS no pool de nós pertencem.

desired_size

Long

2

Número esperado de nós no pool de nós.

private_pool_options

Object

Configuração do pool de nós privado.

id

String

eap-bp67acfmxazb4****

ID do pool de nós privado.

match_criteria

String

Open

Tipo de pool de nós privado. Este parâmetro especifica o tipo de pool privado a ser usado para criar instâncias. Um pool de nós privado é gerado quando uma garantia de elasticidade ou um serviço de reserva de capacidade entra em vigor. O sistema seleciona um pool de nós privado para iniciar instâncias. Valores válidos:

  • Open: pool privado aberto. O sistema seleciona um pool de nós privado aberto para iniciar instâncias. Se nenhum pool de nós privado aberto correspondente estiver disponível, os recursos do pool de nós público serão utilizados.

  • Target: pool privado específico. O sistema usa os recursos do pool de nós privado especificado para iniciar instâncias. Se o pool de nós privado especificado estiver indisponível, as instâncias não poderão ser iniciadas.

  • None: nenhum pool privado é usado. Os recursos dos pools de nós privados não são utilizados para iniciar as instâncias.

tee_config

Object

Configuração de computação confidencial.

tee_enable

Boolean

false

Define se a computação confidencial deve ser ativada para o pool de nós.

management

Object

Configuração do recurso de pool de nós gerenciado.

enable

Boolean

false

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

  • true: ativa o recurso de pool de nós gerenciado.
  • false: desativa o recurso de pool de nós gerenciado. Outros parâmetros nesta seção têm efeito apenas quando enable=true é especificado.

auto_repair

Boolean

false

Define se o reparo automático deve ser ativado. Este parâmetro tem efeito apenas quando você especifica enable=true. Valores válidos:

  • true: ativa o reparo automático.
  • false: desativa o reparo automático.

upgrade_config

Object

Configuração de atualização automática. A configuração tem efeito apenas quando enable=true é especificado.

auto_upgrade

Boolean

false

Define 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.

surge

Long

0

Número de nós adicionais.

surge_percentage

Long

0

Percentual de nós adicionais em relação aos nós no pool de nós. Defina este parâmetro ou surge.

max_unavailable

Long

0

Número máximo de nós que podem estar no estado Indisponível. Valores válidos: 1 a 1000.

Valor padrão: 1.

count

Long

1

Este parâmetro foi descontinuado. Use o parâmetro desired_size em seu lugar.

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

interconnect_mode

String

basic

Tipo de rede do pool de nós de borda. Este parâmetro tem efeito apenas quando você define o parâmetro type do pool de nós como edge. Valores válidos:

  • basic: básico.
  • improved: aprimorado.
  • private: dedicado. Apenas o Kubernetes 1.22 e versões posteriores têm suporte a este parâmetro.

interconnect_config

Object

Este parâmetro foi descontinuado.

Configurações do pool de nós de borda.

cen_id

String

cen-ey9k9nfhz0f***

Este parâmetro foi descontinuado.

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

ccn_id

String

ccn-qm5i0i0q9yi***

Este parâmetro foi descontinuado.

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

ccn_region_id

String

cn-shanghai

Este parâmetro foi descontinuado.

Região à qual pertence a instância CCN associada ao pool de nós de borda aprimorado.

bandwidth

Long

10

Este parâmetro foi descontinuado.

Largura de banda do pool de nós de borda aprimorado. Unidade: Mbit/s.

improved_period

String

1

Este parâmetro foi descontinuado.

Duração da assinatura do pool de nós de borda aprimorado. A duração é medida em meses.

max_nodes

Long

10

Número máximo de nós com suporte em um pool de nós de borda. O valor deve ser igual ou superior a 0. Um valor de 0 indica que o número de nós no pool é limitado apenas pela cota de nós no cluster. Na maioria dos casos, este parâmetro é definido com um valor maior que 0 para pools de nós de borda. Este parâmetro é definido como 0 para pools de nós cujos tipos são ess ou pools de nós de borda padrão.

runtime

Configurações dos mecanismos de contêiner.

Parâmetro

Tipo

Exemplo

Descrição

name

String

containerd

Nome de um runtime de contêiner. Os seguintes tipos de runtime têm suporte no ACK.

  • containerd: tem suporte a todas as versões do Kubernetes. Recomendamos o uso do containerd.
  • Sandboxed-Container.runv: permite executar aplicações em contêineres sandbox, que oferecem maior segurança. Apenas o Kubernetes 1.24 e versões anteriores têm suporte ao Sandboxed-Container.
  • docker: tem suporte ao Kubernetes 1.22 e versões anteriores.

Valor padrão: containerd.

version

String

1.6.20

Versão do runtime de contêiner. Por padrão, a versão mais recente é utilizada.

Para mais informações sobre as alterações no Sandboxed-Container, consulte Notas de versão do Sandboxed-Container.

tag

Configurações de rótulos.

Parâmetro

Tipo

Exemplo

Descrição

key

String

env

A chave de um rótulo.

value

String

prod

O valor de um rótulo.

taint

Configurações de taints de nó.

Parâmetro

Tipo

Exemplo

Descrição

key

String

key

A chave de um taint.

value

String

value

O valor de um taint.

effect

String

NoSchedule

Política de agendamento. Valores válidos:

  • NoSchedule: Pods que não toleram este taint não são agendados em nós com este taint. Esta política afeta apenas o processo de agendamento e tem efeito somente para pods a serem agendados. Pods já agendados não estão sujeitos a esta política.

  • NoExecute: Pods que não toleram este taint são despejados após a adição deste taint ao nó.

  • PreferNoSchedule: política de preferência para pods. Pods já agendados não estão sujeitos a esta política. Se este taint for adicionado a um nó, o sistema tentará não agendar pods que não toleram este taint nesse nó.

Valor padrão: NoSchedule.