- NAME
-
- gcloud alpha storage objects describe - describe a Cloud Storage object
- SYNOPSIS
-
-
gcloud alpha storage objects describe
URL
[--additional-headers
=HEADER
=VALUE
] [--fetch-encrypted-object-hashes
] [--raw
] [--soft-deleted
] [--decryption-keys
=[DECRYPTION_KEY
,…]] [GCLOUD_WIDE_FLAG …
]
-
- DESCRIPTION
-
(ALPHA)
Describe a Cloud Storage object. - EXAMPLES
-
Describe a Google Cloud Storage object with the url "gs://bucket/my-object":
gcloud alpha storage objects describe gs://bucket/my-object
Describe object with JSON formatting, only returning the "name" key:
gcloud alpha storage objects describe gs://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 list
of key=value pairs, e.g.
header1=value1,header2=value2
. Overrides the defaultstorage/additional_headers
property value for this command invocation. --fetch-encrypted-object-hashes
- 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.
--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 and noncurrent ones.
- ENCRYPTION FLAGS
-
--decryption-keys
=[DECRYPTION_KEY
,…]- 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.
- 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 help
for details. - NOTES
-
This command is currently in alpha and might change without notice. If this
command fails with API permission errors despite specifying the correct project,
you might be trying to access an API with an invitation-only early access
allowlist. This variant is also available:
gcloud storage objects describe
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2024-09-24 UTC.