gcloud beta compute instances delete

NAME
gcloud beta compute instances delete - delete Compute Engine virtual machine instances
SYNOPSIS
gcloud beta compute instances deleteINSTANCE_NAMES[INSTANCE_NAMES …][--no-graceful-shutdown][--zone=ZONE][--delete-disks=DISK_TYPE    |--keep-disks=DISK_TYPE][GCLOUD_WIDE_FLAG]
DESCRIPTION
(BETA)gcloud beta compute instances delete deletesone or more Compute Engine virtual machine instances.
EXAMPLES
To delete an instance called 'instance-1' in the zone 'us-central-2-a', run:
gcloudbetacomputeinstancesdeleteinstance-1--zone=us-central2-a
POSITIONAL ARGUMENTS
INSTANCE_NAMES [INSTANCE_NAMES …]
Names of the instances to delete. For details on valid instance names, refer tothe criteria documented under the field 'name' at:https://cloud.google.com/compute/docs/reference/rest/v1/instances
FLAGS
--no-graceful-shutdown
Deletes the instance immediately without gracefully shutting it down. If agraceful shutdown is in progress, then the instance is forcefully stopped anddeleted.
--zone=ZONE
Zone of the instances to delete. If not specified, you might be prompted toselect a zone (interactive mode only).gcloud attempts to identify theappropriate zone by searching for resources in your currently active project. Ifthe zone cannot be determined,gcloud prompts you for a selection withall available Google Cloud Platform zones.

To avoid prompting when this flag is omitted, the user can set thecompute/zone property:

gcloudconfigsetcompute/zoneZONE

A list of zones can be fetched by running:

gcloudcomputezoneslist

To unset the property, run:

gcloudconfigunsetcompute/zone

Alternatively, the zone can be stored in the environment variableCLOUDSDK_COMPUTE_ZONE.

At most one of these can be specified:
--delete-disks=DISK_TYPE
The types of disks to delete with instance deletion regardless of the disks'auto-delete configuration. When this flag is provided, the auto-delete bits onthe attached disks are modified accordingly before the instance deletionrequests are issued. For more information on disk auto-deletion, seeSetthe auto-delete state of a zonal persistent disk.DISK_TYPE must be one of:
all
All disk types.
boot
The first partition is reserved for the root filesystem.
data
A non-boot disk.
--keep-disks=DISK_TYPE
The types of disks to not delete with instance deletion regardless of the disks'auto-delete configuration. When this flag is provided, the auto-delete bits onthe attached disks are modified accordingly before the instance deletionrequests are issued. For more information on disk auto-deletion, seeSetthe auto-delete state of a zonal persistent disk.DISK_TYPE must be one of:
all
All disk types.
boot
The first partition is reserved for the root filesystem.
data
A non-boot disk.
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
This command is currently in beta and might change without notice. Thesevariants are also available:
gcloudcomputeinstancesdelete
gcloudalphacomputeinstancesdelete

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.