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

Ajoute des instances Elastic Compute Service (ECS) existantes à un cluster Container Service for Kubernetes (ACK). Lorsque vous devez ajouter une instance ECS en tant que nœud de travail à un cluster ACK ou réajouter un nœud de travail au cluster, vous pouvez appeler cette opération.

Description de l'opération

Avant d'appeler cette API, veuillez lire attentivement les Limites d'utilisation pour vous assurer que les instances ECS à ajouter remplissent les conditions requises.

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

update

*Cluster

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

Aucune

Syntaxe de la requête

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

Paramètres de chemin

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

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
body	object	Non	Les paramètres du corps de la requête.
instances	array	Oui	Les instances ECS que vous souhaitez ajouter.
	string	Non	L'identifiant de l'instance ECS.	i-2zed0sswuau6o89b****
key_pair	string	Non	Le nom de la paire de clés utilisée pour se connecter aux instances ECS. Vous devez spécifier ce paramètre ou login_password. Remarque Ce paramètre n'est pas pris en charge si vous spécifiez nodepool_id.	security-key
password	string	Non	Le mot de passe de connexion SSH utilisé pour se connecter aux instances ECS. Vous devez spécifier ce paramètre ou 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. Le mot de passe ne peut pas contenir de barres obliques inverses () ni de guillemets doubles ("). Le mot de passe est chiffré lors du transfert des données afin de garantir la sécurité.	Hello1234
format_disk	boolean	Non	Indique si les données et les images des conteneurs doivent être stockées sur des disques de données. Valeurs valides : true : stocke les données et les images des conteneurs sur des disques de données. false : ne stocke pas les données ou les images des conteneurs sur des disques de données. Valeur par défaut : false. Mode de rattachement des disques de données : Si l'instance ECS possède déjà des disques de données rattachés et que le système de fichiers du dernier disque de données n'est pas initialisé, le système formate automatiquement ce disque de données en ext4. Ensuite, le système utilise le disque pour stocker les données dans les répertoires /var/lib/docker et /var/lib/kubelet. Si aucun disque de données n'est rattaché à l'instance ECS, le système n'achète pas de nouveau disque de données. Remarque Si vous choisissez de stocker les données et les images des conteneurs sur des disques de données et qu'un disque de données est déjà rattaché à l'instance ECS, les données d'origine sur ce disque de données sont effacées. Vous pouvez sauvegarder le disque pour éviter toute perte de données.	false
keep_instance_name	boolean	Non	Indique si le nom de l'instance doit être conservé. Valeurs valides : true : conserve le nom de l'instance. false : ne conserve pas le nom de l'instance. Valeur par défaut : false.	false
is_edge_worker	boolean	Non	Indique si le nœud que vous souhaitez ajouter est un nœud Edge Node Service (ENS). Valeurs valides : true : le nœud que vous souhaitez ajouter est un nœud ENS. false : le nœud que vous souhaitez ajouter n'est pas un nœud ENS. Valeur par défaut : false. Remarque Si le nœud que vous souhaitez ajouter est un nœud ENS, vous devez définir la valeur sur true. Cela vous permet d'identifier le nœud.	false
nodepool_id	string	Non	L'identifiant du pool de nœuds auquel le nœud est ajouté. Si vous ne spécifiez pas ce paramètre, le nœud est ajouté au pool de nœuds par défaut.	np615c0e0966124216a0412e10afe0****
image_id	string	Non	L'identifiant de l'image personnalisée. Si vous ne spécifiez pas ce paramètre, l'image système par défaut est utilisée. Remarque Si vous spécifiez une image personnalisée, l'image personnalisée est utilisée pour déployer le système d'exploitation sur le disque système du nœud. Ce paramètre n'est pas pris en charge si vous spécifiez nodepool_id.	aliyun_2_1903_x64_20G_alibase_20200529.vhd
cpu_policy	string	Non	La stratégie de gestion du processeur du nœud. Les stratégies suivantes sont prises en charge si la version Kubernetes du cluster est 1.12.6 ou ultérieure : static : permet d'accorder aux pods présentant des caractéristiques de ressources spécifiques sur le nœud une affinité et une exclusivité de processeur améliorées. none : utilise l'affinité de processeur par défaut. Valeur par défaut : none Remarque Ce paramètre n'est pas pris en charge si vous spécifiez nodepool_id.	none
user_data	string	Non	Les données définies par l'utilisateur sur le nœud. Pour plus d'informations, consultez Utiliser les données utilisateur de l'instance pour exécuter automatiquement des commandes ou des scripts au démarrage de l'instance. Remarque Ce paramètre n'est pas pris en charge si vous spécifiez nodepool_id.	IyEvdXNyL2Jpbi9iYXNoCmVjaG8gIkhlbGxvIEFDSyEi
rds_instances	array	Non	Une liste d'instances ApsaraDB RDS.
	string	Non	L'identifiant de l'instance ApsaraDB RDS. Remarque Ce paramètre n'est pas pris en charge si vous spécifiez nodepool_id.	rm-67yawhau****
runtime	runtime	Non	L'environnement d'exécution de conteneur. Remarque Ce paramètre n'est pas pris en charge si vous spécifiez nodepool_id.
tags	array	Non	Les balises que vous souhaitez ajouter au nœud. Lorsque vous ajoutez des balises à un nœud, les règles suivantes s'appliquent : Une balise est une paire clé-valeur sensible à la casse. Vous pouvez ajouter jusqu'à 20 balises. La clé doit être unique et ne peut pas dépasser 64 caractères. La valeur peut être vide et ne peut pas dépasser 128 caractères. Les clés et les valeurs ne peuvent pas commencer par aliyun, acs:, https:// ou http://. Pour plus d'informations, consultez Balises et sélecteurs. Remarque Ce paramètre n'est pas pris en charge si vous spécifiez nodepool_id.
	tag	Non	Les balises que vous souhaitez ajouter au nœud.

Éléments de réponse

Élément	Type	Description	Exemple
	object	Le corps de la réponse.
list	array<object>	Les détails des nœuds ajoutés.
	object
code	string	Le code qui indique le résultat de la tâche.	200
instanceId	string	L'identifiant de l'instance ECS.	i-2ze0lgm3y6iylcbt****
message	string	Indique si l'instance ECS a été ajoutée avec succès au cluster ACK.	successful
task_id	string	L'identifiant de la tâche.	T-5a544aff80282e39ea00****

Exemples

JSON format

{
  "list": [
    {
      "code": "200",
      "instanceId": "i-2ze0lgm3y6iylcbt****",
      "message": "successful"
    }
  ],
  "task_id": "T-5a544aff80282e39ea00****"
}

Codes d'erreur

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

Notes de version

Consultez Notes de version pour la liste complète.