DescribeClusterNodePools - Container Service for Kubernetes - Centre de documentation Alibaba Cloud

Consulte la liste de tous les pools de nœuds d'un cluster.

Description de l'opération

Lors de la suppression de nœuds, effectuez des opérations standardisées via cette API ou la console Container Service. Ne supprimez pas manuellement les nœuds en utilisant kubectl delete node.
Ne libérez pas directement les nœuds, ne supprimez pas d'instances dans la console ECS ou ESS (ou via les API associées), et ne laissez pas les nœuds être libérés passivement en raison de l'expiration d'instances par abonnement. Dans ces cas, les nœuds sont directement arrêtés et automatiquement supprimés de la console Container Service.
Si un nombre de nœuds souhaité est configuré pour le pool de nœuds, celui-ci ajoute automatiquement d'autres instances en fonction de la configuration correspondante afin de maintenir le nombre de nœuds à la valeur souhaitée.
La suppression de nœuds implique la migration de pods, ce qui peut affecter vos services. Effectuez cette opération pendant les heures creuses. Des risques imprévus peuvent survenir pendant l'opération. Sauvegardez les données pertinentes au préalable.
Lors de la suppression de nœuds, ACK exécute une opération de vidage. Assurez-vous que les autres nœuds du cluster disposent de ressources suffisantes pour éviter que les pods d'application ne puissent pas être planifiés.
Vérifiez les règles d'affinité de nœuds et les stratégies de planification des pods sur les nœuds à supprimer afin de vous assurer que les pods ne deviennent pas non planifiables sur d'autres nœuds après la suppression du nœud.

Testez maintenant

Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale. Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale.

Test

Autorisation RAM

Le tableau ci-dessous décrit les autorisations nécessaires pour appeler cette API. Vous pouvez les définir dans une politique Resource Access Management (RAM). Les colonnes du tableau sont détaillées ci-dessous :

Action : les actions peuvent être utilisées dans l'élément Action des instructions de politique de permissions RAM pour accorder les autorisations nécessaires à l'exécution de l'opération.
API : l'API que vous pouvez appeler pour exécuter l'action.
Niveau d'accès : le niveau d'accès prédéfini accordé pour chaque API. Valeurs valides : create, list, get, update et delete.
Type de ressource : le type de ressource qui prend en charge l'autorisation pour exécuter l'action. Il indique si l'action prend en charge les permissions au niveau de la ressource. La ressource spécifiée doit être compatible avec l'action. Sinon, la politique sera inefficace.
- Pour les API avec permissions au niveau de la ressource, les types de ressource requis sont marqués d'un astérisque (*). Spécifiez l'Alibaba Cloud Resource Name (ARN) correspondant dans l'élément Resource de la politique.
- Pour les API sans permissions au niveau de la ressource, la valeur All Resources est affichée. Utilisez un astérisque (*) dans l'élément Resource de la politique.
Clé de condition : les clés de condition définies par le service. La clé permet un contrôle granulaire, applicable aux actions seules ou aux actions associées à des ressources spécifiques. En plus des clés de condition propres au service, Alibaba Cloud fournit un ensemble de clés de condition communes applicables à tous les services pris en charge par RAM.
Action dépendante : les actions dépendantes requises pour exécuter l'action. Pour mener à bien l'opération, l'utilisateur RAM ou le rôle RAM doit disposer des permissions pour toutes les actions dépendantes.

cs:DescribeClusterNodePools

get

*Cluster.

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

Aucune

Syntaxe de la requête

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

Paramètres de chemin

Paramètre	Type	Requis	Description	Exemple
ClusterId	string	Oui	L'identifiant du cluster.	cc0f87de0b8fb403f86e10e204f83****

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
NodepoolName	string	Non	Le nom du pool de nœuds.	nodepool-test

Éléments de réponse

Élément	Type	Description	Exemple
	object	Les détails du pool de nœuds.
nodepools	array<object>	La liste des instances de pool de nœuds.
	array<object>	Les détails de l'instance de pool de nœuds.
nodepool_info	object	Les informations du pool de nœuds.
nodepool_id	string	L'identifiant du pool de nœuds.	np615c0e0966124216a0412e10afe0****
name	string	Le nom du pool de nœuds.	default-nodepool
type	string	Le type de pool de nœuds. Valeurs valides : `ess` : pool de nœuds standard (inclut les fonctionnalités gérées et la mise à l'échelle élastique). `edge` : pool de nœuds périphériques. `lingjun` : pool de nœuds Lingjun.	ess
is_default	boolean	Indique s'il s'agit du pool de nœuds par défaut. Un cluster ne possède généralement qu'un seul pool de nœuds par défaut. Valeurs valides : `true` : pool de nœuds par défaut. `false` : pool de nœuds non par défaut.	true
resource_group_id	string	L'identifiant du groupe de ressources.	rg-acfmyvw3wjm****
region_id	string	L'identifiant de la région.	cn-beijing
created	string	L'heure à laquelle le pool de nœuds a été créé.	2025-04-15T16:33:29.362888807+08:00
updated	string	L'heure de la dernière mise à jour du pool de nœuds.	2025-04-15T16:33:32.823+08:00
status	object	L'état du pool de nœuds.
state	string	L'état du pool de nœuds. Valeurs valides : `active` : activé. `scaling` : mise à l'échelle en cours. `removing` : suppression de nœuds en cours. `deleting` : suppression en cours. `updating` : mise à jour en cours.	active
healthy_nodes	integer	Le nombre d'instances saines.	3
initial_nodes	integer	Le nombre de nœuds en cours de création.	0
failed_nodes	integer	Le nombre d'instances en échec.	0
offline_nodes	integer	Le nombre de nœuds hors ligne.	0
removing_nodes	integer	Le nombre de nœuds en cours de suppression.	0
serving_nodes	integer	Le nombre de nœuds en service.	3
total_nodes	integer	Le nombre total de nœuds dans le pool de nœuds.	3
auto_scaling	object	La configuration de mise à l'échelle automatique.
enable	boolean	Indique si la mise à l'échelle élastique doit être activée. Valeurs valides : `true` : active la fonctionnalité de mise à l'échelle élastique pour le pool de nœuds. Lorsque la planification de la capacité du cluster ne peut pas répondre aux exigences de planification des pods d'application, ACK met automatiquement à l'échelle les ressources de nœuds en fonction des nombres minimum et maximum d'instances configurés. Les clusters de version 1.24 ou ultérieure utilisent la mise à l'échelle instantanée des nœuds par défaut. Les clusters de versions antérieures à 1.24 utilisent la mise à l'échelle automatique des nœuds par défaut. Pour plus d'informations, consultez Mise à l'échelle des nœuds. `false` : désactive la mise à l'échelle élastique. ACK ajuste le nombre de nœuds dans le pool de nœuds en fonction du nombre de nœuds souhaité configuré et maintient le nombre de nœuds à la valeur souhaitée. Lorsque ce paramètre est défini sur false, les autres paramètres de configuration dans `auto_scaling` ne prennent pas effet.	true
type	string	Le type de mise à l'échelle automatique, classé par type d'instance. Valeurs valides : `cpu` : type d'instance standard. `gpu` : type d'instance GPU. `gpushare` : type de partage de GPU. `spot` : type d'instance spot.	cpu
max_instances	integer	Le nombre maximum d'instances extensibles dans le pool de nœuds, à l'exclusion de vos instances existantes.	10
min_instances	integer	Le nombre minimum d'instances extensibles dans le pool de nœuds, à l'exclusion de vos instances existantes.	2
eip_internet_charge_type	string	Le type de facturation de l'EIP. Valeurs valides : `PayByBandwidth` : facturation par bande passante. `PayByTraffic` : facturation par trafic.	PayByBandwidth
is_bond_eip	boolean	Indique si une EIP doit être associée. Valeurs valides : `true` : associe une EIP. `false` : n'associe pas d'EIP.	true
eip_bandwidth	integer	La bande passante maximale de l'EIP. Valeurs valides : [1, 100]. Unité : Mbit/s.	5
management	object	La configuration du pool de nœuds géré. Cette configuration ne prend effet que dans les clusters gérés professionnels.
enable	boolean	Indique si le pool de nœuds géré doit être activé. Valeurs valides : `true` : active le pool de nœuds géré. `false` : désactive le pool de nœuds géré. Les autres configurations associées ne prennent effet que lorsque `enable=true`.	true
auto_repair	boolean	Indique si la réparation automatique doit être activée. Ce paramètre ne prend effet que lorsque `enable=true`. `true` : active la réparation automatique. `false` : désactive la réparation automatique.	true
auto_repair_policy	object	La stratégie de nœud de réparation automatique.
restart_node	boolean	Indique si le redémarrage du nœud est autorisé. Ce paramètre ne prend effet que lorsque `auto_repair=true`. `true` : autorise le redémarrage du nœud. `false` : n'autorise pas le redémarrage du nœud.	true
approval_required	boolean	Indique si une approbation manuelle est requise pour la réparation du nœud.	false
auto_repair_policy_id	string	L'identifiant de la stratégie de réparation automatique.	r-xxxxxxxxx
max_parallel_repairing_nodes	string	Le nombre maximum de réparations parallèles. Lorsqu'un grand nombre de nœuds anormaux sont présents dans le pool de nœuds, cela spécifie le nombre ou le pourcentage maximum de nœuds pouvant être réparés simultanément.	1
max_unhealthy_nodes_threshold	string	La condition de disjoncteur d'auto-réparation. Lorsque le nombre ou le pourcentage de nœuds défectueux dépasse ce seuil, l'auto-réparation passe à l'état de disjoncteur et cesse d'initier de nouvelles actions de réparation.	10%
auto_vul_fix	boolean	Indique si les CVE doivent être corrigées automatiquement. Ce paramètre ne prend effet que lorsque `enable=true`. `true` : autorise les corrections automatiques des CVE. `false` : n'autorise pas les corrections automatiques des CVE.	true
auto_vul_fix_policy	object	La stratégie de correction automatique des CVE.
restart_node	boolean	Indique si les redémarrages de nœuds sont autorisés. Ce paramètre prend effet uniquement lorsque `auto_vul_fix=true`. Valeurs valides : `true` : les redémarrages de nœuds sont autorisés. `false` : les redémarrages de nœuds ne sont pas autorisés.	true
vul_level	string	Les niveaux de vulnérabilité autorisés pour la correction automatique, séparés par des virgules. Valeurs valides : `asap` : élevé `later` : moyen `nntf` : faible	asap,nntf
exclude_packages	string	Les packages à exclure lors de la correction des vulnérabilités.	kernel
auto_upgrade	boolean	Indique si la mise à niveau automatique des nœuds doit être activée. Ce paramètre prend effet uniquement lorsque `enable=true`. Valeurs valides : `true` : la mise à niveau automatique est activée. `false` : la mise à niveau automatique n'est pas activée.	true
auto_upgrade_policy	object	La stratégie de mise à niveau automatique.
auto_upgrade_kubelet	boolean	Indique si la mise à niveau automatique de kubelet est autorisée. Ce paramètre prend effet uniquement lorsque `auto_upgrade=true`. Valeurs valides : `true` : la mise à niveau automatique de kubelet est autorisée. `false` : la mise à niveau automatique de kubelet n'est pas autorisée.	true
upgrade_config	object	La configuration de la mise à niveau automatique. Ce paramètre prend effet uniquement lorsque `enable=true`.
auto_upgrade	boolean	Indique si la mise à niveau automatique doit être activée. Valeurs valides : `true` : la mise à niveau automatique est activée. `false` : la mise à niveau automatique n'est pas activée.	true
surge	integer	Le nombre de nœuds supplémentaires. Vous devez définir ce paramètre ou `surge_percentage`.	5
surge_percentage	integer	Le pourcentage de nœuds supplémentaires. Vous devez définir ce paramètre ou `surge`. Nombre de nœuds supplémentaires = Pourcentage de nœuds supplémentaires × Nombre de nœuds. Par exemple, si le pourcentage de nœuds supplémentaires est défini sur 50 % et qu'il y a 6 nœuds existants, le nombre de nœuds supplémentaires = 50 % × 6, ce qui signifie que 3 nœuds supplémentaires sont créés.	50
max_unavailable	integer	Le nombre maximal de nœuds indisponibles. Valeurs valides : [1,1000]. Valeur par défaut : 1.	1
auto_fault_diagnosis	boolean	Indique si la détection des pannes ECS pour l'auto-guérison des nœuds doit être activée.
drift_enabled	boolean	Indique si la rotation des nœuds doit être activée. Seuls les pools de nœuds gérés intelligemment prennent en charge cette fonctionnalité, et elle est activée par défaut. Les pools de nœuds classiques ne prennent pas en charge cette fonctionnalité.
scaling_group	object	La configuration du groupe de mise à l'échelle du pool de nœuds.
scaling_group_id	string	L'identifiant du groupe de mise à l'échelle.	asg-2ze8n5qw4atggut8****
vswitch_ids	array	La liste des identifiants des vSwitch.
	string	L'identifiant du vSwitch.	vsw-2ze3ds0mdip0hdz8i****
instance_types	array	La liste des types d'instances de nœuds. Vous pouvez sélectionner plusieurs types d'instances comme alternatives. Lors de la création de chaque nœud, le système tente d'acheter des instances en commençant par la première spécification jusqu'à ce que la création réussisse. Le type d'instance réellement acheté peut varier en fonction de la disponibilité des stocks.	ecs.n4.large
	string	Le type d'instance de nœud.	ecs.n4.large
instance_charge_type	string	Le mode de facturation des nœuds dans le pool de nœuds. Valeurs valides : `PrePaid` : abonnement. `PostPaid` : paiement à l'usage.	PostPaid
period	integer	La durée d'abonnement des nœuds. Ce paramètre prend effet et est requis uniquement lorsque `instance_charge_type` est défini sur `PrePaid`. Lorsque `period_unit=Week`, valeurs valides de `period` : {1, 2, 3, 4}. Lorsque `period_unit=Month`, valeurs valides de `period` : {1, 2, 3, 4, 5, 6, 7, 8, 9, 12, 24, 36, 48, 60}.	1
period_unit	string	L'unité de la période de facturation des nœuds. Ce paramètre est requis lorsque `instance_charge_type` est défini sur `PrePaid`. Valeurs valides : `Month` : l'unité de calcul (CU) est le mois. `Week` : l'unité de calcul (CU) est la semaine.	Month
auto_renew	boolean	Indique si le renouvellement automatique des nœuds doit être activé. Ce paramètre prend effet uniquement lorsque `instance_charge_type` est défini sur `PrePaid`. Valeurs valides : `true` : le renouvellement automatique est activé. `false` : le renouvellement automatique n'est pas activé.	false
auto_renew_period	integer	La durée de chaque cycle de renouvellement automatique. Valeurs valides : PeriodUnit=Week : 1, 2, 3. PeriodUnit=Month : 1, 2, 3, 6, 12, 24, 36, 48, 60.	0
spot_strategy	string	Le type d'instance spot. Valeurs valides : NoSpot : instance non spot. SpotWithPriceLimit : instance spot avec une limite de prix. SpotAsPriceGo : le système enchérit automatiquement au prix actuel du marché. Pour plus d'informations, consultez Instances spot.	NoSpot
spot_price_limit	array<object>	La configuration de la fourchette de prix pour les instances spot.
	object	La configuration de la fourchette de prix pour les instances spot. Vous pouvez définir différentes fourchettes de prix pour différents types d'instances.
instance_type	string	Le type d'instance spot.	ecs.c6.large
price_limit	string	La limite de prix pour une instance unique. Unité : USD/heure.	0.39
image_type	string	Le type d'image du système d'exploitation. Valeurs valides : `AliyunLinux` : image Alinux2. `AliyunLinuxSecurity` : image Alinux2 UEFI. `AliyunLinux3` : image Alinux3. `AliyunLinux3Arm64` : image Alinux3 ARM. `AliyunLinux3Security` : image Alinux3 UEFI. `CentOS` : image CentOS. `Windows` : image Windows. `WindowsCore` : image WindowsCore. `ContainerOS` : image optimisée pour les conteneurs. `AliyunLinux3ContainerOptimized` : image Alinux3 optimisée pour les conteneurs.	AliyunLinux3
image_id	string	L'identifiant de l'image personnalisée. Vous pouvez appeler `DescribeKubernetesVersionMetadata` pour interroger les images prises en charge par le système.	aliyun_3_x64_20G_alibase_20241218.vhd
system_disk_category	string	Le type de disque cloud système du nœud. Valeurs valides : `cloud_efficiency` : disque cloud ultra. `cloud_ssd` : SSD standard. `cloud_essd` : ESSD. `cloud_auto` : disque cloud ESSD AutoPL. `cloud_essd_entry` : disque cloud ESSD Entry.	cloud_efficiency
system_disk_categories	array	Les types de disques multiples pour le disque cloud système. Lorsqu'un type de disque de priorité supérieure n'est pas disponible, le système tente automatiquement le type de disque de priorité suivante pour créer le disque cloud système.
	string	Le type de disque cloud système du nœud. Valeurs valides : `cloud_efficiency` : disque cloud ultra. `cloud_ssd` : SSD standard. `cloud_essd` : ESSD. `cloud_auto` : disque cloud ESSD AutoPL. `cloud_essd_entry` : disque cloud ESSD Entry.	SSD standard
system_disk_size	integer	La taille du disque cloud système du nœud, en Gio. Valeurs valides : [20,2048].	120
system_disk_performance_level	string	Le niveau de performance du disque cloud système du nœud. Ce paramètre prend effet uniquement pour les disques cloud ESSD. Le niveau de performance est lié à la taille du disque cloud. Pour plus d'informations, consultez Disques cloud ESSD. Valeurs valides : PL0 : performances d'E/S simultanées maximales modérées avec une latence de lecture/écriture relativement stable. PL1 : performances d'E/S simultanées maximales modérées avec une latence de lecture/écriture relativement stable. PL2 : performances d'E/S simultanées maximales élevées avec une latence de lecture/écriture stable. PL3 : performances d'E/S simultanées maximales ultra-élevées avec une latence de lecture/écriture extrêmement stable.	PL1
system_disk_encrypted	boolean	Indique si le disque cloud système doit être chiffré. Valeurs valides : true : chiffré. false : non chiffré.	false
system_disk_kms_key_id	string	L'identifiant de la clé KMS utilisée pour le disque cloud système.	0e478b7a-4262-4802-b8cb-00d3fb40****
system_disk_encrypt_algorithm	string	L'algorithme de chiffrement utilisé pour le disque cloud système. Valeurs valides : aes-256.	aes-256
system_disk_bursting_enabled	boolean	Indique si le mode burst (burst de performance) doit être activé pour le disque cloud système du nœud. Valeurs valides : true : activé. Lorsqu'il est activé, le disque cloud améliore temporairement les performances en cas de pression soudaine de lecture/écriture de données due à des charges de travail fluctuantes, jusqu'à ce que la charge de travail se stabilise. false : non activé. Ce paramètre est pris en charge uniquement lorsque `system_disk_category` est défini sur `cloud_auto`. Pour plus d'informations, consultez Disques cloud ESSD AutoPL.	true
system_disk_provisioned_iops	integer	Les IOPS de lecture/écriture provisionnés pour le disque cloud système du nœud. Ce paramètre est applicable lorsque le type de disque est cloud_auto.	1000
data_disks	array	Les configurations des disques cloud de données des nœuds, y compris le type et la taille.
	data_disk	La configuration d'un disque cloud de données de nœud.
disk_init	array	La configuration de l'initialisation des périphériques bloc.
	DiskInit	La configuration DiskInit.
security_group_ids	array	La liste des identifiants de groupe de sécurité pour le pool de nœuds.
	string	La liste des identifiants de groupe de sécurité pour le pool de nœuds.	sg-2ze1iuk12m2sb4c4****
key_pair	string	Le nom de la paire de clés, mutuellement exclusif avec `login_password`. Lorsque le pool de nœuds est un pool de nœuds géré, seul `key_pair` est pris en charge.	pro-nodepool
login_password	string	Le mot de passe de connexion SSH, mutuellement exclusif avec `key_pair`. Le mot de passe doit comporter entre 8 et 30 caractères et contenir au moins trois des types de caractères suivants : lettres majuscules, lettres minuscules, chiffres et caractères spéciaux. Pour des raisons de sécurité, le mot de passe renvoyé dans le résultat de la requête est chiffré.	******
login_as_non_root	boolean	Indique si l'instance ECS issue de la mise à l'échelle utilise un utilisateur non-root pour la connexion. true : se connecte en tant qu'utilisateur non-root (ecs-user). false : se connecte en tant qu'utilisateur root.	true
cis_enabled `deprecated`	boolean	[Obsolète] Utilisez plutôt le paramètre security_hardening_os.	false
soc_enabled	boolean	Indique s'il faut activer le durcissement de sécurité MLPS 2.0. Vous ne pouvez activer cette fonctionnalité que lorsque l'image système est Alibaba Cloud Linux 2 ou Alibaba Cloud Linux 3. Alibaba Cloud fournit des normes de vérification de référence de conformité à la protection classifiée et des programmes d'analyse pour les images Alibaba Cloud Linux 2 et Alibaba Cloud Linux 3 MLPS 2.0 de niveau 3.	false
security_hardening_os	boolean	Indique s'il faut activer le durcissement de sécurité du système d'exploitation Alibaba Cloud. Valeurs valides : `true` : active le durcissement de sécurité du système d'exploitation Alibaba Cloud. `false` : n'active pas le durcissement de sécurité du système d'exploitation Alibaba Cloud. Valeur par défaut : `false`.	false
internet_charge_type	string	La méthode de facturation réseau pour les adresses IP publiques des nœuds. PayByBandwidth : facturé par bande passante fixe. PayByTraffic : facturé par consommation de trafic.	PayByBandwidth
internet_max_bandwidth_out	integer	La bande passante sortante maximale pour les adresses IP publiques des nœuds, en Mbit/s (mégabits par seconde). Valeurs valides : 1 à 100.	10
tags	array	Les balises de l'instance ECS.
	tag	La balise du nœud.	[{\"key\":\"pkg.E2EClient.ClusterId\",\"value\":\"troopers-\"}]
desired_size	integer	Le nombre souhaité de nœuds dans le pool de nœuds.	2
multi_az_policy	string	La stratégie de mise à l'échelle multizone pour les instances ECS dans le groupe de mise à l'échelle. Valeurs valides : `PRIORITY` : met à l'échelle en fonction des vSwitchs (VSwitchIds.N) que vous définissez. Lorsque des instances ECS ne peuvent pas être créées dans la zone du vSwitch ayant la priorité la plus élevée, le système utilise automatiquement le vSwitch de priorité suivante pour créer des instances ECS. `COST_OPTIMIZED` : tente de créer des instances par ordre de prix unitaire du vCPU, du plus bas au plus élevé. Lorsque la configuration de mise à l'échelle définit la méthode de facturation sur préemptible pour plusieurs types d'instances, les instances spot sont créées en premier. Vous pouvez utiliser le paramètre `CompensateWithOnDemand` pour indiquer s'il faut tenter automatiquement de créer des instances à la demande lorsque des instances spot ne peuvent pas être créées en raison d'un stock insuffisant. Remarque `COST_OPTIMIZED` ne prend effet que lorsque la configuration de mise à l'échelle spécifie plusieurs types d'instances ou utilise des instances spot. `BALANCE` : répartit uniformément les instances ECS sur les multiples zones spécifiées dans le groupe de mise à l'échelle. Si les zones deviennent déséquilibrées en raison d'un stock insuffisant, vous pouvez appeler l'opération API RebalanceInstances pour rééquilibrer les ressources.	COST_OPTIMIZED
scaling_policy	string	Le mode du groupe de mise à l'échelle. Valeurs valides : `release` : mode standard. Met à l'échelle en créant et en libérant des instances ECS en fonction de l'utilisation des ressources. `recycle` : mode rapide. Met à l'échelle en créant, en arrêtant et en démarrant des instances, ce qui améliore la vitesse des opérations de mise à l'échelle ultérieures. (Les ressources de calcul ne sont pas facturées pendant l'état arrêté. Seuls les frais de stockage sont facturés, à l'exception des types d'instances à disque local.)	release
on_demand_base_capacity	integer	Le nombre minimum d'instances à la demande requis dans le groupe de mise à l'échelle. Valeurs valides : [0,1000]. Lorsque le nombre d'instances à la demande est inférieur à cette valeur, les instances à la demande sont créées en premier.	0
on_demand_percentage_above_base_capacity	integer	Le pourcentage d'instances à la demande parmi les instances qui dépassent le nombre minimum d'instances à la demande (`on_demand_base_capacity`). Valeurs valides : [0,100].	20
spot_instance_pools	integer	Le nombre de types d'instances disponibles. Le groupe de mise à l'échelle crée des instances spot de manière équilibrée parmi les types d'instances les moins chers. Valeurs valides : [1,10].	5
spot_instance_remedy	boolean	Indique s'il faut activer le remplacement des instances spot. Lorsqu'il est activé, le groupe de mise à l'échelle tente de créer de nouvelles instances pour remplacer les instances spot sur le point d'être récupérées. Valeurs valides : `true` : active le remplacement des instances spot. `false` : n'active pas le remplacement des instances spot.	false
compensate_with_on_demand	boolean	Lorsque `multi_az_policy` est défini sur `COST_OPTIMIZED`, indique s'il faut autoriser la création automatique d'instances à la demande pour répondre aux exigences de quantité d'instances ECS lorsque des instances spot ne peuvent pas être créées en raison du prix ou du stock. Valeurs valides : `true` : autorise la création automatique d'instances à la demande pour répondre aux exigences de quantité d'instances ECS. `false` : n'autorise pas la création automatique d'instances à la demande pour répondre aux exigences de quantité d'instances ECS.	true
enable_high_density_mode	boolean	Indique s'il faut activer le mode disque cloud haute densité. Ceci n'est pris en charge que lorsque le pool de nœuds utilise des types d'instances. Lorsqu'il est activé, le nombre total de disques système et de disques de données ne dépasse pas la limite de disques cloud haute densité prise en charge par le type d'instance.	false
deploymentset_id	string	L'identifiant de l'ensemble de déploiement.	ds-bp1d19mmbsv3jf6xxxxx
rds_instances	array	Si des instances RDS sont spécifiées, les instances ECS dans le pool de nœuds du cluster sont automatiquement ajoutées à la liste blanche RDS.
	string	L'instance RDS.	rm-xxx
private_pool_options	object	Les options de pool privé.
id	string	L'identifiant du pool privé, qui est l'identifiant d'assurance d'élasticité ou l'identifiant de réservation de capacité.	eap-bp67acfmxazb4****
match_criteria	string	L'option de capacité de pool privé pour le lancement d'instances. Après l'entrée en vigueur d'une assurance d'élasticité ou d'une réservation de capacité, un pool privé est généré pour le lancement d'instances. Valeurs valides : `Open` : mode ouvert. Correspond automatiquement à la capacité de pool privé ouverte. Si aucune capacité de pool privé correspondante n'est disponible, les ressources du pool public sont utilisées pour le lancement. `Target` : mode spécifié. Utilise la capacité de pool privé spécifiée pour lancer des instances. Si la capacité de pool privé spécifiée n'est pas disponible, le lancement de l'instance échoue. `None` : n'utilise pas la capacité de pool privé pour le lancement d'instances.	Open
security_group_id	string	[Obsolète] L'identifiant du groupe de sécurité du pool de nœuds. Lorsque le pool de nœuds est associé à plusieurs groupes de sécurité, il s'agit de la première valeur dans `security_group_ids`.	sg-2ze1iuk12m2sb4c4****
platform	string	[Obsolète] La distribution du système d'exploitation. Valeurs valides : `CentOS` `AliyunLinux` `Windows` `WindowsCore`	AliyunLinux
ram_policy	string	Ce champ est obsolète. Utilisez plutôt ram_role_name.	KubernetesWorkerRole-021dc54f-929b-437a-8ae0-34c24d3e****
instance_patterns	array	Les configurations des attributs d'instance.
	instance_patterns	Les attributs d'instance.
ram_role_name	string	Le nom du rôle RAM du worker.	KubernetesWorkerRole-4a4fa089-80c1-48a5-b3c6-9349311f****
resource_pool_options	object	Le pool de ressources et la stratégie de pool de ressources utilisés lors de la création d'instances.
strategy	string	La stratégie de pool de ressources utilisée lors de la création d'instances. Valeurs valides : PrivatePoolFirst : pool privé en premier. PrivatePoolOnly : pool privé uniquement. None : aucune stratégie de pool de ressources.	PrivatePoolFirst
private_pool_ids	array	La liste des identifiants de pool privé.
	string	L'identifiant du pool privé.	eap-bp1c1fohub5jccwi****
system_disk_snapshot_policy_id	string	La stratégie d'instantané du disque système.	sp-0jl6xnmme8v7o935****
cpu_options	object	Les options de configuration du processeur.
nested_virtualization	string	Indique si la virtualisation imbriquée est activée. Valeurs valides : disabled : la virtualisation imbriquée est désactivée. enabled : la virtualisation imbriquée est activée.	enabled
node_config	object	La configuration du nœud.
kubelet_configuration	kubelet_config	Les paramètres de Kubelet.
node_os_config	object	La configuration du système d'exploitation du nœud.
hugepage	Hugepage	La configuration des pages volumineuses.
kubernetes_config	object	La configuration liée au cluster.
labels	array	La balise du nœud.
	tag	La configuration des étiquettes.	{}
taints	array	Les informations sur les taints du nœud. Les taints et les tolérances fonctionnent ensemble pour empêcher les pods d'être planifiés sur des nœuds inappropriés. Pour plus d'informations, consultez la page taint-and-toleration.
	taint	Les informations sur les taints du nœud.
runtime	string	Le nom de l'environnement d'exécution de conteneurs. ACK prend en charge les trois environnements d'exécution de conteneurs suivants : containerd : Recommandé. Prend en charge toutes les versions de cluster. Sandboxed-Container.runv : Conteneur sandboxé offrant une isolation renforcée. Prend en charge les clusters de version 1.31 et antérieures. docker : N'est plus maintenu. Prend en charge les clusters de version 1.22 et antérieures.	containerd
runtime_version	string	La version de l'environnement d'exécution de conteneurs.	1.6.38
cpu_policy	string	La stratégie de gestion CPU des nœuds. Les deux stratégies suivantes sont prises en charge pour les clusters de version 1.12.6 et ultérieure : `static` : permet d'accorder une affinité CPU renforcée et une exclusivité aux pods présentant certaines caractéristiques de ressources sur le nœud. `none` : active le schéma d'affinité CPU par défaut existant.	none
user_data	string	Les données personnalisées du pool de nœuds, qui correspondent à un script exécuté après l'initialisation du nœud. Pour plus d'informations, consultez la section Générer les données utilisateur de l'instance.	IyEvYmluL3NoCmVjaG8gIkhlbGxvIEFD****
unschedulable	boolean	Indique si les nœuds ajoutés lors de la mise à l'échelle sont non planifiables. true : non planifiable. false : planifiable.	true
cms_enabled	boolean	Indique si l'agent CloudMonitor doit être installé sur les nœuds ECS. Après l'installation, vous pouvez consulter les informations de surveillance des instances ECS créées dans la console CloudMonitor. Nous vous recommandons d'activer cette fonctionnalité. Valeurs valides : `true` : installe l'agent CloudMonitor sur les nœuds ECS. `false` : n'installe pas l'agent CloudMonitor sur les nœuds ECS.	true
node_name_mode	string	Le nom de nœud personnalisé. Un nom de nœud se compose de trois parties : préfixe + sous-chaîne de l'adresse IP du nœud + suffixe : Le préfixe et le suffixe peuvent tous deux être constitués d'une ou plusieurs parties séparées par « . ». Chaque partie peut contenir des lettres minuscules, des chiffres et des traits d'union (-). Le nom du nœud doit commencer et se terminer par une lettre minuscule ou un chiffre. La longueur du segment d'adresse IP spécifie le nombre de chiffres à extraire de la fin de l'adresse IP du nœud. Valeurs valides : 5 à 12. Par exemple, si l'adresse IP du nœud est 192.168.0.55, que le préfixe est aliyun.com, que la longueur du segment d'adresse IP est 5 et que le suffixe est test, le nom du nœud est aliyun.com00055test.	aliyun.com192.XX.YY.55test
pre_user_data	string	Les données pré-personnalisées du pool de nœuds, qui correspondent à un script exécuté avant l'initialisation du nœud. Pour plus d'informations, consultez la section Générer les données utilisateur de l'instance.	IyEvYmluL3NoCmVjaG8gIkhlbGxvIEFD
tee_config	object	La configuration du calcul confidentiel.
tee_enable	boolean	Indique si le calcul confidentiel doit être activé pour le cluster. Valeurs valides : `true` : Activé. `false` : Non activé.	false
interconnect_config	object	[Obsolète]\n\nLa configuration réseau pour les pools de nœuds périphériques. Cette valeur n'est significative que pour les pools de nœuds de type périphérique.
cen_id	string	[Obsolète]\n\nL'identifiant de l'instance Cloud Enterprise Network (CEN) liée au pool de nœuds périphériques amélioré.	cen-ey9k9nfhz0f*******
ccn_id	string	[Obsolète]\n\nL'identifiant de l'instance Cloud Connect Network (CCN) liée au pool de nœuds périphériques amélioré.	ccn-qm5i0i0q9yi*******
ccn_region_id	string	[Obsolète]\n\nLa région de l'instance Cloud Connect Network liée au pool de nœuds périphériques amélioré.	cn-shanghai
bandwidth	integer	[Obsolète]\n\nLa bande passante réseau du pool de nœuds périphériques amélioré. Unité : Mbit/s.	10
improved_period	string	[Obsolète]\n\nLa durée d'achat du pool de nœuds périphériques amélioré. Unité : mois.	1
max_nodes	integer	Le nombre maximal de nœuds autorisés dans le pool de nœuds périphériques. Ce paramètre spécifie le nombre maximal de nœuds que le pool de nœuds peut contenir et doit être supérieur ou égal à 0. Une valeur de 0 indique aucune limite supplémentaire (limité uniquement par le nombre total de nœuds que le cluster peut contenir, sans limite supplémentaire pour le pool de nœuds lui-même). Ce paramètre est généralement supérieur à 0 pour les pools de nœuds périphériques. Pour les pools de nœuds de type ESS et les pools de nœuds périphériques par défaut, ce paramètre est égal à 0.	10
interconnect_mode	string	Le type de réseau du pool de nœuds périphériques. Ce paramètre prend effet uniquement pour les pools de nœuds dont le `type` est `edge`. Valeurs valides : `basic` : Réseau public. Les nœuds du pool de nœuds cloud interagissent avec les nœuds cloud via le réseau public. Les applications du pool de nœuds cloud ne peuvent pas accéder directement au réseau interne du VPC cloud. `private` : Réseau privé. Les nœuds du pool de nœuds cloud se connectent au cloud via Express Connect, VPN ou CEN, offrant une meilleure qualité de communication cloud-périphérie et une sécurité plus efficace.	basic
auto_mode	object	La configuration de gestion intelligente.
enable	boolean	Indique si le mode de gestion intelligente est activé.	true
node_components	array<object>	La liste des composants du nœud.
	array<object>	Le composant du nœud.
name	string	Le nom du composant du nœud.	kubelet
version	string	La version du composant du nœud.	1.33.3-aliyun.1
config	object	La configuration du composant du nœud.
custom_config	object	La configuration personnalisée du composant du nœud.	{"cpuManagerPolicy":"static"}
	any	La chaîne de configuration personnalisée du composant du nœud.	cpuManagerPolicy
envs	array<object>	Les variables d'environnement du composant du nœud.
	object
name	string	Le nom de la variable d'environnement.	LOG_LEVEL
value	string	La valeur de la variable d'environnement.	info
config_revision	string	Le numéro de version de la configuration personnalisée du composant du nœud.	1
eflo_node_group	object	Les informations sur le groupe de nœuds Lingjun.
cluster_id	string	L'identifiant du cluster Lingjun.	i113790071760688002461
group_id	string	L'identifiant du groupe Lingjun.	i128147721760688002463
auto_attach_enabled	boolean	Indique si l'ajout automatique de nœuds est activé pour le pool de nœuds Lingjun (non effectif).
worker_ram_role_name	string	Le rôle RAM worker utilisé par le pool de nœuds Lingjun.

Exemples

JSON format

{
  "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": [
          "SSD standard"
        ],
        "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": "clé",
            "value": "valeur",
            "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": ""
      }
    }
  ]
}

Codes d'erreur

Consultez Codes d'erreur pour la liste complète.

Notes de version

Consultez Notes de version pour la liste complète.