.TH "GCLOUD_COMPUTE_INSTANCES_DELETE" 1



.SH "NAME"
.HP
gcloud compute instances delete \- delete Compute Engine virtual machine instances



.SH "SYNOPSIS"
.HP
\f5gcloud compute instances delete\fR \fIINSTANCE_NAMES\fR [\fIINSTANCE_NAMES\fR\ ...] [\fB\-\-zone\fR=\fIZONE\fR] [\fB\-\-delete\-disks\fR=\fIDISK_TYPE\fR\ |\ \fB\-\-keep\-disks\fR=\fIDISK_TYPE\fR] [\fIGCLOUD_WIDE_FLAG\ ...\fR]



.SH "DESCRIPTION"

\fBgcloud compute instances delete\fR deletes one or more Compute Engine virtual
machine instances.



.SH "EXAMPLES"

To delete an instance called 'instance\-1' in the zone 'us\-central\-2\-a', run:

.RS 2m
$ gcloud compute instances delete instance\-1 \-\-zone=us\-central2\-a
.RE



.SH "POSITIONAL ARGUMENTS"

.RS 2m
.TP 2m
\fIINSTANCE_NAMES\fR [\fIINSTANCE_NAMES\fR ...]

Names of the instances to delete. For details on valid instance names, refer to
the criteria documented under the field 'name' at:
https://cloud.google.com/compute/docs/reference/rest/v1/instances


.RE
.sp

.SH "FLAGS"

.RS 2m
.TP 2m
\fB\-\-zone\fR=\fIZONE\fR

Zone of the instances to delete. If not specified, you might be prompted to
select a zone (interactive mode only). \f5gcloud\fR attempts to identify the
appropriate zone by searching for resources in your currently active project. If
the zone cannot be determined, \f5gcloud\fR prompts you for a selection with all
available Google Cloud Platform zones.

To avoid prompting when this flag is omitted, the user can set the
\f5\fIcompute/zone\fR\fR property:

.RS 2m
$ gcloud config set compute/zone ZONE
.RE

A list of zones can be fetched by running:

.RS 2m
$ gcloud compute zones list
.RE

To unset the property, run:

.RS 2m
$ gcloud config unset compute/zone
.RE

Alternatively, the zone can be stored in the environment variable
\f5\fICLOUDSDK_COMPUTE_ZONE\fR\fR.

.TP 2m

At most one of these can be specified:


.RS 2m
.TP 2m
\fB\-\-delete\-disks\fR=\fIDISK_TYPE\fR

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 on
the attached disks are modified accordingly before the instance deletion
requests are issued. For more information on disk auto\-deletion, see Set the
auto\-delete state of a zonal persistent disk
(https://cloud.google.com/compute/docs/disks/modify\-persistent\-disk#updateautodelete).
\fIDISK_TYPE\fR must be one of:

.RS 2m
.TP 2m
\fBall\fR
All disk types.
.TP 2m
\fBboot\fR
The first partition is reserved for the root filesystem.
.TP 2m
\fBdata\fR
A non\-boot disk.
.RE
.sp


.TP 2m
\fB\-\-keep\-disks\fR=\fIDISK_TYPE\fR

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 on
the attached disks are modified accordingly before the instance deletion
requests are issued. For more information on disk auto\-deletion, see Set the
auto\-delete state of a zonal persistent disk
(https://cloud.google.com/compute/docs/disks/modify\-persistent\-disk#updateautodelete).
\fIDISK_TYPE\fR must be one of:

.RS 2m
.TP 2m
\fBall\fR
All disk types.
.TP 2m
\fBboot\fR
The first partition is reserved for the root filesystem.
.TP 2m
\fBdata\fR
A non\-boot disk.
.RE
.sp



.RE
.RE
.sp

.SH "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 \fB$ gcloud help\fR for details.



.SH "NOTES"

These variants are also available:

.RS 2m
$ gcloud alpha compute instances delete
.RE

.RS 2m
$ gcloud beta compute instances delete
.RE