Tous les produits
Search

Ce produit

    Container Service for Kubernetes:CreateClusterNodePool

    Centre de documentation

    Container Service for Kubernetes:CreateClusterNodePool

    Dernière mise à jour :Aug 21, 2026

    Un pool de nœuds est une collection logique de nœuds partageant les mêmes attributs. Les pools de nœuds permettent une gestion et une exploitation et maintenance unifiées des nœuds, telles que les mises à niveau des nœuds et la mise à l'échelle élastique. Vous pouvez également utiliser les capacités d'exploitation et maintenance automatisées des pools de nœuds, y compris le correctif automatique des vulnérabilités CVE du système d'exploitation, la récupération automatique des nœuds défectueux et les mises à niveau automatiques des versions de kubelet et containerd, afin de réduire les coûts d'exploitation et de maintenance. Vous pouvez appeler CreateClusterNodePool pour créer un pool de nœuds pour un cluster.

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

    create

    *Cluster.

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

    		 Aucune Aucune

    Syntaxe de la requête

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

    Paramètres de chemin

    Paramètre

    Type

    Requis

    Description

    Exemple
    ClusterId

    string

    Oui

    L'identifiant du cluster.

    c61da77e8bfbc4c4c999af2b51b65****

    Paramètres de requête

    Paramètre

    Type

    Requis

    Description

    Exemple
    body

    object

    Non

    Les paramètres du corps de la requête.

    nodepool_info

    object

    Non

    La configuration du pool de nœuds.

    name

    string

    Oui

    Le nom du pool de nœuds.

    nodepool-test
    type

    string

    Non

    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.

    • hybrid : pool de nœuds de cloud hybride.

    Valeurs valides :

    • lingjun :

      Pool de nœuds Lingjun.

    • edge :

      Pool de nœuds périphériques.

    • ess :

      Pool de nœuds standard.

    ess
    resource_group_id

    string

    Non

    L'identifiant du groupe de ressources du pool de nœuds. Les instances mises à l'échelle horizontale par le pool de nœuds appartiennent à ce groupe de ressources.

    Une ressource ne peut appartenir qu'à un seul groupe de ressources. Vous pouvez mapper les groupes de ressources à des concepts tels que des projets, des applications ou des organisations en fonction de différents scénarios métier.

    rg-acfmyvw3wjmb****
    auto_scaling

    object

    Non

    La configuration de la mise à l'échelle élastique.

    enable

    boolean

    Non

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

    • true : active la fonctionnalité de mise à l'échelle automatique 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œud en fonction des nombres minimum et maximum d'instances configurés. Les clusters de version 1.24 ou ultérieure activent la mise à l'échelle instantanée des nœuds par défaut. Les clusters de versions antérieures à 1.24 activent 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 automatique. 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 au nombre souhaité.

    Lorsque la valeur est false, les autres paramètres de configuration dans auto_scaling ne prennent pas effet.

    Valeur par défaut : false.

    false
    type

    string

    Non

    Le type d'instance pour la mise à l'échelle élastique. Ce paramètre ne prend effet que lorsque enable=true. Valeurs valides :

    • cpu : type d'instance standard.

    • gpu : type d'instance GPU.

    • gpushare : type de partage de GPU.

    • spot : type d'instance spot.

    Valeur par défaut : cpu.

    Important Ce paramètre ne peut pas être modifié après la création du pool de nœuds.

    Valeurs valides :

    • spot :

      Type d'instance spot.

    • cpu :

      Type d'instance standard.

    • gpushare :

      Type de partage de GPU.

    • gpu :

      Type d'instance GPU.

    cpu
    max_instances

    integer

    Non

    Le nombre maximum d'instances extensibles dans le pool de nœuds, à l'exclusion de vos instances existantes. Ce paramètre ne prend effet que lorsque enable=true.

    Plage de valeurs : [min_instances, 2000]. Valeur par défaut : 0.

    10
    min_instances

    integer

    Non

    Le nombre minimum d'instances extensibles dans le pool de nœuds, à l'exclusion de vos instances existantes. Ce paramètre ne prend effet que lorsque enable=true.

    Plage de valeurs : [0, max_instances]. Valeur par défaut : 0.

    Remarque

    • Si le nombre minimum d'instances n'est pas 0, le groupe de mise à l'échelle crée automatiquement le nombre correspondant d'instances ECS après sa prise d'effet.

    • Définissez le nombre maximum d'instances sur une valeur qui n'est pas inférieure au nombre actuel de nœuds dans le pool de nœuds. Sinon, la fonctionnalité de mise à l'échelle élastique déclenchera directement une réduction horizontale des nœuds pour le pool de nœuds après sa prise d'effet.

    1
    is_bond_eip deprecated

    boolean

    Non

    [Deprecated] Ce paramètre est obsolète. Utilisez internet_charge_type et internet_max_bandwidth_out à la place.

    Indique si une EIP doit être associée. Valeurs valides :

    • true : associe une EIP.

    • false : n'associe pas d'EIP.

    Valeur par défaut : false.

    null
    eip_internet_charge_type deprecated

    string

    Non

    [Deprecated] Utilisez internet_charge_type et internet_max_bandwidth_out à la place.

    La méthode de facturation de l'EIP. Valeurs valides :

    • PayByBandwidth : paiement par bande passante fixe.

    • PayByTraffic : paiement par transfert de données.

    Valeur par défaut : PayByBandwidth.

    null
    eip_bandwidth deprecated

    integer

    Non

    [Deprecated] Utilisez internet_charge_type et internet_max_bandwidth_out à la place.

    La bande passante de crête de l'EIP. Unité : Mbit/s.

    null
    management

    object

    Non

    La configuration de la fonctionnalité de pool de nœuds géré.

    enable

    boolean

    Non

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

    • true : Activée.

    • false : Désactivée. Les autres configurations associées ne prennent effet que lorsque enable est défini sur true.

    Valeur par défaut : false.

    false
    auto_repair

    boolean

    Non

    Indique si la réparation automatique des nœuds doit être activée. Ce paramètre ne prend effet que lorsque enable=true.

    • true : Activée.

    • false : Désactivée.

    Valeur par défaut : true.

    true
    auto_repair_policy

    object

    Non

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

    restart_node

    boolean

    Non

    Indique si le redémarrage des nœuds est autorisé. Ce paramètre ne prend effet que lorsque auto_repair=true. Valeurs valides :

    • true : Le redémarrage des nœuds est autorisé.

    • false : Le redémarrage des nœuds n'est pas autorisé.

    Valeur par défaut : true.

    true
    approval_required

    boolean

    Non

    Indique si une approbation manuelle est requise pour la réparation des nœuds.

    max_parallel_repairing_nodes

    string

    Non

    Le nombre maximal de nœuds pouvant être réparés en parallèle. Lorsqu'un grand nombre de nœuds non sains existent 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. Vous pouvez spécifier un nombre (par exemple 5, plage valide : 1 à 100000) ou un pourcentage (par exemple 10 %, plage valide : 1 % à 100 %). Valeur par défaut : 1.

    5
    max_unhealthy_nodes_threshold

    string

    Non

    Le seuil 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. Vous pouvez spécifier un nombre (par exemple 10, plage valide : 1 à 100000) ou un pourcentage (par exemple 20 %, plage valide : 1 % à 100 %). Valeur par défaut : 100 %.

    20%
    auto_vul_fix

    boolean

    Non

    Indique si la correction automatique des vulnérabilités CVE doit être activée. Ce paramètre ne prend effet que lorsque enable=true.

    • true : La correction automatique des CVE est activée.

    • false : La correction automatique des CVE est désactivée.

    Valeur par défaut : true.

    true
    auto_vul_fix_policy

    object

    Non

    La stratégie de correction automatique des CVE.

    restart_node

    boolean

    Non

    Indique si le redémarrage des nœuds est autorisé. Ce paramètre ne prend effet que lorsque auto_vul_fix=true. Valeurs valides :

    • true : Le redémarrage des nœuds est autorisé.

    • false : Le redémarrage des nœuds n'est pas autorisé.

    Valeur par défaut : true.

    false
    vul_level

    string

    Non

    Les niveaux de vulnérabilité autorisés pour la correction automatique, séparés par des virgules. Exemple : asap,later. Valeurs valides :

    • asap : élevé

    • later : moyen

    • nntf : faible

    Valeur par défaut : asap.

    asap,nntf
    exclude_packages

    string

    Non

    Les packages à exclure lors de la correction des vulnérabilités.

    Valeur par défaut : kernel.

    kernel
    auto_upgrade

    boolean

    Non

    Indique si la mise à niveau automatique des nœuds doit être activée. Ce paramètre ne prend effet que lorsque enable=true.

    • true : La mise à niveau automatique est activée.

    • false : La mise à niveau automatique est désactivée.

    Valeur par défaut : true.

    true
    auto_upgrade_policy

    object

    Non

    La stratégie de mise à niveau automatique des nœuds.

    auto_upgrade_kubelet

    boolean

    Non

    Indique si la mise à niveau automatique de kubelet est autorisée. Ce paramètre ne prend effet que 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.

    Valeur par défaut : true.

    true
    auto_upgrade_runtime

    boolean

    Non

    Indique si la mise à niveau automatique du runtime est autorisée. Ce paramètre ne prend effet que lorsque auto_upgrade=true. Valeurs valides :

    • true : La mise à niveau automatique du runtime est autorisée.

    • false : La mise à niveau automatique du runtime n'est pas autorisée.

    Valeur par défaut : true.

    false
    auto_upgrade_os

    boolean

    Non

    Indique si la mise à niveau automatique du système d'exploitation est autorisée. Ce paramètre ne prend effet que lorsque auto_upgrade=true. Valeurs valides :

    • true : La mise à niveau automatique du système d'exploitation est autorisée.

    • false : La mise à niveau automatique du système d'exploitation n'est pas autorisée.

    Valeur par défaut : false.

    false
    upgrade_config deprecated

    object

    Non

    [Obsolète] Utilisez plutôt le paramètre auto_upgrade au niveau supérieur.

    La configuration de la mise à niveau automatique. Ce paramètre ne prend effet que lorsque enable=true.

    auto_upgrade deprecated

    boolean

    Non

    [Obsolète] Utilisez plutôt le paramètre auto_upgrade au niveau supérieur.

    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 est désactivée.

    null
    surge

    integer

    Non

    Le nombre de nœuds supplémentaires. Vous pouvez spécifier ce paramètre ou surge_percentage.

    Les nœuds deviennent indisponibles pendant une mise à niveau. Vous pouvez créer des nœuds supplémentaires pour compenser la charge de travail du cluster.

    Remarque

    Le nombre de nœuds supplémentaires ne doit pas dépasser le nombre actuel de nœuds.

    0
    surge_percentage

    integer

    Non

    Le pourcentage de nœuds supplémentaires. Vous pouvez spécifier 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 existe 6 nœuds, le nombre de nœuds supplémentaires = 50 % × 6 = 3.

    0
    max_unavailable

    integer

    Non

    Le nombre maximal de nœuds indisponibles. Plage valide : [1,1000].

    Valeur par défaut : 1.

    1
    auto_fault_diagnosis

    boolean

    Non

    Indique si la détection des pannes ECS pour l'auto-réparation des nœuds doit être activée.

    drift_enabled

    boolean

    Non

    Indique si la rotation des nœuds doit être activée. Seuls les pools de nœuds gérés intelligents 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

    Non

    La configuration du groupe de mise à l'échelle du pool de nœuds.

    vswitch_ids

    array

    Oui

    La liste des identifiants de vSwitch. Valeurs valides : [1,8].

    Remarque

    Pour garantir une haute disponibilité, sélectionnez des vSwitch dans différentes zones.

    string

    Non

    L'identifiant du vSwitch.

    vsw-wz9mfnhmssud6eicu****
    instance_types

    array

    Oui

    La liste des types d'instances pour le pool de nœuds. Lorsque le pool de nœuds monte en charge, des instances sont créées en fonction des types d'instances qui répondent aux exigences de cette liste.

    Le nombre de types d'instances pris en charge varie de 1 à 10.

    Remarque

    Pour garantir une haute disponibilité, spécifiez plusieurs types d'instances.

    string

    Non

    Le type d'instance. Pour plus d'informations, consultez Familles d'instances.

    ecs.d1ne.2xlarge
    instance_charge_type

    string

    Oui

    Le mode de facturation des nœuds du pool de nœuds. Valeurs valides :

    • PrePaid : abonnement.

    • PostPaid : paiement à l'usage.

    Valeur par défaut : PostPaid.

    Valeurs valides :

    • PostPaid :

      Instance à paiement à l'usage.

    • PrePaid :

      Instance par abonnement.

    PostPaid
    period

    integer

    Non

    La durée d'abonnement des nœuds du pool de nœuds. Ce paramètre prend effet et est requis uniquement lorsque instance_charge_type est défini sur PrePaid.

    • Si period_unit=Week, valeurs valides de period : {1, 2, 3, 4}.

    • Si 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

    Non

    L'unité de temps de facturation pour les nœuds du pool de nœuds. Ce paramètre prend effet et est requis uniquement lorsque instance_charge_type est défini sur PrePaid.

    • Month : utilise le mois comme unité de calcul (CU).

    • Week : utilise la semaine comme unité de calcul (CU).

    Valeur par défaut : Month.

    Month
    auto_renew

    boolean

    Non

    Indique si le renouvellement automatique des nœuds du pool de nœuds doit être activé. Ce paramètre prend effet uniquement lorsque instance_charge_type est défini sur PrePaid. Valeurs valides :

    • true : active le renouvellement automatique.

    • false : désactive le renouvellement automatique.

    Valeur par défaut : false.

    true
    auto_renew_period

    integer

    Non

    La durée de renouvellement automatique pour un seul renouvellement. Valeurs valides :

    • PeriodUnit=Week : 1, 2, 3.

    • PeriodUnit=Month : 1, 2, 3, 6, 12, 24, 36, 48, 60.

    Valeur par défaut : 1.

    1
    spot_strategy

    string

    Non

    Le type d'instance spot. Valeurs valides :

    • NoSpot : instance non spot.

    • SpotWithPriceLimit : instance spot avec 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>

    Non

    La configuration de la limite de prix pour le type d'instance spot actuel.

    object

    Non

    La configuration de la limite de prix pour les instances spot. Vous pouvez définir différentes limites de prix pour différents types d'instances.

    instance_type

    string

    Non

    Le type d'instance de l'instance spot.

    ecs.c6.large
    price_limit

    string

    Non

    Le prix maximum par instance.

    Unité : USD/heure.

    0.39
    image_type

    string

    Non

    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 d'optimisation de conteneur.

    • AliyunLinux3ContainerOptimized : image d'optimisation de conteneur Alinux3.

    AliyunLinux3
    image_id

    string

    Non

    L'identifiant de l'image personnalisée. L'image fournie par le système est utilisée par défaut.

    aliyun_2_1903_x64_20G_alibase_20200529.vhd
    system_disk_category

    string

    Non

    Le type de disque cloud système pour les nœuds. 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.

    Valeur par défaut : cloud_efficiency.

    cloud_efficiency
    system_disk_categories

    array

    Non

    Plusieurs types de disques cloud pour le disque cloud système. Si le type de disque cloud de priorité la plus élevée n'est pas disponible, le système tente automatiquement le type de disque cloud de priorité suivante pour créer le disque cloud système.

    string

    Non

    Plusieurs types de disques cloud système pour les nœuds.

    Valeurs valides :

    • cloud : disque cloud basique.

    • cloud_efficiency : disque cloud ultra.

    • cloud_ssd : SSD standard.

    • cloud_essd : ESSD.

    • cloud_auto : disque cloud ESSD AutoPL.

    • cloud_essd_entry : disque ESSD Entry.

    cloud_essd
    system_disk_size

    integer

    Non

    La taille du disque cloud système pour les nœuds. Unité : GiB.

    Valeurs valides : [20,2048].

    120
    system_disk_performance_level

    string

    Non

    Le niveau de performance du disque cloud système pour les nœuds. Ce paramètre prend effet uniquement pour les disques cloud ESSD. Le niveau de performance varie en fonction de la taille du disque cloud. Pour plus d'informations, consultez Disques cloud ESSD.

    • PL0 : performances d'E/S concurrentes maximales modérées avec une latence de lecture/écriture relativement stable.

    • PL1 : performances d'E/S concurrentes maximales modérées avec une latence de lecture/écriture relativement stable.

    • PL2 : performances d'E/S concurrentes maximales élevées avec une latence de lecture/écriture stable.

    • PL3 : performances d'E/S concurrentes maximales ultra-élevées avec une latence de lecture/écriture extrêmement stable.

    PL1
    system_disk_encrypted

    boolean

    Non

    Indique si le disque cloud système doit être chiffré. Valeurs valides :

    • true : chiffre le disque cloud système.

    • false : ne chiffre pas le disque cloud système.

    false
    system_disk_kms_key_id

    string

    Non

    L'identifiant de la clé KMS utilisée par le disque cloud système.

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

    string

    Non

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

    aes-256
    system_disk_bursting_enabled

    boolean

    Non

    Indique si les performances en rafale du disque cloud système des nœuds doivent être activées. Valeurs valides :

    • true : active les performances en rafale.

    • false : désactive les performances en rafale.

    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

    Non

    Les IOPS de lecture/écriture provisionnés pour le disque cloud système des nœuds.

    Valeurs valides : 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 Disques cloud ESSD AutoPL.

    1000
    data_disks

    array

    Non

    La configuration des disques cloud de données pour les nœuds du pool de nœuds.

    data_disk

    Non

    La configuration du disque cloud de données.

    security_group_ids

    array

    Non

    La liste des identifiants de groupe de sécurité. Ce paramètre est mutuellement exclusif avec security_group_id. Utilisez security_group_ids à la place. Si security_group_id et security_group_ids sont tous deux spécifiés, security_group_ids est prioritaire.

    string

    Non

    La liste des identifiants de groupe de sécurité. Ce paramètre est mutuellement exclusif avec security_group_id. Utilisez security_group_ids à la place. Si security_group_id et security_group_ids sont tous deux spécifiés, security_group_ids est prioritaire.

    sg-wz9a8g2mt6x5ll******
    key_pair

    string

    Non

    Le nom de la paire de clés pour la connexion sans mot de passe. Ce paramètre est mutuellement exclusif avec login_password.

    Remarque

    Si le pool de nœuds utilise le système d'exploitation ContainerOS, seul key_pair est pris en charge.

    np-key-name
    login_password

    string

    Non

    Le mot de passe de connexion SSH. Ce paramètre est mutuellement exclusif avec key_pair. Le mot de passe doit comporter de 8 à 30 caractères et contenir au moins trois des types de caractères suivants : lettres majuscules, lettres minuscules, chiffres et caractères spéciaux.

    ****
    login_as_non_root

    boolean

    Non

    Indique si la connexion à l'instance ECS issue du scale-out doit s'effectuer en tant qu'utilisateur non root.

    • true : se connecte en tant qu'utilisateur non root (ecs-user).

    • false : se connecte en tant qu'utilisateur root.

    true
    cis_enabled deprecated

    boolean

    Non

    [Obsolète] Utilisez le paramètre security_hardening_os à la place.

    null
    soc_enabled

    boolean

    Non

    Indique si le renforcement de la sécurité MLPS 2.0 doit être activé. Ce paramètre est disponible uniquement 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é de protection classifiée et des programmes d'analyse pour les images de niveau 3 MLPS 2.0 d'Alibaba Cloud Linux 2 et d'Alibaba Cloud Linux 3.

    false
    security_hardening_os

    boolean

    Non

    Indique si le renforcement de la sécurité d'Alibaba Cloud OS doit être activé. Valeurs valides :

    • true : active le renforcement de la sécurité d'Alibaba Cloud OS.

    • false : désactive le renforcement de la sécurité d'Alibaba Cloud OS.

    Valeur par défaut : false.

    false
    internet_charge_type

    string

    Non

    Le mode de facturation des adresses IP publiques. Valeurs valides :

    • PayByBandwidth : paiement par bande passante.

    • PayByTraffic : paiement par trafic.

    PayByTraffic
    internet_max_bandwidth_out

    integer

    Non

    La bande passante publique sortante maximale pour les nœuds. Unité : Mbit/s. Valeurs valides : [1,100].

    5
    tags

    array<object>

    Non

    Les balises qui sont ajoutées uniquement aux instances ECS.

    Les clés de balise ne peuvent pas être dupliquées et peuvent comporter jusqu'à 128 caractères. Les clés et les valeurs de balise ne peuvent pas commencer par "aliyun" ou "acs:", ni contenir "https://" ou "http://".

    object

    Non

    La balise du nœud.

    key

    string

    Non

    La clé de la balise.

    node-k-1
    value

    string

    Non

    La valeur de la balise.

    node-v-1
    desired_size

    integer

    Non

    Le nombre de nœuds souhaité dans le pool de nœuds.

    Le nombre total de nœuds que le pool de nœuds doit maintenir. Nous vous recommandons de configurer au moins 2 nœuds pour garantir le bon fonctionnement des composants du cluster. Vous pouvez augmenter ou réduire le pool de nœuds en ajustant le nombre de nœuds souhaité.

    Si vous n'avez pas besoin de créer des nœuds, définissez ce paramètre sur 0. Vous pourrez ajuster manuellement la valeur ultérieurement pour ajouter des nœuds.

    0
    multi_az_policy

    string

    Non

    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 les instances 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 ayant la 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 plusieurs types d'instances avec le mode de facturation préemptible, les instances spot sont créées en premier. Vous pouvez utiliser le paramètre CompensateWithOnDemand pour indiquer si le système doit automatiquement tenter de créer des instances prépayées lorsque des instances spot ne peuvent pas être créées en raison d'un stock insuffisant ou pour d'autres raisons.

      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 spécifiées dans le groupe de mise à l'échelle. Si les zones deviennent déséquilibrées en raison d'un stock insuffisant ou pour d'autres raisons, vous pouvez appeler l'opération API RebalanceInstances pour rééquilibrer les ressources.

    Valeur par défaut : PRIORITY. RebalanceInstances

    COST_OPTIMIZED
    scaling_policy

    string

    Non

    Le modèle de groupe de mise à l'échelle. Valeurs valides :

    • release : Modèle standard. Met à l'échelle en créant et en libérant des instances ECS en fonction de l'utilisation des ressources de calcul demandées.

    • recycle : Modèle rapide. Met à l'échelle en créant, arrêtant et démarrant des instances, ce qui améliore la vitesse des opérations de mise à l'échelle ultérieures. Les instances arrêtées n'entraînent pas de frais de ressources de calcul, mais des frais de stockage s'appliquent toujours, à l'exception des instances avec des disques locaux.

    Valeur par défaut : release.

    release
    on_demand_base_capacity

    integer

    Non

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

    0
    on_demand_percentage_above_base_capacity

    integer

    Non

    Le pourcentage d'instances prépayées parmi les instances supplémentaires qui dépassent le nombre minimum d'instances prépayées (on_demand_base_capacity) dans le groupe de mise à l'échelle. Valeurs valides : [0, 100].

    20
    spot_instance_pools

    integer

    Non

    Le nombre de types d'instances disponibles. Le groupe de mise à l'échelle crée des instances spot de plusieurs types au coût le plus bas. Valeurs valides : [1, 10].

    5
    spot_instance_remedy

    boolean

    Non

    Indique si la complétion des instances spot doit être activée. Lorsqu'elle est activée, 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 après la réception d'une notification système. Valeurs valides :

    • true : Active la complétion des instances spot.

    • false : Désactive la complétion des instances spot.

    false
    compensate_with_on_demand

    boolean

    Non

    Indique si la création automatique d'instances prépayées est autorisée pour atteindre le nombre requis d'instances ECS lorsque multi_az_policy est défini sur COST_OPTIMIZED et que des instances spot ne peuvent pas être créées en raison du prix, du stock ou d'autres raisons. Valeurs valides :

    • true : Autorise la création automatique d'instances prépayées pour atteindre le nombre requis d'instances ECS.

    • false : N'autorise pas la création automatique d'instances prépayées pour atteindre le nombre requis d'instances ECS.

    true
    enable_high_density_mode

    boolean

    Non

    Indique si le mode de disque cloud haute densité doit être activé. 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 cloud système et de disques cloud de données ne dépasse pas le nombre maximum de disques cloud haute densité pris en charge par le type d'instance.

    false
    deploymentset_id

    string

    Non

    L'identifiant du jeu de déploiement. Vous pouvez utiliser un jeu de déploiement pour répartir les instances ECS mises à l'échelle horizontalement par le pool de nœuds sur différents serveurs physiques afin de garantir une haute disponibilité et une reprise sur sinistre sous-jacente. Lorsque des instances ECS sont créées dans un jeu de déploiement, elles sont lancées dans la région spécifiée en fonction de la stratégie de déploiement préconfigurée.

    Important Après avoir sélectionné un jeu de déploiement, le nombre maximum de nœuds dans le pool de nœuds est limité. Par défaut, un jeu de déploiement prend en charge un maximum de 20 × nombre de zones (le nombre de zones est déterminé par les vSwitchs). Choisissez avec soin et assurez-vous que le jeu de déploiement dispose d'un quota suffisant pour éviter les échecs de mise à l'échelle horizontale des nœuds.

    ds-bp1d19mmbsv3jf6xxxxx
    rds_instances

    array

    Non

    La liste des instances ApsaraDB RDS.

    string

    Non

    L'identifiant de l'instance ApsaraDB RDS.

    rds-****
    private_pool_options

    object

    Non

    La configuration du pool privé.

    id

    string

    Non

    L'identifiant du pool privé. Lorsque match_criteria est défini sur Target, vous devez spécifier l'identifiant du pool privé.

    eap-bp67acfmxazb4****
    match_criteria

    string

    Non

    Le type de pool privé. Indique 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é de type ouvert. Si aucune capacité de pool privé correspondante n'est disponible, les ressources de pool public sont utilisées pour le lancement.

    • Target : Mode ciblé. 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 : Aucun mode de pool privé. Le lancement d'instances n'utilise pas la capacité de pool privé.

    Target
    security_group_id deprecated

    string

    Non

    L'identifiant du groupe de sécurité du pool de nœuds. Utilisez soit ce paramètre, soit security_group_ids. L'utilisation de security_group_ids est recommandée.

    sg-wz9a8g2mt6x5llu0****
    platform deprecated

    string

    Non

    [Obsolète] Utilisez le paramètre image_type à la place.

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

    • CentOS

    • AliyunLinux

    • Windows

    • WindowsCore

    Valeur par défaut : AliyunLinux.

    null
    instance_patterns

    array

    Non

    La configuration des attributs d'instance.

    instance_patterns

    Non

    Les attributs d'instance.

    ram_role_name

    string

    Non

    Le nom du rôle RAM Worker.

    • Si laissé vide, le rôle RAM Worker par défaut créé par le cluster est utilisé.

    • Si spécifié, le rôle RAM doit être un rôle de service standard avec son service de confiance configuré sur Elastic Compute Service. Pour plus d'informations, consultez Créer un rôle de service standard. Lorsque le rôle RAM spécifié n'est pas le rôle RAM Worker par défaut créé par le cluster, le nom du rôle ne peut pas commencer par KubernetesMasterRole- ou KubernetesWorkerRole-.

    Important Seuls les clusters ACK gérés de version 1.22 ou ultérieure prennent en charge ce paramètre.
    Create a regular service role

    example-role
    instance_metadata_options InstanceMetadataOptions

    Non

    La configuration d'accès aux métadonnées de l'instance ECS.

    resource_pool_options

    object

    Non

    Le pool de ressources et la stratégie de pool de ressources utilisés lors de la création d'instances. Après avoir défini ce paramètre, notez ce qui suit : Ce paramètre ne prend effet que lors de la création d'instances prépayées. Ce paramètre ne peut pas être défini conjointement avec private_pool_options.match_criteria ou private_pool_options.id.

    strategy

    string

    Non

    La stratégie de pool de ressources utilisée lors de la création d'instances. Les pools de ressources incluent les pools privés générés après l'entrée en vigueur d'une assurance d'élasticité ou d'une réservation de capacité, et les pools publics, pour le lancement d'instances. Valeurs valides : PrivatePoolFirst : Pool privé en premier. Lorsque cette stratégie est sélectionnée et que resouce_pool_options.private_pool_ids est spécifié, les pools privés spécifiés sont utilisés en premier. Si aucun pool privé n'est spécifié ou si la capacité du pool privé spécifié est insuffisante, les pools privés de type ouvert sont automatiquement appariés. Si aucun pool privé correspondant n'est disponible, les ressources du pool public sont utilisées pour créer des instances. PrivatePoolOnly : Pool privé uniquement. Lorsque cette stratégie est sélectionnée, resouce_pool_options.private_pool_ids doit être spécifié. Si la capacité du pool privé spécifié est insuffisante, le lancement de l'instance échoue. None : Aucune stratégie de pool de ressources. Valeur par défaut : None.

    PrivatePoolFirst
    private_pool_ids

    array

    Non

    La liste des identifiants de pool privé, qui sont des identifiants d'assurance d'élasticité ou des identifiants de réservation de capacité. Seuls les identifiants de pool privé en mode Target peuvent être spécifiés. Valeurs valides de N : 1 à 20.

    string

    Non

    L'identifiant du pool privé, qui est l'identifiant d'assurance d'élasticité ou l'identifiant de réservation de capacité. Seuls les identifiants de pool privé en mode Target peuvent être spécifiés.

    eap-bp67acfmxazb4****
    system_disk_snapshot_policy_id

    string

    Non

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

    sp-0jl6xnmme8v7o935****
    disk_init

    array

    Non

    La configuration d'initialisation des périphériques bloc.

    DiskInit

    Non

    La configuration DiskInit.

    cpu_options

    object

    Non

    Les options de configuration liées au processeur.

    nested_virtualization

    string

    Non

    Indique si la virtualisation imbriquée doit être activée. Valeurs valides : disabled : Désactive la virtualisation imbriquée. enabled : Active la virtualisation imbriquée.

    enabled
    node_config

    object

    Non

    La configuration du nœud.

    kubelet_configuration kubelet_config

    Non

    Les paramètres de kubelet.

    kubernetes_config

    object

    Non

    La configuration relative au cluster.

    labels

    array

    Non

    Les étiquettes de nœud. Vous pouvez ajouter des étiquettes aux nœuds du cluster Kubernetes.

    tag

    Non

    La configuration des étiquettes.

    taints

    array

    Non

    La configuration des taints.

    taint

    Non

    La collection des configurations de taints.

    runtime

    string

    Non

    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é. Pris en charge par toutes les versions de cluster.

    • Sandboxed-Container.runv : Conteneur sandbox offrant une isolation supérieure. Pris en charge par les clusters de version 1.31 et antérieures.

    • docker : N'est plus maintenu. Pris en charge par les clusters de version 1.22 et antérieures.

    Valeur par défaut : containerd.

    containerd
    runtime_version

    string

    Non

    La version de l'environnement d'exécution de conteneurs.

    1.6.38
    cpu_policy

    string

    Non

    La stratégie de gestion CPU pour les nœuds. Les deux stratégies suivantes sont prises en charge pour les clusters de version 1.12.6 et ultérieures :

    • static : Permet d'accorder aux pods présentant certaines caractéristiques de ressources sur le nœud une affinité et une exclusivité CPU améliorées.

    • none : Active le schéma d'affinité CPU par défaut existant.

    Valeur par défaut : none.

    none
    user_data

    string

    Non

    Les données utilisateur de l'instance. Une fois le nœud intégré au cluster, le script de données utilisateur spécifié est exécuté. Pour plus d'informations, consultez Scripts de données utilisateur.

    dGhpcyBpcyBhIGV4YW1wbGU=
    unschedulable

    boolean

    Non

    Indique si les nœuds ajoutés par mise à l'échelle sont non planifiables.

    • true : Non planifiables.

    • false : Planifiables.

    true
    cms_enabled

    boolean

    Non

    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. Il est recommandé 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.

    Valeur par défaut : false.

    false
    node_name_mode

    string

    Non

    Le nom de nœud personnalisé. Une fois le nom du nœud personnalisé, le nom du nœud, le nom de l'instance ECS et le nom d'hôte de l'instance ECS sont tous modifiés en conséquence.

    Remarque

    Pour les instances Windows avec des noms de nœud personnalisés activés, le nom d'hôte est fixé à l'adresse IP avec des tirets (-) remplaçant les points (.) dans l'adresse IP, et n'inclut pas le préfixe ou le suffixe.

    Le nom du nœud se compose d'un préfixe, de l'adresse IP du nœud et d'un suffixe :

    • La longueur totale est de 2 à 64 caractères. Le nom du nœud doit commencer et se terminer par une lettre minuscule ou un chiffre.

    • Le préfixe et le suffixe peuvent contenir des lettres majuscules et minuscules, des chiffres, des tirets (-) et des points (.). Ils doivent commencer par une lettre majuscule ou minuscule et ne peuvent pas commencer ou se terminer par un tiret (-) ou un point (.). Les tirets (-) ou points (.) consécutifs ne sont pas autorisés.

    • Le préfixe est obligatoire (restriction ECS). Le suffixe est facultatif.

    • L'IP du nœud est l'adresse IP privée complète du nœud.

    Exemple : Si l'adresse IP du nœud est 192.XX.YY.55, que le préfixe est aliyun.com et que le suffixe est test :

    • Pour un nœud Linux, le nom du nœud, le nom de l'instance ECS et le nom d'hôte de l'instance ECS sont tous aliyun.com192.XX.YY.55test.

    • Pour un nœud Windows, le nom d'hôte de l'instance ECS est 192-XX-YY-55, et le nom du nœud ainsi que le nom de l'instance ECS sont tous deux aliyun.com192.XX.YY.55test.

    aliyun.com192.XX.YY.55test
    pre_user_data

    string

    Non

    Les pré-données utilisateur pour l'instance. Avant que le nœud ne rejoigne le cluster, le script de pré-données utilisateur spécifié est exécuté. Pour plus d'informations, consultez Scripts de données utilisateur.

    dGhpcyBpcyBhIGV4YW1wbGU
    tee_config

    object

    Non

    La configuration du cluster de calcul confidentiel.

    tee_enable

    boolean

    Non

    Indique si le calcul confidentiel doit être activé pour le cluster.

    • true : Active le calcul confidentiel.

    • false : N'active pas le calcul confidentiel.

    true
    interconnect_config deprecated

    object

    Non

    [Obsolète]

    La configuration du pool de nœuds périphériques.

    cen_id

    string

    Non

    [Deprecated]

    L'identifiant de l'instance du Cloud Enterprise Network (CEN) associée au pool de nœuds périphériques amélioré.

    null
    ccn_id

    string

    Non

    [Deprecated]

    L'identifiant de l'instance du Cloud Connect Network (CCN) associée au pool de nœuds périphériques amélioré.

    null
    ccn_region_id

    string

    Non

    [Deprecated]

    La région de l'instance du Cloud Connect Network (CCN) liée au pool de nœuds périphériques amélioré.

    null
    bandwidth

    integer

    Non

    [Deprecated]

    La bande passante réseau du pool de nœuds périphériques amélioré. Unité : Mbit/s.

    null
    improved_period

    string

    Non

    [Deprecated]

    La durée d'achat du pool de nœuds périphériques amélioré. Unité : mois.

    null
    count deprecated

    integer

    Non

    [Deprecated] Utilisez desired_size à la place.

    Le nombre de nœuds dans le pool de nœuds.

    null
    max_nodes deprecated

    integer

    Non

    [Deprecated]

    Le nombre maximal de nœuds autorisés dans le pool de nœuds périphériques.

    null
    interconnect_mode

    string

    Non

    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 Internet. 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 qualité de communication cloud-périphérie supérieure et une sécurité plus efficace.

    basic
    host_network

    boolean

    Non

    Indique si le mode réseau des pods utilise le mode réseau hôte.

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

    • 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

    Non

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

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

    • false : Non connectés. Aucun nœud du pool de nœuds ne dispose d'une connectivité réseau de couche 3 avec les autres.

    true
    eflo_node_group

    object

    Non

    La configuration du pool de nœuds Lingjun.

    cluster_id

    string

    Non

    L'identifiant du cluster Lingjun à associer lors de la création d'un pool de nœuds Lingjun.

    i1169130516633730****
    group_id

    string

    Non

    L'identifiant du groupe Lingjun du cluster Lingjun à associer lors de la création d'un pool de nœuds Lingjun.

    ng-ec3c96ff0aa****
    auto_attach_enabled

    boolean

    Non

    Indique si l'ajout automatique de nœuds doit être activé pour le pool de nœuds Lingjun.

    worker_ram_role_name

    string

    Non

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

    auto_mode

    object

    Non

    La configuration de la gestion intelligente pour le pool de nœuds.

    enable

    boolean

    Non

    Indique si le mode de gestion intelligente doit être activé. Valeurs valides :

    • true : Active le mode de gestion intelligente. Cette option ne peut être activée que si le mode de gestion intelligente est activé pour le cluster.

    • false : N'active pas le mode de gestion intelligente.

    true
    node_components

    array<object>

    Non

    La liste des composants de nœud.

    array<object>

    Non

    Le composant de nœud.

    name

    string

    Non

    Le nom du composant de nœud.

    kubelet
    version

    string

    Non

    La version du composant de nœud.

    1.33.3-aliyun.1
    config

    object

    Non

    La configuration du composant de nœud.

    custom_config

    object

    Non

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

    {"cpuManagerPolicy":"static"}

    any

    Non

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

    cpuManagerPolicy
    envs

    array<object>

    Non

    Les variables d'environnement du composant de nœud.

    object

    Non

    name

    string

    Non

    Le nom de la variable d'environnement.

    LOG_LEVEL
    value

    string

    Non

    La valeur de la variable d'environnement.

    info

    Éléments de réponse

    Élément

    Type

    Description

    Exemple

    object

    La configuration du pool de nœuds.

    nodepool_id

    string

    L'identifiant du pool de nœuds.

    np31da1b38983f4511b490fc62108a****
    task_id

    string

    L'identifiant de la tâche.

    T-613b19bbd160ad492800****
    request_id

    string

    L'identifiant de la requête.

    0527ac9a-c899-4341-a21a-****

    Exemples

    JSON format

    {
  "nodepool_id": "np31da1b38983f4511b490fc62108a****",
  "task_id": "T-613b19bbd160ad492800****",
  "request_id": "0527ac9a-c899-4341-a21a-****"
}

    Codes d'erreur

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

    Notes de version

    Consultez Notes de version pour la liste complète.