gcloud container node-pools delete NAME [--async] [--cluster=CLUSTER] [--location=LOCATION | --region=REGION | --zone=ZONE, -z ZONE] [GCLOUD_WIDE_FLAG …]
gcloud container node-pools delete deletes 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 of MAX_POD.
MAX_POD is the maximum terminationGracePeriodSeconds
set on the Pods scheduled to the node with a cap of one hour.
gcloud container node-pools delete node-pool-1 --cluster=sample-clusterNAME--async--cluster=CLUSTERcontainer/cluster property value for this command invocation.
--location=LOCATION--region=REGION--zone=ZONE, -z ZONE--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.
gcloud alpha container node-pools deletegcloud beta 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.