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

Cria um pool de nós para um cluster. Um pool de nós é uma coleção lógica de nós que compartilham a mesma propriedade, permitindo o gerenciamento e a O&M unificados dos nós, como atualizações de nós e escalonamento elástico. Você pode usar ainda os recursos de O&M automatizada dos pools de nós para reduzir os custos de O&M. Esses recursos incluem o reparo automático de vulnerabilidades CVE do SO, a recuperação automática de nós com falha e as atualizações automáticas das versões do kubelet e do containerd. Você pode invocar 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.
auto_mode	object	Não	A configuração de gerenciamento inteligente do pool de nós.
enable	boolean	Não	Especifica se o modo de gerenciamento inteligente deve ser ativado. Valores válidos: true: ativa o modo de gerenciamento inteligente. Este valor é válido apenas quando o modo de gerenciamento inteligente está ativado para o cluster. false: desativa o modo de gerenciamento inteligente.	true
auto_scaling	object	Não	A configuração de escalonamento elástico.
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
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`: cobrança por largura de banda. `PayByTraffic`: cobrança por transferência de dados. Valor padrão: `PayByBandwidth`.	null
enable	boolean	Não	Especifica se o escalonamento automático deve ser ativado. Valores válidos: `true`: ativa o escalonamento 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 escala 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 do Kubernetes e posteriores, a elasticidade just-in-time é ativada por padrão. Para clusters anteriores à versão 1.24, o escalonamento automático é ativado por padrão. Para obter 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 no número esperado de nós configurado e sempre mantém o número de nós no valor esperado. Quando este parâmetro é definido como false, outros parâmetros de configuração em `auto_scaling` não entram em vigor. Valor padrão: `false`.	false
is_bond_eip `deprecated`	boolean	Não	[Descontinuado] Use internet_charge_type e internet_max_bandwidth_out em seu lugar. Especifica se um EIP deve ser vinculado. Valores válidos: `true`: vincula um EIP. `false`: não vincula um EIP. Valor padrão: `false`.	null
max_instances	integer	Não	O número máximo de instâncias escalonáveis no pool de nós, excluindo as instâncias existentes. Este parâmetro entra em vigor apenas 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 escalonáveis no pool de nós, excluindo as instâncias existentes. Este parâmetro entra em vigor apenas 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á acionada após o grupo de escalonamento entrar em vigor. Defina o número máximo de instâncias com um valor maior ou igual 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 diretamente reduzidos após o recurso de escalonamento elástico entrar em vigor.	1
type	string	Não	O tipo de instância para escalonamento elástico. Este parâmetro entra em vigor apenas quando `enable` é definido como true. 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`. Importante Este parâmetro não pode ser modificado após a criação do pool de nós. Valores válidos: spot : Instância spot. cpu : Instância regular. gpushare : Instância acelerada por GPU compartilhada. gpu : Instância acelerada por GPU.	cpu
count `deprecated`	integer	Não	[Descontinuado] Use desired_size em seu lugar. O número de nós no pool de nós.	null
eflo_node_group	object	Não	A configuração do pool de nós Lingjun.
auto_attach_enabled	boolean	Não	Especifica se a adição automática deve ser ativada para o pool de nós Lingjun.
cluster_id	string	Não	O ID do cluster Lingjun a ser associado ao criar o pool de nós Lingjun.	i1169130516633730****
group_id	string	Não	O ID do grupo Lingjun no cluster Lingjun a ser associado ao criar o pool de nós Lingjun.	ng-ec3c96ff0aa****
worker_ram_role_name	string	Não	A função RAM do worker usada pelo pool de nós Lingjun.	KubernetesWorkerRole-1025ec00-9a27-4c63-8a98-******
host_network	boolean	Não	Especifica se os pods no pool de nós de borda são implantados no modo de rede do host. Valores válidos: `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 do contêiner. Os pods têm pilhas de rede independentes e não ocupam as portas de rede do host.	true
interconnect_config `deprecated`	object	Não	[Descontinuado] A configuração do pool de nós de borda.
bandwidth	integer	Não	[Descontinuado] A largura de banda da rede do pool de nós de borda aprimorado. Unidade: Mbit/s.	null
ccn_id	string	Não	[Descontinuado] O ID da instância da Cloud Connect Network (CCN) anexada ao pool de nós de borda aprimorado.	null
ccn_region_id	string	Não	[Descontinuado] O ID da região da instância CCN vinculada ao pool de nós de borda aprimorado.	null
cen_id	string	Não	[Descontinuado] O ID da instância da Cloud Enterprise Network (CEN) anexada ao pool de nós de borda aprimorado.	null
improved_period	string	Não	[Descontinuado] A duração da assinatura do pool de nós de borda aprimorado. Unidade: meses.	null
interconnect_mode	string	Não	O tipo de rede do pool de nós de borda. Este parâmetro entra em vigor apenas quando `type` é definido como `edge`. Valores válidos: `basic`: rede pública. Os nós no pool de nós de nuvem interagem com os nós da nuvem pela rede pública. Os aplicativos no pool de nós de nuvem não podem acessar diretamente a rede interna da VPC da nuvem. `private`: rede privada. Os nós no pool de nós de nuvem conectam as redes da nuvem e locais por meio de circuitos do Express Connect, VPNs ou CEN. Isso proporciona maior qualidade de comunicação entre a nuvem e a borda e uma proteção de segurança mais eficaz.	basic
intranet	boolean	Não	Especifica se a conectividade de rede da camada 3 está ativada entre os nós no pool de nós de borda. Valores válidos: `true`: ativada. A conectividade de rede da camada 3 é ativada entre todos os nós no pool de nós. `false`: desativada. A conectividade de rede da camada 3 é desativada entre todos os hosts no pool de nós.	true
kubernetes_config	object	Não	As configurações relacionadas ao cluster.
cms_enabled	boolean	Não	Especifica se o CloudMonitor deve ser instalado nos nós do ECS. Após a instalação, você pode visualizar as informações de monitoramento das instâncias ECS criadas no console do CloudMonitor. Recomenda-se ativar esse recurso. Valores válidos: `true`: instala o CloudMonitor nos nós do ECS. `false`: não instala o CloudMonitor nos nós do ECS. Valor padrão: `false`.	false
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
labels	array	Não	Os labels adicionados aos nós no cluster Kubernetes.
	tag	Não	A configuração do label.
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 nome do host da instância ECS são alterados ao mesmo tempo. Nota Para instâncias Windows com nomes de nó personalizados ativados, o nome do host é fixado no endereço IP, com hifens (-) substituindo os pontos (.) no endereço IP, e não inclui prefixos ou sufixos. O nome do nó consiste em três partes: um prefixo, o endereço IP do nó e um sufixo: O comprimento total é de 2 a 64 caracteres. O nome do nó deve começar e terminar com uma letra minúscula ou um 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 e não podem começar ou terminar com um hífen (-) ou um ponto (.). Hifens (-) ou pontos (.) consecutivos não são permitidos. O prefixo é obrigatório (devido aos limites do ECS) e o sufixo é opcional. O IP do nó é o endereço IP privado completo do nó. Por exemplo, se o endereço IP do nó for 192.XX.YY.55, o prefixo especificado for aliyun.com e o sufixo for test: Se o nó for um nó Linux, o nome do nó, o nome da instância ECS e o nome do host da instância ECS serão todos aliyun.com192.XX.YY.55test. Se o nó for um nó Windows, o nome do host da instância ECS será 192-XX-YY-55, e tanto o nome do nó quanto o nome da instância ECS serão aliyun.com192.XX.YY.55test.	aliyun.com192.XX.YY.55test
pre_user_data	string	Não	Os dados personalizados prévios para a instância. Antes de o nó ingressar no cluster, o script de dados personalizados prévios especificado é executado. Para mais informações, consulte Scripts de dados do usuário.	dGhpcyBpcyBhIGV4YW1wbGU
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. Suporta todas as versões do cluster. Sandboxed-Container.runv: contêineres em sandbox seguros que fornecem maior isolamento. Suporta versões do cluster 1.31 e anteriores. docker: não é mais mantido. Suporta versões do cluster 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
taints	array	Não	A configuração de taints.
	taint	Não	A coleção de configurações de taints.
unschedulable	boolean	Não	Especifica se os nós não são agendáveis após um scale-out. Valores válidos: `true`: Os nós não são agendáveis. `false`: Os nós são agendáveis.	true
user_data	string	Não	Os dados do usuário da instância. Depois que o nó ingressa no cluster, o script de dados do usuário da instância especificado é executado. Para mais informações, consulte Scripts de dados do usuário.	dGhpcyBpcyBhIGV4YW1wbGU=
management	object	Não	A configuração do recurso de pool de nós gerenciado.
auto_fault_diagnosis	boolean	Não	Especifica se a detecção de falhas do ECS para autorrecuperação de nós deve ser ativada.
auto_repair	boolean	Não	Especifica se os nós devem ser reparados automaticamente. Este parâmetro só entra em vigor 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 autorreparo para nós.
approval_required	boolean	Não	Especifica se a aprovação manual é necessária para o reparo de nós.
auto_repair_policy_id	string	Não	O ID da política de autorreparo. Se você não especificar este parâmetro ou especificar uma string vazia, nenhuma regra de autorrecuperação será vinculada.	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 ao mesmo tempo. 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 no backend: 1.	5
max_unhealthy_nodes_threshold	string	Não	A condição de disjuntor para autorrecuperação. Quando o número ou a porcentagem de nós com falha excede esse limite, a autorrecuperação entra no estado de disjuntor e para de iniciar novas ações de autorrecuperação. 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 no backend: 100%.	20%
restart_node	boolean	Não	Especifica se as reinicializações de nós são permitidas. Este parâmetro só entra em vigor 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
auto_upgrade	boolean	Não	Especifica se os nós devem ser atualizados automaticamente. Este parâmetro só entra em vigor quando enable é definido como `true`. Valores válidos: `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 para nós.
auto_upgrade_kubelet	boolean	Não	Especifica se as atualizações automáticas do kubelet são permitidas. Este parâmetro só entra em vigor 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_os	boolean	Não	Especifica se as atualizações automáticas do sistema operacional são permitidas. Este parâmetro só entra em vigor 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
auto_upgrade_runtime	boolean	Não	Especifica se as atualizações automáticas do runtime são permitidas. Este parâmetro só entra em vigor 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_vul_fix	boolean	Não	Especifica se as vulnerabilidades CVE devem ser reparadas automaticamente. Este parâmetro só entra em vigor quando enable é definido como `true`. Valores válidos: `true`: permite o reparo automático de CVEs. `false`: não permite o reparo automático de CVEs. Valor padrão: `true`.	true
auto_vul_fix_policy	object	Não	A política de autorreparo para CVEs.
exclude_packages	string	Não	Os pacotes a serem excluídos durante o reparo de vulnerabilidades. Valor padrão: `kernel`.	kernel
restart_node	boolean	Não	Especifica se as reinicializações de nós são permitidas. Este parâmetro só entra em vigor 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`.	false
vul_level	string	Não	Os níveis de vulnerabilidade permitidos para reparo automático, separados por vírgulas. Exemplo: `asap,later`. Níveis de vulnerabilidade suportados: `asap`: alto `later`: médio `nntf`: baixo Valor padrão: `asap`.	asap,nntf
drift_enabled	boolean	Não	Especifica se o recurso de rotação de nós deve ser ativado. 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.
enable	boolean	Não	Especifica se o recurso gerenciado deve ser ativado para o pool de nós. Valores válidos: `true`: ativa o recurso gerenciado. `false`: desativa o recurso gerenciado. Outras configurações relacionadas só entram em vigor quando enable é definido como `true`. 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 só entra em vigor 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 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
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
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 uma atualização. Você pode criar nós de surge para compensar a carga do cluster. Nota O número de nós de surge criados não deve exceder o número atual de nós.	0
surge_percentage	integer	Não	A porcentagem de nós de surge. Este parâmetro e surge são mutuamente exclusivos. Número de nós de surge = Porcentagem de nós de surge × Número de nós. Por exemplo, se a porcentagem de nós de surge for definida como 50% e o número de nós existentes for 6, o número de nós de surge gerados será 50% × 6 = 3.	0
max_nodes `deprecated`	integer	Não	[Deprecated] O número máximo de nós permitidos em um pool de nós de borda.	null
node_components	array<object>	Não	A lista de componentes do nó.
	array<object>	Não	O componente do nó.
config	object	Não	A configuração do componente do nó.
custom_config	object	Não	A configuração personalizada para o componente do nó.	{"cpuManagerPolicy":"static"}
	any	Não	A string de configuração personalizada para o componente do nó.	cpuManagerPolicy
envs	array<object>	Não	As variáveis de ambiente para o 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
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
node_config	object	Não	A configuração do nó.
kubelet_configuration	kubelet_config	Não	As configurações de parâmetros do Kubelet.
node_os_config	object	Não	A configuração do sistema operacional para o nó.
hugepage	Hugepage	Não	A configuração de transparent huge page.
sysctl	object	Não	As configurações de parâmetros de kernel sysctl. Apenas parâmetros de kernel específicos são suportados, e a versão do cluster deve ser 1.28 ou posterior.	{"fs.file-max":"1048576"}
	any	Não	Os valores dos parâmetros de kernel sysctl, passados como strings.	1048576
nodepool_info	object	Não	A configuração do node pool.
name	string	Sim	O nome do node pool.	nodepool-test
resource_group_id	string	Não	O ID do grupo de recursos ao qual o node pool pertence. As instâncias iniciadas 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****
type	string	Não	O tipo do node pool. Valores válidos: `ess`: node pool padrão, que suporta recursos gerenciados e dimensionamento elástico. `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
scaling_group	object	Não	A configuração do grupo de escalonamento do pool de nós.
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 só entra em vigor quando instance_charge_type é definido como PrePaid. Valores válidos:\n\n- true: ativa a renovação automática.\n- false: desativa a renovação automática.\n\nValor padrão: false.	true
auto_renew_period	integer	Não	A duração de cada renovação automática. Valores válidos:\n- Quando PeriodUnit é definido como Week: 1, 2 e 3.\n- Quando PeriodUnit é definido como Month: 1, 2, 3, 6, 12, 24, 36, 48 e 60.\n\nValor padrão: 1.	1
cis_enabled `deprecated`	boolean	Não	[Deprecated] Use o parâmetro security_hardening_os em seu lugar.	null
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 multi_az_policy é 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:\n\n- true: cria automaticamente instâncias pay-as-you-go para atender ao número necessário de instâncias ECS.\n- false: não cria automaticamente instâncias pay-as-you-go.	true
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. Valores válidos: disabled enabled	enabled
data_disks	array	Não	A configuração de disco de dados em nuvem para os nós no pool de nós.
	data_disk	Não	A configuração de disco de dados em nuvem.
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 criadas pelo pool de nós em diferentes servidores físicos para garantir alta disponibilidade e recursos subjacentes de recuperação de desastres. Ao criar instâncias ECS em um conjunto de implantação, as instâncias são iniciadas de maneira distribuída na região especificada com base na política de implantação predefinida.\n\n Importante Após selecionar um conjunto de implantação, o número máximo de nós no pool de nós é limitado. Por padrão, um conjunto de implantação suporta até 20 × o número de nós das zonas. O número de zonas é determinado pelos vSwitches. Prossiga com cautela e certifique-se de que a cota no conjunto de implantação seja suficiente para evitar falhas no scale-out de nós.	ds-bp1d19mmbsv3jf6xxxxx
desired_size	integer	Não	O número esperado de nós no pool de nós.\n\nEste é 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 fazer o scale-out ou scale-in do pool de nós ajustando o número esperado de nós.\n\nSe você não precisar criar nós, defina este parâmetro como 0 e aumente manualmente o número de nós posteriormente.	0
disk_init	array	Não	A configuração de inicialização de dispositivo de bloco.
	DiskInit	Não	A configuração DiskInit.
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. Após a ativação deste modo, o número total de discos do sistema em nuvem e discos de dados em nuvem não excede o número máximo de discos em nuvem de alta densidade suportados pelo tipo de instância.	false
image_id	string	Não	O ID da imagem personalizada. Por padrão, a imagem fornecida pelo sistema é usada.	aliyun_2_1903_x64_20G_alibase_20200529.vhd
image_type	string	Não	O tipo de imagem do sistema operacional. Valores válidos:\n\n- AliyunLinux: imagem Alinux2.\n- AliyunLinuxSecurity: imagem Alinux2 UEFI.\n- AliyunLinux3: imagem Alinux3.\n- AliyunLinux3Arm64: imagem Alinux3 ARM.\n- AliyunLinux3Security: imagem Alinux3 UEFI.\n- CentOS: imagem CentOS.\n- Windows: imagem Windows.\n- WindowsCore: imagem WindowsCore.\n- ContainerOS: imagem otimizada para contêineres.\n- AliyunLinux3ContainerOptimized: imagem Alinux3 otimizada para contêineres.	AliyunLinux3
instance_charge_type	string	Sim	O método de cobrança dos nós no pool de nós. Valores válidos:\n \n- PrePaid: assinatura.\n- PostPaid: pay-as-you-go.\n\nValor padrão: PostPaid.\n\nA exclusão de um pool de nós, o scale-in de um pool de nós ou a remoção de nós não libera automaticamente os nós de assinatura. Para liberar automaticamente os nós de assinatura, altere o método de cobrança dos nós de assinatura para pay-as-you-go e, em seguida, faça login no console do ECS para liberá-los automaticamente. Valores válidos: PostPaid : Instância pay-as-you-go. PrePaid : Instância de assinatura.	PostPaid
instance_metadata_options	InstanceMetadataOptions	Não	A configuração de acesso a metadados da instância para instâncias ECS.
instance_patterns	array	Não	A configuração de propriedades da instância.
	instance_patterns	Não	As propriedades da instância.
instance_types	array	Sim	A lista de tipos de instância para os nós no pool de nós. Quando o pool de nós faz o scale-out de nós, ele seleciona tipos de instância que atendem aos requisitos da lista especificada para criar instâncias.\n\nValores válidos para o número de tipos de instância suportados: [1,10].\n\n> Para garantir alta disponibilidade, recomendamos que você 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
internet_charge_type	string	Não	O método de cobrança para o endereço IP público. Valores válidos:\n\n- PayByBandwidth: cobrança por largura de banda.\n- PayByTraffic: cobrança por tráfego.	PayByTraffic
internet_max_bandwidth_out	integer	Não	A largura de banda de saída máxima para o endereço IP público do nó. Unidade: Mbit/s. Valores válidos: [1,100].	5
key_pair	string	Não	O nome do par de chaves usado para login sem senha. Você deve especificar este parâmetro ou login_password.\n\n> Se o pool de nós usar o sistema operacional ContainerOS, apenas key_pair é suportado.	np-key-name
login_as_non_root	boolean	Não	Especifica se o login nas instâncias ECS criadas deve ser feito como um usuário não root.\n \n- true: faz login como um usuário não root (ecs-user).\n- false: faz login como o usuário root.	true
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.	****
multi_az_policy	string	Não	A política de escalonamento para instâncias ECS em um grupo de escalonamento multizona. Valores válidos:\n\n- PRIORITY: escalona instâncias ECS com base nos vSwitches (VSwitchIds.N) que você especificar. Se não for possível criar instâncias ECS na zona do vSwitch com a prioridade mais alta, o sistema usará automaticamente o vSwitch com a próxima prioridade mais alta para criar instâncias ECS.\n\n- COST_OPTIMIZED: cria instâncias ECS com base no preço unitário da vCPU em ordem crescente. Se a configuração de escalonamento especificar vários tipos de instância e o método de cobrança de instância spot for usado, o sistema criará preferencialmente instâncias spot. Você pode usar o parâmetro CompensateWithOnDemand para especificar se instâncias pay-as-you-go devem ser criadas automaticamente quando não for possível criar instâncias spot devido à falta de estoque ou outros motivos.\n\n > COST_OPTIMIZED só entra em vigor quando a configuração de escalonamento especifica vários tipos de instância ou usa instâncias spot.\n\n- BALANCE: aloca instâncias ECS uniformemente nas zonas especificadas no grupo de escalonamento. Se as zonas ficarem desbalanceadas devido à falta de estoque ou outros motivos, você pode chamar a operação de API RebalanceInstances para balancear os recursos.\n\nValor padrão: PRIORITY.	COST_OPTIMIZED
on_demand_base_capacity	integer	Não	O número mínimo de instâncias pay-as-you-go necessárias pelo grupo de escalonamento. Valores válidos: [0,1000]. Se o número de instâncias pay-as-you-go for menor que este valor, o sistema criará 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 atender ao número mínimo de instâncias pay-as-you-go (on_demand_base_capacity). Valores válidos: [0,100].	20
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 é definido como PrePaid.\n\n- Quando period_unit é definido como Week, os valores válidos para period são 1, 2, 3 e 4.\n- 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 dos nós no pool de nós. Este parâmetro entra em vigor e é obrigatório apenas quando instance_charge_type é definido como PrePaid.\n\n- Month: mês.\n- Week: semana.\n\nValor padrão: Month.	Month
platform `deprecated`	string	Não	[Deprecated] Use o parâmetro image_type em seu lugar.\n\nA distribuição do sistema operacional. Valores válidos:\n- CentOS\n- AliyunLinux\n- Windows\n- WindowsCore\n\nValor padrão: AliyunLinux.	null
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 é 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 e o modo de correspondência de capacidade de pool privado para inicialização de instância. Após uma garantia de elasticidade ou reserva de capacidade entrar em vigor, um pool privado é gerado para você selecionar ao iniciar instâncias. Valores válidos:\n- Open: modo aberto. O sistema corresponde automaticamente à capacidade de um pool privado aberto. Se nenhuma capacidade de pool privado correspondente estiver disponível, o sistema usa recursos de pool público para iniciar a instância.\n- Target: modo especificado. O sistema usa a capacidade do pool privado especificado para iniciar a instância. Se a capacidade do pool privado especificado não estiver disponível, a instância falhará ao iniciar.\n- None: modo sem pool privado. O sistema não usa capacidade de pool privado para iniciar a instância.	Target
ram_role_name	string	Não	O nome da função RAM do worker.\n\n* Se este parâmetro for deixado em branco, a função RAM do worker padrão criada para o cluster será usada.\n* Se este parâmetro for especificado, a função RAM deve ser uma função de serviço normal e seu serviço confiável deve ser definido como ECS. Para mais informações, consulte Criar uma função de serviço normal. Se a função RAM especificada não for a função RAM do worker padrão criada para o cluster, o nome da função não poderá começar com `KubernetesMasterRole-` ou `KubernetesWorkerRole-`.\n\n Importante Este parâmetro é suportado apenas por clusters gerenciados ACK da versão 1.22 e posteriores.	example-role
rds_instances	array	Não	A lista de instâncias ApsaraDB RDS.
	string	Não	O ID da instância ApsaraDB RDS.	rds-****
resource_pool_options	object	Não	O pool de recursos e a política de pool de recursos usados para a criação de instâncias. Observe os seguintes limites ao configurar este parâmetro:\nEste parâmetro só entra em vigor quando você cria instâncias pay-as-you-go.\nEste parâmetro não pode ser configurado ao mesmo tempo que private_pool_options.match_criteria e private_pool_options.id.
private_pool_ids	array	Não	A lista de IDs de pool privado, que são os IDs de garantias de elasticidade ou reservas de capacidade. Você pode especificar apenas os 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 o ID da reserva de capacidade. Este parâmetro aceita apenas o ID de um pool privado no modo Target.	eap-bp67acfmxazb4****
strategy	string	Não	A estratégia de pool de recursos usada para criar instâncias. Os pools de recursos incluem pools privados gerados após as garantias de elasticidade ou reservas de capacidade entrarem em vigor, bem como pools públicos, que estão disponíveis para seleção durante a inicialização da instância. Valores válidos:\nPrivatePoolFirst: Pool privado primeiro. Se você selecionar esta estratégia e especificar resource_pool_options.private_pool_ids, os pools privados especificados serão usados primeiro. Se nenhum pool privado for especificado ou se os pools privados especificados tiverem capacidade insuficiente, os pools privados abertos serão correspondidos automaticamente. Se nenhum pool privado elegível estiver disponível, o pool público será usado para criar instâncias.\nPrivatePoolOnly: Apenas pool privado. Se você selecionar esta estratégia, deverá especificar resource_pool_options.private_pool_ids. Se os pools privados especificados tiverem capacidade insuficiente, a instância falhará ao iniciar.\nNone: Nenhuma estratégia de pool de recursos é usada.\nValor padrão: None. Valores válidos: PrivatePoolOnly PrivatePoolFirst None	PrivatePoolFirst
scaling_policy	string	Não	O modo do grupo de escalonamento. Valores válidos:\n- release: Modo padrão. As instâncias são escalonadas criando e liberando instâncias ECS com base no uso de recursos solicitado.\n- recycle: Modo rápido. As instâncias são escalonadas criando, parando e iniciando instâncias 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.\nValor padrão: release.	release
security_group_id `deprecated`	string	Não	O ID do grupo de segurança do pool de nós. Especifique este parâmetro ou security_group_ids. Recomendamos que você use security_group_ids.	sg-wz9a8g2mt6x5llu0****
security_group_ids	array	Não	A lista de IDs de grupos de segurança. Especifique este parâmetro ou security_group_id. Recomendamos que você use security_group_ids. Se tanto security_group_id quanto security_group_ids forem especificados, security_group_ids terá precedência.
	string	Não	A lista de IDs de grupos de segurança. Especifique este parâmetro ou security_group_id. Recomendamos que você use security_group_ids. Se tanto security_group_id quanto security_group_ids forem especificados, security_group_ids terá precedência.	sg-wz9a8g2mt6x5ll******
security_hardening_os	boolean	Não	Especifica se o reforço de segurança do SO do Alibaba Cloud deve ser ativado. Valores válidos:\n- true: Ativa o reforço de segurança do SO do Alibaba Cloud.\n- false: Não ativa o reforço de segurança do SO do Alibaba Cloud.\nValor padrão: false.	false
soc_enabled	boolean	Não	Especifica se o reforço de segurança MLPS 2.0 deve ser ativado. Você pode ativar o reforço de segurança MLPS 2.0 para nós apenas quando a imagem do sistema for Alibaba Cloud Linux 2 ou Alibaba Cloud Linux 3. O Alibaba Cloud fornece padrões de verificação de linha de base e programas de varredura para conformidade com proteção classificada para imagens de nível 3 do MLPS 2.0 do Alibaba Cloud Linux 2 e Alibaba Cloud Linux 3.	false
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 em vários tipos de instância com os custos mais baixos. 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. Após a ativação desse recurso, quando o grupo de escalonamento recebe uma mensagem do sistema de que uma instância spot será recuperada, o grupo de escalonamento tenta criar uma nova instância para substituir a instância spot a ser recuperada. Valores válidos:\n- true: Ativa a reposição de instâncias spot.\n- false: Não ativa a reposição de instâncias spot.	false
spot_price_limit	array<object>	Não	A configuração do intervalo de preço de mercado para um único tipo de instância spot.
	object	Não	A configuração do intervalo de preço de mercado para instâncias spot. Você pode definir diferentes intervalos de preços para diferentes tipos de instância.
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.\n\n\nUnidade: USD/hora.	0.39
spot_strategy	string	Não	A estratégia de instância spot. Valores válidos:\n- NoSpot: Instância pay-as-you-go.\n- SpotWithPriceLimit: Define o preço máximo para instâncias spot.\n- SpotAsPriceGo: Usa a estratégia de lance automático do sistema, que segue o preço real de mercado.\nPara mais informações, consulte Instâncias spot.	NoSpot
system_disk_bursting_enabled	boolean	Não	Especifica se o burst de desempenho deve ser ativado para o disco do sistema do nó. Valores válidos:\n- true: Sim.\n- false: Não.\nEste 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_categories	array	Não	As categorias do disco do sistema. Se o disco do sistema não puder ser criado usando uma categoria de disco com prioridade mais alta, o sistema tentará automaticamente usar a categoria de disco com a próxima prioridade mais alta.
	string	Não	A categoria do disco do sistema do nó. Valores válidos:\n- cloud: Disco em nuvem básico.\n- cloud_efficiency: Disco em nuvem ultra.\n- cloud_ssd: SSD padrão.\n- cloud_essd: ESSD.\n- cloud_auto: Disco em nuvem ESSD AutoPL.\n- cloud_essd_entry: Disco em nuvem ESSD Entry.	cloud_essd
system_disk_category	string	Não	A categoria do disco do sistema do nó. Valores válidos:\n- cloud_efficiency: Disco em nuvem ultra.\n- cloud_ssd: SSD padrão.\n- cloud_essd: ESSD.\n- cloud_auto: Disco em nuvem ESSD AutoPL.\n- cloud_essd_entry: Disco em nuvem ESSD Entry.\nValor padrão: cloud_efficiency.	cloud_efficiency
system_disk_encrypt_algorithm	string	Não	O algoritmo de criptografia usado para o disco do sistema. Valor válido: aes-256.	aes-256
system_disk_encrypted	boolean	Não	Especifica se o disco do sistema deve ser criptografado. Valores válidos:\n- true: Criptografa o disco do sistema.\n- false: Não criptografa o disco do sistema.	false
system_disk_kms_key_id	string	Não	O ID da chave KMS usada para o disco do sistema.	0e478b7a-4262-4802-b8cb-00d3fb40****
system_disk_performance_level	string	Não	O nível de desempenho do disco do sistema. Este parâmetro é aplicável apenas a ESSDs. O nível de desempenho varia com base no tamanho do disco. Para mais informações, consulte ESSD. Valores válidos:\n- PL0: Desempenho máximo de I/O simultâneo médio e latência de leitura/gravação relativamente estável.\n- PL1: Desempenho máximo de I/O simultâneo médio e latência de leitura/gravação relativamente estável.\n- PL2: Alto desempenho máximo de I/O simultâneo e latência de leitura/gravação estável.\n- PL3: Desempenho máximo de I/O simultâneo extremamente alto e latência de leitura/gravação altamente estável.	PL1
system_disk_provisioned_iops	integer	Não	O IOPS de leitura/gravação provisionado para o disco 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, 50.000}. 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
system_disk_size	integer	Não	O tamanho do disco do sistema. Unidade: GiB. Valores válidos: 20 a 2048.	120
system_disk_snapshot_policy_id	string	Não	A política de snapshot para o disco do sistema.	sp-0jl6xnmme8v7o935****
tags	array<object>	Não	As tags a serem adicionadas apenas às instâncias ECS. As chaves de tag devem ser exclusivas 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
vswitch_ids	array	Sim	A lista de IDs de vSwitch. Você pode especificar de 1 a 8 IDs de vSwitch.\n> Para garantir alta disponibilidade, recomendamos que você selecione vSwitches em zonas diferentes.
	string	Não	O ID do vSwitch.	vsw-wz9mfnhmssud6eicu****
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.\n\n- true: Ativa a computação confidencial.\n\n- false: Desativa a computação confidencial.	true

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****
request_id	string	O ID da solicitação.	0527ac9a-c899-4341-a21a-****
task_id	string	O ID da tarefa.	T-613b19bbd160ad492800****

Exemplos

Resposta de sucesso

JSON formato

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

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.