Met à jour la configuration d'un pool de nœuds en fonction de l'identifiant du pool de nœuds en appelant l'opération ModifyClusterNodePool.
Description de l'opération
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
|
cs:ModifyClusterNodePool |
update |
*Cluster.
|
Aucune | Aucune |
Syntaxe de la requête
PUT /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. |
p31da1b38983f4511b490fc62108a**** |
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 |
Non |
Le nom du pool de nœuds. Règles de nommage : Le nom doit comporter de 1 à 63 caractères et peut contenir des chiffres, des caractères chinois, des lettres et des traits d'union (-). Il ne peut pas commencer par un trait d'union (-). |
default-nodepool |
| resource_group_id |
string |
Non |
L'identifiant du groupe de ressources du pool de nœuds. Les instances ajoutées par le pool de nœuds lors de la mise à l'échelle appartiennent à ce groupe de ressources. |
rg-acfmyvw3wjm**** |
| auto_scaling |
object |
Non |
La configuration de mise à l'échelle automatique. |
|
| enable |
boolean |
Non |
Indique si la mise à l'échelle automatique doit être activée. Valeurs valides : |
true |
type
deprecated
|
string |
Non |
Le type de mise à l'échelle automatique, classé par type d'instance pour la mise à l'échelle automatique. Valeurs valides : |
cpu |
| max_instances |
integer |
Non |
Le nombre maximal d'instances pouvant être ajoutées par mise à l'échelle dans le pool de nœuds, à l'exclusion de vos instances existantes. Ce paramètre ne prend effet que lorsque |
10 |
| min_instances |
integer |
Non |
Le nombre minimal d'instances évolutives dans le pool de nœuds, à l'exclusion de vos instances existantes. Ce paramètre prend effet uniquement lorsque enable=true. Valeurs valides : [0, max_instances]. Valeur par défaut : 0. Remarque
|
2 |
is_bond_eip
deprecated
|
boolean |
Non |
[Déprécié] Ce paramètre est déprécié. Utilisez plutôt internet_charge_type et internet_max_bandwidth_out. |
null |
eip_internet_charge_type
deprecated
|
string |
Non |
[Déprécié] Utilisez plutôt internet_charge_type et internet_max_bandwidth_out. |
null |
eip_bandwidth
deprecated
|
integer |
Non |
[Obsolète] Utilisez plutôt internet_charge_type et internet_max_bandwidth_out. La bande passante maximale de l'EIP. Valeurs valides : [1,100]. Unité : Mbit/s. |
null |
| management |
object |
Non |
La configuration du pool de nœuds géré. |
|
| enable |
boolean |
Non |
Indique si le pool de nœuds géré doit être activé. Valeurs valides : |
true |
| auto_repair |
boolean |
Non |
Indique si les nœuds doivent être réparés automatiquement. Ce paramètre prend effet uniquement lorsque
Valeur par défaut : |
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 prend effet uniquement lorsque |
true |
| approval_required |
boolean |
Non |
Indique si la réparation des nœuds nécessite une approbation manuelle. |
|
| auto_repair_policy_id |
string |
Non |
L'identifiant de la stratégie de réparation automatique. |
r-xxxxxxxxxx |
| 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 anormaux 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 |
La condition de déclenchement du disjoncteur pour l'auto-réparation. Lorsque le nombre ou le pourcentage de nœuds défectueux dépasse ce seuil, l'auto-réparation passe en é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 les vulnérabilités CVE doivent être corrigées automatiquement. Ce paramètre prend effet uniquement lorsque |
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 prend effet uniquement lorsque auto_vul_fix=true. Valeurs valides :
Valeur par défaut : true. |
true |
| vul_level |
string |
Non |
Les niveaux de vulnérabilité autorisés pour la correction automatique, séparés par des virgules. Exemple : |
asap,nntf |
| exclude_packages |
string |
Non |
Les packages à exclure lors de la correction des vulnérabilités. |
kernel |
| auto_upgrade |
boolean |
Non |
Indique si les nœuds doivent être mis à niveau automatiquement. Ce paramètre prend effet uniquement lorsque |
true |
| auto_upgrade_policy |
object |
Non |
La stratégie de mise à niveau automatique. |
|
| auto_upgrade_kubelet |
boolean |
Non |
Indique si la mise à niveau automatique de kubelet est autorisée. Ce paramètre prend effet uniquement lorsque |
true |
| auto_upgrade_runtime |
boolean |
Non |
Indique si la mise à niveau automatique de l'environnement d'exécution est autorisée. Ce paramètre prend effet uniquement lorsque |
false |
| auto_upgrade_os |
boolean |
Non |
Indique si la mise à niveau automatique du système d'exploitation est autorisée. Ce paramètre prend effet uniquement lorsque |
false |
upgrade_config
deprecated
|
object |
Non |
[Obsolète] Utilisez plutôt le paramètre La configuration de mise à niveau automatique. Ce paramètre prend effet uniquement lorsque |
|
auto_upgrade
deprecated
|
boolean |
Non |
[Obsolète] Utilisez plutôt le paramètre auto_upgrade au niveau supérieur. |
true |
| surge |
integer |
Non |
Le nombre de nœuds supplémentaires. Vous pouvez spécifier soit ce paramètre, soit |
5 |
| surge_percentage |
integer |
Non |
Le pourcentage de nœuds supplémentaires. Vous pouvez spécifier soit ce paramètre, soit |
0 |
| max_unavailable |
integer |
Non |
Le nombre maximal de nœuds indisponibles. |
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 |
Non |
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-wz9uwxhawmtzg7u9h**** |
|
| instance_types |
array |
Non |
La liste des types d'instances de nœud. Vous pouvez sélectionner plusieurs types d'instances comme alternatives. Lors de la création de chaque nœud, le système tente d'acheter des instances en commençant par la première spécification jusqu'à ce que la création réussisse. Le type d'instance finalement acheté peut varier en fonction de la disponibilité des stocks. |
|
|
string |
Non |
Le type d'instance. Pour plus d'informations, consultez Famille d'instances. |
ecs.c6.large |
|
| instance_charge_type |
string |
Non |
Le mode de facturation des nœuds dans le pool de nœuds. Valeurs valides : |
PostPaid |
| period |
integer |
Non |
La durée de l'abonnement des nœuds dans le pool de nœuds. Ce paramètre prend effet et est requis uniquement lorsque |
1 |
| period_unit |
string |
Non |
Le cycle de facturation des nœuds dans le pool de nœuds. Ce paramètre prend effet et est requis uniquement lorsque |
Month |
| auto_renew |
boolean |
Non |
Indique si le renouvellement automatique doit être activé pour les nœuds. Ce paramètre prend effet uniquement lorsque |
true |
| auto_renew_period |
integer |
Non |
La durée de chaque cycle de renouvellement automatique. Valeurs valides : |
1 |
| spot_strategy |
string |
Non |
Le type d'instance spot. Valeurs valides : |
SpotWithPriceLimit |
| spot_price_limit |
array<object> |
Non |
Les configurations de limite de prix pour les instances spot. |
|
|
object |
Non |
Les configurations de limite de prix pour les instances spot. |
||
| instance_type |
string |
Non |
Le type d'instance de l'instance spot. |
ecs.c6.large |
| price_limit |
string |
Non |
Le prix maximal d'une instance. Unité : USD/heure. |
0.39 |
| image_type |
string |
Non |
Le type de distribution du système d'exploitation. Nous vous recommandons d'utiliser ce paramètre pour spécifier le système d'exploitation du nœud. Valeurs valides : |
AliyunLinux3 |
| image_id |
string |
Non |
L'identifiant de l'image personnalisée. Vous pouvez appeler |
|
| system_disk_category |
string |
Non |
Le type de disque cloud système du nœud. Valeurs valides : |
cloud_efficiency |
| system_disk_categories |
array |
Non |
Les types de disques cloud multiples pour le disque cloud système. Si un type de disque cloud de priorité supérieure 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 |
Les types de disques cloud système multiples pour le nœud. |
cloud_essd |
|
| system_disk_size |
integer |
Non |
La taille du disque cloud système du nœud. Unité : Gio. |
120 |
| system_disk_performance_level |
string |
Non |
Le niveau de performance du disque cloud système du nœud. Ce paramètre prend effet uniquement pour les disques cloud ESSD. Le niveau de performance est lié à la taille du disque cloud. Pour plus d'informations, consultez Disques cloud ESSD. |
PL1 |
| system_disk_encrypted |
boolean |
Non |
Indique si le disque cloud système doit être chiffré. Valeurs valides : |
false |
| system_disk_kms_key_id |
string |
Non |
L'identifiant de clé KMS utilisé 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_provisioned_iops |
integer |
Non |
Les IOPS de lecture/écriture provisionnés pour le disque cloud système du nœud. |
1000 |
| system_disk_bursting_enabled |
boolean |
Non |
Indique si le mode burst (burst de performances d'E/S) doit être activé pour le disque cloud système du nœud. Valeurs valides : |
true |
| data_disks |
array |
Non |
Les configurations de disque cloud de données pour les nœuds. Valeurs valides : de 0 à 10. Vous pouvez ajouter jusqu'à 10 disques cloud de données. |
|
| data_disk |
Non |
La configuration du disque cloud de données pour le nœud. |
||
| disk_init |
array |
Non |
La configuration de l'initialisation des périphériques blocs. |
|
|
DiskInit |
Non |
La configuration de l'initialisation des périphériques blocs. |
||
| key_pair |
string |
Non |
Le nom de la paire de clés. Spécifiez ce paramètre ou |
pro-nodepool |
| login_password |
string |
Non |
Le mot de passe de connexion SSH. Spécifiez ce paramètre ou |
Hello1234 |
| internet_charge_type |
string |
Non |
Le mode de facturation des adresses IP publiques. Valeurs valides : |
PayByBandwidth |
| internet_max_bandwidth_out |
integer |
Non |
La bande passante sortante maximale pour l'adresse IP publique du nœud. Unité : Mbps (mégabits par seconde). Valeurs valides : [1,100]. |
5 |
| tags |
array |
Non |
Les balises qui sont ajoutées uniquement aux instances ECS. |
|
| tag |
Non |
La balise de l'instance ECS. |
||
| desired_size |
integer |
Non |
Le nombre souhaité de nœuds dans le pool de nœuds. |
2 |
| 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 : |
BALANCE |
| scaling_policy |
string |
Non |
Le mode du groupe de mise à l'échelle. Valeurs valides : |
release |
| on_demand_base_capacity |
integer |
Non |
Le nombre minimum d'instances à la demande requis par le groupe de mise à l'échelle. Valeurs valides : [0,1000]. Les instances à la demande sont créées en priorité lorsque le nombre d'instances à la demande est inférieur à cette valeur. |
0 |
| on_demand_percentage_above_base_capacity |
integer |
Non |
Le pourcentage d'instances à la demande parmi les instances qui dépassent le nombre minimum d'instances à la demande ( |
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 manière optimisée en termes de coûts sur plusieurs types d'instances. Valeurs valides : [1,10]. |
5 |
| spot_instance_remedy |
boolean |
Non |
Indique si le remplacement des instances spot doit être activé. Si cette option est activée, lorsqu'un message système indique qu'une instance spot va être récupérée, le groupe de mise à l'échelle tente de créer une nouvelle instance pour remplacer l'instance spot sur le point d'être récupérée. Valeurs valides : |
false |
| compensate_with_on_demand |
boolean |
Non |
Indique si la création automatique d'instances postpayées est autorisée pour atteindre le nombre requis d'instances ECS lorsque les instances spot spécifiées ne peuvent pas être créées en raison de contraintes de coût ou d'un stock insuffisant. Ce paramètre ne prend effet que lorsque |
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. Lorsque ce mode est activé, le nombre total de disques cloud système et de disques cloud de données ne dépasse pas le nombre de disques cloud haute densité pris en charge par le type d'instance. |
false |
| rds_instances |
array |
Non |
La liste des instances RDS. |
|
|
string |
Non |
L'identifiant de l'instance RDS. Si une liste d'instances RDS est spécifiée, les instances ECS des nœuds du cluster sont automatiquement ajoutées à la liste blanche RDS. |
rds-xxx |
|
| private_pool_options |
object |
Non |
La configuration du pool privé. |
|
| id |
string |
Non |
L'identifiant du pool privé. Lorsque |
eap-bp67acfmxazb4**** |
| match_criteria |
string |
Non |
Le type du pool de nœuds privé. L'option de pool privé pour le lancement d'instance. Une fois qu'une garantie d'élasticité ou une réservation de capacité prend effet, un pool privé est généré pour la capacité réservée, lequel peut être sélectionné lors du lancement des instances. Valeurs valides :
|
Open |
platform
deprecated
|
string |
Non |
[Obsolète] Utilisez plutôt le paramètre image_type. La plateforme du système d'exploitation. Valeurs valides :
|
AliyunLinux |
| instance_patterns |
array |
Non |
Les configurations d'attributs d'instance. |
|
| instance_patterns |
Non |
Les attributs d'instance. |
||
| deploymentset_id |
string |
Non |
L'ensemble de déploiement auquel appartiennent les instances ECS créées par le pool de nœuds. Ce paramètre prend effet uniquement pour les nouveaux nœuds. L'ensemble de déploiement des nœuds existants n'est pas modifié. |
ds-bp1d19mmbsv3jf6xxxxx |
| security_group_ids |
array |
Non |
La liste des identifiants de groupe de sécurité. |
|
|
string |
Non |
L'identifiant du groupe de sécurité. |
sg-wz9a8g2mt6x5ll****** |
|
| 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 les points suivants : |
|
| strategy |
string |
Non |
La stratégie de pool de ressources utilisée lors de la création des instances. Les pools de ressources comprennent les pools privés générés après l'entrée en vigueur de l'assurance d'élasticité ou de la réservation de capacité, ainsi que les pools publics, qui sont disponibles pour le démarrage des instances. Valeurs valides :
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 pour ce paramètre. Valeurs valides de N : 1 à 20. |
|
|
string |
Non |
L'identifiant du pool privé, qui correspond à 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 pour ce paramètre. |
eap-bp67acfmxazb4**** |
|
| system_disk_snapshot_policy_id |
string |
Non |
La stratégie d'instantané pour le disque cloud système. |
sp-0jl6xnmme8v7o935**** |
| kubernetes_config |
object |
Non |
La configuration liée au cluster. |
|
| labels |
array |
Non |
Les étiquettes de nœud. Vous pouvez ajouter des étiquettes aux nœuds du cluster Kubernetes. Règles de définition des étiquettes : |
|
| tag |
Non |
L'étiquette de nœud. |
||
| taints |
array |
Non |
La configuration des taints de nœud. |
|
| taint |
Non |
La configuration des taints de nœud. |
||
| 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 :
Valeur par défaut : containerd. |
containerd |
| runtime_version |
string |
Non |
La version de l'environnement d'exécution de conteneur. |
1.6.38 |
| cpu_policy |
string |
Non |
La stratégie de gestion du CPU pour les nœuds. Les deux stratégies suivantes sont prises en charge pour les clusters de version 1.12.6 ou ultérieure : |
none |
| unschedulable |
boolean |
Non |
Indique si les nœuds ajoutés lors de la mise à l'échelle sont non planifiables. |
false |
| user_data |
string |
Non |
Les données utilisateur de l'instance. Une fois qu'un nœud rejoint le cluster, le script de données utilisateur spécifié est exécuté. Pour plus d'informations, consultez Scripts de données utilisateur. |
IyEvdXNyL2Jpbi9iYXNoCmVjaG8gIkhlbGxvIEFDSyEi |
| 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. Nous vous recommandons d'activer cette fonctionnalité. Valeurs valides :
Valeur par défaut : |
true |
| pre_user_data |
string |
Non |
Les pré-données utilisateur de l'instance. Avant qu'un 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. |
IyEvdXNyL2Jpbi9iYXNoCmVjaG8gIkhlbGxvIEFDSyEi |
| node_name_mode |
string |
Non |
Le paramètre de nom de nœud personnalisé. Un nom de nœud se compose de trois parties : préfixe + adresse IP du nœud + suffixe. |
customized,aliyun,ip,com |
| tee_config |
object |
Non |
La configuration du cluster de calcul confidentiel. |
|
| tee_enable |
boolean |
Non |
Indique si le cluster de calcul confidentiel doit être activé. Valeurs valides :
Valeur par défaut : |
false |
| update_nodes |
boolean |
Non |
Indique si les étiquettes et les taints de nœud doivent être mis à jour de manière synchrone. |
true |
| concurrency |
boolean |
Non |
Indique si la concurrence doit être activée. |
true |
| eflo_node_group |
object |
Non |
La configuration du pool de nœuds Lingjun. (Non effectif) |
|
| auto_attach_enabled |
string |
Non |
Indique si l'ajout automatique pour le pool de nœuds Lingjun doit être activé. (Non effectif) |
Éléments de réponse
|
Élément |
Type |
Description |
Exemple |
|
object |
Les données du corps de la réponse. |
||
| task_id |
string |
L'identifiant de la tâche. |
T-5fd211e924e1d00787000293 |
| nodepool_id |
string |
L'identifiant du pool de nœuds. |
np737c3ac1ac684703b9e10673aa2c**** |
| request_id |
string |
L'identifiant de la requête. |
687C5BAA-D103-4993-884B-C35E4314**** |
Exemples
JSON format
{
"task_id": "T-5fd211e924e1d00787000293",
"nodepool_id": "np737c3ac1ac684703b9e10673aa2c****",
"request_id": "687C5BAA-D103-4993-884B-C35E4314****"
}
Codes d'erreur
Consultez Codes d'erreur pour la liste complète.
Notes de version
Consultez Notes de version pour la liste complète.