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 dimensionamento 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`: Dimensionando. `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 atributo de status único.
type	string	O tipo.	ImageUpgradeReady
status	string	O status.	True
reason	string	O motivo.	UpgradeDisabled
message	string	As informações detalhadas.	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 dimensionamento automático para o pool de nós.
enable	boolean	Especifica se o dimensionamento elástico deve ser ativado. Valores válidos: `true`: Ativa o recurso de dimensionamento 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 dimensiona 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 dimensionamento elástico de nós por padrão. Para mais informações, consulte Dimensionamento de nós. `false`: Desativa o dimensionamento 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 dimensionamento 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 dimensionadas 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 dimensionadas no pool de nós, excluindo suas instâncias existentes.	1
eip_internet_charge_type	string	O tipo de cobrança do 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 o reparo automático. `false`: Desativar o reparo automático.	true
auto_repair_policy	object	A política de reparo automático de nós.
restart_node	boolean	Especifica se as reinicializações de nós são permitidas. Este parâmetro entra em vigor apenas quando `auto_repair=true`. Valores válidos: `true`: Permitir reinicializações de nós. `false`: Não permitir reinicializações de nós.	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, isso 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. Isso só tem efeito quando `enable=true`. `true`: Permite correções automáticas de CVEs. `false`: Não permite correções automáticas de CVEs.	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. Isso só tem efeito quando `auto_vul_fix=true`. Valores válidos: `true`: Permite reinicializações de nós. `false`: Não permite reinicializações de nós.	true
vul_level	string	Os níveis de vulnerabilidade permitidos para correções automáticas, separados por vírgulas. `asap`: alta `later`: média `nntf`: baixa	asap,nntf
exclude_packages	string	Os pacotes que devem ser excluídos durante as correções de vulnerabilidades.	kernel
auto_upgrade	boolean	Especifica se deve atualizar os nós automaticamente. Isso só tem efeito quando `enable=true`. `true`: Ativa a atualização automática. `false`: Não ativa a atualização automática.	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. Isso só tem efeito quando `auto_upgrade=true`. Valores válidos: `true`: Permite atualizações automáticas do kubelet. `false`: Não permite atualizações automáticas do kubelet.	true
upgrade_config	object	A configuração de atualização automática. Isso só tem efeito quando `enable=true`.
auto_upgrade	boolean	Especifica se deve ativar a atualização automática. Valores válidos: `true`: Ativa a atualização automática. `false`: Não ativa a atualização automática.	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 esse recurso, e ele é ativado por padrão. Pools de nós comuns não suportam esse 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 da 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 cobrança dos nós. 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. Isso só tem efeito quando `instance_charge_type` está definido como `PrePaid`. Valores válidos: `true`: Ativa a renovação automática. `false`: Não ativa a renovação automática.	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 faixa de preço para instâncias spot.
	object	A configuração de faixa de preço para instâncias spot. Você pode definir diferentes faixas de preço para diferentes tipos de instância.
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ó. Isso se aplica apenas a discos em nuvem ESSD. O nível de desempenho está relacionado ao tamanho do disco. Para mais informações, consulte Discos em nuvem ESSD. Valores válidos: 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 linha de base}. Desempenho de linha de base=min{1.800+50×capacidade, 50000}. Este parâmetro é suportado apenas quando `system_disk_category` está definido como `cloud_auto`. Para mais informações, consulte Disco em nuvem ESSD AutoPL.	1000
data_disks	array	A combinação de tipo, tamanho e outras configurações de discos em nuvem de dados para os nós.
	data_disk	A configuração do disco em nuvem de dados 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 deve 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 retornada no resultado da consulta é criptografada.	********
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 endurecimento de segurança MLPS 2.0 está ativado. Isso pode ser ativado 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 do Alibaba Cloud Linux 2 e Alibaba Cloud Linux 3 MLPS 2.0 Nível 3.	false
security_hardening_os	boolean	Especifica se o endurecimento de segurança do SO do Alibaba Cloud está ativado. Valores válidos: `true`: O endurecimento de segurança do SO do Alibaba Cloud está ativado. `false`: O endurecimento de segurança do SO do Alibaba Cloud não está ativado. Valor padrão: `false`.	false
internet_charge_type	string	O método de cobrança para o IP público do nó. Valores válidos: 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 o IP público do nó, 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 do vSwitch de maior prioridade, o próximo vSwitch de prioridade é 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 automaticamente criar 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 para o grupo de escalonamento dependem da política selecionada.	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 (os recursos de computação não são cobrados durante a parada, apenas taxas de armazenamento se aplicam, 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 está 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	Especifica se a suplementação de instâncias spot deve ser 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 do pool privado para o lançamento da instância. Após uma garantia de elasticidade ou reserva de capacidade entrar em vigor, uma capacidade de pool privado é gerada para o lançamento da instância. Valores válidos: `Open`: Modo aberto. Corresponde automaticamente à capacidade do pool privado do tipo aberto. Se nenhuma capacidade correspondente do pool privado estiver disponível, os recursos do pool público são usados para o lançamento. `Target`: Modo especificado. Usa a capacidade do pool privado especificado para lançar instâncias. Se a capacidade do pool privado especificado estiver indisponível, a instância falhará ao ser lançada. `None`: Modo não usar. O lançamento da instância não usa a capacidade do 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: apenas 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 e exclusividade aprimoradas de CPU. `none`: Ativa o esquema padrão existente de afinidade de CPU.	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: Mbps.	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 na nuvem pela Internet. Aplicações no pool de nós em nuvem não podem acessar diretamente a rede interna da VPC na nuvem. `private`: Rede privada. Os nós no pool de nós em nuvem conectam-se à nuvem através do Express Connect, VPN ou CEN, proporcionando maior qualidade de comunicação entre nuvem e borda e segurança mais eficaz.	basic
host_network	boolean	Especifica se o modo de rede do Pod usa o modo de rede do host. `true`: Rede do host. Os pods usam diretamente a pilha de rede do host e compartilham o endereço IP e as portas com o host. `false`: Rede de contêiner. Os pods possuem pilhas de rede independentes e não ocupam portas de rede do host.	true
intranet	boolean	Especifica se os nós no pool de nós de borda possuem conectividade de rede de Camada 3 entre si. `true`: Conectado. Todos os nós neste pool de nós possuem conectividade de rede de Camada 3 entre si. `false`: Não conectado. Todos os nós neste pool de nós não possuem conectividade de rede de Camada 3 entre si.	true
auto_mode	object	A configuração gerenciada inteligente.
enable	boolean	Especifica se o gerenciamento 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 ao pool de nós Lingjun está ativada.
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.