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

Um pool de nós é uma coleção lógica de nós que compartilham os mesmos atributos. Os pools de nós permitem gerenciar e manter os nós de maneira unificada, como atualizações de nós e escalonamento elástico. Você também pode utilizar os recursos automatizados de O&M dos pools de nós, incluindo correção automática de vulnerabilidades CVE do SO, 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. Você pode chamar CreateClusterNodePool para criar um pool de nós para um cluster.

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 pool de nós.
name	string	Sim	O nome do pool de nós.	nodepool-test
type	string	Não	O tipo de pool de nós. Valores válidos: `ess`: pool de nós regular (inclui recursos gerenciados e escalonamento elástico). `edge`: pool de nós de borda. `lingjun`: pool de nós Lingjun. `hybrid`: pool de nós de nuvem híbrida. Valores válidos: lingjun : Pool de nós Lingjun. edge : Pool de nós de borda. ess : Pool de nós regular.	ess
resource_group_id	string	Não	O ID do grupo de recursos do pool de nós. As instâncias expandidas pelo 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, aplicações ou organizações com base em diferentes cenários de negócios.	rg-acfmyvw3wjmb****
auto_scaling	object	Não	A configuração de escalonamento elástico.
enable	boolean	Não	Especifica se o escalonamento automático deve ser ativado. Valores válidos: `true`: ativa o recurso de escalonamento automático para o pool de nós. Quando o planejamento de capacidade do cluster não consegue atender aos requisitos de agendamento de Pods da aplicação, o ACK escala automaticamente os recursos de nós com base nas contagens mínima e máxima de instâncias configuradas. Clusters da versão 1.24 ou posterior ativam o escalonamento instantâneo 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 pool de nós 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. 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 de compartilhamento 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 pool de nós. Valores válidos: spot : Tipo de instância spot. cpu : Tipo de instância regular. gpushare : Tipo de compartilhamento 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 pool de nós, 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 pool de nós, 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. Defina o número máximo de instâncias com um valor que não seja inferior ao número atual de nós no pool de nós. Caso contrário, os nós no pool de nós serão reduzidos após o recurso de escalonamento elástico entrar em vigor.	1
is_bond_eip `deprecated`	boolean	Não	[Descontinuado] Este parâmetro foi descontinuado. Use internet_charge_type e internet_max_bandwidth_out em seu lugar. Especifica se um EIP deve ser associado. 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	[Descontinuado] Use internet_charge_type e internet_max_bandwidth_out em seu lugar. O método de cobrança do EIP. Valores válidos: `PayByBandwidth`: pagamento por largura de banda. `PayByTraffic`: pagamento por tráfego. Valor padrão: `PayByBandwidth`.	null
eip_bandwidth `deprecated`	integer	Não	[Descontinuado] 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 do recurso de pool de nós gerenciado.
enable	boolean	Não	Especifica se o recurso de pool de nós gerenciado deve ser ativado. Valores válidos: `true`: Ativado. `false`: Desativado. Outras configurações relacionadas entram em vigor apenas quando enable está definido como true. Valor padrão: false.	false
auto_repair	boolean	Não	Especifica se o reparo automático de nós deve ser ativado. Este parâmetro entra em vigor apenas quando `enable=true`. `true`: Ativado. `false`: Desativado. 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 as reinicializações de nós são permitidas. Este parâmetro entra em vigor apenas quando `auto_repair=true`. Valores válidos: `true`: As reinicializações de nós são permitidas. `false`: As reinicializações de nós não são permitidas. Valor padrão: `true`.	true
approval_required	boolean	Não	Especifica se a aprovação manual é necessária para o reparo de nós.
max_parallel_repairing_nodes	string	Não	O número máximo de nós que podem ser reparados em paralelo. Quando existe um grande número de nós não íntegros 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, intervalo válido: 1 a 100000) ou uma porcentagem (como 10%, intervalo válido: 1% a 100%). Valor padrão: 1.	5
max_unhealthy_nodes_threshold	string	Não	O limite do disjuntor de autocura. Quando o número ou a porcentagem de nós com falha excede esse limite, a autocura entra em estado de disjuntor e para de iniciar novas ações de reparo. Você pode especificar um número (como 10, intervalo válido: 1 a 100000) ou uma porcentagem (como 20%, intervalo válido: 1% a 100%). Valor padrão: 100%.	20%
auto_vul_fix	boolean	Não	Especifica se a correção automática de vulnerabilidades CVE deve ser ativada. Este parâmetro entra em vigor apenas quando `enable=true`. `true`: A correção automática de CVE está ativada. `false`: A correção automática de CVE está desativada. 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 as reinicializações de nós são permitidas. Este parâmetro entra em vigor apenas quando `auto_vul_fix=true`. Valores válidos: `true`: As reinicializações de nós são permitidas. `false`: As reinicializações de nós não são permitidas. 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`. Valores válidos: `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 a atualização automática de nós deve ser ativada. Este parâmetro entra em vigor apenas quando `enable=true`. `true`: A atualização automática está ativada. `false`: A atualização automática está desativada. 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`: A atualização automática do kubelet é permitida. `false`: A atualização automática do kubelet não é permitida. 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`: A atualização automática do runtime é permitida. `false`: A atualização automática do runtime não é permitida. 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`: A atualização automática do SO é permitida. `false`: A atualização automática do SO não é permitida. Valor padrão: `false`.	false
upgrade_config `deprecated`	object	Não	[Descontinuado] 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=true`.
auto_upgrade `deprecated`	boolean	Não	[Descontinuado] Use o parâmetro `auto_upgrade` no nível superior em vez disso. Especifica se a atualização automática deve ser ativada. Valores válidos: `true`: A atualização automática está ativada. `false`: A atualização automática está desativada.	null
surge	integer	Não	O número de nós extras. Você pode especificar este parâmetro ou `surge_percentage`. Os nós ficam indisponíveis durante uma atualização. 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. Você pode especificar este parâmetro ou `surge`. Número de nós extras = porcentagem extra de nós × número de nós. Por exemplo, se a porcentagem extra de nós estiver 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. Intervalo válido: [1,1000]. Valor padrão: 1.	1
auto_fault_diagnosis	boolean	Não	Especifica se a detecção de falhas ECS para autocura de nós deve ser ativada.
drift_enabled	boolean	Não	Especifica se a rotação de nós deve ser ativada. Apenas pools de nós gerenciados inteligentes suportam este recurso, e ele é ativado por padrão. Pools de nós comuns não suportam este recurso.
scaling_group	object	Não	A configuração do grupo de escalonamento do pool de nós.
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 pool de nós. Quando o pool de nós escala horizontalmente, as instâncias são criadas com base nos tipos de instância que atendem aos requisitos desta lista. O número de tipos de instância suportados varia de 1 a 10. Nota Para garantir alta disponibilidade, especifique 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 dos nós no pool de nós. Valores válidos: `PrePaid`: assinatura. `PostPaid`: pay-as-you-go. Valor padrão: `PostPaid`. Valores válidos: PostPaid : Instância pay-as-you-go. PrePaid : Instância de assinatura.	PostPaid
period	integer	Não	A duração da assinatura dos nós no pool de nós. Este parâmetro entra em vigor e é obrigatório apenas quando `instance_charge_type` está definido como `PrePaid`. Se `period_unit=Week`, valores válidos de `period`: {1, 2, 3, 4}. Se `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 época de cobrança dos nós no pool de nós. Este parâmetro entra em vigor e é obrigatório apenas quando `instance_charge_type` está definido como `PrePaid`. `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 a renovação automática deve ser ativada para os nós no pool de nós. Este parâmetro entra em vigor apenas quando `instance_charge_type` está definido como `PrePaid`. Valores válidos: `true`: ativa a renovação automática. `false`: desativa a renovação automática. Valor padrão: `false`.	true
auto_renew_period	integer	Não	A duração da renovação automática para uma única renovação. Valores válidos: PeriodUnit=Week: 1, 2, 3. PeriodUnit=Month: 1, 2, 3, 6, 12, 24, 36, 48, 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`: instância spot com limite de preço. `SpotAsPriceGo`: o sistema faz lances automaticamente pelo preço de mercado atual. Para mais informações, consulte Instâncias spot.	NoSpot
spot_price_limit	array<object>	Não	As configurações de faixa de preço para o tipo de instância spot atual.
	object	Não	A configuração de faixa de preço para instâncias spot. Você pode definir faixas de preço diferentes para tipos de instância diferentes.
instance_type	string	Não	O tipo de instância da 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 do disco em nuvem do sistema do nó. 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	Os vários tipos de disco em nuvem para o disco em nuvem do sistema. Quando um tipo de disco em nuvem de maior prioridade 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 vários tipos de disco em nuvem do sistema para o nó. 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 do nó. 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 do nó. Este parâmetro entra em vigor apenas para discos em nuvem ESSD. O nível de desempenho varia com base no tamanho do disco em nuvem. Para mais informações, consulte Discos em nuvem ESSD. PL0: desempenho de E/S simultânea máxima moderada com latência de leitura/gravação relativamente estável. PL1: desempenho de E/S simultânea máxima moderada com latência de leitura/gravação relativamente estável. PL2: alto desempenho de E/S simultânea máxima com latência de leitura/gravação estável. PL3: desempenho de E/S simultânea máxima ultra-alto com 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 usado pelo disco em nuvem do sistema.	0e478b7a-4262-4802-b8cb-00d3fb40****
system_disk_encrypt_algorithm	string	Não	O algoritmo de criptografia usado pelo disco em nuvem do sistema. Valores válidos: aes-256.	aes-256
system_disk_bursting_enabled	boolean	Não	Especifica se o burst (aumento de desempenho) deve ser ativado 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 do disco em nuvem do sistema do nó. Valores válidos: 0 a min{50.000, 1000 × capacidade - desempenho de linha de base}. Desempenho de linha de base = min{1.800 + 50 × capacidade, 50000}. Este parâmetro é suportado apenas quando `system_disk_category` está definido como `cloud_auto`. Para mais informações, consulte Discos em nuvem ESSD AutoPL.	1000
data_disks	array	Não	As configurações de disco em nuvem de dados dos nós no pool de nós.
	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. Use este parâmetro ou `security_group_id`. Recomendamos que você use `security_group_ids`. Se ambos `security_group_id` e `security_group_ids` forem especificados, `security_group_ids` terá precedência.
	string	Não	A lista de IDs de grupo de segurança. Use este parâmetro ou `security_group_id`. Recomendamos que você use `security_group_ids`. Se ambos `security_group_id` e `security_group_ids` forem especificados, `security_group_ids` terá precedência.	sg-wz9a8g2mt6x5ll******
key_pair	string	Não	O nome do par de chaves para logon sem senha. Use este parâmetro ou `login_password`. Nota Se o pool de nós usar o sistema operacional ContainerOS, apenas `key_pair` é suportado.	np-key-name
login_password	string	Não	A senha de logon SSH. Use este parâmetro ou `key_pair`. A senha deve ter de 8 a 30 caracteres e conter pelo menos três dos seguintes tipos de caracteres: letras maiúsculas, letras minúsculas, dígitos e caracteres especiais.	****
login_as_non_root	boolean	Não	Especifica se a instância ECS escalonada horizontalmente usa um usuário não root para logon. true: faz logon como um usuário não root (ecs-user). false: faz logon como o usuário root.	true
cis_enabled `deprecated`	boolean	Não	[Descontinuado] Use o parâmetro security_hardening_os em vez deste.	null
soc_enabled	boolean	Não	Especifica se o endurecimento de segurança MLPS 2.0 deve ser ativado. Este recurso pode ser ativado 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 do MLPS 2.0 do Alibaba Cloud Linux 2 e Alibaba Cloud Linux 3.	false
security_hardening_os	boolean	Não	Especifica se o endurecimento de segurança do Alibaba Cloud OS deve ser ativado. 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: cobrado com base na largura de banda fixa. PayByTraffic: cobrado com base no uso de tráfego.	PayByTraffic
internet_max_bandwidth_out	integer	Não	A largura de banda pública de saída máxima do nó. 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 pool de nós. O número total de nós que o pool de nós deve manter. Recomendamos que você configure pelo menos 2 nós para garantir que os componentes do cluster funcionem corretamente. Você pode escalar o pool de nós horizontalmente ou verticalmente ajustando a contagem desejada de nós. Se você não precisar criar nós, defina este parâmetro como 0. Você pode ajustar o valor manualmente mais tarde para adicionar nós.	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`: Escalona instâncias com base nos vSwitches (VSwitchIds.N) que você define. Quando não for possível criar instâncias ECS na zona do vSwitch com a prioridade mais alta, o sistema usa automaticamente o vSwitch com a próxima prioridade mais alta para criar instâncias ECS. `COST_OPTIMIZED`: Tenta criar instâncias em ordem de preço unitário de vCPU do menor para o maior. Quando as configurações de escalonamento especificam vários tipos de instância com o método de cobrança preemptível, as instâncias spot são criadas primeiro. Você pode usar o parâmetro `CompensateWithOnDemand` para especificar se deve tentar automaticamente criar instâncias pay-as-you-go quando as instâncias spot não puderem ser criadas devido a estoque insuficiente 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 zonas ficarem desbalanceadas devido a estoque insuficiente ou outros motivos, você pode chamar a operação de API RebalanceInstances para reequilibrar os recursos. Valor padrão: `PRIORITY`.	COST_OPTIMIZED
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. `recycle`: modo rápido. Escalona instâncias criando, parando e iniciando instâncias ECS, o que melhora a velocidade das operações de escalonamento subsequentes. Os recursos de computação não são cobrados durante o período de parada. Apenas taxas de armazenamento são cobradas, exceto para instâncias com discos locais. Valor padrão: `release`.	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,1000]. Quando o número de instâncias pay-as-you-go for inferior a este valor, as instâncias pay-as-you-go serão criadas primeiro.	0
on_demand_percentage_above_base_capacity	integer	Não	A porcentagem de instâncias pay-as-you-go entre as instâncias extras que excedem o número mínimo de instâncias pay-as-you-go (`on_demand_base_capacity`) no grupo de escalonamento. Valores válidos: [0,100].	20
spot_instance_pools	integer	Não	O número de tipos de instância disponíveis. O grupo de escalonamento cria instâncias spot de vários tipos ao menor custo. Valores válidos: [1,10].	5
spot_instance_remedy	boolean	Não	Especifica se a suplementação de instâncias spot deve ser ativada. Se ativado, quando o sistema recebe uma notificação de que uma instância spot será recuperada, o grupo de escalonamento tenta criar uma nova instância para substituir a instância spot que será recuperada. Valores válidos: `true`: Ativa a suplementação de instâncias spot. `false`: Desativa a suplementação de instâncias spot.	false
compensate_with_on_demand	boolean	Não	Especifica se deve permitir a criação automática de instâncias pay-as-you-go para atender ao número necessário de instâncias ECS quando `multi_az_policy` está definido como `COST_OPTIMIZED` e as instâncias spot não puderem ser criadas devido a custos, estoque ou outros motivos. Valores válidos: `true`: Permite a criação automática de instâncias pay-as-you-go para atender ao número necessário de instâncias ECS. `false`: Não permite a criação automática de 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. Isso é 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 suportado pelo tipo de instância.	false
deploymentset_id	string	Não	O ID do conjunto de implantação. Você pode usar um conjunto de implantação para distribuir instâncias ECS escalonadas horizontalmente pelo pool de nós em diferentes servidores físicos para garantir alta disponibilidade e recuperação de desastres subjacente. Quando instâncias ECS são criadas dentro de um conjunto de implantação, elas são iniciadas na região especificada com base na política de implantação pré-configurada. Importante Após selecionar um conjunto de implantação, o número máximo de nós no pool de nós é limitado. O número máximo padrão de nós suportado por um conjunto de implantação é 20 × o número de zonas (o número de zonas é determinado pelos vSwitches). Selecione cuidadosamente e garanta que o conjunto de implantação tenha cota suficiente para evitar falhas no escalonamento horizontal de nós.	ds-bp1d19mmbsv3jf6xxxxx
rds_instances	array	Não	A lista de instâncias do ApsaraDB RDS.
	string	Não	O ID da instância do ApsaraDB RDS.	rds-****
private_pool_options	object	Não	A configuração 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 de pool de nós privado. Especifica a opção de capacidade do pool privado para inicialização de instâncias. Após uma garantia de elasticidade ou reserva de capacidade entrar em vigor, um pool privado é gerado para inicialização de instâncias. Valores válidos: `Open`: modo aberto. Corresponde automaticamente à capacidade do pool privado aberto. Se nenhuma capacidade de pool privado correspondente estiver disponível, os recursos do pool público serão usados. `Target`: modo direcionado. Usa a capacidade do pool privado especificado para iniciar instâncias. Se a capacidade do pool privado especificado não estiver disponível, a inicialização da instância falhará. `None`: modo nenhum. A inicialização da instância não usa capacidade de pool privado.	Target
security_group_id `deprecated`	string	Não	O ID do grupo de segurança do pool de nós. Use este parâmetro ou `security_group_ids`. O uso de `security_group_ids` é recomendado.	sg-wz9a8g2mt6x5llu0****
platform `deprecated`	string	Não	[Descontinuado] Use o parâmetro `image_type` em vez disso. A distribuição do sistema operacional. Valores válidos: `CentOS` `AliyunLinux` `Windows` `WindowsCore` Valor padrão: `AliyunLinux`.	null
instance_patterns	array	Não	A configuração de atributos da instância.
	instance_patterns	Não	Os atributos da instância.
ram_role_name	string	Não	O nome da função RAM do Worker. Se deixado em branco, a função RAM do Worker padrão criada pelo cluster será usada. Se especificado, a função RAM deve ser uma função de serviço regular com seu serviço confiável configurado como Elastic Compute Service. Para mais informações, consulte Criar uma função de serviço regular. Quando a função RAM especificada não for a função RAM do Worker padrão criada pelo cluster, o nome da função não pode começar com `KubernetesMasterRole-` ou `KubernetesWorkerRole-`. Importante Apenas clusters gerenciados ACK versão 1.22 ou posterior suportam este parâmetro.	example-role
instance_metadata_options	InstanceMetadataOptions	Não	A configuração de acesso a metadados da instância ECS.
resource_pool_options	object	Não	O pool de recursos e a política de pool de recursos usados ao criar instâncias. Após definir este parâmetro, observe o seguinte: Este parâmetro entra em vigor apenas ao criar instâncias pay-as-you-go. Este parâmetro não pode ser definido junto com private_pool_options.match_criteria ou private_pool_options.id.
strategy	string	Não	A política de pool de recursos usada ao criar instâncias. Os pools de recursos incluem pools privados gerados após uma garantia de elasticidade ou reserva de capacidade entrar em vigor, e pools públicos, para inicialização de instâncias. Valores válidos: PrivatePoolFirst: pool privado primeiro. Quando esta política é selecionada e resouce_pool_options.private_pool_ids é especificado, os pools privados especificados são usados primeiro. Se nenhum pool privado for especificado ou a capacidade do pool privado especificado for insuficiente, os pools privados abertos serão correspondidos automaticamente. Se nenhum pool privado correspondente estiver disponível, os recursos do pool público serão usados. PrivatePoolOnly: apenas pool privado. Quando esta política é selecionada, resouce_pool_options.private_pool_ids deve ser especificado. Se a capacidade do pool privado especificado for insuficiente, a inicialização da instância falhará. None: sem política de pool de recursos. Valor padrão: None.	PrivatePoolFirst
private_pool_ids	array	Não	A lista de IDs de pool privado, que são IDs de garantia de elasticidade ou IDs de reserva de capacidade. Apenas IDs de pool privado do modo Target podem ser especificados. Valores válidos de N: 1 a 20.
	string	Não	O ID do pool privado, que é um ID de garantia de elasticidade ou ID de reserva de capacidade. Apenas IDs de pool privado do modo Target podem ser especificados.	eap-bp67acfmxazb4****
system_disk_snapshot_policy_id	string	Não	A política de snapshot para o disco em nuvem do sistema.	sp-0jl6xnmme8v7o935****
disk_init	array	Não	A configuração de inicialização de dispositivo de bloco.
	DiskInit	Não	A configuração DiskInit.
cpu_options	object	Não	As opções de configuração relacionadas à CPU.
nested_virtualization	string	Não	Especifica se a virtualização aninhada deve ser ativada. Valores válidos: disabled: desativa a virtualização aninhada. enabled: ativa a virtualização aninhada.	enabled
node_config	object	Não	A configuração do nó.
kubelet_configuration	kubelet_config	Não	As configurações de parâmetros do kubelet.
kubernetes_config	object	Não	A configuração relacionada ao cluster.
labels	array	Não	Os labels do nó. Você pode adicionar labels aos nós no cluster Kubernetes.
	tag	Não	A configuração do label.
taints	array	Não	A configuração de taint.
	taint	Não	A coleção de configurações de taint.
runtime	string	Não	O nome do runtime de contêiner. O ACK suporta os três runtimes de contêiner a seguir: containerd: Recomendado. Suportado por todas as versões de cluster. Sandboxed-Container.runv: Contêiner sandbox que oferece maior isolamento. Suportado por clusters da versão 1.31 e anteriores. docker: Não é mais mantido. Suportado por 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 nós. As duas políticas a seguir são suportadas para clusters da versão 1.12.6 e posteriores: `static`: Permite que pods com determinadas características de recursos no nó recebam afinidade de CPU aprimorada e exclusividade. `none`: Habilita o esquema de afinidade de CPU padrão existente. Valor padrão: `none`.	none
user_data	string	Não	Os dados de usuário da instância. Após o nó ingressar no cluster, o script de dados de usuário especificado é executado. Para mais informações, consulte Scripts de dados de usuário.	dGhpcyBpcyBhIGV4YW1wbGU=
unschedulable	boolean	Não	Especifica se os nós não são agendáveis após o scale-out. true: Não agendável. false: Agendável.	true
cms_enabled	boolean	Não	Especifica se o agente do CloudMonitor deve ser instalado em nós ECS. Após a instalação, você pode visualizar informações de monitoramento sobre as instâncias ECS criadas no console do CloudMonitor. Recomendamos que você ative esse recurso. Valores válidos: `true`: Instala o agente do CloudMonitor em nós ECS. `false`: Não instala o agente do CloudMonitor em nós ECS. Valor padrão: `false`.	false
node_name_mode	string	Não	O nome personalizado do nó. Após personalizar o nome do nó, o nome do nó, o nome da instância ECS e o hostname da instância ECS são alterados de acordo. Nota Para instâncias Windows com nomes personalizados de nó habilitados, o hostname é fixado no endereço IP com hifens (-) substituindo os pontos (.) no endereço IP, e não inclui o prefixo ou sufixo. O nome do nó consiste em três partes: prefixo, endereço IP do nó e sufixo. O comprimento total é de 2 a 64 caracteres. O nome do nó deve começar e terminar com uma letra minúscula ou dígito. O prefixo e o sufixo podem conter letras maiúsculas e minúsculas, dígitos, hifens (-) e pontos (.). Eles devem começar com uma letra maiúscula ou minúscula e não podem começar ou terminar com um hífen (-) ou ponto (.). Hifens (-) ou pontos (.) consecutivos não são permitidos. O prefixo é obrigatório (restrição do ECS). O sufixo é opcional. O IP do nó é o endereço IP privado completo do nó. Exemplo: Se o endereço IP do nó for 192.XX.YY.55, o prefixo for aliyun.com e o sufixo for test: Para um nó Linux, o nome do nó, o nome da instância ECS e o hostname da instância ECS são todos aliyun.com192.XX.YY.55test. Para um nó Windows, o hostname da instância ECS é 192-XX-YY-55, e o nome do nó e o nome da instância ECS são ambos aliyun.com192.XX.YY.55test.	aliyun.com192.XX.YY.55test
pre_user_data	string	Não	Os dados de pré-usuário da instância. Antes de o nó ingressar no cluster, o script de dados de pré-usuário especificado é executado. Para mais informações, consulte Scripts de dados de usuário.	dGhpcyBpcyBhIGV4YW1wbGU
tee_config	object	Não	A configuração do cluster de computação confidencial.
tee_enable	boolean	Não	Especifica se a computação confidencial deve ser ativada para o cluster. true: Ativa a computação confidencial. false: Não ativa a computação confidencial.	true
interconnect_config `deprecated`	object	Não	[Obsoleto] A configuração do pool de nós de borda.
cen_id	string	Não	[Deprecated] O ID da instância da Cloud Enterprise Network (CEN) vinculada ao pool de nós de borda aprimorado.	null
ccn_id	string	Não	[Deprecated] O ID da instância da Cloud Connect Network (CCN) vinculada ao pool de nós de borda aprimorado.	null
ccn_region_id	string	Não	[Deprecated] A região da instância da Cloud Connect Network (CCN) vinculada ao pool de nós de borda aprimorado.	null
bandwidth	integer	Não	[Deprecated] A largura de banda de rede do pool de nós de borda aprimorado. Unidade: Mbps.	null
improved_period	string	Não	[Deprecated] A duração da compra do pool de nós de borda aprimorado. Unidade: meses.	null
count `deprecated`	integer	Não	[Deprecated] Use desired_size em vez disso. O número de nós no pool de nós.	null
max_nodes `deprecated`	integer	Não	[Obsoleto] O número máximo de nós permitidos no pool de nós de borda.	null
interconnect_mode	string	Não	O tipo de rede do pool de nós de borda. Este parâmetro entra em vigor apenas para pools de nós cujo `type` é `edge`. Valores válidos: `basic`: Rede pública. Os nós no pool de nós em nuvem interagem com os nós em nuvem pela Internet. As aplicações no pool de nós em nuvem não podem acessar diretamente a rede privada VPC na nuvem. `private`: Rede privada. Os nós no pool de nós em nuvem conectam-se à nuvem através do Express Connect, VPN ou CEN, proporcionando maior qualidade de comunicação nuvem-borda e segurança mais eficaz.	basic
host_network	boolean	Não	Especifica se o modo de rede do pod usa o modo de rede do host. `true`: Rede do host. Os pods usam diretamente a pilha de rede do host e compartilham o endereço IP e as portas com o host. `false`: Rede de contêiner. Os pods possuem pilhas de rede independentes e não ocupam portas de rede do host.	true
intranet	boolean	Não	Especifica se os nós no pool de nós de borda têm conectividade de rede de camada 3 entre si. `true`: Conectado. Todos os nós no pool de nós têm conectividade de rede de camada 3 entre si. `false`: Não conectado. Todos os nós no pool de nós não têm conectividade de rede de camada 3 entre si.	true
eflo_node_group	object	Não	A configuração do pool de nós Lingjun.
cluster_id	string	Não	O ID do cluster Lingjun a ser associado ao criar um pool de nós Lingjun.	i1169130516633730****
group_id	string	Não	O ID do grupo Lingjun do cluster Lingjun a ser associado ao criar um pool de nós Lingjun.	ng-ec3c96ff0aa****
auto_attach_enabled	boolean	Não	Especifica se a adição automática de nós deve ser ativada para o pool de nós Lingjun.
worker_ram_role_name	string	Não	A função RAM do Worker usada pelo pool de nós Lingjun.
auto_mode	object	Não	A configuração gerenciada inteligente para o pool de nós.
enable	boolean	Não	Especifica se o modo gerenciado inteligente deve ser ativado. Valores válidos: true: Ativa o modo gerenciado inteligente. Isso só pode ser ativado quando o cluster tiver o modo gerenciado inteligente ativado. false: Não ativa o modo gerenciado inteligente.	true
node_components	array<object>	Não	A lista de componentes do nó.
	array<object>	Não	O componente do nó.
name	string	Não	O nome do componente do nó.	kubelet
version	string	Não	A versão do componente do nó.	1.33.3-aliyun.1
config	object	Não	A configuração do componente do nó.
custom_config	object	Não	A configuração personalizada do componente do nó.	{"cpuManagerPolicy":"static"}
	any	Não	A string de configuração personalizada do componente do nó.	cpuManagerPolicy
envs	array<object>	Não	As variáveis de ambiente do componente do nó.
	object	Não
name	string	Não	O nome da variável de ambiente.	LOG_LEVEL
value	string	Não	O valor da variável de ambiente.	info

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	A configuração do pool de nós.
nodepool_id	string	O ID do pool de nós.	np31da1b38983f4511b490fc62108a****
task_id	string	O ID da tarefa.	T-613b19bbd160ad492800****
request_id	string	O ID da solicitação.	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.