Tous les produits
Search
Centre de documentation

Container Service for Kubernetes:DescribeClusterAttachScripts

Dernière mise à jour :Aug 18, 2026

Pour ajouter manuellement des instances ECS existantes à un cluster ACK en tant que nœuds de travail ou pour réintégrer des nœuds dans un pool de nœuds, appelez l'opération DescribeClusterAttachScripts afin d'obtenir le script d'attachement requis.

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

update

*Cluster

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

Aucune Aucune

Syntaxe de la requête

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

Paramètres de chemin

Paramètre

Type

Requis

Description

Exemple

ClusterId

string

Oui

L'identifiant du cluster.

ca375a93a30474552ad2a0ebe183e****

Paramètres de requête

Paramètre

Type

Requis

Description

Exemple

body

object

Non

Le corps de la requête.

amd64

nodepool_id

string

Non

L'identifiant du pool de nœuds. Vous pouvez ajouter le nœud à un pool de nœuds spécifique.

Remarque

Si vous ne spécifiez pas d'identifiant de pool de nœuds, le nœud est ajouté au pool de nœuds par défaut.

np1c9229d9be2d432c93f77a88fca0****

format_disk

boolean

Non

Indique s'il faut monter un disque de données sur l'instance et stocker les conteneurs et les images sur le disque de données lorsque vous ajoutez manuellement une instance existante au cluster. Valeurs valides :

  • true : monte le disque de données sur l'instance. Les données d'origine sur le disque de données seront effacées. Sauvegardez vos données avant de poursuivre.

  • false : ne monte pas le disque de données sur l'instance.

Valeur par défaut : false.

Règles de montage des disques de données :

  • Si une instance ECS possède des disques de données attachés et que le dernier disque de données n'est pas initialisé, le système formate automatiquement ce disque en ext4 et l'utilise pour stocker le contenu de /var/lib/docker et /var/lib/kubelet.

  • Si aucun disque de données n'est attaché à l'instance ECS, le système ne monte pas de nouveau disque de données.

false

keep_instance_name

boolean

Non

Indique s'il faut conserver le nom de l'instance lorsque l'instance est ajoutée au cluster. Si vous ne conservez pas le nom de l'instance, le système renomme l'instance pour utiliser le format worker-k8s-for-cs-<clusterid>. Valeurs valides :

  • true : conserve le nom de l'instance.

  • false : ne conserve pas le nom de l'instance. Le système renomme l'instance selon une règle système.

Valeur par défaut : true.

true

rds_instances

array

Non

Si vous spécifiez une liste d'instances RDS, le système ajoute automatiquement les instances ECS des nœuds du cluster aux listes blanches d'accès des instances RDS spécifiées.

string

Non

L'identifiant de l'instance RDS.

rm-xxx

arch

string

Non

L'architecture CPU du nœud. Les architectures CPU prises en charge incluent amd64, arm et arm64.

Valeur par défaut : amd64.

Remarque

Ce paramètre est requis si le cluster est un cluster edge managé.

amd64

options

string

Non

Les paramètres de configuration pour l'attachement des nœuds.

Remarque

Ce paramètre est requis si le cluster est un cluster edge managé.

{"enableIptables": true,"manageRuntime": true,"quiet": true,"allowedClusterAddons": ["kube-proxy","flannel","coredns"]}

expired

integer

Non

L'horodatage Unix qui indique la date d'expiration du jeton généré. Par exemple, l'horodatage 1739980800 correspond au 20 février 2025 à 00:00:00 (UTC).

1740037333

one_time_token

boolean

Non

Éléments de réponse

Élément

Type

Description

Exemple

string

Le script d'attachement des nœuds.

"wget http://***.oss-cn-hangzhou.aliyuncs.com/***"

Exemples

JSON format

"\"wget http://***.oss-cn-hangzhou.aliyuncs.com/***\""

Codes d'erreur

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

Notes de version

Consultez Notes de version pour la liste complète.