- NAME
-
- gcloud container node-pools delete - delete an existing node pool in a running cluster
- SYNOPSIS
-
-
gcloud container node-pools deleteNAME[--async] [--cluster=CLUSTER] [--location=LOCATION|--region=REGION|--zone=ZONE,-zZONE] [GCLOUD_WIDE_FLAG …]
-
- DESCRIPTION
-
gcloud container node-pools deletedeletes a node pool from a Google Kubernetes Engine (GKE) cluster. When you delete a node pool, GKE drains all the nodes in the node pool. The draining process involves GKE deleting Pods on each node in the node pool. Each node in a node pool is drained by deleting Pods with an allotted graceful termination period ofMAX_POD.MAX_PODis the maximumterminationGracePeriodSecondsset on the Pods scheduled to the node with a cap of one hour. - EXAMPLES
- To delete the "node-pool-1" node pool from the cluster "sample-cluster", run:
gcloud container node-pools delete node-pool-1 --cluster = sample-cluster - POSITIONAL ARGUMENTS
-
-
NAME - The name of the node pool to delete.
-
- FLAGS
-
-
--async - Return immediately, without waiting for the operation in progress to complete.
-
--cluster=CLUSTER - The cluster from which to delete the node pool. Overrides the default
container/clusterproperty value for this command invocation. - 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 command invocation. Prefer using this flag over the --region or --zone flags.
-
--region=REGION - Compute region (e.g. us-central1) for a regional cluster. Overrides the default compute/region property value for this command invocation.
-
--zone=ZONE,-zZONE - Compute zone (e.g. us-central1-a) for a zonal cluster. Overrides the default compute/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 helpfor details. - NOTES
- These variants are also available:
gcloud alpha container node-pools deletegcloud beta container node-pools delete
gcloud container node-pools delete
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License , and code samples are licensed under the Apache 2.0 License . For details, see the Google Developers Site Policies . Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2026-05-27 UTC.
