.TH "GCLOUD_STORAGE_OBJECTS_DESCRIBE" 1



.SH "NAME"
.HP
gcloud storage objects describe \- describe a Cloud Storage object



.SH "SYNOPSIS"
.HP
\f5gcloud storage objects describe\fR \fIURL\fR [\fB\-\-additional\-headers\fR=\fIHEADER\fR=\fIVALUE\fR] [\fB\-\-fetch\-encrypted\-object\-hashes\fR] [\fB\-\-raw\fR] [\fB\-\-soft\-deleted\fR] [\fB\-\-decryption\-keys\fR=[\fIDECRYPTION_KEY\fR,...]] [\fIGCLOUD_WIDE_FLAG\ ...\fR]



.SH "DESCRIPTION"

Describe a Cloud Storage object.



.SH "EXAMPLES"

Describe a Google Cloud Storage object with the url "gs://bucket/my\-object":

.RS 2m
$ gcloud storage objects describe gs://bucket/my\-object
.RE

Describe object with JSON formatting, only returning the "name" key:

.RS 2m
$ gcloud storage objects describe gs://bucket/my\-object \e
    \-\-format="json(name)"
.RE



.SH "POSITIONAL ARGUMENTS"

.RS 2m
.TP 2m
\fIURL\fR

Specifies URL of object to describe.


.RE
.sp

.SH "FLAGS"

.RS 2m
.TP 2m
\fB\-\-additional\-headers\fR=\fIHEADER\fR=\fIVALUE\fR

Includes arbitrary headers in storage API calls. Accepts a comma separated list
of key=value pairs, e.g. \f5header1=value1,header2=value2\fR. Overrides the
default \fBstorage/additional_headers\fR property value for this command
invocation.

.TP 2m
\fB\-\-fetch\-encrypted\-object\-hashes\fR

If the initial GET request returns an object encrypted with a customer\-supplied
encryption key, the hash fields will be null. If the matching decryption key is
present on the system, this flag retries the GET request with the key.

.TP 2m
\fB\-\-raw\fR

Shows metadata in the format returned by the API instead of standardizing it.

.TP 2m
\fB\-\-soft\-deleted\fR

Displays soft\-deleted resources only. For objects, it will exclude live and
noncurrent ones.


.RE
.sp

.SH "ENCRYPTION FLAGS"

.RS 2m
.TP 2m
\fB\-\-decryption\-keys\fR=[\fIDECRYPTION_KEY\fR,...]

A comma\-separated list of customer\-supplied encryption keys (RFC 4648 section
4 base64\-encoded AES256 strings) that will be used to decrypt Cloud Storage
objects. Data encrypted with a customer\-managed encryption key (CMEK) is
decrypted automatically, so CMEKs do not need to be listed here.


.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 variant is also available:

.RS 2m
$ gcloud alpha storage objects describe
.RE