Tous les produits
Search
Centre de documentation

Container Service for Kubernetes:DescribeClusterNodePoolDetail

Dernière mise à jour :Aug 21, 2026

Consulte la configuration d'un pool de nœuds spécifié dans un cluster par identifiant de pool de nœuds.

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

get

*Cluster.

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

Aucune Aucune

Syntaxe de la requête

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

Paramètres de chemin

Paramètre

Type

Requis

Description

Exemple

ClusterId

string

Oui

L'identifiant du cluster.

c23421cfa74454bc8b37163fd19af****

NodepoolId

string

Oui

L'identifiant du pool de nœuds.

np31da1b38983f4511b490fc62108a****

Paramètres de requête

Paramètre

Type

Requis

Description

Exemple

Éléments de réponse

Élément

Type

Description

Exemple

object

Les détails du pool de nœuds.

nodepool_info

object

La configuration 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 de gestion et de mise à l'échelle élastique).

  • edge : pool de nœuds de périphérie.

  • lingjun : pool de nœuds Lingjun.

ess

is_default

boolean

Indique s'il s'agit du pool de nœuds par défaut. En règle générale, un cluster ne possède 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-acfmyvw3wjmb****

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-10T14:25:37.285530433+08:00

updated

string

L'heure de la dernière mise à jour du pool de nœuds.

2025-04-15T15:39:45.41+08:00

status

object

L'état du pool de nœuds.

state

string

L'état du pool de nœuds. Valeurs valides :

  • active : actif.

  • scaling : mise à l'échelle.

  • removing : suppression de nœuds.

  • deleting : suppression.

  • updating : mise à jour.

active

healthy_nodes

integer

Le nombre de nœuds sains.

3

initial_nodes

integer

Le nombre de nœuds en cours de création.

0

failed_nodes

integer

Le nombre de nœuds 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

conditions

array<object>

Les conditions du pool de nœuds, qui représentent les informations d'état du pool de nœuds selon différentes dimensions.

object

Un attribut d'état unique.

type

string

Le type.

ImageUpgradeReady

status

string

L'état.

True

reason

string

La raison.

UpgradeDisabled

message

string

Les informations détaillées.

AutoUpgradeDisabled

last_transition_time

string

L'heure de la dernière transition d'état.

20**-**-30T10:39:00+08:00

auto_scaling

object

La configuration de mise à l'échelle automatique pour le pool de nœuds.

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 l'élasticité instantanée des nœuds par défaut. Les clusters de versions antérieures à 1.24 utilisent la mise à l'échelle élastique 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 la valeur est 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 maximal d'instances pouvant être mises à l'échelle dans le pool de nœuds, à l'exclusion de vos instances existantes.

10

min_instances

integer

Le nombre minimal d'instances pouvant être mises à l'échelle dans le pool de nœuds, à l'exclusion de vos instances existantes.

1

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 : associer une EIP.

  • false : ne pas associer d'EIP.

true

eip_bandwidth

integer

La bande passante crête de l'EIP.

Valeurs valides : [1,100]. Unité : Mbit/s.

5

management

object

La configuration du pool de nœuds géré.

enable

boolean

Indique si le pool de nœuds géré doit être activé. Valeurs valides :

  • true : activer le pool de nœuds géré.

  • false : désactiver 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. Valeurs valides :

  • true : activer la réparation automatique.

  • false : désactiver la réparation automatique.

true

auto_repair_policy

object

La stratégie de réparation automatique des nœuds.

restart_node

boolean

Indique si les redémarrages de nœuds sont autorisés. Ce paramètre ne prend effet que lorsque auto_repair=true. Valeurs valides :

  • true : autoriser les redémarrages de nœuds.

  • false : ne pas autoriser les redémarrages de nœuds.

true

approval_required

boolean

Indique si une approbation manuelle est requise pour la réparation de nœud.

false

auto_repair_policy_id

string

L'identifiant de la stratégie de réparation automatique.

r-xxxxxxxxxx

max_parallel_repairing_nodes

string

Le nombre maximal de réparations parallèles. Lorsqu'un grand nombre de nœuds anormaux sont présents dans le pool de nœuds, ce paramètre spécifie le nombre ou le pourcentage maximal de nœuds pouvant être réparés simultanément.

1

max_unhealthy_nodes_threshold

string

La condition du 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. Cela ne prend effet que lorsque enable=true.

  • true : autorise la correction automatique des CVE.

  • false : n'autorise pas la correction automatique 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. Cela ne prend effet que lorsque auto_vul_fix=true. Valeurs valides :

  • true : autorise les redémarrages de nœuds.

  • false : n'autorise pas les redémarrages de nœuds.

true

vul_level

string

Les niveaux de vulnérabilité autorisés pour les corrections automatiques, séparés par des virgules.

  • asap : élevé

  • later : moyen

  • nntf : faible

asap,nntf

exclude_packages

string

Les packages devant être exclus lors des corrections de vulnérabilités.

kernel

auto_upgrade

boolean

Indique si les nœuds doivent être mis à niveau automatiquement. Cela ne prend effet que lorsque enable=true.

  • true : active la mise à niveau automatique.

  • false : n'active pas la mise à niveau automatique.

true

auto_upgrade_policy

object

La stratégie de mise à niveau automatique.

auto_upgrade_kubelet

boolean

Indique si les mises à niveau automatiques de kubelet sont autorisées. Cela ne prend effet que lorsque auto_upgrade=true. Valeurs valides :

  • true : autorise les mises à niveau automatiques de kubelet.

  • false : n'autorise pas les mises à niveau automatiques de kubelet.

true

upgrade_config

object

La configuration de la mise à niveau automatique. Cela ne prend effet que lorsque enable=true.

auto_upgrade

boolean

Indique si la mise à niveau automatique doit être activée. Valeurs valides :

  • true : active la mise à niveau automatique.

  • false : n'active pas la mise à niveau automatique.

true

surge

integer

Le nombre de nœuds supplémentaires. Vous pouvez définir ce paramètre ou surge_percentage, mais pas les deux.

5

surge_percentage

integer

Le pourcentage de nœuds supplémentaires. Vous pouvez définir ce paramètre ou surge, mais pas les deux.

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 = 3.

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 la réparation automatique 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-2zeieod8giqmov7z****

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.

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}.

0

period_unit

string

L'unité de la période de facturation des nœuds. Ce paramètre doit être spécifié lorsque instance_charge_type est défini sur PrePaid.

  • Month : mesuré en mois.

  • Week : mesuré en semaines.

Month

auto_renew

boolean

Indique si le renouvellement automatique des nœuds doit être activé. Cela ne prend effet que lorsque instance_charge_type est défini sur PrePaid. Valeurs valides :

  • true : active le renouvellement automatique.

  • false : n'active pas le renouvellement automatique.

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.

1

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>

Les configurations 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

Le prix du marché d'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.

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.

cloud_essd

system_disk_size

integer

La taille du disque cloud système du nœud, en GiB.

Valeurs valides : [20,2048].

120

system_disk_performance_level

string

Le niveau de performance du disque cloud système du nœud. Cela s'applique uniquement aux disques cloud ESSD. Le niveau de performance est lié à la taille du disque. 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 clé KMS utilisé par le disque cloud système.

0e478b7a-4262-4802-b8cb-00d3fb40****

system_disk_encrypt_algorithm

string

L'algorithme de chiffrement utilisé par le disque cloud système. Valeurs valides : aes-256.

aes-256

system_disk_bursting_enabled

boolean

Indique si le mode burst (rafale de performances) est 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 lors de pics soudains de pression de lecture/écriture de données dus à des charges de travail fluctuantes, jusqu'à ce que la charge de travail revienne à un état stable.

  • 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 Disque 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.

Valeurs possibles : 0~min{50 000, 1000×capacité-performances de base}. Performances de base=min{1 800+50×capacité, 50000}.

Ce paramètre est pris en charge uniquement lorsque system_disk_category est défini sur cloud_auto. Pour plus d'informations, consultez Disque cloud ESSD AutoPL.

1000

data_disks

array

La combinaison du type, de la taille et d'autres configurations des disques cloud de données pour les nœuds.

data_disk

La configuration du disque cloud de données du nœud.

security_group_ids

array

La liste des identifiants de groupe de sécurité pour le pool de nœuds.

string

L'identifiant du groupe de sécurité du pool de nœuds.

sg-2ze60ockeekspl3d****

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 provisionnée 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 si le renforcement de la sécurité MLPS 2.0 est activé. Cela ne peut être activé pour les nœuds 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 base 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 niveau 3.

false

security_hardening_os

boolean

Indique si le renforcement de la sécurité du système d'exploitation Alibaba Cloud est activé. Valeurs valides :

  • true : Le renforcement de la sécurité du système d'exploitation Alibaba Cloud est activé.

  • false : Le renforcement de la sécurité du système d'exploitation Alibaba Cloud n'est pas activé.

Valeur par défaut : false.

false

internet_charge_type

string

La méthode de facturation pour l'adresse IP publique du nœud. Valeurs valides :

  • PayByBandwidth : facturé par bande passante fixe.

  • PayByTraffic : facturé par consommation de trafic.

PayByBandwidth

internet_max_bandwidth_out

integer

La bande passante sortante maximale pour l'adresse IP publique du nœud, 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.

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 de priorité la plus élevée, le vSwitch de priorité suivante est automatiquement utilisé.

  • 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 plusieurs types d'instances avec une facturation préemptible, les instances spot sont créées en premier. Vous pouvez utiliser le paramètre CompensateWithOnDemand pour spécifier s'il faut tenter automatiquement de créer des instances prépayées lorsque des instances spot ne peuvent pas être créées en raison d'un inventaire insuffisant.

    Remarque

    COST_OPTIMIZED ne prend effet que lorsque la configuration de mise à l'échelle définit plusieurs types d'instances ou utilise des instances spot.

  • BALANCE : Répartit uniformément les instances ECS sur les multiples zones actives spécifiées dans le groupe de mise à l'échelle. Si les zones deviennent déséquilibrées en raison d'un inventaire insuffisant, vous pouvez utiliser l'API RebalanceInstances pour rééquilibrer les ressources. Pour plus d'informations, consultez RebalanceInstances.

Valeur par défaut : PRIORITY.

Paramètres : Les méthodes de facturation pour le groupe de mise à l'échelle dépendent de la stratégie sélectionnée.

BALANCE

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, arrêtant et démarrant des instances, ce qui améliore la vitesse de mise à l'échelle ultérieure (les ressources de calcul ne sont pas facturées pendant l'arrêt, seuls les frais de stockage s'appliquent, à l'exception des types d'instances à disque local).

release

on_demand_base_capacity

integer

Le nombre minimum d'instances prépayées requis par le groupe de mise à l'échelle. Valeurs valides : [0,1000]. Les instances prépayées sont créées en premier lorsque le nombre est inférieur à cette valeur.

0

on_demand_percentage_above_base_capacity

integer

Le pourcentage d'instances prépayées parmi les instances qui dépassent la capacité de base à la demande minimale (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 uniforme parmi les types 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 prépayées pour répondre aux exigences de quantité d'instances ECS lorsque des instances spot ne peuvent pas être créées pour des raisons de prix ou d'inventaire. Valeurs valides :

  • true : Autorise la création automatique d'instances prépayées pour répondre aux exigences de quantité d'instances ECS.

  • false : N'autorise pas la création automatique d'instances prépayées pour répondre aux exigences de quantité d'instances ECS.

true

enable_high_density_mode

boolean

Indique si le mode disque cloud haute densité est activé. Cela 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 cloud système et 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 une liste d'instances RDS est spécifiée, les nœuds ECS du cluster sont automatiquement ajoutés à la liste blanche d'accès RDS.

string

L'instance RDS.

rm-xxx

private_pool_options

object

La configuration du pool de nœuds privé.

id

string

L'identifiant du pool de nœuds privé.

eap-bp67acfmxazb4****

match_criteria

string

Le type de pool de nœuds privé. Spécifie l'option de capacité de pool privé pour le lancement de l'instance. Après qu'une assurance d'élasticité ou une réservation de capacité prend effet, une capacité de pool privé est générée pour le lancement de l'instance. Valeurs valides :

  • Open : Mode ouvert. Fait automatiquement correspondre la capacité de pool privé de type ouvert. 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 : Mode non utilisé. Le lancement de l'instance n'utilise pas la capacité du pool privé.

Open

security_group_id

string

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-2ze60ockeekspl3d****

platform

string

La distribution du système d'exploitation. Valeurs valides :

  • CentOS

  • AliyunLinux

  • Windows

  • WindowsCore

AliyunLinux

ram_policy

string

[Obsolète] Utilisez plutôt ram_role_name.

KubernetesWorkerRole-021dc54f-929b-437a-8ae0-34c24d3e****

instance_patterns

array

Les configurations des attributs de l'instance.

instance_patterns

Les attributs de l'instance.

ram_role_name

string

Le nom du rôle RAM du worker.

KubernetesWorkerRole-4a4fa089-80c1-48a5-b3c6-9349311f****

instance_metadata_options InstanceMetadataOptions

La configuration d'accès aux métadonnées pour les instances ECS.

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.

private_pool_ids

array

La liste des identifiants de pool privé.

string

L'identifiant du pool privé.

eap-bp1c1fohub5jccwi****

strategy

string

La stratégie de pool de ressources utilisée lors de la création d'instances. Valeurs valides :\n- PrivatePoolFirst : pool privé en priorité.\n- PrivatePoolOnly : pool privé uniquement.\n- None : aucune stratégie de pool de ressources n'est utilisée.

PrivatePoolFirst

system_disk_snapshot_policy_id

string

La stratégie d'instantané pour le disque cloud système.

sp-bp11g8z59rawcud9****

disk_init

array

La configuration de l'initialisation des périphériques de bloc.

DiskInit

La configuration DiskInit.

cpu_options

object

Les options de configuration liées au processeur.

nested_virtualization

string

Indique si la virtualisation imbriquée est activée. Valeurs valides :\n- disabled : la virtualisation imbriquée est désactivée.\n- 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 balise ECS.

taints

array

Les informations sur les taints du nœud. Les taints et les tolerations 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

La configuration des 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 versions de cluster 1.31 et antérieures.

  • docker : N'est plus maintenu. Prend en charge les versions de cluster 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 du processeur des nœuds. Les deux stratégies suivantes sont prises en charge pour les clusters exécutant la version 1.12.6 ou ultérieure :

  • static : permet d'accorder aux pods présentant certaines caractéristiques de ressources sur le nœud une affinité processeur et une exclusivité renforcées.

  • none : active le schéma d'affinité processeur 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.

IyEvYmluL3NoCmVjaG8gIkhlbGxvIEFDSyEi

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 chacun ê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 extraits 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.

dGhpcyBpcyBhIGV4YW1wbGU

tee_config

object

La configuration du cluster de 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 liée au 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 (CCN) 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é : Mbps.

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

[Obsolète]\n\nLe nombre maximal de nœuds autorisés dans le pool de nœuds périphériques.

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 défini sur edge. Valeurs valides :\n\n- basic : réseau public. Les nœuds du pool de nœuds cloud interagissent avec les nœuds cloud via Internet. Les applications du pool de nœuds cloud ne peuvent pas accéder directement au réseau interne du VPC cloud.\n- 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 qualité de communication cloud-périphérie supérieure et une sécurité plus efficace.

basic

host_network

boolean

Indique si le mode réseau des pods utilise le mode réseau hôte.\n- true : réseau hôte. Les pods utilisent directement la pile réseau de l'hôte et partagent l'adresse IP et les ports avec l'hôte.\n- false : réseau de conteneurs. Les pods disposent de piles réseau indépendantes et n'occupent pas les ports réseau de l'hôte.

true

intranet

boolean

Indique si les nœuds du pool de nœuds de périphérie disposent d'une connectivité réseau de couche 3 entre eux.

  • true : Connectés. Tous les nœuds de ce pool de nœuds disposent d'une connectivité réseau de couche 3 entre eux.

  • false : Non connectés. Tous les nœuds de ce pool de nœuds ne disposent pas d'une connectivité réseau de couche 3 entre eux.

true

auto_mode

object

La configuration de gestion intelligente.

enable

boolean

Indique si la gestion intelligente est activée.

false

node_components

array<object>

La liste des composants de nœud.

array<object>

Le composant de nœud.

name

string

Le nom du composant de nœud.

kubelet

version

string

La version du composant de nœud.

1.33.3-aliyun.1

config

object

La configuration du composant de nœud.

custom_config

object

La configuration personnalisée du composant de nœud.

{"cpuManagerPolicy":"static"}

any

La chaîne de configuration personnalisée du composant de nœud.

cpuManagerPolicy

envs

array<object>

Les variables d'environnement du composant de 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 de 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 au pool de nœuds Lingjun est activé.

worker_ram_role_name

string

Le rôle RAM Worker utilisé par le pool de nœuds Lingjun.

Exemples

JSON format

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

Codes d'erreur

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

Notes de version

Consultez Notes de version pour la liste complète.