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. Ele permite o gerenciamento e a O&M unificados de nós, como atualizações de nós e dimensionamento elástico. Você pode usar ainda mais os recursos de O&M automatizada dos pools de nós e usar recursos como reparo automático 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 do 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.
auto_mode	object	Não	A configuração do modo automático do pool de nós.
enable	boolean	Não	Especifica se o modo automático deve ser ativado. Valores válidos: true: ativa o modo automático. Este valor é válido apenas quando o modo automático está ativado para o cluster. false: desativa o modo automático.	true
auto_scaling	object	Não	A configuração de dimensionamento automático.
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 dimensionamento automático deve ser ativado. Valores válidos: `true`: ativa o dimensionamento automático para o pool de nós. Quando o planejamento de capacidade do cluster não consegue atender aos requisitos de agendamento dos pods de aplicativo, o ACK dimensiona automaticamente os recursos de nós com base nos números mínimo e máximo de instâncias configurados. Para clusters da versão 1.24 e posteriores, a elasticidade just-in-time é ativada por padrão. Para clusters anteriores à versão 1.24, o dimensionamento automático é ativado por padrão. Para mais informações, consulte Dimensionamento de nós. `false`: desativa o dimensionamento automático. O ACK ajusta o número de nós no pool de nós com base no número esperado de nós configurado e sempre mantém o número de nós no valor esperado. Se este parâmetro for definido como false, outros parâmetros de configuração em `auto_scaling` não terão efeito. Valor padrão: `false`.	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 associado. Valores válidos: `true`: associa um EIP. `false`: não associa um EIP. Valor padrão: `false`.	null
max_instances	integer	Não	O número máximo de instâncias escaláveis no pool de nós, excluindo as instâncias existentes. Este parâmetro só tem efeito quando `enable` é definido como true. Valores válidos: [min_instances, 2000]. Valor padrão: 0.	10
min_instances	integer	Não	O número mínimo de instâncias escaláveis no pool de nós, excluindo as instâncias existentes. Este parâmetro só tem efeito quando `enable` é definido como true. Valores válidos: [0, max_instances]. Valor padrão: 0. Nota Se o número mínimo de instâncias não for 0, a criação automática do número correspondente de instâncias ECS será acionada após o grupo de dimensionamento entrar em vigor. Recomenda-se que as configurações para o número máximo de instâncias não sejam inferiores ao número atual de nós no pool de nós. Caso contrário, o recurso de dimensionamento elástico reduzirá os nós no pool de nós imediatamente após entrar em vigor.	1
type	string	Não	O tipo de instância para dimensionamento automático. Este parâmetro só tem efeito quando `enable` é definido como true. Valores válidos: `cpu`: instância regular. `gpu`: instância acelerada por GPU. `gpushare`: instância com 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 com 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. `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 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 aprimorada. 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 aprimorada.	null
ccn_region_id	string	Não	[Descontinuado] A região da instância CCN associada ao pool de nós de borda aprimorada.	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 aprimorada.	null
improved_period	string	Não	[Descontinuado] A duração da assinatura do pool de nós de borda aprimorada. Unidade: meses.	null
interconnect_mode	string	Não	O tipo de rede do pool de nós de borda. Este parâmetro só tem efeito 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 de nuvem pela rede pública. Os aplicativos no pool de nós de nuvem não podem acessar diretamente a rede interna da VPC de nuvem. `private`: rede privada. Os nós no pool de nós de nuvem conectam as redes de nuvem e locais por meio de circuitos do Express Connect, VPNs ou CEN. Isso proporciona maior qualidade de comunicação entre nuvem e borda e segurança mais eficaz.	basic
intranet	boolean	Não	Especifica se a conectividade de rede de camada 3 está ativada entre os nós no pool de nós de borda. `true`: ativada. A conectividade de rede de camada 3 está ativada entre todos os nós no pool de nós. `false`: desativada. A conectividade de rede de camada 3 está desativada entre todos os hosts no pool de nós.	true
kubernetes_config	object	Não	As configurações do cluster.
cms_enabled	boolean	Não	Especifica se o CloudMonitor deve ser instalado nos nós ECS. Após a instalação, você pode visualizar as informações de monitoramento das instâncias ECS criadas no console do CloudMonitor. É recomendável ativar esse recurso. Valores válidos: true: instala o CloudMonitor nos nós ECS. false: não instala o CloudMonitor nos nós ECS. Valor padrão: false.	false
cpu_policy	string	Não	A política de gerenciamento de CPU para 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 de nó usados para adicionar labels aos nós no cluster Kubernetes.
	tag	Não	A configuração de label.
node_name_mode	string	Não	O nome de nó personalizado. 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 pontos (.) no endereço IP, e não inclui prefixos ou sufixos. 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 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 endereç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 o nome do nó e o nome da instância ECS serão ambos 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 obter 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. Suportado por todas as versões de cluster. Sandboxed-Container.runv: contêineres em sandbox seguros que fornecem 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
taints	array	Não	A configuração de taint.
	taint	Não	A coleção de configurações de taint.
unschedulable	boolean	Não	Especifica se os nós não são agendáveis após o scale-out. Valores válidos: true: não agendável. false: agendável.	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 obter mais informações, consulte Scripts de dados do usuário.	dGhpcyBpcyBhIGV4YW1wbGU=
management	object	Não	A configuração para o 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 entra em vigor apenas quando enable=true. Valores válidos: true: repara nós automaticamente. false: não repara nós automaticamente. Valor padrão: true.	true
auto_repair_policy	object	Não	A política de reparo automático para nós.
approval_required	boolean	Não	Especifica se a aprovação manual é necessária para o reparo do nó.
auto_repair_policy_id	string	Não	O ID da política de reparo automático. 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 circuit breaker 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 circuit breaker e para de iniciar novas ações de reparo 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ó devem ser permitidas. Este parâmetro entra em vigor apenas quando auto_repair=true. Valores válidos: true: permite reinicializações de nó. false: não permite reinicializações de nó. Valor padrão: true.	true
auto_upgrade	boolean	Não	Especifica se os nós devem ser atualizados automaticamente. Este parâmetro entra em vigor apenas quando enable=true. Valores válidos: true: ativa o upgrade automático. false: desativa o upgrade automático. Valor padrão: true.	true
auto_upgrade_policy	object	Não	A política de upgrade automático para nós.
auto_upgrade_kubelet	boolean	Não	Especifica se os upgrades automáticos do kubelet devem ser permitidos. Este parâmetro entra em vigor apenas quando auto_upgrade=true. Valores válidos: true: permite upgrades automáticos do kubelet. false: não permite upgrades automáticos do kubelet. Valor padrão: true.	true
auto_upgrade_os	boolean	Não	Especifica se os upgrades automáticos do sistema operacional devem ser permitidos. Este parâmetro entra em vigor apenas quando auto_upgrade=true. Valores válidos: true: permite upgrades automáticos do sistema operacional. false: não permite upgrades automáticos do sistema operacional. Valor padrão: false.	false
auto_upgrade_runtime	boolean	Não	Especifica se os upgrades automáticos do runtime devem ser permitidos. Este parâmetro entra em vigor apenas quando auto_upgrade=true. Valores válidos: true: permite upgrades automáticos do runtime. false: não permite upgrades automáticos 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 entra em vigor apenas quando enable=true. Valores válidos: true: permite o reparo automático de CVE. false: não permite o reparo automático de CVE. Valor padrão: true.	true
auto_vul_fix_policy	object	Não	A política de reparo automático de CVE.
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ó devem ser permitidas. Este parâmetro entra em vigor apenas quando auto_vul_fix=true. Valores válidos: true: permite reinicializações de nó. false: não permite reinicializações de nó. 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: alta later: média nntf: baixa Valor padrão: asap.	asap,nntf
drift_enabled	boolean	Não	Especifica se a rotação de nós deve ser ativada. Este recurso é suportado apenas por pools de nós gerenciados inteligentes e é ativado por padrão. Não é suportado por pools de nós regulares.
enable	boolean	Não	Especifica se o recurso gerenciado para o pool de nós deve ser ativado. 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
upgrade_config `deprecated`	object	Não	[Deprecated] Use o parâmetro auto_upgrade de nível superior em vez disso. A configuração de upgrade automático. Este parâmetro entra em vigor apenas quando enable=true.
auto_upgrade `deprecated`	boolean	Não	[Deprecated] Use o parâmetro auto_upgrade de nível superior em vez disso. Especifica se o upgrade automático deve ser ativado. Valores válidos: true: ativa o upgrade automático. false: desativa o upgrade automático.	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 extras. Este parâmetro e surge_percentage são mutuamente exclusivos. Os nós ficam indisponíveis durante os upgrades. Você pode criar nós extras para compensar a carga 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. Este parâmetro e surge são mutuamente exclusivos. Número de nós extras = Porcentagem de nós extras × Número de nós. Por exemplo, se a porcentagem de nós extras for definida como 50% e o número de nós existentes for 6, o número de nós extras 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 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
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 do nó.
hugepage	Hugepage	Não	A configuração de Transparent HugePages.
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	O valor do parâmetro de kernel sysctl, passado como uma string.	1048576
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
resource_group_id	string	Não	O ID do grupo de recursos ao qual o pool de nós pertence. As instâncias adicionadas ao pool de nós pertencem a este grupo de recursos. Um recurso pode pertencer a apenas um grupo de recursos. Você pode mapear grupos de recursos para conceitos como projetos, aplicativos ou organizações com base em seus cenários de negócios.	rg-acfmyvw3wjmb****
type	string	Não	O tipo do pool de nós. Valores válidos: `ess`: pool de nós padrão, que suporta recursos gerenciados e dimensionamento elástico automático. `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 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: 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 renovação automática. Valores válidos: Quando PeriodUnit é definido como Week: 1, 2 e 3. Quando PeriodUnit é definido como Month: 1, 2, 3, 6, 12, 24, 36, 48 e 60. Valor padrão: 1.	1
cis_enabled `deprecated`	boolean	Não	[Deprecated] Use o parâmetro security_hardening_os em vez disso.	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 caso não seja possível criar instâncias spot suficientes devido a problemas de preço ou estoque quando multi_az_policy é definido como COST_OPTIMIZED. Valores válidos: true: cria automaticamente instâncias pay-as-you-go para atender ao número necessário de instâncias ECS. 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 em nuvem de dados para os nós no pool de nós.
	data_disk	Não	A configuração do disco em nuvem de dados.
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 distribuídas e iniciadas na região especificada com base na política de implantação predefinida. Importante Depois de 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 de zonas. O número de zonas é determinado pelos vSwitches. Prossiga com cautela e garanta 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. Este é o número total de nós que o pool de nós deve manter. Recomendamos que você configure pelo menos dois nós para garantir a operação normal dos componentes do cluster. Você pode fazer scale-out ou scale-in do pool de nós ajustando o número esperado de nós. Se você não precisar criar nós, defina este parâmetro como 0 e aumente manualmente o número de nós posteriormente.	0
disk_init	array	Não	A configuração de inicialização do dispositivo de bloco.
	DiskInit	Não	A configuração do 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. Depois que este modo é 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
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 da imagem do sistema operacional. Recomendamos que você use este parâmetro para especificar o sistema operacional para os nós. Valores válidos: AliyunLinux: imagem Alinux2. AliyunLinuxSecurity: imagem Alinux2 UEFI. AliyunLinux3: imagem Alinux3. AliyunLinux3Arm64: imagem Alinux3 ARM. AliyunLinux3Security: imagem Alinux3 UEFI. CentOS: imagem CentOS. Windows: imagem Windows. WindowsCore: imagem Windows Core. ContainerOS: imagem otimizada para contêiner. AliyunLinux3ContainerOptimized: imagem Alinux3 otimizada para contêiner.	AliyunLinux3
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. Excluir um pool de nós, fazer scale-in de um pool de nós ou remover 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 das 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 scale-out de nós, ele seleciona tipos de instância que atendem aos requisitos da lista especificada para criar instâncias. Valores válidos para o número de tipos de instância: 1 a 10. Nota 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: PayByBandwidth: cobrança por largura de banda. PayByTraffic: cobrança por transferência de dados.	PayByTraffic
internet_max_bandwidth_out	integer	Não	A largura de banda de saída máxima para o endereço IP público dos nós. Unidade: Mbit/s. Valores válidos: 1 a 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. Nota 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. true: faz login como um usuário não root (ecs-user). 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 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: PRIORITY: escala 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 usa automaticamente o vSwitch com a próxima prioridade mais alta para criar instâncias ECS. 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 estiver definido como preemptível, o sistema cria preferencialmente instâncias spot. Você pode usar o parâmetro CompensateWithOnDemand para especificar se instâncias pay-as-you-go devem ser criadas automaticamente caso não seja possível criar instâncias spot devido à falta de estoque. Nota COST_OPTIMIZED só entra em vigor quando a configuração de escalonamento especifica vários tipos de instância ou usa instâncias spot. BALANCE: aloca instâncias ECS uniformemente entre as zonas especificadas no grupo de escalonamento. Se a distribuição ficar desequilibrada devido à falta de estoque, você pode chamar a operação de API RebalanceInstances para equilibrar os recursos. Valor padrão: PRIORITY.	COST_OPTIMIZED
on_demand_base_capacity	integer	Não	O número mínimo de instâncias pay-as-you-go exigido pelo grupo de escalonamento. Valores válidos: 0 a 1000. Se o número de instâncias pay-as-you-go for menor que este valor, o sistema cria preferencialmente instâncias pay-as-you-go.	0
on_demand_percentage_above_base_capacity	integer	Não	A porcentagem de instâncias pay-as-you-go entre as instâncias excedentes após o grupo de escalonamento atender ao número mínimo de instâncias pay-as-you-go (on_demand_base_capacity). Valores válidos: 0 a 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. Quando period_unit é definido como Week, os valores válidos para period são 1, 2, 3 e 4. Quando period_unit é definido como Month, os valores válidos para period são 1, 2, 3, 4, 5, 6, 7, 8, 9, 12, 24, 36, 48 e 60.	1
period_unit	string	Não	O ciclo de cobrança 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. Month: mês. Week: semana. Valor padrão: Month.	Month
platform `deprecated`	string	Não	[Deprecated] 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
private_pool_options	object	Não	A configuração do pool de nós privado.
id	string	Não	O ID do pool privado. Quando match_criteria é definido como Target, você deve especificar o ID do pool privado.	eap-bp67acfmxazb4****
match_criteria	string	Não	O modo de correspondência de capacidade de pool privado para a inicialização da instância. Depois que um elasticity assurance ou capacity reservation entra em vigor, um pool privado é gerado para você selecionar ao iniciar instâncias. Valores válidos: Open: modo aberto. O sistema corresponde automaticamente à capacidade de um pool privado aberto. Se nenhuma capacidade de pool privado elegível estiver disponível, o sistema usa recursos do pool público para iniciar a instância. Neste modo, você não precisa especificar o parâmetro PrivatePoolOptions.Id. Target: modo especificado. O sistema usa a capacidade do pool privado especificado para iniciar a instância. Se a capacidade do pool privado especificado estiver indisponível, a instância falha ao iniciar. Neste modo, você deve especificar o ID do pool privado usando o parâmetro PrivatePoolOptions.Id. None: modo sem pool privado. O sistema não usa a capacidade do pool privado para iniciar a instância.	Target
ram_role_name	string	Não	O nome da função RAM para nós worker. Se este parâmetro for deixado vazio, a função RAM padrão para nós worker criada pelo cluster será usada. Se este parâmetro for especificado, a função RAM deve ser uma função de serviço padrão, e seu serviço confiável deve ser definido como ECS. Para mais informações, consulte Criar uma função de serviço padrão. Se a função RAM especificada não for a função RAM padrão para nós worker criada pelo cluster, o nome da função não pode começar com KubernetesMasterRole- ou KubernetesWorkerRole-. Importante Este parâmetro é suportado apenas por clusters gerenciados do ACK do Kubernetes 1.22 e posteriores.	example-role
rds_instances	array	Não	A lista de instâncias do ApsaraDB RDS.
	string	Não	O ID da instância RDS.	rds-****
resource_pool_options	object	Não	O pool de recursos e a política de pool de recursos usados ao criar instâncias. Observe o seguinte ao configurar este parâmetro: Este parâmetro só entra em vigor quando você cria instâncias pay-as-you-go. Este 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 elasticity assurances ou capacity reservations. 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, e pools públicos. Valores válidos: PrivatePoolFirst: Pool privado primeiro. Se esta estratégia for selecionada e resouce_pool_options.private_pool_ids for especificado, os pools privados especificados serão priorizados. Se nenhum pool privado for especificado ou se os pools privados especificados tiverem capacidade insuficiente, o sistema corresponderá automaticamente aos pools privados abertos. Se nenhum pool privado elegível for encontrado, o pool público será usado para criar instâncias. PrivatePoolOnly: Apenas pool privado. Se esta estratégia for selecionada, resouce_pool_options.private_pool_ids deverá ser especificado. Se os pools privados especificados tiverem capacidade insuficiente, a instância falhará ao iniciar. None: Nenhuma estratégia de pool de recursos é usada. Valor padrão: None. Valores válidos: PrivatePoolOnly PrivatePoolFirst None	PrivatePoolFirst
scaling_policy	string	Não	O padrão do grupo de escalonamento. Valores válidos: release: Padrão padrão. O grupo de escalonamento escala criando e liberando instâncias ECS com base no uso de recursos solicitado. recycle: Padrão extremo. O grupo de escalonamento escala criando, parando e iniciando instâncias para melhorar a velocidade das operações de escalonamento subsequentes. Quando uma instância é parada, os recursos de computação não são cobrados, e apenas as taxas de armazenamento são cobradas, exceto para instâncias com discos locais. Valor 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. Recomenda-se 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. Recomenda-se security_group_ids. Se security_group_id e 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. Recomenda-se security_group_ids. Se security_group_id e 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: true: Ativa o reforço de segurança do SO do Alibaba Cloud. false: Não ativa o reforço de segurança do SO do Alibaba Cloud. Valor 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 esse recurso 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 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
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. Depois que esse recurso é ativado, quando o grupo de escalonamento recebe uma mensagem do sistema de que uma instância spot será recuperada, ele tenta criar uma nova instância para substituir a instância spot a ser recuperada. Valores válidos: true: Ativa a reposição de instâncias spot. false: Desativa a reposição de instâncias spot.	false
spot_price_limit	array<object>	Não	A configuração de faixa de preço de mercado para um único tipo de instância spot.
	object	Não	A configuração de faixa de preço de mercado para instâncias spot. Você pode definir diferentes faixas de preço 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. Unidade: USD/hora.	0.39
spot_strategy	string	Não	A estratégia de instância spot. Valores válidos: NoSpot: Instância não spot. SpotWithPriceLimit: Define um preço máximo para a instância spot. SpotAsPriceGo: O sistema faz lances automaticamente com base no preço de mercado atual. Para mais informações, consulte Instâncias spot.	NoSpot
system_disk_bursting_enabled	boolean	Não	Especifica se o pico de desempenho deve ser ativado para o disco do sistema do nó. Valores válidos: true: Sim. false: Não. 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_categories	array	Não	A lista de tipos de disco do sistema. Se um tipo de disco com prioridade mais alta não estiver disponível, o sistema tentará automaticamente usar o próximo tipo de disco prioritário para criar o disco do sistema.
	string	Não	Os tipos de disco 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 ESSD AutoPL. cloud_essd_entry: Disco ESSD Entry.	cloud_essd
system_disk_category	string	Não	O tipo de disco do sistema do nó. Valores válidos: cloud_efficiency: Disco em nuvem ultra. cloud_ssd: SSD padrão. cloud_essd: ESSD. cloud_auto: Disco ESSD AutoPL. cloud_essd_entry: Disco ESSD Entry. Valor 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: true: Criptografa o disco do sistema. 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 do nó. Este parâmetro é válido apenas para ESSDs. O nível de desempenho está relacionado ao tamanho do disco. Para mais informações, consulte ESSD. Valores válidos: PL0: Desempenho de E/S simultâneo médio e latência de leitura/gravação relativamente estável. PL1: Desempenho de E/S simultâneo médio e latência de leitura/gravação relativamente estável. PL2: Alto desempenho de E/S simultâneo e latência de leitura/gravação estável. PL3: Desempenho de E/S simultâneo extremamente alto e latência de leitura/gravação altamente estável.	PL1
system_disk_provisioned_iops	integer	Não	Os IOPS de leitura/gravação provisionados para o disco 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, 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 do nó. 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	Adiciona tags apenas às instâncias ECS. As chaves de tag devem ser exclusivas e podem ter até 128 caracteres de comprimento. Nem as chaves de tag nem os valores de tag podem começar com aliyun ou acs:, ou conter https:// ou http://.
	object	Não	As tags para o 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. Valores válidos: 1 a 8. Nota Para garantir alta disponibilidade, 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. Valores válidos: true: Ativa a computação confidencial. 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.