gcloud container clusters delete

NAME
gcloud container clusters delete - delete an existing cluster for running containers
SYNOPSIS
gcloud container clusters deleteNAME[NAME …][--async][--location=LOCATION    |--region=REGION    |--zone=ZONE,-zZONE][GCLOUD_WIDE_FLAG …]
DESCRIPTION
When you delete a cluster, the following resources are deleted:
  • The control plane resources
  • All of the node instances in the cluster
  • Any Pods that are running on those instances
  • Any firewalls and routes created by Kubernetes Engine at the time of clustercreation
  • Data stored in host hostPath and emptyDir volumes

GKE will attempt to delete the following resources. Deletion of these resourcesis not always guaranteed:

  • External load balancers created by the cluster
  • Internal load balancers created by the cluster
  • Persistent disk volumes
EXAMPLES
To delete an existing cluster, run:
gcloudcontainerclustersdeletesample-cluster
POSITIONAL ARGUMENTS
NAME [NAME …]
The names of the clusters to delete.
FLAGS
--async
Return immediately, without waiting for the operation in progress to complete.
At most one of these can be specified:
--location=LOCATION
Compute zone or region (e.g. us-central1-a or us-central1) for the cluster.Overrides the default compute/region or compute/zone value for this commandinvocation. Prefer using this flag over the --region or --zone flags.
--region=REGION
Compute region (e.g. us-central1) for a regional cluster. Overrides the defaultcompute/region property value for this command invocation.
--zone=ZONE,-zZONE
Compute zone (e.g. us-central1-a) for a zonal cluster. Overrides the defaultcompute/zone property value for this command invocation.
GCLOUD WIDE FLAGS
These flags are available to all commands:--access-token-file,--account,--billing-project,--configuration,--flags-file,--flatten,--format,--help,--impersonate-service-account,--log-http,--project,--quiet,--trace-token,--user-output-enabled,--verbosity.

Run$gcloud help for details.

NOTES
These variants are also available:
gcloudalphacontainerclustersdelete
gcloudbetacontainerclustersdelete

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2025-05-07 UTC.