gcloud storage objects describe Stay organized with collections Save and categorize content based on your preferences.
- NAME
- gcloud storage objects describe - describe a Cloud Storage object
- SYNOPSIS
gcloud storage objects describeURL[--additional-headers=HEADER=VALUE][--fetch-encrypted-object-hashes][--raw][--soft-deleted][--decryption-keys=[DECRYPTION_KEY,…]][GCLOUD_WIDE_FLAG …]
- DESCRIPTION
- Describe a Cloud Storage object.
- EXAMPLES
- Describe a Google Cloud Storage object with the url "gs://bucket/my-object":
gcloudstorageobjectsdescribegs://bucket/my-objectDescribe object with JSON formatting, only returning the "name" key:
gcloudstorageobjectsdescribegs://bucket/my-object--format="json(name)" - POSITIONAL ARGUMENTS
URL- Specifies URL of object to describe.
- FLAGS
--additional-headers=HEADER=VALUE- Includes arbitrary headers in storage API calls. Accepts a comma separated listof key=value pairs, e.g.
header1=value1,header2=value2. Overridesthe defaultstorage/additional_headersproperty value for thiscommand invocation. --fetch-encrypted-object-hashes- If the initial GET request returns an object encrypted with a customer-suppliedencryption key, the hash fields will be null. If the matching decryption key ispresent on the system, this flag retries the GET request with the key.
--raw- Shows metadata in the format returned by the API instead of standardizing it.
--soft-deleted- Displays soft-deleted resources only. For objects, it will exclude live andnoncurrent ones.
- ENCRYPTION FLAGS
--decryption-keys=[DECRYPTION_KEY,…]- A comma-separated list of customer-supplied encryption keys (RFC 4648 section 4base64-encoded AES256 strings) that will be used to decrypt Cloud Storageobjects. Data encrypted with a customer-managed encryption key (CMEK) isdecrypted automatically, so CMEKs do not need to be listed here.
- 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
$gcloud helpfor details. - NOTES
- This variant is also available:
gcloudalphastorageobjectsdescribe
Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-05-07 UTC.