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

Consulta a lista de todos os pools de nós em um cluster.

Descrição da operação

Ao remover nós, execute operações padronizadas por meio desta API ou do Console do Container Service. Não remova nós manualmente usando kubectl delete node.
Não libere nós diretamente, não remova instâncias no console do ECS ou ESS (ou por meio de APIs relacionadas), nem permita que nós sejam liberados passivamente devido à expiração de instâncias por assinatura. Nesses casos, os nós são interrompidos diretamente e removidos automaticamente do Console do Container Service.
Se o pool de nós tiver um número desejado de nós configurado, o pool de nós expandirá automaticamente outras instâncias com base na configuração correspondente para manter a contagem de nós no número desejado.
A remoção de nós envolve a migração de Pods, o que pode afetar seus serviços. Execute esta operação fora dos horários de pico. Riscos inesperados podem ocorrer durante a operação. Faça backup dos dados relevantes com antecedência.
Ao remover nós, o ACK executa uma operação de drenagem. Certifique-se de que outros nós no cluster tenham recursos suficientes para evitar que os pods de aplicação não possam ser agendados.
Verifique as regras de afinidade de nó e as políticas de agendamento dos Pods nos nós a serem removidos para garantir que os Pods não fiquem não agendáveis em outros nós após a remoção do nó.

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

get

*Cluster

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

Nenhuma

Sintaxe da solicitação

GET /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.	cc0f87de0b8fb403f86e10e204f83****

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
NodepoolName	string	Não	O nome do pool de nós.	nodepool-test

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Os detalhes do pool de nós.
nodepools	array<object>	A lista de instâncias de pool de nós.
	array<object>	Os detalhes da instância do pool de nós.
nodepool_info	object	As informações 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 de pool de nós. Valores válidos: `ess`: pool de nós padrão (inclui recursos gerenciados e 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. Um cluster normalmente 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-acfmyvw3wjm****
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-15T16:33:29.362888807+08:00
updated	string	A hora em que o pool de nós foi atualizado pela última vez.	2025-04-15T16:33:32.823+08:00
status	object	O status do pool de nós.
state	string	O status do pool de nós. Valores válidos: `active`: Ativado. `scaling`: Dimensionamento em andamento. `removing`: Nós estão sendo removidos. `deleting`: Sendo excluído. `updating`: Sendo atualizado.	active
healthy_nodes	integer	O número de instâncias íntegras.	3
initial_nodes	integer	O número de nós sendo criados.	0
failed_nodes	integer	O número de instâncias 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 no estado de serviço.	3
total_nodes	integer	O número total de nós no pool de nós.	3
auto_scaling	object	A configuração de dimensionamento automático.
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 o dimensionamento instantâneo de nós por padrão. Clusters de versões anteriores à 1.24 usam o dimensionamento automático 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 este parâmetro é definido como 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 padrão. `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 escaláveis no pool de nós, excluindo suas instâncias existentes.	10
min_instances	integer	O número mínimo de instâncias escaláveis no pool de nós, excluindo suas instâncias existentes.	2
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 de pool de nós gerenciado. Esta configuração entra em vigor apenas em clusters gerenciados profissionais.
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`. `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`. `true`: Permitir reinicialização do nó. `false`: Não permitir reinicialização do nó.	true
approval_required	boolean	Indica 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-xxxxxxxxx
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 máximo ou porcentagem 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 este limite, a autocura entra em estado de disjuntor e para de iniciar novas ações de reparo.	10%
auto_vul_fix	boolean	Especifica se as CVEs devem ser corrigidas automaticamente. Este parâmetro entra em vigor apenas quando `enable=true`. `true`: Permite correções automáticas de CVE. `false`: Não permite correções automáticas de CVE.	true
auto_vul_fix_policy	object	A política de correção automática de CVE.
restart_node	boolean	Especifica se deve permitir a reinicialização de nós. Este parâmetro entra em vigor apenas quando `auto_vul_fix=true`. Valores válidos: `true`: A reinicialização de nós é permitida. `false`: A reinicialização de nós não é permitida.	true
vul_level	string	Os níveis de vulnerabilidade permitidos para correção automática, separados por vírgulas. Valores válidos: `asap`: alta `later`: média `nntf`: baixa	asap,nntf
exclude_packages	string	Os pacotes a serem excluídos durante a correção de vulnerabilidades.	kernel
auto_upgrade	boolean	Especifica se deve ativar a atualização automática para os nós. Este parâmetro entra em vigor apenas quando `enable=true`. Valores válidos: `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 a atualização automática do kubelet. Este parâmetro entra em vigor apenas quando `auto_upgrade=true`. Valores válidos: `true`: A atualização automática do kubelet é permitida. `false`: A atualização automática do kubelet não é permitida.	true
upgrade_config	object	A configuração de atualização automática. Este parâmetro entra em vigor apenas 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ê deve definir este parâmetro ou `surge_percentage`.	5
surge_percentage	integer	A porcentagem de nós extras. Você deve definir este parâmetro ou `surge`. 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, o que significa que 3 nós extras serão criados.	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 autorrecuperação 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-2ze8n5qw4atggut8****
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ó. Você pode selecionar vários tipos de instância como alternativas. Quando cada nó é criado, o sistema tenta adquirir instâncias começando pela primeira especificação até que a criação seja bem-sucedida. O tipo de instância realmente adquirido pode variar dependendo da disponibilidade de estoque.	ecs.n4.large
	string	O tipo de instância do 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 entra em vigor 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}.	1
period_unit	string	A época de cobrança dos nós. Este parâmetro é obrigatório quando `instance_charge_type` está definido como `PrePaid`. Valores válidos: `Month`: a unidade de computação (CU) é mês. `Week`: a unidade de computação (CU) é semana.	Month
auto_renew	boolean	Especifica se deve ativar a renovação automática para os nós. Este parâmetro entra em vigor apenas 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.	0
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 faz lances automaticamente pelo preço de mercado atual. Para mais informações, consulte Instâncias spot.	NoSpot
spot_price_limit	array<object>	A configuração 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 limite de preço para 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. Você pode chamar `DescribeKubernetesVersionMetadata` para consultar as imagens suportadas pelo sistema.	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.	standard SSD
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 entra em vigor apenas para discos em nuvem ESSD. O nível de desempenho está relacionado ao tamanho do disco em nuvem. Para mais informações, consulte Discos em nuvem ESSD. Valores válidos: PL0: desempenho máximo de E/S simultânea moderado com latência de leitura/gravação relativamente estável. PL1: desempenho máximo de E/S simultânea moderado com latência de leitura/gravação relativamente estável. PL2: alto desempenho máximo de E/S simultânea com latência de leitura/gravação estável. PL3: desempenho máximo de E/S simultânea ultra-alto com latência de leitura/gravação extremamente estável.	PL1
system_disk_encrypted	boolean	Especifica se deve criptografar o disco em nuvem do sistema. Valores válidos: true: Criptografado. false: Não criptografado.	false
system_disk_kms_key_id	string	O ID da chave KMS usada para o disco em nuvem do sistema.	0e478b7a-4262-4802-b8cb-00d3fb40****
system_disk_encrypt_algorithm	string	O algoritmo de criptografia usado para o disco em nuvem do sistema. Valores válidos: aes-256.	aes-256
system_disk_bursting_enabled	boolean	Especifica se deve ativar burst (aumento de desempenho) para o disco em nuvem do sistema do nó. Valores válidos: true: Ativado. Quando ativado, o disco em nuvem aumenta 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 se estabilize. false: Não ativado. Este parâmetro é suportado apenas quando `system_disk_category` está definido como `cloud_auto`. Para mais informações, consulte Discos em nuvem ESSD AutoPL.	true
system_disk_provisioned_iops	integer	Os IOPS de leitura/gravação provisionados para o disco em nuvem do sistema do nó. Este parâmetro é aplicável quando o tipo de disco é cloud_auto.	1000
data_disks	array	As configurações dos discos em nuvem de dados do nó, incluindo o tipo e o tamanho.
	data_disk	A configuração de um disco em nuvem de dados do nó.
disk_init	array	A configuração de inicialização de dispositivo de bloco.
	DiskInit	A configuração DiskInit.
security_group_ids	array	A lista de IDs de grupos de segurança para o pool de nós.
	string	A lista de IDs de grupos de segurança para o pool de nós.	sg-2ze1iuk12m2sb4c4****
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	Especifica se a instância ECS expandida 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	Especifica se deve ativar o reforço de segurança MLPS 2.0. Você pode ativar esse recurso apenas quando a imagem do sistema for Alibaba Cloud Linux 2 ou Alibaba Cloud Linux 3. A Alibaba Cloud fornece padrões de verificação de linha de base de conformidade de proteção classificada e programas de varredura para imagens de Nível 3 do MLPS 2.0 do Alibaba Cloud Linux 2 e Alibaba Cloud Linux 3.	false
security_hardening_os	boolean	Especifica se deve ativar o reforço de segurança do SO da Alibaba Cloud. Valores válidos: `true`: Ativa o reforço de segurança do SO da Alibaba Cloud. `false`: Não ativa o reforço de segurança do SO da Alibaba Cloud. Valor padrão: `false`.	false
internet_charge_type	string	O método de cobrança de rede para endereços IP públicos de 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 de 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ó.	[{\"key\":\"pkg.E2EClient.ClusterId\",\"value\":\"troopers-\"}]
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 não é possível criar instâncias ECS na zona do vSwitch com a prioridade mais alta, o sistema usa automaticamente o próximo vSwitch prioritário para criar instâncias ECS. `COST_OPTIMIZED`: Tenta criar instâncias em ordem de preço unitário de vCPU do menor para o maior. Quando a configuração de escalonamento define o método de cobrança como preemptível para vários tipos de instância, 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 não for possível criar instâncias spot devido a estoque insuficiente. Nota `COST_OPTIMIZED` entra em vigor apenas quando a configuração de escalonamento especifica vários tipos de instância ou usa instâncias spot. `BALANCE`: Distribui instâncias ECS uniformemente entre as múltiplas zonas especificadas no grupo de escalonamento. Se as zonas ficarem desequilibradas devido a estoque insuficiente, você pode chamar a operação de API RebalanceInstances para reequilibrar os recursos.	COST_OPTIMIZED
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 das operações de escalonamento subsequentes. (Os recursos de computação não são cobrados durante o estado parado. Apenas taxas de armazenamento são cobradas, 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 necessárias no grupo de escalonamento. Valores válidos: [0,1000]. Quando o número de instâncias pay-as-you-go for menor que este valor, as instâncias pay-as-you-go serão criadas primeiro.	0
on_demand_percentage_above_base_capacity	integer	A porcentagem de instâncias pay-as-you-go entre as instâncias que excedem a contagem mínima de instâncias pay-as-you-go (`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 de maneira equilibrada entre os tipos de instância de menor custo. Valores válidos: [1,10].	5
spot_instance_remedy	boolean	Especifica se deve ativar a suplementação de instâncias spot. 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	Especifica se deve ativar o modo de disco em nuvem de alta densidade. Isso é suportado apenas quando o pool de nós usa tipos de instância. Quando ativado, o número total de discos de sistema e discos 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 instâncias RDS forem especificadas, as instâncias ECS no pool de nós do cluster serão adicionadas automaticamente à lista de permissões do RDS.
	string	A instância RDS.	rm-xxx
private_pool_options	object	As opções de pool privado.
id	string	O ID do pool privado, que é o ID de garantia de elasticidade ou ID de reserva de capacidade.	eap-bp67acfmxazb4****
match_criteria	string	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, um pool privado é gerado para o lançamento da instância. Valores válidos: `Open`: Modo aberto. Corresponde automaticamente à capacidade aberta do pool privado. Se nenhuma capacidade correspondente de pool privado estiver disponível, os recursos do pool público serão usados para o lançamento. `Target`: Modo especificado. Usa a capacidade especificada do pool privado para lançar instâncias. Se a capacidade especificada do pool privado não estiver disponível, o lançamento da instância falhará. `None`: Não usa capacidade de pool privado para o lançamento de instância.	Open
security_group_id	string	[Descontinuado] 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-2ze1iuk12m2sb4c4****
platform	string	[Descontinuado] A distribuição do sistema operacional. Valores válidos: `CentOS` `AliyunLinux` `Windows` `WindowsCore`	AliyunLinux
ram_policy	string	Este campo está 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****
resource_pool_options	object	O pool de recursos e a política de pool de recursos usados ao criar instâncias.
strategy	string	A política de pool de recursos usada ao criar instâncias. Valores válidos: PrivatePoolFirst: Pool privado primeiro. PrivatePoolOnly: Apenas pool privado. None: Sem política de pool de recursos.	PrivatePoolFirst
private_pool_ids	array	A lista de IDs de pools privados.
	string	O ID do pool privado.	eap-bp1c1fohub5jccwi****
system_disk_snapshot_policy_id	string	A política de snapshot do disco de sistema.	sp-0jl6xnmme8v7o935****
cpu_options	object	As opções de configuração de 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 configuração da label.	{}
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	As informações 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 clusters da versão 1.31 e anteriores. docker: Não é mais mantido. Suporta clusters da versão 1.22 e anteriores.	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 da versão 1.12.6 e posteriores: `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.	IyEvYmluL3NoCmVjaG8gIkhlbGxvIEFD****
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: Tanto o prefixo quanto 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 a serem 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.	IyEvYmluL3NoCmVjaG8gIkhlbGxvIEFD
tee_config	object	A configuração 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 de 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 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	O número máximo de nós permitidos no pool de nós de borda. Este parâmetro especifica o número máximo de nós que o pool de nós pode conter e deve ser maior ou igual a 0. Um valor de 0 indica nenhum limite adicional (limitado apenas pelo número total de nós que o cluster pode conter, sem limite adicional no próprio pool de nós). Este parâmetro é tipicamente maior que 0 para pools de nós de borda. Para pools de nós do tipo ess e pools de nós de borda padrão, este parâmetro é 0.	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 cujo `type` é `edge`. Valores válidos: `basic`: Rede pública. Os nós no pool de nós em nuvem interagem com os nós em nuvem pela rede pública. 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
auto_mode	object	A configuração gerenciada inteligente.
enable	boolean	Indica se o modo gerenciado inteligente está ativado.	true
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 do nó.	{"cpuManagerPolicy":"static"}
	any	A string de configuração personalizada do componente do nó.	cpuManagerPolicy
envs	array<object>	As variáveis de ambiente do componente do 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 do 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 (não efetivo).
worker_ram_role_name	string	A função RAM do worker usada pelo pool de nós Lingjun.

Exemplos

Resposta de sucesso

JSON formato

{
  "nodepools": [
    {
      "nodepool_info": {
        "nodepool_id": "np615c0e0966124216a0412e10afe0****",
        "name": "default-nodepool",
        "type": "ess",
        "is_default": true,
        "resource_group_id": "rg-acfmyvw3wjm****",
        "region_id": "cn-beijing",
        "created": "2025-04-15T16:33:29.362888807+08:00",
        "updated": "2025-04-15T16:33:32.823+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
      },
      "auto_scaling": {
        "enable": true,
        "type": "cpu",
        "max_instances": 10,
        "min_instances": 2,
        "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-xxxxxxxxx",
          "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-2ze8n5qw4atggut8****",
        "vswitch_ids": [
          "vsw-2ze3ds0mdip0hdz8i****"
        ],
        "instance_types": [
          "ecs.n4.large"
        ],
        "instance_charge_type": "PostPaid",
        "period": 1,
        "period_unit": "Month",
        "auto_renew": false,
        "auto_renew_period": 0,
        "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": [
          "standard SSD"
        ],
        "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****"
          }
        ],
        "disk_init": [
          {
            "disk_name": "disk0",
            "mkfs_type": "ext4",
            "mount_target": "/mnt/disk0",
            "mount_for_runtime": false,
            "local_disk": false
          }
        ],
        "security_group_ids": [
          "sg-2ze1iuk12m2sb4c4****"
        ],
        "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": "COST_OPTIMIZED",
        "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-2ze1iuk12m2sb4c4****",
        "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****",
        "resource_pool_options": {
          "strategy": "PrivatePoolFirst",
          "private_pool_ids": [
            "eap-bp1c1fohub5jccwi****"
          ]
        },
        "system_disk_snapshot_policy_id": "sp-0jl6xnmme8v7o935****",
        "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": "IyEvYmluL3NoCmVjaG8gIkhlbGxvIEFD****",
        "unschedulable": true,
        "cms_enabled": true,
        "node_name_mode": "aliyun.com192.XX.YY.55test",
        "pre_user_data": "IyEvYmluL3NoCmVjaG8gIkhlbGxvIEFD"
      },
      "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",
      "auto_mode": {
        "enable": true
      },
      "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.