.TH "GCLOUD_BETA_KMS_KEYS_VERSIONS_DESCRIBE" 1



.SH "NAME"
.HP
gcloud beta kms keys versions describe \- get metadata for a given version



.SH "SYNOPSIS"
.HP
\f5gcloud beta kms keys versions describe\fR \fIVERSION\fR [\fB\-\-attestation\-file\fR=\fIATTESTATION_FILE\fR] [\fB\-\-key\fR=\fIKEY\fR] [\fB\-\-keyring\fR=\fIKEYRING\fR] [\fB\-\-location\fR=\fILOCATION\fR] [\fIGCLOUD_WIDE_FLAG\ ...\fR]



.SH "DESCRIPTION"

\fB(BETA)\fR Returns metadata for the given version.

The optional flag \f5attestation\-file\fR specifies file to write the
attestation object into. The attestation object enables the user to verify the
integrity and provenance of the key. See
https://cloud.google.com/kms/docs/attest\-key for more information about
attestations.



.SH "EXAMPLES"

The following command returns metadata for version 2 within key \f5frodo\fR
within the keyring \f5fellowship\fR in the location \f5us\-east1\fR:

.RS 2m
$ gcloud beta kms keys versions describe 2 \-\-key=frodo \e
    \-\-keyring=fellowship \-\-location=us\-east1
.RE

For key versions with protection level \f5HSM\fR, use the
\f5\-\-attestation\-file\fR flag to save the attestation to a local file.

.RS 2m
$ gcloud beta kms keys versions describe 2 \-\-key=frodo \e
    \-\-keyring=fellowship \-\-location=us\-east1 \e
    \-\-attestation\-file=path/to/attestation.dat
.RE



.SH "POSITIONAL ARGUMENTS"

.RS 2m
.TP 2m
\fIVERSION\fR

Name of the version to describe.


.RE
.sp

.SH "FLAGS"

.RS 2m
.TP 2m
\fB\-\-attestation\-file\fR=\fIATTESTATION_FILE\fR

Path to the output attestation file.

.TP 2m
\fB\-\-key\fR=\fIKEY\fR

The containing key.

.TP 2m
\fB\-\-keyring\fR=\fIKEYRING\fR

Key ring of the key.

.TP 2m
\fB\-\-location\fR=\fILOCATION\fR

Location of the keyring.


.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 kms keys versions describe
.RE

.RS 2m
$ gcloud alpha kms keys versions describe
.RE