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

Description de l'opération

Important.

Les ressources par abonnement, telles que les instances ECS et les nœuds de calcul Lingjun, ne sont pas automatiquement libérées. Vous devez les libérer manuellement pour éviter des frais inutiles. Pour plus de détails, consultez Règles de suppression de cluster et de libération de nœuds.
Les ressources SLB APIServer par abonnement ne sont pas automatiquement libérées. Vous devez les libérer manuellement pour éviter des frais inutiles.
Si des ressources telles que les VPC, les VSwitch, les groupes de sécurité et les rôles RAM sont utilisées par d'autres ressources, elles sont conservées par défaut. Vous devez les libérer manuellement.
Les ECI créés avec des nœuds virtuels sont automatiquement libérés.
Certaines ressources cloud créées avec le cluster ne sont pas automatiquement libérées lorsque vous supprimez le cluster et continuent de générer des frais. Vous pouvez choisir de les conserver ou de les libérer. Ces ressources incluent les projets SLS créés automatiquement par le cluster et les disques cloud achetés via des volumes dynamiques.

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

delete

*Cluster

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

Aucune

Syntaxe de la requête

DELETE /clusters/{ClusterId} HTTP/1.1

Paramètres de chemin

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

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
retain_all_resources	boolean	Non	Indique si toutes les ressources associées doivent être conservées. Si vous définissez ce paramètre sur `true`, le paramètre `retain_resources` est ignoré, et toutes les ressources cloud créées avec le cluster et pouvant être interrogées en appelant `DescribeClusterResources` sont conservées. Si vous définissez ce paramètre sur `false`, notez que les ressources configurées pour être conservées par défaut dans le paramètre `delete_options` sont tout de même conservées. Pour supprimer ces ressources, vous devez explicitement définir le paramètre `delete_mode` sur `delete` pour celles-ci dans `delete_options`. `true` : conserve toutes les ressources cloud associées créées avec le cluster. `false` : ne conserve pas toutes les ressources cloud associées. Les ressources configurées pour être conservées par défaut dans le paramètre `delete_options`, telles que `ALB`, sont tout de même conservées lorsque ce paramètre est défini sur `false`. Valeur par défaut : `false`.	false
keep_slb `deprecated`	boolean	Non	Indique si les ressources SLB doivent être conservées. Valeurs valides : `true` : conserve les ressources SLB créées pour le cluster. `false` : ne conserve pas les ressources SLB créées pour le cluster. Valeur par défaut : `false`. Utilisez plutôt le paramètre `delete_options` pour gérer les ressources `SLB`.	false
retain_resources	array	Non	Les identifiants des ressources à conserver lors de la suppression du cluster.
	string	Non	L'identifiant de la ressource.	sg-2ze6ess9kho6fdn9****
delete_options	array<object>	Non	Les options de suppression des ressources associées au cluster.
	object	Non	Les options de suppression pour un type de ressource spécifique.
resource_type	string	Non	Le type de ressource. Valeurs valides : SLB : les ressources SLB créées pour les Services. Ces ressources sont supprimées par défaut, mais vous pouvez choisir de les conserver. ALB : les ressources ALB créées par le contrôleur Ingress ALB. Ces ressources sont conservées par défaut, mais vous pouvez choisir de les supprimer. SLS_Data : le projet SLS utilisé pour les journaux du cluster. Cette ressource est conservée par défaut, mais vous pouvez choisir de la supprimer. SLS_ControlPlane : le projet SLS utilisé pour les journaux du plan de contrôle dans un cluster géré. Cette ressource est conservée par défaut, mais vous pouvez choisir de la supprimer. PrivateZone : la ressource PrivateZone créée par un cluster ACK Serverless. Cette ressource est conservée par défaut, mais vous pouvez choisir de la supprimer.	SLS_Data
delete_mode	string	Non	La stratégie de suppression pour le type de ressource spécifié. Valeurs valides :\n\n- delete : supprime les ressources.\n\n- retain : conserve les ressources.	delete

Éléments de réponse

Élément	Type	Description	Exemple
	object
cluster_id	string	L'identifiant du cluster.	cb95aa626a47740afbf6aa099b650****
request_id	string	L'identifiant de la requête.	687C5BAA-D103-4993-884B-C35E4314****
task_id	string	L'identifiant de la tâche.	T-5a54309c80282e39ea****

Exemples

JSON format

{
  "cluster_id": "cb95aa626a47740afbf6aa099b650****",
  "request_id": "687C5BAA-D103-4993-884B-C35E4314****",
  "task_id": "T-5a54309c80282e39ea****"
}

Codes d'erreur

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

Notes de version

Consultez Notes de version pour la liste complète.