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

Cria um node pool para um cluster. Um node pool é uma coleção lógica de nós que compartilham os mesmos atributos, permitindo gerenciamento e operações unificadas, como atualizações de nós e escalonamento elástico. Você também pode utilizar os recursos automatizados de O&M dos node pools, incluindo correção automática de vulnerabilidades CVE do sistema operacional, recuperação automática de nós com falha e atualizações automáticas das versões do kubelet e containerd, para reduzir os custos de O&M.

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:CreateClusterNodePool

create

*Cluster

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

Nenhuma

Sintaxe da solicitação

POST /clusters/{ClusterId}/nodepools HTTP/1.1

Parâmetros de caminho

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
ClusterId	string	Sim	O ID do cluster.	c61da77e8bfbc4c4c999af2b51b65****

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	A configuração do node pool.
name	string	Sim	O nome do node pool.	nodepool-test
type	string	Não	O tipo do node pool. Valores válidos: `ess`: node pool padrão (inclui recursos gerenciados e escalonamento elástico automático). `edge`: node pool de borda. `lingjun`: node pool Lingjun. `hybrid`: node pool de nuvem híbrida. Valores válidos: lingjun : Node pool Lingjun. edge : Node pool de borda. ess : Node pool padrão.	ess
resource_group_id	string	Não	O ID do grupo de recursos do node pool. As instâncias criadas pelo node pool 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, aplicações ou organizações com base em seus cenários de negócios.	rg-acfmyvw3wjmb****
auto_scaling	object	Não	A configuração de escalonamento elástico automático.
enable	boolean	Não	Especifica se deve ativar o escalonamento automático. Valores válidos: `true`: ativa o recurso de escalonamento automático para o node pool. Quando o planejamento de capacidade do cluster não consegue atender aos requisitos de agendamento dos pods da aplicação, o ACK escala automaticamente os recursos dos nós com base nas contagens mínima e máxima de instâncias configuradas. Clusters da versão 1.24 e posteriores ativam a elasticidade instantânea de nós por padrão. Clusters de versões anteriores à 1.24 ativam o escalonamento automático de nós por padrão. Para mais informações, consulte Escalonamento de nós. `false`: desativa o escalonamento automático. O ACK ajusta o número de nós no node pool com base na contagem desejada de nós configurada e mantém a contagem de nós no valor desejado. Quando o valor é false, outros parâmetros de configuração em `auto_scaling` não entram em vigor. Valor padrão: `false`.	false
type	string	Não	O tipo de instância para escalonamento elástico automático. Este parâmetro entra em vigor apenas quando `enable=true`. 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`. Importante Este parâmetro não pode ser modificado após a criação do node pool. Valores válidos: spot : Tipo de instância spot. cpu : Tipo de instância regular. gpushare : Tipo compartilhado de GPU. gpu : Tipo de instância GPU.	cpu
max_instances	integer	Não	O número máximo de instâncias escaláveis no node pool, excluindo suas instâncias existentes. Este parâmetro entra em vigor apenas quando `enable=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 node pool, excluindo suas instâncias existentes. Este parâmetro entra em vigor apenas quando `enable=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, o número correspondente de instâncias ECS estará sujeito à criação automática após o grupo de escalonamento entrar em vigor. As configurações para o número máximo de instâncias não devem ser menores que o número atual de nós no node pool. Caso contrário, os nós no node pool serão reduzidos (scale-in) após o recurso de escalonamento elástico entrar em vigor.	1
is_bond_eip `deprecated`	boolean	Não	[Obsoleto] Este parâmetro está obsoleto. Use internet_charge_type e internet_max_bandwidth_out em seu lugar. Especifica se deve associar um elastic IP address (EIP). Valores válidos: `true`: associa um EIP. `false`: não associa um EIP. Valor padrão: `false`.	null
eip_internet_charge_type `deprecated`	string	Não	[Obsoleto] Use internet_charge_type e internet_max_bandwidth_out em seu lugar. O método de cobrança para o EIP. Valores válidos: `PayByBandwidth`: pagamento por largura de banda. `PayByTraffic`: pagamento por transferência de dados. Valor padrão: `PayByBandwidth`.	null
eip_bandwidth `deprecated`	integer	Não	[Obsoleto] Use internet_charge_type e internet_max_bandwidth_out em seu lugar. A largura de banda de pico do EIP. Unidade: Mbit/s.	null
management	object	Não	A configuração de recursos gerenciados para o node pool.
enable	boolean	Não	Especifica se deve ativar o recurso gerenciado para o node pool. Valores válidos: `true`: ativa o recurso gerenciado. `false`: desativa o recurso gerenciado. Outras configurações relacionadas entram em vigor apenas quando enable=true. Valor padrão: false.	false
auto_repair	boolean	Não	Especifica se deve reparar automaticamente os nós. Este parâmetro entra em vigor apenas quando `enable=true`. `true`: repara automaticamente os nós. `false`: não repara automaticamente os nós. Valor padrão: `true`.	true
auto_repair_policy	object	Não	A política de reparo automático de nós.
restart_node	boolean	Não	Especifica se a reinicialização do nó é permitida. Este parâmetro entra em vigor apenas quando `auto_repair=true`. Valores válidos: `true`: permite a reinicialização do nó. `false`: não permite a reinicialização do nó. Valor padrão: `true`.	true
approval_required	boolean	Não	Especifica se o reparo do nó requer aprovação manual.
auto_vul_fix	boolean	Não	Especifica se deve corrigir automaticamente vulnerabilidades CVE. Este parâmetro entra em vigor apenas quando `enable=true`. `true`: permite a correção automática de CVE. `false`: não permite a correção automática de CVE. Valor padrão: `true`.	true
auto_vul_fix_policy	object	Não	A política de correção automática de CVE.
restart_node	boolean	Não	Especifica se a reinicialização do nó é permitida. Este parâmetro entra em vigor apenas quando `auto_vul_fix=true`. Valores válidos: `true`: permite a reinicialização do nó. `false`: não permite a reinicialização do nó. Valor padrão: `true`.	false
vul_level	string	Não	Os níveis de vulnerabilidade permitidos para correção automática, separados por vírgulas. Exemplo: `asap,later`. Níveis de vulnerabilidade suportados: `asap`: alta `later`: média `nntf`: baixa Valor padrão: `asap`.	asap,nntf
exclude_packages	string	Não	Os pacotes a serem excluídos durante a correção de vulnerabilidades. Valor padrão: `kernel`.	kernel
auto_upgrade	boolean	Não	Especifica se deve atualizar automaticamente os nós. Este parâmetro entra em vigor apenas quando `enable=true`. `true`: ativa a atualização automática. `false`: desativa a atualização automática. Valor padrão: `true`.	true
auto_upgrade_policy	object	Não	A política de atualização automática de nós.
auto_upgrade_kubelet	boolean	Não	Especifica se a atualização automática do kubelet é permitida. Este parâmetro entra em vigor apenas quando `auto_upgrade=true`. Valores válidos: `true`: permite a atualização automática do kubelet. `false`: não permite a atualização automática do kubelet. Valor padrão: `true`.	true
auto_upgrade_runtime	boolean	Não	Especifica se a atualização automática do runtime é permitida. Este parâmetro entra em vigor apenas quando `auto_upgrade=true`. Valores válidos: `true`: permite a atualização automática do runtime. `false`: não permite a atualização automática do runtime. Valor padrão: `true`.	false
auto_upgrade_os	boolean	Não	Especifica se a atualização automática do sistema operacional é permitida. Este parâmetro entra em vigor apenas quando `auto_upgrade=true`. Valores válidos: `true`: permite a atualização automática do SO. `false`: não permite a atualização automática do SO. Valor padrão: `false`.	false
upgrade_config `deprecated`	object	Não	[Obsoleto] Use o parâmetro `auto_upgrade` no nível superior em seu lugar. A configuração de atualização automática. Este parâmetro entra em vigor apenas quando `enable=true`.
auto_upgrade `deprecated`	boolean	Não	[Obsoleto] Use o parâmetro `auto_upgrade` no nível superior em seu lugar. 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.	null
surge	integer	Não	O número de nós extras. Especifique este parâmetro ou `surge_percentage`. Os nós ficam indisponíveis durante as atualizações. Você pode criar nós extras para compensar a carga de trabalho do cluster. Nota O número de nós extras não deve exceder o número atual de nós.	0
surge_percentage	integer	Não	A porcentagem de nós extras. Especifique este parâmetro ou `surge`. Número de nós extras = porcentagem de nós extras × número de nós. Por exemplo, se a porcentagem for definida como 50% e houver 6 nós existentes, o número de nós extras = 50% × 6 = 3.	0
max_unavailable	integer	Não	O número máximo de nós indisponíveis. Valores válidos: [1,1000]. Valor padrão: 1.	1
auto_fault_diagnosis	boolean	Não	Especifica se deve ativar a detecção de falhas ECS para autocura de nós.
drift_enabled	boolean	Não	Especifica se deve ativar a rotação de nós. Apenas node pools gerenciados inteligentes suportam este recurso, e ele é ativado por padrão. Node pools padrão não suportam este recurso.
scaling_group	object	Não	A configuração do grupo de escalonamento para o node pool.
vswitch_ids	array	Sim	A lista de IDs de vSwitch. Valores válidos: [1,8]. Nota Para garantir alta disponibilidade, selecione vSwitches em zonas diferentes.
	string	Não	O ID do vSwitch.	vsw-wz9mfnhmssud6eicu****
instance_types	array	Sim	A lista de tipos de instância para o node pool. Quando o node pool faz scale-out, ele seleciona tipos de instância elegíveis desta lista para criar instâncias. Número de tipos de instância suportados: [1,10]. Nota Para garantir alta disponibilidade, selecione vários tipos de instância.
	string	Não	O tipo de instância. Para mais informações, consulte Famílias de instâncias.	ecs.d1ne.2xlarge
instance_charge_type	string	Sim	O método de cobrança para os nós no node pool. Valores válidos: `PrePaid`: assinatura. `PostPaid`: pay-as-you-go. Valor padrão: `PostPaid`. Valores válidos: PostPaid : Pay-as-you-go. PrePaid : Assinatura.	PostPaid
period	integer	Não	A duração da assinatura para os nós no node pool. Este parâmetro entra em vigor e é obrigatório apenas quando `instance_charge_type` está definido como `PrePaid`. Quando `period_unit=Week`, valores válidos de `period`: {1, 2, 3, 4}. Quando `period_unit=Month`, valores válidos de `period`: {1, 2, 3, 4, 5, 6, 7, 8, 9, 12, 24, 36, 48, 60}.	1
period_unit	string	Não	A unidade de época de cobrança para os nós no node pool. Este parâmetro entra em vigor e é obrigatório apenas quando `instance_charge_type` está definido como `PrePaid`. `Month`: usa mês como unidade de computação (CU). `Week`: usa semana como unidade de computação (CU). Valor padrão: `Month`.	Month
auto_renew	boolean	Não	Especifica se deve ativar a renovação automática para os nós no node pool. 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: `false`.	true
auto_renew_period	integer	Não	A duração de cada ciclo de renovação automática. Valores válidos: Quando PeriodUnit=Week: 1, 2, 3. Quando PeriodUnit=Month: 1, 2, 3, 6, 12, 24, 36, 48, 60. Valor padrão: 1.	1
spot_strategy	string	Não	A política de lance para instâncias spot. Valores válidos: `NoSpot`: instância não spot. `SpotWithPriceLimit`: define um preço máximo para a instância spot. `SpotAsPriceGo`: o sistema dá lance automaticamente pelo preço de mercado atual. Para mais informações, consulte Instâncias spot.	NoSpot
spot_price_limit	array<object>	Não	A configuração de limite de preço para o tipo de instância spot atual.
	object	Não	A configuração de limite de preço para instâncias spot. Você pode definir limites de preço diferentes para tipos de instância diferentes.
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 imagem do sistema operacional. 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 WindowsCore. `ContainerOS`: Imagem otimizada para contêineres. `AliyunLinux3ContainerOptimized`: Imagem Alinux3 otimizada para contêineres.	AliyunLinux3
image_id	string	Não	O ID da imagem personalizada. A imagem fornecida pelo sistema é usada por padrão.	aliyun_2_1903_x64_20G_alibase_20200529.vhd
system_disk_category	string	Não	O tipo de disco em nuvem do sistema 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 em nuvem ESSD Entry. Valor padrão: `cloud_efficiency`.	cloud_efficiency
system_disk_categories	array	Não	Vários tipos de disco em nuvem do sistema. Quando um tipo de disco em nuvem de prioridade mais alta estiver indisponível, o sistema tentará automaticamente o próximo tipo de disco em nuvem prioritário para criar o disco em nuvem do sistema.
	string	Não	Os tipos de disco em nuvem do sistema para os nós. Valores válidos: `cloud`: disco em nuvem básico. `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.	cloud_essd
system_disk_size	integer	Não	O tamanho do disco em nuvem do sistema para os nós. Unidade: GiB. Valores válidos: [20,2048].	120
system_disk_performance_level	string	Não	O nível de desempenho do disco em nuvem do sistema para os nós. Este parâmetro aplica-se apenas a discos em nuvem ESSD. O nível de desempenho está relacionado ao tamanho do disco em nuvem. Para mais informações, consulte ESSDs. PL0: Desempenho de I/O simultâneo máximo moderado com latência de leitura/gravação relativamente estável. PL1: Desempenho de I/O simultâneo máximo moderado 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 de I/O simultâneo máximo ultra-alto com latência de leitura/gravação extremamente estável.	PL1
system_disk_encrypted	boolean	Não	Especifica se deve criptografar o disco em nuvem do sistema. 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 usado pelo disco em nuvem do sistema.	0e478b7a-4262-4802-b8cb-00d3fb40****
system_disk_encrypt_algorithm	string	Não	O algoritmo de criptografia para o disco em nuvem do sistema. Valores válidos: aes-256.	aes-256
system_disk_bursting_enabled	boolean	Não	Especifica se deve ativar burst (burst de desempenho) para o disco em nuvem do sistema do nó. Valores válidos: true: ativa o burst. false: desativa o burst. Este parâmetro é suportado apenas quando `system_disk_category` está definido como `cloud_auto`. Para mais informações, consulte Discos em nuvem ESSD AutoPL.	true
system_disk_provisioned_iops	integer	Não	Os IOPS de leitura/gravação provisionados para o disco em nuvem do sistema do nó. Valores válidos: 0~min{50.000, 1000capacidade-desempenho baseline}. Desempenho baseline=min{1.800+50capacidade, 50000}. Este parâmetro é suportado apenas quando `system_disk_category` está definido como `cloud_auto`. Para mais informações, consulte Discos em nuvem ESSD AutoPL.	1000
data_disks	array	Não	A configuração de disco em nuvem de dados para os nós no node pool.
	data_disk	Não	A configuração do disco em nuvem de dados.
security_group_ids	array	Não	A lista de IDs de grupo de segurança. Especifique 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	Não	A lista de IDs de grupo de segurança. Especifique 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.	sg-wz9a8g2mt6x5ll******
key_pair	string	Não	O nome do par de chaves para logon sem senha. Especifique este parâmetro ou `login_password`. Nota Se o node pool usar o sistema operacional ContainerOS, apenas `key_pair` é suportado.	np-key-name
login_password	string	Não	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.	****
login_as_non_root	boolean	Não	Especifica se as instâncias ECS criadas usam um usuário não root para logon. true: faz logon como um usuário não root (ecs-user). false: faz logon como usuário root.	true
cis_enabled `deprecated`	boolean	Não	[Obsoleto] Use o parâmetro security_hardening_os em seu lugar.	null
soc_enabled	boolean	Não	Especifica se deve ativar o endurecimento de segurança MLPS 2.0. Este recurso está disponível apenas quando a imagem do sistema é Alibaba Cloud Linux 2 ou Alibaba Cloud Linux 3. A Alibaba Cloud fornece padrões de verificação de linha de base de conformidade de proteção classificada e programas de varredura para imagens de Nível 3 MLPS 2.0 do Alibaba Cloud Linux 2 e Alibaba Cloud Linux 3.	false
security_hardening_os	boolean	Não	Especifica se deve ativar o endurecimento de segurança do Alibaba Cloud OS. Valores válidos: `true`: ativa o endurecimento de segurança do Alibaba Cloud OS. `false`: desativa o endurecimento de segurança do Alibaba Cloud OS. Valor padrão: `false`.	false
internet_charge_type	string	Não	O método de cobrança para endereços IP públicos. Valores válidos: PayByBandwidth: pagamento por largura de banda. PayByTraffic: pagamento por transferência de dados.	PayByTraffic
internet_max_bandwidth_out	integer	Não	A largura de banda pública de saída máxima para os nós. Unidade: Mbit/s. Valores válidos: [1,100].	5
tags	array<object>	Não	Tags adicionadas apenas a 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	Não	A tag do nó.
key	string	Não	A chave da tag.	node-k-1
value	string	Não	O valor da tag.	node-v-1
desired_size	integer	Não	O número desejado de nós no node pool. O número total de nós que o node pool deve manter. Configure pelo menos 2 nós para garantir que os componentes do cluster funcionem corretamente. Ajuste a contagem desejada de nós para aumentar ou diminuir o node pool. Se você não precisar criar nós, defina este parâmetro como 0 e ajuste manualmente a contagem de nós posteriormente.	0
multi_az_policy	string	Não	A política de escalonamento multizona para instâncias ECS no grupo de escalonamento. Valores válidos: `PRIORITY`: Escala com base nos vSwitches (VSwitchIds.N) que você definiu. Quando instâncias ECS não puderem ser criadas na zona do vSwitch com a prioridade mais alta, o sistema usará automaticamente o vSwitch com a próxima prioridade mais alta. `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 escal RebalanceInstances	COST_OPTIMIZED
scaling_policy	string	Não	O modo do grupo de escalonamento. Valores válidos: `release`: Modo padrão. Escala criando e liberando instâncias ECS com base no uso de recursos. `recycle`: Modo rápido. Escala criando, parando e iniciando instâncias, o que melhora a velocidade de escalonamento subsequente. Instâncias paradas não são cobradas por recursos de computação, apenas por armazenamento. Isso não se aplica a instâncias com discos locais. Valor padrão: `release`.	release
on_demand_base_capacity	integer	Não	The minimum number of pay-as-you-go instances required in the scaling group. Valid values: [0,1000]. Pay-as-you-go instances are created first when the number of pay-as-you-go instances is less than this value.	0
on_demand_percentage_above_base_capacity	integer	Não	The percentage of pay-as-you-go instances among the excess instances after the minimum number of pay-as-you-go instances (`on_demand_base_capacity`) is met. Valid values: [0,100].	20
spot_instance_pools	integer	Não	The number of available instance types. The scaling group creates spot instances across the lowest-cost instance types in a balanced manner. Valid values: [1,10].	5
spot_instance_remedy	boolean	Não	Specifies whether to enable supplementing spot instances. If enabled, the scaling group attempts to create new instances to replace spot instances that are about to be reclaimed. Valid values: `true`: Enables supplementing spot instances. `false`: Disables supplementing spot instances.	false
compensate_with_on_demand	boolean	Não	Specifies whether to allow automatic creation of pay-as-you-go instances to meet the required number of ECS instances when `multi_az_policy` is set to `COST_OPTIMIZED` and spot instances cannot be created due to price or inventory reasons. Valid values: `true`: Allows automatic creation of pay-as-you-go instances to meet the required number of ECS instances. `false`: Does not allow automatic creation of pay-as-you-go instances to meet the required number of ECS instances.	true
deploymentset_id	string	Não	The deployment set ID. You can use a deployment set to distribute ECS instances scaled out by the node pool across different physical servers to ensure high availability and underlying disaster recovery. When ECS instances are created in a deployment set, they are launched in the specified region based on the preconfigured deployment strategy. Importante After you select a deployment set, the maximum number of nodes in the node pool is limited. By default, a deployment set supports up to 20 × number of zones (the number of zones is determined by the vSwitches). Select carefully and ensure that the deployment set has sufficient quota to avoid node scale-out failures.	ds-bp1d19mmbsv3jf6xxxxx
rds_instances	array	Não	The list of RDS instances.
	string	Não	The RDS instance ID.	rds-****
private_pool_options	object	Não	The private node pool configuration.
id	string	Não	The private node pool ID. When `match_criteria` is set to `Target`, you must specify the private pool ID.	eap-bp67acfmxazb4****
match_criteria	string	Não	The private node pool type. Specifies the private pool capacity option for instance startup. After an elasticity assurance or capacity reservation takes effect, a private pool is generated for instance startup. Valid values: `Open`: Open mode. Automatically matches open-type private pool capacity. If no matching private pool capacity is available, public pool resources are used. `Target`: Targeted mode. Uses the specified private pool capacity to start instances. If the specified private pool capacity is unavailable, instance startup fails. `None`: No private pool. Instances do not use private pool capacity.	Target
security_group_id `deprecated`	string	Não	The security group ID of the node pool. Use either this parameter or `security_group_ids`. We recommend that you use `security_group_ids`.	sg-wz9a8g2mt6x5llu0****
platform `deprecated`	string	Não	[Deprecated] Use the `image_type` parameter instead. The operating system distribution. Valid values: `CentOS` `AliyunLinux` `Windows` `WindowsCore` Default value: `AliyunLinux`.	null
instance_patterns	array	Não	The instance attribute configuration.
	instance_patterns	Não	The instance attributes.
ram_role_name	string	Não	The worker RAM role name. If empty, the default worker RAM role created by the cluster is used. If specified, the RAM role must be a normal service role with its trusted service configured as Elastic Compute Service. For more information, see Create a normal service role. When the specified RAM role is not the default worker RAM role created by the cluster, the role name cannot start with `KubernetesMasterRole-` or `KubernetesWorkerRole-`. Importante This parameter is supported only for ACK managed clusters of version 1.22 or later.	example-role
instance_metadata_options	InstanceMetadataOptions	Não	The ECS instance metadata access configuration.
resource_pool_options	object	Não	The resource pool and resource pool policy used when creating instances. Note the following when you set this parameter: This parameter takes effect only when creating pay-as-you-go instances. This parameter cannot be set together with private_pool_options.match_criteria or private_pool_options.id.
strategy	string	Não	The resource pool strategy used when creating instances. Resource pools include private pools generated after an elasticity assurance or capacity reservation takes effect, and public pools, for instance startup. Valid values: PrivatePoolFirst: Private pool first. When resouce_pool_options.private_pool_ids is specified, the specified private pools are used first. If no private pool is specified or the specified private pool capacity is insufficient, open-type private pools are automatically matched. If no matching private pool is available, public pool resources are used. PrivatePoolOnly: Private pool only. resouce_pool_options.private_pool_ids must be specified. If the specified private pool capacity is insufficient, instance startup fails. None: No resource pool strategy. Default value: None.	PrivatePoolFirst
private_pool_ids	array	Não	The list of private pool IDs, which are elasticity assurance IDs or capacity reservation IDs. Only Target mode private pool IDs can be specified. Valid values of N: 1 to 20.
	string	Não	The private pool ID, which is the elasticity assurance ID or capacity reservation ID. Only Target mode private pool IDs can be specified.	eap-bp67acfmxazb4****
system_disk_snapshot_policy_id	string	Não	The system cloud disk snapshot policy.	sp-0jl6xnmme8v7o935****
disk_init	array	Não	The block device initialization configuration.
	DiskInit	Não	The DiskInit configuration.
cpu_options	object	Não	The CPU-related configuration options.
nested_virtualization	string	Não	Specifies whether to enable nested virtualization. Valid values: disabled: Disables nested virtualization. enabled: Enables nested virtualization.	enabled
node_config	object	Não	The node configuration.
kubelet_configuration	kubelet_config	Não	The Kubelet parameter settings.
kubernetes_config	object	Não	The cluster-related configuration.
labels	array	Não	The node labels. Adds labels to Kubernetes cluster nodes.
	tag	Não	The label configuration.
taints	array	Não	The taint configuration.
	taint	Não	The taint configuration set.
runtime	string	Não	The container runtime name. ACK supports the following three container runtimes: containerd: Recommended. Supported for all cluster versions. Sandboxed-Container.runv: Sandboxed container that provides higher isolation. Supported for cluster versions 1.31 and earlier. docker: No longer maintained. Supported for cluster versions 1.22 and earlier. Default value: containerd.	containerd
runtime_version	string	Não	The container runtime version.	1.6.38
cpu_policy	string	Não	The node CPU management policy. The following two policies are supported for cluster versions 1.12.6 and later: `static`: Allows pods with certain resource characteristics on the node to be granted enhanced CPU affinity and exclusivity. `none`: Enables the existing default CPU affinity scheme. Default value: `none`.	none
user_data	string	Não	The instance user data. After the node joins the cluster, the specified user data script is executed. For more information, see User-Data scripts.	dGhpcyBpcyBhIGV4YW1wbGU=
unschedulable	boolean	Não	Specifies whether scaled-out nodes are unschedulable. true: Unschedulable. false: Schedulable.	true
cms_enabled	boolean	Não	Specifies whether to install CloudMonitor on ECS nodes. After installation, you can view monitoring information for the created ECS instances in the CloudMonitor console. We recommend that you enable this feature. Valid values: `true`: Installs CloudMonitor on ECS nodes. `false`: Does not install CloudMonitor on ECS nodes. Default value: `false`.	false
node_name_mode	string	Não	The custom node name. After you customize the node name, the node name, ECS instance name, and ECS instance hostname are all changed. Nota For Windows instances with custom node names enabled, the hostname is fixed to the IP address with hyphens (-) replacing the dots (.) in the IP address, without the prefix and suffix. The node name consists of a prefix, the node IP address, and a suffix: The total length is 2 to 64 characters. The node name must start and end with a lowercase letter or digit. The prefix and suffix can contain uppercase and lowercase letters, digits, hyphens (-), and periods (.). They must start with an uppercase or lowercase letter and cannot start or end with a hyphen (-) or period (.). Consecutive hyphens (-) or periods (.) are not allowed. The prefix is required (ECS restriction). The suffix is optional. The node IP is the full private IP address of the node. Example: The node IP address is 192.XX.YY.55, the prefix is aliyun.com, and the suffix is test. For Linux nodes, the node name, ECS instance name, and ECS instance hostname are all aliyun.com192.XX.YY.55test. For Windows nodes, the ECS instance hostname is 192-XX-YY-55, and the node name and ECS instance name are both aliyun.com192.XX.YY.55test.	aliyun.com192.XX.YY.55test
pre_user_data	string	Não	The instance pre-user data. Before the node joins the cluster, the specified pre-user data script is executed. For more information, see User-Data scripts.	dGhpcyBpcyBhIGV4YW1wbGU
tee_config	object	Não	The confidential computing cluster configuration.
tee_enable	boolean	Não	Specifies whether to enable confidential computing for the cluster. true: Enables confidential computing. false: Does not enable confidential computing.	true
interconnect_config `deprecated`	object	Não	[Deprecated] The edge node pool configuration.
cen_id	string	Não	[Deprecated] The Cloud Enterprise Network (CEN) instance ID bound to the edge enhanced node pool.	null
ccn_id	string	Não	[Deprecated] The Cloud Connect Network (CCN) instance ID bound to the edge enhanced node pool.	null
ccn_region_id	string	Não	[Deprecated] The region of the Cloud Connect Network instance bound to the edge enhanced node pool.	null
bandwidth	integer	Não	[Deprecated] The network bandwidth of the edge enhanced node pool. Unit: Mbps.	null
improved_period	string	Não	[Deprecated] The purchase duration of the edge enhanced node pool. Unit: months.	null
count `deprecated`	integer	Não	[Deprecated] Use desired_size instead. The number of nodes in the node pool.	null
max_nodes `deprecated`	integer	Não	[Deprecated] The maximum number of nodes allowed in the edge node pool.	null
interconnect_mode	string	Não	The network type of the edge node pool. This parameter takes effect only for node pools with `type` set to `edge`. Valid values: `basic`: Public network. Nodes in cloud node pool interact with cloud nodes over the Internet. Applications in cloud node pool cannot directly access the cloud VPC internal network. `private`: Private network. Nodes in cloud node pool connect to the cloud through Express Connect, VPN, or CEN, providing higher cloud-edge communication quality and more effective security.	basic
host_network	boolean	Não	Specifies whether the pod network mode uses host network mode. `true`: Host network. Pods directly use the host network stack and share the IP address and ports with the host. `false`: Container network. Pods have independent network stacks and do not occupy host network ports.	true
intranet	boolean	Não	Specifies whether nodes in the edge node pool have Layer 3 network connectivity with each other. `true`: Connected. All nodes in the node pool have Layer 3 network connectivity. `false`: Not connected. All nodes in the node pool do not have Layer 3 network connectivity.	true
eflo_node_group	object	Não	The Lingjun node pool configuration.
cluster_id	string	Não	The Lingjun cluster ID to associate when creating a Lingjun node pool.	i1169130516633730****
group_id	string	Não	The Lingjun group ID of the Lingjun cluster to associate when creating a Lingjun node pool.	ng-ec3c96ff0aa****
auto_attach_enabled	boolean	Não	Specifies whether to enable automatic node addition for the Lingjun node pool.
worker_ram_role_name	string	Não	The worker RAM role used by the Lingjun node pool.
auto_mode	object	Não	The intelligent managed configuration for the node pool.
enable	boolean	Não	Specifies whether to enable intelligent managed mode. Valid values: true: Enables intelligent managed mode. This can be enabled only when the cluster has intelligent managed mode enabled. false: Does not enable intelligent managed mode.	true
node_components	array<object>	Não	The list of node components.
	array<object>	Não	The node component.
name	string	Não	The node component name.	kubelet
version	string	Não	The node component version.	1.33.3-aliyun.1
config	object	Não	The node component configuration.
custom_config	object	Não	The custom node component configuration.	{"cpuManagerPolicy":"static"}
	any	Não	The custom node component configuration string.	cpuManagerPolicy

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	The node pool configuration.
nodepool_id	string	The node pool ID.	np31da1b38983f4511b490fc62108a****
task_id	string	The task ID.	T-613b19bbd160ad492800****
request_id	string	The request ID.	0527ac9a-c899-4341-a21a-****

Exemplos

Resposta de sucesso

JSON formato

{
  "nodepool_id": "np31da1b38983f4511b490fc62108a****",
  "task_id": "T-613b19bbd160ad492800****",
  "request_id": "0527ac9a-c899-4341-a21a-****"
}

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.