File: //snap/google-cloud-cli/394/help/man/man1/gcloud_beta_compute_snapshots_describe.1
.TH "GCLOUD_BETA_COMPUTE_SNAPSHOTS_DESCRIBE" 1
.SH "NAME"
.HP
gcloud beta compute snapshots describe \- describe a Compute Engine snapshot
.SH "SYNOPSIS"
.HP
\f5gcloud beta compute snapshots describe\fR \fISNAPSHOT_NAME\fR [\fB\-\-global\fR\ |\ \fB\-\-region\fR=\fIREGION\fR] [\fIGCLOUD_WIDE_FLAG\ ...\fR]
.SH "DESCRIPTION"
\fB(BETA)\fR \fBgcloud beta compute snapshots describe\fR displays all data
associated with a Compute Engine snapshot in a project.
Given an existing snapshot is queried, successful output of this command looks
like the following:
.RS 2m
creationTimestamp: '2018\-05\-07T10:45:46.988\-07:00'
diskSizeGb: '500'
id: '1234567891234567890'
kind: compute#snapshot
labelFingerprint: 12345abcdWW=
name: zs9utdhb8r1x
selfLink: https://www.googleapis.com/compute/v1/projects/test\-project\-name/global/snapshots/snapshot\-number
sourceDisk: https://www.googleapis.com/compute/v1/projects/test\-project\-name/zones/us\-central1\-c/disks/test
sourceDiskId: '1234567891234567890'
status: READY
storageBytes: '0'
storageBytesStatus: UP_TO_DATE
.RE
.SH "EXAMPLES"
To run \f5gcloud beta compute snapshots describe\fR, you'll need the name of a
snapshot. To list existing snapshots by name, run:
.RS 2m
$ gcloud beta compute snapshots list
.RE
To display specific details of an existing Compute Engine snapshot (like its
creation time, status, and storage details), run:
.RS 2m
$ gcloud beta compute snapshots describe SNAPSHOT_NAME \e
\-\-format="table(creationTimestamp, status, storageBytesStatus)"
.RE
.SH "POSITIONAL ARGUMENTS"
.RS 2m
.TP 2m
\fISNAPSHOT_NAME\fR
Name of the snapshot to describe.
.RE
.sp
.SH "FLAGS"
.RS 2m
.TP 2m
At most one of these can be specified:
.RS 2m
.TP 2m
\fB\-\-global\fR
If set, the snapshot is global.
.TP 2m
\fB\-\-region\fR=\fIREGION\fR
Region of the snapshot to describe. Overrides the default \fBcompute/region\fR
property value for this command invocation.
.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 snapshots describe
.RE
.RS 2m
$ gcloud alpha compute snapshots describe
.RE