ModifyClusterNodePool - Container Service for Kubernetes: Central de Documentação do Alibaba Cloud

Atualiza as configurações de um pool de nós especificado.

Descrição da operação

Importante A partir de 4 de julho de 2026, os parâmetros de solicitação instance_deletion_protection, ingress_loadbalancer_id e access_control_list não terão mais efeito. Para obter mais informações sobre as alterações, consulte Anúncio sobre alterações nos parâmetros de solicitação e resposta de operações de API relacionadas ao gerenciamento de clusters ACK e descontinuação de operações de API.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.
API: A API que você pode chamar para executar a ação.
Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.
Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.
- Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.
- Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.
Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.
Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

cs:ModifyClusterNodePool

update

*Cluster

acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId}

Nenhuma

Sintaxe da solicitação

PUT /clusters/{ClusterId}/nodepools/{NodepoolId} HTTP/1.1

Parâmetros de caminho

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
ClusterId	string	Sim	O ID do cluster.	c23421cfa74454bc8b37163fd19af****
NodepoolId	string	Sim	O ID do pool de nós.	p31da1b38983f4511b490fc62108a****

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
body	object	Não	Os parâmetros do corpo da solicitação.
nodepool_info	object	Não	As configurações do pool de nós.
name	string	Não	O nome do pool de nós. Regras de nomenclatura: O nome deve ter de 1 a 63 caracteres e pode conter dígitos, caracteres chineses, letras e hifens (-). Não pode começar com um hífen (-).	default-nodepool
resource_group_id	string	Não	O ID do grupo de recursos do pool de nós. As instâncias expandidas a partir do pool de nós pertencem a este grupo de recursos. Um recurso pode pertencer a apenas um grupo de recursos. Você pode mapear grupos de recursos para conceitos como projetos, aplicativos ou organizações com base em diferentes cenários de negócios.	rg-acfmyvw3wjm****
auto_scaling	object	Não	As configurações de dimensionamento automático.
enable	boolean	Não	Especifica se o dimensionamento automático deve ser ativado. Valores válidos: `true`: ativa o dimensionamento automático para o pool de nós. Quando o planejamento de capacidade do cluster não consegue atender aos requisitos de agendamento dos pods de aplicativo, o ACK dimensiona automaticamente os recursos do nó com base nos números mínimo e máximo de instâncias configurados. Para clusters da versão 1.24 e posteriores, a elasticidade instantânea do nó é ativada por padrão. Para clusters anteriores à versão 1.24, o dimensionamento automático do nó é ativado por padrão. Para obter mais informações, consulte Dimensionamento de nós. `false`: desativa o dimensionamento automático. O ACK ajusta o número de nós no pool de nós com base no número esperado de nós configurado para manter o número de nós no valor esperado. 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
type `deprecated`	string	Não	O tipo de dimensionamento automático, que é classificado pelo tipo de instância de dimensionamento automático. Valores válidos: `cpu`: instância regular. `gpu`: instância acelerada por GPU. `gpushare`: instância acelerada por GPU compartilhada. `spot`: instância spot. Valor padrão: `cpu`.	cpu
max_instances	integer	Não	O número máximo de instâncias escaláveis no pool de nós, excluindo as instâncias existentes. Este parâmetro só tem efeito quando `enable` é definido como true. Valores válidos: [min_instances, 2000]. Valor padrão: 0.	10
min_instances	integer	Não	O número mínimo de instâncias escaláveis no pool de nós, excluindo as instâncias existentes. Este parâmetro só tem efeito quando `enable` é definido como true. Valores válidos: [0, max_instances]. Valor padrão: 0. Nota Se o número mínimo de instâncias não for 0, a criação automática do número correspondente de instâncias ECS será realizada após o grupo de dimensionamento entrar em vigor. Configurações recomendadas: o número máximo de instâncias não deve ser menor que o número atual de nós no pool de nós. Caso contrário, o pool de nós será reduzido imediatamente após o recurso de dimensionamento elástico entrar em vigor.	2
is_bond_eip `deprecated`	boolean	Não	[Deprecated] Este parâmetro foi descontinuado. Use internet_charge_type e internet_max_bandwidth_out em seu lugar. `true`: associa um EIP. `false`: não associa um EIP. Valor padrão: `false`.	null
eip_internet_charge_type `deprecated`	string	Não	[Deprecated] Use internet_charge_type e internet_max_bandwidth_out em seu lugar. 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`.	null
eip_bandwidth `deprecated`	integer	Não	[Deprecated] Use internet_charge_type e internet_max_bandwidth_out em seu lugar. A largura de banda de pico do EIP. Valores válidos: 1 a 100. Unidade: Mbit/s.	null
management	object	Não	A configuração do pool de nós gerenciado.
enable	boolean	Não	Especifica se o pool de nós gerenciado deve ser ativado. Valores válidos: `true`: Ativa o pool de nós gerenciado. `false`: Não ativa o pool de nós gerenciado. Outras configurações relacionadas entram em vigor apenas quando `enable` é definido como `true`. Valor padrão: `false`.	true
auto_repair	boolean	Não	Especifica se os nós devem ser reparados automaticamente. Este parâmetro entra em vigor apenas quando `enable` é definido como `true`. Valores válidos: `true`: Repara os nós automaticamente. `false`: Não repara os nós automaticamente. Valor padrão: `true`.	true
auto_repair_policy	object	Não	A política de reparo automático.
restart_node	boolean	Não	Especifica se as reinicializações de nós devem ser permitidas. Este parâmetro entra em vigor apenas quando `auto_repair` é definido como `true`. Valores válidos: `true`: Permite reinicializações de nós. `false`: Não permite reinicializações de nós. Valor padrão: `true`.	true
approval_required	boolean	Não	Especifica se a aprovação manual é necessária para o reparo do nó.
auto_repair_policy_id	string	Não	O ID da política de reparo automático.	r-xxxxxxxxxx
max_parallel_repairing_nodes	string	Não	O número máximo de reparos paralelos. Quando existe um grande número de nós anormais no pool de nós, este parâmetro especifica o número máximo ou a porcentagem de nós que podem ser reparados simultaneamente. 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	Não	O limite de disjuntor para reparo automático. Quando o número ou a porcentagem de nós com falha excede esse limite, o processo de reparo automático entra no estado de disjuntor e para de iniciar novas ações de reparo automático. 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	Não	Especifica se as vulnerabilidades de CVE devem ser reparadas automaticamente. Este parâmetro entra em vigor apenas quando `enable` é definido como `true`. Valores válidos: `true`: Permite o reparo automático de CVE. `false`: Não permite o reparo automático de CVE. Valor padrão: `true`.	true
auto_vul_fix_policy	object	Não	A política de reparo automático de CVE.
restart_node	boolean	Não	Especifica se as reinicializações de nós devem ser permitidas. Este parâmetro entra em vigor apenas quando `auto_vul_fix` é definido como `true`. Valores válidos: `true`: Permite reinicializações de nós. `false`: Não permite reinicializações de nós. Valor padrão: `true`.	true
vul_level	string	Não	Os níveis de vulnerabilidade permitidos para reparo automático, separados por vírgulas. Exemplo: `asap,later`. Valores válidos: `asap`: Alto. `later`: Médio. `nntf`: Baixo. Valor padrão: `asap`.	asap,nntf
exclude_packages	string	Não	Os pacotes a serem excluídos durante o reparo de vulnerabilidades. Valor padrão: `kernel`.	kernel
auto_upgrade	boolean	Não	Especifica se os nós devem ser atualizados automaticamente. Este parâmetro entra em vigor apenas quando `enable` é definido como `true`. Valores válidos: `true`: Ativa as atualizações automáticas. `false`: Desativa as atualizações automáticas. Valor padrão: `true`.	true
auto_upgrade_policy	object	Não	A política de atualização automática.
auto_upgrade_kubelet	boolean	Não	Especifica se as atualizações automáticas do kubelet devem ser permitidas. Este parâmetro entra em vigor apenas quando `auto_upgrade` é definido como `true`. Valores válidos: `true`: Permite atualizações automáticas do kubelet. `false`: Não permite atualizações automáticas do kubelet. Valor padrão: `true`.	true
auto_upgrade_runtime	boolean	Não	Especifica se as atualizações automáticas do runtime devem ser permitidas. Este parâmetro entra em vigor apenas quando `auto_upgrade` é definido como `true`. Valores válidos: `true`: Permite atualizações automáticas do runtime. `false`: Não permite atualizações automáticas do runtime. Valor padrão: `true`.	false
auto_upgrade_os	boolean	Não	Especifica se as atualizações automáticas do sistema operacional devem ser permitidas. Este parâmetro entra em vigor apenas quando `auto_upgrade` é definido como `true`. Valores válidos: `true`: Permite atualizações automáticas do sistema operacional. `false`: Não permite atualizações automáticas do sistema operacional. Valor padrão: `false`.	false
upgrade_config `deprecated`	object	Não	[Deprecated] Use o parâmetro `auto_upgrade` no nível superior em vez disso. A configuração de atualização automática. Este parâmetro entra em vigor apenas quando `enable` é definido como `true`.
auto_upgrade `deprecated`	boolean	Não	[Deprecated] Use o parâmetro `auto_upgrade` no nível superior em vez disso. Especifica se as atualizações automáticas devem ser ativadas. Valores válidos: `true`: Ativa as atualizações automáticas. `false`: Desativa as atualizações automáticas. Valor padrão: `true`.	true
surge	integer	Não	O número de nós de surge. Este parâmetro e `surge_percentage` são mutuamente exclusivos. Os nós ficam indisponíveis durante as atualizações. Você pode criar nós de surge para compensar a carga do cluster. Nota Não crie mais nós de surge do que o número atual de nós.	5
surge_percentage	integer	Não	A porcentagem de nós de surge. Este parâmetro e `surge` são mutuamente exclusivos. O número de nós de surge é calculado multiplicando a porcentagem pelo número total de nós. Por exemplo, se a porcentagem for definida como 50% e o número total de nós for 6, o número de nós de surge será 50% × 6 = 3.	0
max_unavailable	integer	Não	O número máximo de nós indisponíveis. Valores válidos: 1 a 1000. Valor padrão: 1.	1
auto_fault_diagnosis	boolean	Não	Especifica se a detecção de falhas de ECS para reparo automático deve ser ativada.
drift_enabled	boolean	Não	Especifica se a rotação de nós deve ser ativada. Este recurso é suportado apenas por pools de nós gerenciados inteligentes e é ativado por padrão. Não é suportado por pools de nós regulares.
scaling_group	object	Não	A configuração do grupo de escalonamento do pool de nós.
vswitch_ids	array	Não	A lista de IDs de vSwitch. Valores válidos: 1 a 8. Nota Para garantir alta disponibilidade, selecione vSwitches em zonas diferentes.
	string	Não	O ID do vSwitch.	vsw-wz9uwxhawmtzg7u9h****
instance_types	array	Não	A lista de tipos de instância para nós. Você pode selecionar vários tipos de instância como alternativas. Quando um nó é criado, o sistema tenta comprar uma instância do primeiro tipo de instância na lista e prossegue para o próximo até que a criação seja bem-sucedida. O tipo de instância final comprado pode variar com base no estoque. Valores válidos: 1 a 10.
	string	Não	O tipo de instância. Para mais informações, consulte Famílias de instâncias.	ecs.c6.large
instance_charge_type	string	Não	O método de cobrança para nós no pool de nós. Valores válidos: PrePaid: assinatura. PostPaid: pay-as-you-go. Valor padrão: PostPaid. A exclusão de um pool de nós, a redução de escala de um pool de nós ou a remoção de um nó não libera automaticamente os nós de assinatura. Para liberar automaticamente um nó de assinatura, altere o método de cobrança do nó de assinatura para pay-as-you-go e, em seguida, faça login no console do ECS para liberar automaticamente o nó.	PostPaid
period	integer	Não	A duração da assinatura para nós no pool de nós. Este parâmetro entra em vigor e é obrigatório apenas quando instance_charge_type é definido como PrePaid. Quando period_unit é definido como Week, os valores válidos para period são 1, 2, 3 e 4. Quando period_unit é definido como Month, os valores válidos para period são 1, 2, 3, 4, 5, 6, 7, 8, 9, 12, 24, 36, 48 e 60.	1
period_unit	string	Não	O ciclo de cobrança para nós no pool de nós. Este parâmetro entra em vigor e é obrigatório apenas quando instance_charge_type é definido como PrePaid. Month: usa o mês como unidade de tempo. Week: usa a semana como unidade de tempo. Valor padrão: Month.	Month
auto_renew	boolean	Não	Especifica se a renovação automática para nós deve ser ativada. Este parâmetro entra em vigor apenas quando instance_charge_type é definido como PrePaid. Valores válidos: true: ativa a renovação automática. false: desativa a renovação automática. Valor padrão: false.	true
auto_renew_period	integer	Não	O período de renovação automática. Valores válidos: Quando PeriodUnit é definido como Week: 1, 2 e 3. Quando PeriodUnit é definido como Month: 1, 2, 3, 6, 12, 24, 36, 48 e 60. Valor padrão: 1.	1
spot_strategy	string	Não	O tipo de instância spot. Valores válidos: NoSpot: instância não spot. SpotWithPriceLimit: define um preço máximo para a instância spot. SpotAsPriceGo: usa o lance automático do sistema, que segue o preço real de mercado. Para mais informações, consulte Instâncias spot.	SpotWithPriceLimit
spot_price_limit	array<object>	Não	A configuração do intervalo de preço de mercado para instâncias spot.
	object	Não	A configuração do intervalo de preço de mercado para instâncias spot.
instance_type	string	Não	O tipo de instância spot.	ecs.c6.large
price_limit	string	Não	O preço máximo por instância. Unidade: USD/hora.	0.39
image_type	string	Não	O tipo de distribuição do sistema operacional. Recomendamos que você use este parâmetro para especificar o sistema operacional para nós. Valores válidos: AliyunLinux: imagem Alinux2. AliyunLinuxSecurity: imagem Alinux2 UEFI. AliyunLinux3: imagem Alinux3. AliyunLinux3Arm64: imagem Alinux3 ARM. AliyunLinux3Security: imagem Alinux3 UEFI. CentOS: imagem CentOS. Windows: imagem Windows. WindowsCore: imagem Windows Core. ContainerOS: imagem otimizada para contêineres. AliyunLinux3ContainerOptimized: imagem Alinux3 otimizada para contêineres.	AliyunLinux3
image_id	string	Não	O ID da imagem personalizada. Você pode chamar a operação DescribeKubernetesVersionMetadata para consultar as imagens suportadas pelo sistema. Por padrão, a imagem de sistema mais recente é usada.	aliyun_3_x64_20G_alibase_20241218.vhd
system_disk_category	string	Não	O tipo de disco em nuvem do sistema para nós. Valores válidos: cloud_efficiency: ultra disk. cloud_ssd: SSD padrão. cloud_essd: ESSD. cloud_auto: ESSD AutoPL. cloud_essd_entry: ESSD Entry. Valor padrão: cloud_efficiency.	cloud_efficiency
system_disk_categories	array	Não	Os múltiplos tipos de disco em nuvem do sistema. Se o disco em nuvem do sistema não puder ser criado usando o tipo de disco com a maior prioridade, o sistema tenta automaticamente usar o tipo de disco com a próxima prioridade mais alta.
	string	Não	Os múltiplos tipos de disco em nuvem do sistema para nós. Valores válidos: cloud_efficiency: ultra disk. cloud_ssd: SSD padrão. cloud_essd: ESSD. cloud_auto: ESSD AutoPL. cloud_essd_entry: disco ESSD Entry.	cloud_essd
system_disk_size	integer	Não	O tamanho do disco em nuvem do sistema para nós. Unidade: GiB. Valores válidos: 20 a 2048. O valor deste parâmetro deve ser maior ou igual a max{20, ImageSize}. Valor padrão: max{40, ImageSize da imagem especificada por ImageId}.	120
system_disk_performance_level	string	Não	O nível de desempenho do disco em nuvem do sistema para nós. Este parâmetro entra em vigor apenas para ESSDs. O nível de desempenho está relacionado ao tamanho do disco. Para mais informações, consulte ESSD. Observe que um ESSD é diferente de um SSD padrão. PL0: fornece desempenho de E/S simultâneo médio e latência de leitura/gravação relativamente estável. PL1: fornece desempenho de E/S simultâneo médio e latência de leitura/gravação relativamente estável. PL2: fornece alto desempenho de E/S simultâneo e latência de leitura/gravação estável. PL3: fornece desempenho de E/S simultâneo ultralto e latência de leitura/gravação extremamente estável.	PL1
system_disk_encrypted	boolean	Não	Especifica se o disco em nuvem do sistema deve ser criptografado. Valores válidos: true: criptografa o disco em nuvem do sistema. false: não criptografa o disco em nuvem do sistema.	false
system_disk_kms_key_id	string	Não	O ID da chave KMS usada para o disco em nuvem do sistema.	0e478b7a-4262-4802-b8cb-00d3fb40****
system_disk_encrypt_algorithm	string	Não	O algoritmo de criptografia usado para o disco em nuvem do sistema. Valor válido: aes-256.	aes-256
system_disk_provisioned_iops	integer	Não	O IOPS de leitura/gravação provisionado para o disco em nuvem do sistema. 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 system_disk_category é definido como cloud_auto. Para mais informações, consulte Discos ESSD AutoPL.	1000
system_disk_bursting_enabled	boolean	Não	Especifica se o pico de desempenho para o disco em nuvem do sistema deve ser ativado. Valores válidos: true: ativa o pico de desempenho. Após a ativação deste recurso, se o seu negócio experimentar picos repentinos na pressão de leitura/gravação de dados, o disco em nuvem aumenta temporariamente seu desempenho com base nas necessidades reais do negócio até que o negócio se estabilize. false: desativa o pico de desempenho. Este parâmetro é suportado apenas quando system_disk_category é definido como cloud_auto. Para mais informações, consulte Discos ESSD AutoPL.	true
data_disks	array	Não	A configuração do disco em nuvem de dados para nós. Valores válidos: 0 a 10. Você pode adicionar até 10 discos em nuvem de dados.
	data_disk	Não	A configuração do disco em nuvem de dados para nós.
disk_init	array	Não	A configuração de inicialização do dispositivo de bloco.
	DiskInit	Não	A configuração de inicialização do dispositivo de bloco.
key_pair	string	Não	O nome do par de chaves. Você deve especificar este parâmetro ou login_password. Se o pool de nós for um pool de nós gerenciado, apenas key_pair é suportado.	pro-nodepool
login_password	string	Não	A senha de login SSH. Você deve especificar 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
internet_charge_type	string	Não	O método de cobrança para o endereço IP público. Valores válidos: PayByBandwidth: pagamento por largura de banda. PayByTraffic: pagamento por tráfego.	PayByBandwidth
internet_max_bandwidth_out	integer	Não	A largura de banda pública de saída máxima para nós. Unidade: Mbit/s. Valores válidos: 1 a 100.	5
tags	array	Não	Adiciona tags apenas às instâncias ECS. As chaves de tag devem ser exclusivas e podem ter até 128 caracteres. As chaves e valores de tag não podem começar com "aliyun" ou "acs:" e não podem conter "https://" ou "http://".
	tag	Não	A tag da instância ECS.
desired_size	integer	Não	O número esperado de nós no pool de nós. Este é o número total de nós que o pool de nós deve manter. Recomendamos que você configure pelo menos dois nós para garantir a operação normal dos componentes do cluster. Você pode aumentar ou reduzir a escala do pool de nós ajustando o número esperado de nós. Se você não precisar criar nós, defina este parâmetro como 0 e aumente manualmente o número de nós posteriormente. A redução de escala em um pool de nós não libera automaticamente os nós de assinatura. Para liberar automaticamente um nó de assinatura, altere o método de cobrança do nó de assinatura para pay-as-you-go e, em seguida, faça login no console do ECS para liberar automaticamente o nó.	2
multi_az_policy	string	Não	A política de escalonamento para instâncias ECS em um grupo de escalonamento multizona. Valores válidos: PRIORITY: escalona instâncias ECS com base nos vSwitches (VSwitchIds.N) que você especificar. Se as instâncias ECS não puderem ser criadas na zona ativa onde reside o vSwitch com a maior prioridade, o sistema usa automaticamente o vSwitch com a próxima prioridade mais alta para criar instâncias ECS. COST_OPTIMIZED: tenta criar instâncias ECS em ordem crescente de preço unitário de vCPU. Se as configurações de escalonamento especificarem vários tipos de instância e o método de cobrança spot, o sistema cria preferencialmente instâncias spot. Você pode usar o parâmetro CompensateWithOnDemand para especificar se deve tentar criar automaticamente instâncias pay-as-you-go quando as instâncias spot não puderem ser criadas devido à falta de estoque ou outros motivos. Nota COST_OPTIMIZED entra em vigor apenas quando as configurações de escalonamento especificam vários tipos de instância ou usam instâncias spot. BALANCE: aloca instâncias ECS uniformemente entre as zonas especificadas no grupo de escalonamento. Se as instâncias ficarem desbalanceadas entre as zonas devido à falta de estoque ou outros motivos, você pode chamar a operação RebalanceInstances para balancear os recursos. Para mais informações, consulte RebalanceInstances. Valor padrão: PRIORITY.	BALANCE
scaling_policy	string	Não	O modo do grupo de escalonamento. Valores válidos: release: modo padrão. Escalona instâncias criando e liberando instâncias ECS com base no uso de recursos solicitado. recycle: modo rápido. Escalona instâncias criando, parando e iniciando instâncias ECS para melhorar a velocidade das operações de escalonamento subsequentes. Quando uma instância é parada, você não é cobrado pelos recursos de computação, mas ainda é cobrado pelos recursos de armazenamento, exceto para instâncias com discos locais.	release
on_demand_base_capacity	integer	Não	O número mínimo de instâncias pay-as-you-go necessárias no grupo de escalonamento. Valores válidos: 0 a 1000. Se o número de instâncias pay-as-you-go for menor que este valor, o sistema cria preferencialmente instâncias pay-as-you-go.	0
on_demand_percentage_above_base_capacity	integer	Não	A porcentagem de instâncias pay-as-you-go entre as instâncias excedentes após o grupo de escalonamento atingir o número mínimo de instâncias pay-as-you-go (on_demand_base_capacity). Valores válidos: 0 a 100.	20
spot_instance_pools	integer	Não	O número de tipos de instância disponíveis. O grupo de escalonamento cria instâncias spot uniformemente entre os tipos de instância especificados com os menores custos. Valores válidos: 1 a 10.	5
spot_instance_remedy	boolean	Não	Especifica se a reposição de instâncias spot deve ser ativada. Quando ativado, o grupo de escalonamento tenta criar novas instâncias para substituir as instâncias spot que estão prestes a ser recuperadas ao receber uma mensagem do sistema. Valores válidos: `true`: Ativa a reposição de instâncias spot. `false`: Desativa a reposição de instâncias spot.	false
compensate_with_on_demand	boolean	Não	Especifica se instâncias pay-as-you-go devem ser criadas automaticamente para atender ao número necessário de instâncias ECS quando o parâmetro `multi_az_policy` está definido como `COST_OPTIMIZED` e não é possível criar instâncias spot suficientes devido a restrições de preço ou estoque. Valores válidos: `true`: Permite que o sistema crie automaticamente instâncias pay-as-you-go para atender ao número necessário de instâncias ECS. `false`: Não permite que o sistema crie automaticamente instâncias pay-as-you-go para atender ao número necessário de instâncias ECS.	true
enable_high_density_mode	boolean	Não	Especifica se o modo de disco em nuvem de alta densidade deve ser ativado. Este modo é suportado apenas quando o pool de nós usa tipos de instância. Quando ativado, o número total de discos em nuvem do sistema e discos em nuvem de dados não excede o número máximo de discos em nuvem de alta densidade suportados pelo tipo de instância.	false
rds_instances	array	Não	As instâncias RDS.
	string	Não	O ID da instância RDS. Se uma lista de instâncias RDS for especificada, as instâncias ECS dos nós do cluster serão adicionadas automaticamente à lista de permissões de acesso do RDS.	rds-xxx
private_pool_options	object	Não	As configurações do pool de nós privado.
id	string	Não	O ID do pool de nós privado. Quando `match_criteria` está definido como `Target`, você deve especificar o ID do pool privado.	eap-bp67acfmxazb4****
match_criteria	string	Não	O tipo do pool de nós privado e o modo de correspondência de capacidade do pool privado para a inicialização da instância. Após uma garantia de elasticidade ou reserva de capacidade entrar em vigor, a capacidade do pool privado é gerada para a inicialização da instância. Valores válidos: `Open`: Modo aberto. O sistema corresponde automaticamente à capacidade do pool privado aberto. Se nenhuma capacidade de pool privado elegível estiver disponível, os recursos do pool público serão usados. Neste modo, você não precisa definir o parâmetro PrivatePoolOptions.Id. `Target`: Modo especificado. O sistema usa a capacidade do pool privado especificado para iniciar instâncias. Se a capacidade do pool privado especificado não estiver disponível, as instâncias falharão ao iniciar. Neste modo, você deve especificar o ID do pool privado definindo o parâmetro PrivatePoolOptions.Id. `None`: Modo sem pool privado. O sistema não usa a capacidade do pool privado para iniciar instâncias.	Open
platform `deprecated`	string	Não	[Deprecated] Use o parâmetro `image_type` em seu lugar. A plataforma do sistema operacional. Valores válidos: `AliyunLinux` `CentOS` `Windows` `WindowsCore`	AliyunLinux
instance_patterns	array	Não	As configurações de atributos da instância.
	instance_patterns	Não	Os atributos da instância.
deploymentset_id	string	Não	O conjunto de implantação ao qual as instâncias ECS expandidas pelo pool de nós pertencem. Este parâmetro entra em vigor apenas em novos nós. Os conjuntos de implantação dos nós existentes permanecem inalterados.	ds-bp1d19mmbsv3jf6xxxxx
security_group_ids	array	Não	A lista de IDs de grupos de segurança.
	string	Não	O ID do grupo de segurança.	sg-wz9a8g2mt6x5ll******
resource_pool_options	object	Não	O pool de recursos e a política de pool de recursos usados para criar instâncias. Observe o seguinte ao definir este parâmetro: Este parâmetro entra em vigor apenas quando você cria instâncias pay-as-you-go. Este parâmetro não pode ser definido ao mesmo tempo que `private_pool_options.match_criteria` e `private_pool_options.id`.
strategy	string	Não	A política de pool de recursos usada para criar instâncias. Os pools de recursos incluem pools privados gerados após uma garantia de elasticidade ou reserva de capacidade entrar em vigor, bem como pools públicos. Valores válidos: `PrivatePoolFirst`: Pool privado primeiro. Quando esta política é selecionada e `resouce_pool_options.private_pool_ids` é especificado, os pools privados especificados são priorizados. Se nenhum pool privado for especificado ou se os pools privados especificados tiverem capacidade insuficiente, o sistema corresponde automaticamente aos pools privados abertos. Se nenhum pool privado elegível estiver disponível, o pool público será usado para criar instâncias. `PrivatePoolOnly`: Apenas pool privado. Quando esta política é selecionada, você deve especificar `resouce_pool_options.private_pool_ids`. Se os pools privados especificados tiverem capacidade insuficiente, as instâncias falharão ao iniciar. `None`: Nenhuma política de pool de recursos é usada. Valor padrão: `None`. Valores válidos: PrivatePoolFirst PrivatePoolOnly None	PrivatePoolFirst
private_pool_ids	array	Não	A lista de IDs de pools privados, que são os IDs de garantias de elasticidade ou IDs de reservas de capacidade. Você pode passar apenas IDs de pools privados no modo Target. Valores válidos de N: 1 a 20.
	string	Não	O ID do pool privado, que é o ID da garantia de elasticidade ou ID da reserva de capacidade. Você pode passar apenas um ID de pool privado no modo Target.	eap-bp67acfmxazb4****
system_disk_snapshot_policy_id	string	Não	A política de snapshot para o disco em nuvem do sistema.	sp-0jl6xnmme8v7o935****
kubernetes_config	object	Não	As configurações relacionadas ao cluster.
labels	array	Não	Os labels de nó. Adiciona labels aos nós no cluster Kubernetes. Regras de definição de labels: Os labels consistem em pares chave-valor que diferenciam maiúsculas de minúsculas. Você pode configurar até 20 labels. As chaves de label devem ser exclusivas e podem ter até 64 caracteres. Os valores de label podem estar vazios e ter até 128 caracteres. Nem as chaves nem os valores de label podem começar com `aliyun`, `acs:`, `https://` ou `http://`. Para mais informações, consulte Labels e Seletores.
	tag	Não	O label de nó.
taints	array	Não	A configuração de taints para os nós.
	taint	Não	A configuração de taints para os nós.
runtime	string	Não	O nome do runtime de contêiner. O ACK oferece suporte aos três runtimes de contêiner a seguir: containerd: Recomendado. Compatível com todas as versões de cluster. Sandboxed-Container.runv: Contêineres em sandbox seguros que fornecem maior isolamento. Compatível com clusters da versão 1.31 e anteriores. docker: Obsoleto. Compatível com clusters da versão 1.22 e anteriores. Valor padrão: containerd.	containerd
runtime_version	string	Não	A versão do runtime de contêiner.	1.6.38
cpu_policy	string	Não	A política de gerenciamento de CPU para os nós. As duas políticas a seguir são suportadas quando a versão do cluster é 1.12.6 ou posterior: `static`: Permite aprimorar a afinidade e a exclusividade de CPU para pods com características de recursos específicas no nó. `none`: Ativa o esquema de afinidade de CPU padrão existente. Valor padrão: `none`.	none
unschedulable	boolean	Não	Especifica se os nós expandidos são não agendáveis. Valores válidos: true: Os nós são não agendáveis. false: Os nós são agendáveis.	false
user_data	string	Não	Os dados de usuário da instância. Depois que um nó é adicionado ao cluster, o script de dados de usuário especificado é executado. Para mais informações, consulte Scripts de dados de usuário.	IyEvdXNyL2Jpbi9iYXNoCmVjaG8gIkhlbGxvIEFDSyEi
cms_enabled	boolean	Não	Especifica se o CloudMonitor deve ser instalado nos nós ECS. Após a instalação, você pode visualizar as informações de monitoramento das instâncias ECS criadas no console do CloudMonitor. Recomendado. Valores válidos: `true`: Instalar o CloudMonitor nos nós ECS. `false`: Não instalar o CloudMonitor nos nós ECS. Valor padrão: `false`.	true
pre_user_data	string	Não	Os dados de pré-usuário da instância. Antes de um nó ser adicionado ao cluster, o script de dados de pré-usuário especificado é executado. Para mais informações, consulte Scripts de dados de usuário.	IyEvdXNyL2Jpbi9iYXNoCmVjaG8gIkhlbGxvIEFDSyEi
node_name_mode	string	Não	O parâmetro de nome de nó personalizado. Um nome de nó consiste em três partes: prefixo + endereço IP do nó + sufixo. O prefixo e o sufixo podem consistir em uma ou mais partes separadas por pontos (.). 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 um dígito. O endereç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 o parâmetro for definido como 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
tee_config	object	Não	A configuração do cluster de computação confidencial.
tee_enable	boolean	Não	Especifica se o cluster de computação confidencial deve ser ativado. Valores válidos: `true`: Ativado. `false`: Desativado. Valor padrão: `false`.	false
update_nodes	boolean	Não	Atualiza de forma síncrona os labels e taints de nó.	true
concurrency	boolean	Não	Especifica se a concorrência deve ser ativada.	true
eflo_node_group	object	Não	A configuração do node pool Lingjun. (Não tem efeito.)
auto_attach_enabled	string	Não	Especifica se a adição automática para o node pool Lingjun deve ser ativada. (Não tem efeito.)

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Os dados do corpo da resposta.
task_id	string	O ID da tarefa.	T-5fd211e924e1d00787000293
nodepool_id	string	O ID do pool de nós.	np737c3ac1ac684703b9e10673aa2c****
request_id	string	O ID da solicitação.	687C5BAA-D103-4993-884B-C35E4314****

Exemplos

Resposta de sucesso

JSON formato

{
  "task_id": "T-5fd211e924e1d00787000293",
  "nodepool_id": "np737c3ac1ac684703b9e10673aa2c****",
  "request_id": "687C5BAA-D103-4993-884B-C35E4314****"
}

Códigos de erro

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.