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

Consulta a configuração de um pool de nós especificado em um cluster pelo ID do pool de nós.

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

get

*Cluster

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

Nenhuma

Sintaxe da solicitação

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

Parâmetros de caminho

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

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

Nenhum parâmetro necessário.

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Os detalhes do pool de nós.
nodepool_info	object	A configuração do pool de nós.
nodepool_id	string	O ID do pool de nós.	np615c0e0966124216a0412e10afe0****
name	string	O nome do pool de nós.	default-nodepool
type	string	O tipo do pool de nós. Valores válidos: `ess`: pool de nós padrão (inclui recursos gerenciados e de escalonamento elástico). `edge`: pool de nós de borda. `lingjun`: pool de nós Lingjun.	ess
is_default	boolean	Indica se este é o pool de nós padrão. Normalmente, um cluster possui apenas um pool de nós padrão. Valores válidos: `true`: Pool de nós padrão. `false`: Pool de nós não padrão.	true
resource_group_id	string	O ID do grupo de recursos.	rg-acfmyvw3wjmb****
region_id	string	O ID da região.	cn-beijing
created	string	A hora em que o pool de nós foi criado.	2025-04-10T14:25:37.285530433+08:00
updated	string	A hora em que o pool de nós foi atualizado pela última vez.	2025-04-15T15:39:45.41+08:00
status	object	O status do pool de nós.
state	string	O status do pool de nós. Valores válidos: `active`: Ativo. `scaling`: Escalonando. `removing`: Removendo nós. `deleting`: Excluindo. `updating`: Atualizando.	active
healthy_nodes	integer	O número de nós íntegros.	3
initial_nodes	integer	O número de nós sendo criados.	0
failed_nodes	integer	O número de nós com falha.	0
offline_nodes	integer	O número de nós offline.	0
removing_nodes	integer	O número de nós sendo removidos.	0
serving_nodes	integer	O número de nós em serviço.	3
total_nodes	integer	O número total de nós no pool de nós.	3
conditions	array<object>	As condições do pool de nós, que representam as informações de status do pool de nós em diferentes dimensões.
	object	Um único atributo de condição.
type	string	O tipo.	ImageUpgradeReady
status	string	O status.	True
reason	string	O motivo.	UpgradeDisabled
message	string	A mensagem detalhada.	AutoUpgradeDisabled
last_transition_time	string	A hora da última transição de status.	20--30T10:39:00+08:00
auto_scaling	object	A configuração de escalonamento automático para o pool de nós.
enable	boolean	Especifica se o escalonamento elástico deve ser ativado. Valores válidos: `true`: Ativa o recurso de escalonamento elástico 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 dos nós com base nas contagens mínima e máxima de instâncias configuradas. Clusters da versão 1.24 ou posterior usam elasticidade instantânea de nós por padrão. Clusters de versões anteriores à 1.24 usam escalonamento elástico de nós por padrão. Para mais informações, consulte Escalonamento de nós. `false`: Desativa o escalonamento elástico. 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.	true
type	string	O tipo de escalonamento automático, categorizado por tipo de instância. 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.	cpu
max_instances	integer	O número máximo de instâncias que podem ser escalonadas no pool de nós, excluindo suas instâncias existentes.	10
min_instances	integer	O número mínimo de instâncias que podem ser escalonadas no pool de nós, excluindo suas instâncias existentes.	1
eip_internet_charge_type	string	O tipo de cobrança de EIP. Valores válidos: `PayByBandwidth`: pagamento por largura de banda. `PayByTraffic`: pagamento por tráfego.	PayByBandwidth
is_bond_eip	boolean	Especifica se um EIP deve ser associado. Valores válidos: `true`: Associar um EIP. `false`: Não associar um EIP.	true
eip_bandwidth	integer	A largura de banda de pico do EIP. Valores válidos: [1,100]. Unidade: Mbit/s.	5
management	object	A configuração do pool de nós gerenciado.
enable	boolean	Especifica se o pool de nós gerenciado deve ser ativado. Valores válidos: `true`: Ativar o pool de nós gerenciado. `false`: Desativar o pool de nós gerenciado. Outras configurações relacionadas entram em vigor apenas quando `enable=true`.	true
auto_repair	boolean	Especifica se o reparo automático deve ser ativado. Este parâmetro entra em vigor apenas quando `enable=true`. Valores válidos: `true`: Ativar reparo automático. `false`: Desativar reparo automático.	true
auto_repair_policy	object	A política de reparo automático de nós.
restart_node	boolean	Especifica se a reinicialização do nó é permitida. Este parâmetro entra em vigor apenas quando `auto_repair=true`. Valores válidos: `true`: Permitir reinicialização do nó. `false`: Não permitir reinicialização do nó.	true
approval_required	boolean	Especifica se a aprovação manual é necessária para o reparo do nó.	false
auto_repair_policy_id	string	O ID da política de reparo automático.	r-xxxxxxxxxx
max_parallel_repairing_nodes	string	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 ou porcentagem máxima de nós que podem ser reparados simultaneamente.	1
max_unhealthy_nodes_threshold	string	A condição de disjuntor de autocura. Quando o número ou 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.	10%
auto_vul_fix	boolean	Especifica se deve corrigir CVEs automaticamente. Este parâmetro só tem efeito quando `enable=true`. `true`: A correção automática de CVEs é permitida. `false`: A correção automática de CVEs não é permitida.	true
auto_vul_fix_policy	object	A política de correção automática de CVEs.
restart_node	boolean	Especifica se deve permitir reinicializações de nós. Este parâmetro só tem efeito quando `auto_vul_fix=true`. Valores válidos: `true`: Reinicializações de nós são permitidas. `false`: Reinicializações de nós não são permitidas.	true
vul_level	string	Os níveis de vulnerabilidade permitidos para correção automática, separados por vírgulas. `asap`: alta `later`: média `nntf`: baixa	asap,nntf
exclude_packages	string	Os pacotes que devem ser excluídos durante a correção de vulnerabilidades.	kernel
auto_upgrade	boolean	Especifica se deve atualizar os nós automaticamente. Este parâmetro só tem efeito quando `enable=true`. `true`: A atualização automática está ativada. `false`: A atualização automática não está ativada.	true
auto_upgrade_policy	object	A política de atualização automática.
auto_upgrade_kubelet	boolean	Especifica se deve permitir atualizações automáticas do kubelet. Este parâmetro só tem efeito quando `auto_upgrade=true`. Valores válidos: `true`: Atualizações automáticas do kubelet são permitidas. `false`: Atualizações automáticas do kubelet não são permitidas.	true
upgrade_config	object	A configuração de atualização automática. Este parâmetro só tem efeito quando `enable=true`.
auto_upgrade	boolean	Especifica se deve ativar a atualização automática. Valores válidos: `true`: A atualização automática está ativada. `false`: A atualização automática não está ativada.	true
surge	integer	O número de nós extras. Você pode definir este parâmetro ou surge_percentage, mas não ambos.	5
surge_percentage	integer	A porcentagem de nós extras. Você pode definir este parâmetro ou `surge`, mas não ambos. 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 houver 6 nós existentes, o número de nós extras = 50% × 6 = 3.	50
max_unavailable	integer	O número máximo de nós indisponíveis. Valores válidos: [1,1000]. Valor padrão: 1.	1
auto_fault_diagnosis	boolean	Especifica se deve ativar a detecção de falhas ECS para autocura de nós.
drift_enabled	boolean	Especifica se deve ativar a rotação de nós. 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	A configuração do grupo de escalonamento do pool de nós.
scaling_group_id	string	O ID do grupo de escalonamento.	asg-2zeieod8giqmov7z****
vswitch_ids	array	A lista de IDs de vSwitch.
	string	O ID do vSwitch.	vsw-2ze3ds0mdip0hdz8i****
instance_types	array	A lista de tipos de instância de nó.
	string	O tipo de instância de nó.	ecs.n4.large
instance_charge_type	string	O método de cobrança dos nós no pool de nós. Valores válidos: `PrePaid`: assinatura. `PostPaid`: pay-as-you-go.	PostPaid
period	integer	A duração da assinatura dos nós. Este parâmetro tem efeito e é obrigatório apenas quando `instance_charge_type` está definido como `PrePaid`. Quando `period_unit=Week`, valores válidos de `period`: {1, 2, 3, 4}. Quando `period_unit=Month`, valores válidos de `period`: {1, 2, 3, 4, 5, 6, 7, 8, 9, 12, 24, 36, 48, 60}.	0
period_unit	string	A unidade do período de assinatura. Este parâmetro deve ser especificado quando `instance_charge_type` está definido como `PrePaid`. `Month`: medido em meses. `Week`: medido em semanas.	Month
auto_renew	boolean	Especifica se a renovação automática deve ser ativada para os nós. Este parâmetro só tem efeito quando `instance_charge_type` está definido como `PrePaid`. Valores válidos: `true`: A renovação automática está ativada. `false`: A renovação automática não está ativada.	false
auto_renew_period	integer	A duração de cada ciclo de renovação automática. Valores válidos: PeriodUnit=Week: 1, 2, 3. PeriodUnit=Month: 1, 2, 3, 6, 12, 24, 36, 48, 60.	1
spot_strategy	string	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 oferece lances automaticamente pelo preço de mercado atual. Para mais informações, consulte Instâncias spot.	NoSpot
spot_price_limit	array<object>	As configurações de limite de preço para instâncias spot.
	object	A configuração de limite de preço para instâncias spot. Você pode definir limites de preço diferentes para tipos de instância diferentes.
instance_type	string	O tipo de instância spot.	ecs.c6.large
price_limit	string	O preço de mercado de uma única instância. Unidade: USD/hora.	0.39
image_type	string	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	O ID da imagem personalizada.	aliyun_3_x64_20G_alibase_20241218.vhd
system_disk_category	string	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.	cloud_efficiency
system_disk_categories	array	Os vários tipos de disco para o disco em nuvem do sistema. Quando um tipo de disco de maior prioridade estiver indisponível, o sistema tentará automaticamente o próximo tipo de disco prioritário para criar o disco em nuvem do sistema.
	string	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.	cloud_essd
system_disk_size	integer	O tamanho do disco em nuvem do sistema do nó, em GiB. Valores válidos: [20,2048].	120
system_disk_performance_level	string	O nível de desempenho do disco em nuvem do sistema do nó. Este parâmetro só tem efeito para discos em nuvem ESSD. O nível de desempenho está relacionado ao tamanho do disco. Para mais informações, consulte ESSDs. PL0: desempenho de E/S concorrente máxima moderado com latência de leitura/gravação relativamente estável. PL1: desempenho de E/S concorrente máxima moderado com latência de leitura/gravação relativamente estável. PL2: alto desempenho de E/S concorrente máxima com latência de leitura/gravação estável. PL3: desempenho de E/S concorrente máxima ultra-alto com latência de leitura/gravação extremamente estável.	PL1
system_disk_encrypted	boolean	Especifica se o disco em nuvem do sistema deve ser criptografado. Valores válidos: `true`: Criptografado. `false`: Não criptografado.	false
system_disk_kms_key_id	string	O ID da chave KMS usada pelo disco em nuvem do sistema.	0e478b7a-4262-4802-b8cb-00d3fb40****
system_disk_encrypt_algorithm	string	O algoritmo de criptografia usado pelo disco em nuvem do sistema. Valores válidos: aes-256.	aes-256
system_disk_bursting_enabled	boolean	Indica se o burst (burst de desempenho) está ativado para o disco em nuvem do sistema do nó. Valores válidos: true: Ativado. Quando ativado, o disco em nuvem melhora temporariamente o desempenho durante picos repentinos de pressão de leitura/gravação de dados devido a cargas de trabalho flutuantes, até que a carga de trabalho retorne a um estado estável. false: Não ativado. Este parâmetro é suportado apenas quando `system_disk_category` está definido como `cloud_auto`. Para mais informações, consulte Disco em nuvem ESSD AutoPL.	true
system_disk_provisioned_iops	integer	Os IOPS de leitura/gravação provisionados para o disco em nuvem do sistema do nó. Valores possíveis: 0~min{50.000, 1000×capacidade-desempenho de base}. Desempenho 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 Disco em nuvem ESSD AutoPL.	1000
data_disks	array	A combinação de tipo, tamanho e outras configurações de discos de dados em nuvem para os nós.
	data_disk	A configuração do disco de dados em nuvem do nó.
security_group_ids	array	A lista de IDs de grupos de segurança para o pool de nós.
	string	O ID do grupo de segurança do pool de nós.	sg-2ze60ockeekspl3d****
key_pair	string	O nome do par de chaves, mutuamente exclusivo com `login_password`. Quando o pool de nós é um pool de nós gerenciado, apenas `key_pair` é suportado.	pro-nodepool
login_password	string	A senha de logon SSH, mutuamente exclusiva com `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. Para fins de segurança, a senha é criptografada nos resultados da consulta.	********
login_as_non_root	boolean	Indica se a instância ECS provisionada 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	[Descontinuado] Use o parâmetro security_hardening_os em vez disso.	false
soc_enabled	boolean	Indica se o reforço de segurança MLPS 2.0 está ativado. Isso pode ser ativado 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 do Alibaba Cloud Linux 2 e Alibaba Cloud Linux 3 MLPS 2.0 Nível 3.	false
security_hardening_os	boolean	Reforço de segurança do SO do Alibaba Cloud. 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
internet_charge_type	string	O tipo de cobrança de rede para endereços IP públicos dos nós. PayByBandwidth: Cobrado por largura de banda fixa. PayByTraffic: Cobrado pelo uso de tráfego.	PayByBandwidth
internet_max_bandwidth_out	integer	A largura de banda de saída máxima para endereços IP públicos dos nós, em Mbps (Megabit por segundo). Valores válidos: 1 a 100.	10
tags	array	As tags da instância ECS.
	tag	A tag do nó.
desired_size	integer	O número desejado de nós no pool de nós.	2
multi_az_policy	string	A política de escalonamento multizona para instâncias ECS no grupo de escalonamento. Valores válidos: `PRIORITY`: Escalona com base nos vSwitches (VSwitchIds.N) que você define. Quando instâncias ECS não podem ser criadas na zona de um vSwitch de maior prioridade, o próximo vSwitch prioritário é usado automaticamente. `COST_OPTIMIZED`: Tenta criar instâncias em ordem de preço unitário de vCPU do menor para o maior. Quando a configuração de escalonamento define vários tipos de instância com cobrança preemptível, as instâncias spot são criadas primeiro. Você pode usar o parâmetro `CompensateWithOnDemand` para especificar se deve tentar criar automaticamente instâncias pay-as-you-go quando instâncias spot não puderem ser criadas devido a estoque insuficiente. Nota `COST_OPTIMIZED` entra em vigor apenas quando a configuração de escalonamento define vários tipos de instância ou usa instâncias spot. `BALANCE`: Aloca instâncias ECS uniformemente entre as múltiplas zonas ativas especificadas no grupo de escalonamento. Se as zonas ficarem desequilibradas devido a estoque insuficiente, você pode usar a API RebalanceInstances para reequilibrar os recursos. Para mais informações, consulte RebalanceInstances. Valor padrão: `PRIORITY`. Configurações: Os métodos de cobrança incluem pay-as-you-go e instâncias spot.	BALANCE
scaling_policy	string	O modo do grupo de escalonamento. Valores válidos: `release`: Modo padrão. Escalona criando e liberando instâncias ECS com base no uso de recursos. `recycle`: Modo rápido. Escalona criando, parando e iniciando instâncias, o que melhora a velocidade de escalonamento subsequente (recursos de computação não são cobrados durante a parada, aplicam-se apenas taxas de armazenamento, exceto para tipos de instância com disco local).	release
on_demand_base_capacity	integer	O número mínimo de instâncias pay-as-you-go exigidas pelo grupo de escalonamento. Valores válidos: [0,1000]. Instâncias pay-as-you-go são criadas primeiro quando a contagem estiver abaixo deste valor.	0
on_demand_percentage_above_base_capacity	integer	A porcentagem de instâncias pay-as-you-go entre as instâncias que excedem a capacidade base sob demanda mínima (`on_demand_base_capacity`). Valores válidos: [0,100].	20
spot_instance_pools	integer	O número de tipos de instância disponíveis. O grupo de escalonamento cria instâncias spot uniformemente entre os tipos de menor custo. Valores válidos: [1,10].	5
spot_instance_remedy	boolean	Indica se a suplementação de instâncias spot está ativada. Quando ativado, o grupo de escalonamento tenta criar novas instâncias para substituir instâncias spot que estão prestes a ser recuperadas. Valores válidos: `true`: Ativa a suplementação de instâncias spot. `false`: Não ativa a suplementação de instâncias spot.	false
compensate_with_on_demand	boolean	Quando `multi_az_policy` está definido como `COST_OPTIMIZED`, especifica se deve permitir a criação automática de instâncias pay-as-you-go para atender aos requisitos de quantidade de instâncias ECS quando instâncias spot não puderem ser criadas devido a motivos de preço ou estoque. Valores válidos: `true`: Permite a criação automática de instâncias pay-as-you-go para atender aos requisitos de quantidade de instâncias ECS. `false`: Não permite a criação automática de instâncias pay-as-you-go para atender aos requisitos de quantidade de instâncias ECS.	true
enable_high_density_mode	boolean	Indica se o modo de disco em nuvem de alta densidade está 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 de dados não excede o limite de disco em nuvem de alta densidade suportado pelo tipo de instância.	false
deploymentset_id	string	O ID do conjunto de implantação.	ds-bp1d19mmbsv3jf6xxxxx
rds_instances	array	Se uma lista de instâncias RDS for especificada, os nós ECS no cluster serão adicionados automaticamente à lista de permissões de acesso do RDS.
	string	A instância RDS.	rm-xxx
private_pool_options	object	A configuração do pool de nós privado.
id	string	O ID do pool de nós privado.	eap-bp67acfmxazb4****
match_criteria	string	O tipo de pool de nós privado. Especifica a opção de capacidade de pool privado para lançamento de instância. Após uma garantia de elasticidade ou reserva de capacidade entrar em vigor, uma capacidade de pool privado é gerada para seleção de lançamento de instância. Valores válidos: `Open`: Modo aberto. Corresponde automaticamente à capacidade de pool privado do tipo aberto. Se nenhuma capacidade de pool privado correspondente estiver disponível, os recursos do pool público são usados. `Target`: Modo especificado. Usa a capacidade de pool privado especificada para lançar instâncias. Se a capacidade do pool privado não estiver disponível, o lançamento da instância falha. `None`: Modo não utilizado. O lançamento da instância não usa capacidade de pool privado.	Open
security_group_id	string	O ID do grupo de segurança do pool de nós. Quando o pool de nós está associado a vários grupos de segurança, este é o primeiro valor em `security_group_ids`.	sg-2ze60ockeekspl3d****
platform	string	A distribuição do sistema operacional. Valores válidos: `CentOS` `AliyunLinux` `Windows` `WindowsCore`	AliyunLinux
ram_policy	string	[Descontinuado] Use ram_role_name em vez disso.	KubernetesWorkerRole-021dc54f-929b-437a-8ae0-34c24d3e****
instance_patterns	array	As configurações de atributos da instância.
	instance_patterns	Os atributos da instância.
ram_role_name	string	O nome da função RAM do Worker.	KubernetesWorkerRole-4a4fa089-80c1-48a5-b3c6-9349311f****
instance_metadata_options	InstanceMetadataOptions	A configuração de acesso a metadados para instâncias ECS.
resource_pool_options	object	O pool de recursos e a política de pool de recursos usados ao criar instâncias.
private_pool_ids	array	A lista de IDs de pools privados.
	string	O ID do pool privado.	eap-bp1c1fohub5jccwi****
strategy	string	A estratégia de pool de recursos usada ao criar instâncias. Valores válidos: PrivatePoolFirst: prioridade para pool privado. PrivatePoolOnly: somente pool privado. None: nenhuma estratégia de pool de recursos é usada.	PrivatePoolFirst
system_disk_snapshot_policy_id	string	A política de snapshot para o disco em nuvem do sistema.	sp-bp11g8z59rawcud9****
disk_init	array	A configuração de inicialização de dispositivo de bloco.
	DiskInit	A configuração DiskInit.
cpu_options	object	As opções de configuração relacionadas à CPU.
nested_virtualization	string	Especifica se a virtualização aninhada está ativada. Valores válidos: disabled: A virtualização aninhada está desativada. enabled: A virtualização aninhada está ativada.	enabled
node_config	object	A configuração do nó.
kubelet_configuration	kubelet_config	As configurações de parâmetros do Kubelet.
node_os_config	object	A configuração do sistema operacional do nó.
hugepage	Hugepage	A configuração de hugepage.
kubernetes_config	object	A configuração relacionada ao cluster.
labels	array	A tag do nó.
	tag	A tag ECS.
taints	array	As informações de taint do nó. Taints e tolerations trabalham juntos para evitar que pods sejam agendados em nós inadequados. Para mais informações, consulte taint-and-toleration.
	taint	A configuração de taint do nó.
runtime	string	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 de cluster. Sandboxed-Container.runv: Contêiner sandbox que oferece maior isolamento. Suporta versões de cluster até a 1.31. docker: Não é mais mantido. Suporta versões de cluster até a 1.22.	containerd
runtime_version	string	A versão do runtime de contêiner.	1.6.38
cpu_policy	string	A política de gerenciamento de CPU do nó. As duas políticas a seguir são suportadas para clusters executando a versão 1.12.6 ou posterior: `static`: Permite que pods com determinadas características de recursos no nó recebam afinidade de CPU aprimorada e exclusividade. `none`: Ativa o esquema de afinidade de CPU padrão existente.	none
user_data	string	Os dados personalizados do pool de nós, que consistem em um script executado após a inicialização do nó. Para mais informações, consulte Gerar dados de usuário da instância.	IyEvYmluL3NoCmVjaG8gIkhlbGxvIEFDSyEi
unschedulable	boolean	Especifica se os nós expandidos não são agendáveis. true: Não agendável. false: Agendável.	true
cms_enabled	boolean	Especifica se o agente do CloudMonitor deve ser instalado nos nós ECS. Após a instalação, você pode visualizar informações de monitoramento das instâncias ECS criadas no console do CloudMonitor. Recomendamos que você ative esse recurso. Valores válidos: `true`: Instala o agente do CloudMonitor nos nós ECS. `false`: Não instala o agente do CloudMonitor nos nós ECS.	true
node_name_mode	string	O nome personalizado do nó. Um nome de nó consiste em três partes: prefixo + substring do endereço IP do nó + sufixo: O prefixo e o sufixo podem consistir em uma ou mais partes separadas por ".". Cada parte pode conter letras minúsculas, dígitos e hifens (-). O nome do nó deve começar e terminar com uma letra minúscula ou dígito. O comprimento do segmento de endereço IP especifica o número de dígitos extraídos do final do endereço IP do nó. Valores válidos: 5 a 12. Por exemplo, se o endereço IP do nó for 192.168.0.55, o prefixo for aliyun.com, o comprimento do segmento de endereço IP for 5 e o sufixo for test, o nome do nó será aliyun.com00055test.	aliyun.com192.XX.YY.55test
pre_user_data	string	Os dados pré-personalizados do pool de nós, que consistem em um script executado antes da inicialização do nó. Para mais informações, consulte Gerar dados de usuário da instância.	dGhpcyBpcyBhIGV4YW1wbGU
tee_config	object	A configuração do cluster de computação confidencial.
tee_enable	boolean	Especifica se a computação confidencial deve ser ativada para o cluster. Valores válidos: `true`: Ativado. `false`: Não ativado.	false
interconnect_config	object	[Descontinuado] A configuração relacionada à rede para pools de nós de borda. Este valor é significativo apenas para pools de nós do tipo edge.
cen_id	string	[Descontinuado] O ID da instância da Cloud Enterprise Network (CEN) vinculada ao pool de nós de borda aprimorado.	cen-ey9k9nfhz0f*******
ccn_id	string	[Descontinuado] O ID da instância da Cloud Connect Network (CCN) vinculada ao pool de nós de borda aprimorado.	ccn-qm5i0i0q9yi*******
ccn_region_id	string	[Descontinuado] A região da instância da Cloud Connect Network (CCN) vinculada ao pool de nós de borda aprimorado.	cn-shanghai
bandwidth	integer	[Descontinuado] A largura de banda de rede do pool de nós de borda aprimorado. Unidade: Mbit/s.	10
improved_period	string	[Descontinuado] A duração da compra do pool de nós de borda aprimorado. Unidade: meses.	1
max_nodes	integer	[Descontinuado] O número máximo de nós permitidos no pool de nós de borda.	10
interconnect_mode	string	O tipo de rede do pool de nós de borda. Este parâmetro entra em vigor apenas para pools de nós com `type` definido como `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 interna da VPC em 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	Especifica se o modo de rede do Pod utiliza 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	Especifica se os nós dentro do pool de nós de borda possuem conectividade de rede de Camada 3. `true`: Conectado. Todos os nós dentro do pool de nós possuem conectividade de rede de Camada 3. `false`: Não conectado. Todos os nós dentro do pool de nós não possuem conectividade de rede de Camada 3.	true
auto_mode	object	A configuração gerenciada inteligente.
enable	boolean	Especifica se o modo gerenciado inteligente está ativado.	false
node_components	array<object>	A lista de componentes do nó.
	array<object>	O componente do nó.
name	string	O nome do componente do nó.	kubelet
version	string	A versão do componente do nó.	1.33.3-aliyun.1
config	object	A configuração do componente do nó.
custom_config	object	A configuração personalizada do componente de nó.	{"cpuManagerPolicy":"static"}
	any	A string de configuração personalizada do componente de nó.	cpuManagerPolicy
envs	array<object>	As variáveis de ambiente do componente de nó.
	object
name	string	O nome da variável de ambiente.	LOG_LEVEL
value	string	O valor da variável de ambiente.	info
config_revision	string	O número da versão da configuração personalizada do componente de nó.	1
eflo_node_group	object	As informações do grupo de nós Lingjun.
cluster_id	string	O ID do cluster Lingjun.	i113790071760688002461
group_id	string	O ID do grupo Lingjun.	i128147721760688002463
auto_attach_enabled	boolean	Indica se a adição automática de nós está ativada para o pool de nós Lingjun.
worker_ram_role_name	string	A função RAM Worker usada pelo pool de nós Lingjun.

Exemplos

Resposta de sucesso

JSON formato

{
  "nodepool_info": {
    "nodepool_id": "np615c0e0966124216a0412e10afe0****",
    "name": "default-nodepool",
    "type": "ess",
    "is_default": true,
    "resource_group_id": "rg-acfmyvw3wjmb****",
    "region_id": "cn-beijing",
    "created": "2025-04-10T14:25:37.285530433+08:00",
    "updated": "2025-04-15T15:39:45.41+08:00"
  },
  "status": {
    "state": "active",
    "healthy_nodes": 3,
    "initial_nodes": 0,
    "failed_nodes": 0,
    "offline_nodes": 0,
    "removing_nodes": 0,
    "serving_nodes": 3,
    "total_nodes": 3,
    "conditions": [
      {
        "type": "ImageUpgradeReady",
        "status": "True",
        "reason": "UpgradeDisabled",
        "message": "AutoUpgradeDisabled",
        "last_transition_time": "20**-**-30T10:39:00+08:00"
      }
    ]
  },
  "auto_scaling": {
    "enable": true,
    "type": "cpu",
    "max_instances": 10,
    "min_instances": 1,
    "eip_internet_charge_type": "PayByBandwidth",
    "is_bond_eip": true,
    "eip_bandwidth": 5
  },
  "management": {
    "enable": true,
    "auto_repair": true,
    "auto_repair_policy": {
      "restart_node": true,
      "approval_required": false,
      "auto_repair_policy_id": "r-xxxxxxxxxx",
      "max_parallel_repairing_nodes": "1",
      "max_unhealthy_nodes_threshold": "10%"
    },
    "auto_vul_fix": true,
    "auto_vul_fix_policy": {
      "restart_node": true,
      "vul_level": "asap,nntf",
      "exclude_packages": "kernel"
    },
    "auto_upgrade": true,
    "auto_upgrade_policy": {
      "auto_upgrade_kubelet": true
    },
    "upgrade_config": {
      "auto_upgrade": true,
      "surge": 5,
      "surge_percentage": 50,
      "max_unavailable": 1
    },
    "auto_fault_diagnosis": false,
    "drift_enabled": false
  },
  "scaling_group": {
    "scaling_group_id": "asg-2zeieod8giqmov7z****",
    "vswitch_ids": [
      "vsw-2ze3ds0mdip0hdz8i****"
    ],
    "instance_types": [
      "ecs.n4.large"
    ],
    "instance_charge_type": "PostPaid",
    "period": 0,
    "period_unit": "Month",
    "auto_renew": false,
    "auto_renew_period": 1,
    "spot_strategy": "NoSpot",
    "spot_price_limit": [
      {
        "instance_type": "ecs.c6.large",
        "price_limit": "0.39"
      }
    ],
    "image_type": "AliyunLinux3",
    "image_id": "aliyun_3_x64_20G_alibase_20241218.vhd",
    "system_disk_category": "cloud_efficiency",
    "system_disk_categories": [
      "cloud_essd"
    ],
    "system_disk_size": 120,
    "system_disk_performance_level": "PL1",
    "system_disk_encrypted": false,
    "system_disk_kms_key_id": "0e478b7a-4262-4802-b8cb-00d3fb40****",
    "system_disk_encrypt_algorithm": "aes-256",
    "system_disk_bursting_enabled": true,
    "system_disk_provisioned_iops": 1000,
    "data_disks": [
      {
        "category": "cloud_ssd",
        "size": 40,
        "encrypted": "true",
        "kms_key_id": "0e478b7a-4262-4802-b8cb-00d3fb40****",
        "auto_snapshot_policy_id": "sp-2zej1nogjvovnz4z****",
        "performance_level": "PL1",
        "provisioned_iops": 1000,
        "bursting_enabled": true,
        "auto_format": true,
        "file_system": "ext4",
        "mount_target": "/mnt/path1",
        "disk_name": "DataDiskName",
        "device": "/dev/xvdb",
        "snapshot_id": "s-280s7****"
      }
    ],
    "security_group_ids": [
      "sg-2ze60ockeekspl3d****"
    ],
    "key_pair": "pro-nodepool",
    "login_password": "********",
    "login_as_non_root": true,
    "cis_enabled": false,
    "soc_enabled": false,
    "security_hardening_os": false,
    "internet_charge_type": "PayByBandwidth",
    "internet_max_bandwidth_out": 10,
    "tags": [
      {
        "key": "env",
        "value": "prod"
      }
    ],
    "desired_size": 2,
    "multi_az_policy": "BALANCE",
    "scaling_policy": "release",
    "on_demand_base_capacity": 0,
    "on_demand_percentage_above_base_capacity": 20,
    "spot_instance_pools": 5,
    "spot_instance_remedy": false,
    "compensate_with_on_demand": true,
    "enable_high_density_mode": false,
    "deploymentset_id": "ds-bp1d19mmbsv3jf6xxxxx",
    "rds_instances": [
      "rm-xxx"
    ],
    "private_pool_options": {
      "id": "eap-bp67acfmxazb4****",
      "match_criteria": "Open"
    },
    "security_group_id": "sg-2ze60ockeekspl3d****",
    "platform": "AliyunLinux",
    "ram_policy": "KubernetesWorkerRole-021dc54f-929b-437a-8ae0-34c24d3e****",
    "instance_patterns": [
      {
        "cores": 4,
        "memory": 8,
        "instance_family_level": "EnterpriseLevel",
        "excluded_instance_types": [
          "ecs.c6.large"
        ],
        "min_cpu_cores": 4,
        "max_cpu_cores": 8,
        "min_memory_size": 8,
        "max_memory_size": 16,
        "instance_categories": [
          "General-purpose"
        ],
        "cpu_architectures": [
          "X86"
        ],
        "core": 4,
        "max_price": 2,
        "architectures": [
          "X86"
        ],
        "burst_performance_option": "Exclude",
        "instance_type_families": [
          "ecs.c6"
        ],
        "minimum_eni_quantity": 3,
        "minimum_eni_private_ip_address_quantity": 10,
        "minimum_eni_ipv6_address_quantity": 1,
        "maximum_gpu_amount": 8
      }
    ],
    "ram_role_name": "KubernetesWorkerRole-4a4fa089-80c1-48a5-b3c6-9349311f****",
    "instance_metadata_options": {
      "http_tokens": "optional"
    },
    "resource_pool_options": {
      "private_pool_ids": [
        "eap-bp1c1fohub5jccwi****"
      ],
      "strategy": "PrivatePoolFirst"
    },
    "system_disk_snapshot_policy_id": "sp-bp11g8z59rawcud9****",
    "disk_init": [
      {
        "disk_name": "disk0",
        "mkfs_type": "ext4",
        "mount_target": "/mnt/disk0",
        "mount_for_runtime": false,
        "local_disk": false
      }
    ],
    "cpu_options": {
      "nested_virtualization": "enabled"
    }
  },
  "node_config": {
    "kubelet_configuration": {
      "registryPullQPS": 5,
      "registryBurst": 10,
      "eventRecordQPS": 5,
      "eventBurst": 10,
      "kubeAPIQPS": 5,
      "kubeAPIBurst": 10,
      "serializeImagePulls": true,
      "cpuManagerPolicy": "none",
      "evictionHard": {
        "test": "test",
        "test2": 1
      },
      "evictionSoft": {
        "test": "test",
        "test2": 1
      },
      "evictionSoftGracePeriod": {
        "test": "test",
        "test2": 1
      },
      "systemReserved": {
        "test": "test",
        "test2": 1
      },
      "kubeReserved": {
        "test": "test",
        "test2": 1
      },
      "readOnlyPort": 0,
      "maxPods": 110,
      "containerLogMaxSize": "10Mi",
      "containerLogMaxFiles": 5,
      "featureGates": {
        "test": "test",
        "test2": 1
      },
      "allowedUnsafeSysctls": [
        "net.core.somaxconn"
      ],
      "reservedMemory": [
        {
          "numaNode": 0,
          "limits": {
            "memory": "1Gi"
          }
        }
      ],
      "memoryManagerPolicy": "none",
      "cpuCFSQuota": true,
      "cpuCFSQuotaPeriod": "100ms",
      "imageGCHighThresholdPercent": 85,
      "imageGCLowThresholdPercent": 80,
      "podPidsLimit": -1,
      "topologyManagerPolicy": "restricted",
      "clusterDNS": [
        "127.0.xx.xx"
      ],
      "tracing": {
        "endpoint": "localhost:4317",
        "samplingRatePerMillion": 200000
      },
      "containerLogMaxWorkers": 1,
      "containerLogMonitorInterval": "10s",
      "serverTLSBootstrap": true
    },
    "node_os_config": {
      "hugepage": {
        "transparentEnabled": "",
        "transparentDefrag": "",
        "khugepagedDefrag": 0,
        "khugepagedAllocSleepMillisecs": 0,
        "khugepagedScanSleepMillisecs": 0,
        "khugepagedPagesToScan": 0
      }
    }
  },
  "kubernetes_config": {
    "labels": [
      {
        "key": "env",
        "value": "prod"
      }
    ],
    "taints": [
      {
        "key": "key",
        "value": "value",
        "effect": "NoSchedule"
      }
    ],
    "runtime": "containerd",
    "runtime_version": "1.6.38",
    "cpu_policy": "none",
    "user_data": "IyEvYmluL3NoCmVjaG8gIkhlbGxvIEFDSyEi",
    "unschedulable": true,
    "cms_enabled": true,
    "node_name_mode": "aliyun.com192.XX.YY.55test",
    "pre_user_data": "dGhpcyBpcyBhIGV4YW1wbGU"
  },
  "tee_config": {
    "tee_enable": false
  },
  "interconnect_config": {
    "cen_id": "cen-ey9k9nfhz0f*******",
    "ccn_id": "ccn-qm5i0i0q9yi*******",
    "ccn_region_id": "cn-shanghai",
    "bandwidth": 10,
    "improved_period": "1"
  },
  "max_nodes": 10,
  "interconnect_mode": "basic",
  "host_network": true,
  "intranet": true,
  "auto_mode": {
    "enable": false
  },
  "node_components": [
    {
      "name": "kubelet",
      "version": "1.33.3-aliyun.1",
      "config": {
        "custom_config": {
          "key": "cpuManagerPolicy"
        },
        "envs": [
          {
            "name": "LOG_LEVEL",
            "value": "info"
          }
        ]
      },
      "config_revision": "1"
    }
  ],
  "eflo_node_group": {
    "cluster_id": "i113790071760688002461",
    "group_id": "i128147721760688002463",
    "auto_attach_enabled": false,
    "worker_ram_role_name": ""
  }
}

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.