.TH "GCLOUD_BETA_COMPUTE_INSTANT\-SNAPSHOTS_CREATE" 1



.SH "NAME"
.HP
gcloud beta compute instant\-snapshots create \- create a Compute Engine instant snapshot



.SH "SYNOPSIS"
.HP
\f5gcloud beta compute instant\-snapshots create\fR \fIINSTANT_SNAPSHOT_NAME\fR \fB\-\-source\-disk\fR=\fISOURCE_DISK\fR [\fB\-\-labels\fR=[\fIKEY\fR=\fIVALUE\fR,...]] [\fB\-\-region\fR=\fIREGION\fR\ |\ \fB\-\-zone\fR=\fIZONE\fR] [\fIGCLOUD_WIDE_FLAG\ ...\fR]



.SH "DESCRIPTION"

\fB(BETA)\fR \fBgcloud beta compute instant\-snapshots create\fR creates an
instant snapshot of a disk. Instant snapshots are useful for backing up the disk
data.



.SH "EXAMPLES"

To create an instant snapshot 'my\-instant\-snap' from a disk 'my\-disk' in zone
\'us\-east1\-a', run:

.RS 2m
$ gcloud beta compute instant\-snapshots create my\-instant\-snap \e
  \-\-source\-disk=my\-disk \-\-zone=us\-east1\-a
.RE



.SH "POSITIONAL ARGUMENTS"

.RS 2m
.TP 2m
\fIINSTANT_SNAPSHOT_NAME\fR

Name of the instant snapshot to create.


.RE
.sp

.SH "REQUIRED FLAGS"

.RS 2m
.TP 2m

Source disk options

This must be specified.


.RS 2m
.TP 2m
\fB\-\-source\-disk\fR=\fISOURCE_DISK\fR

Source disk used to create the instant snapshot.


.RE
.RE
.sp

.SH "OPTIONAL FLAGS"

.RS 2m
.TP 2m
\fB\-\-labels\fR=[\fIKEY\fR=\fIVALUE\fR,...]

List of label KEY=VALUE pairs to add.

Keys must start with a lowercase character and contain only hyphens (\f5\-\fR),
underscores (\f5_\fR), lowercase characters, and numbers. Values must contain
only hyphens (\f5\-\fR), underscores (\f5_\fR), lowercase characters, and
numbers.

.TP 2m

At most one of these can be specified:


.RS 2m
.TP 2m
\fB\-\-region\fR=\fIREGION\fR

Region of the instant snapshot to create. If not specified, you might be
prompted to select a region (interactive mode only).

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

.RS 2m
$ gcloud config set compute/region REGION
.RE

A list of regions can be fetched by running:

.RS 2m
$ gcloud compute regions list
.RE

To unset the property, run:

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

Alternatively, the region can be stored in the environment variable
\f5\fICLOUDSDK_COMPUTE_REGION\fR\fR.

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

Zone of the instant snapshot to create. If not specified and the
\f5\fIcompute/zone\fR\fR property isn't set, you might be prompted to select a
zone (interactive mode only).

To avoid prompting when this flag is omitted, you 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.


.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"

This command is currently in beta and might change without notice. These
variants are also available:

.RS 2m
$ gcloud compute instant\-snapshots create
.RE

.RS 2m
$ gcloud alpha compute instant\-snapshots create
.RE