mirror of
https://github.com/imjasonh/gcloud-help
synced 2026-07-08 10:35:03 +00:00
108 lines
4.1 KiB
Text
108 lines
4.1 KiB
Text
NAME
|
|
gcloud alpha storage du - displays the amount of space in bytes used by
|
|
storage resources
|
|
|
|
SYNOPSIS
|
|
gcloud alpha storage du [URL ...] [--additional-headers=HEADER=VALUE]
|
|
[--all-versions, -a]
|
|
[--exclude-name-pattern=EXCLUDE_NAME_PATTERN, -e EXCLUDE_NAME_PATTERN]
|
|
[--exclude-name-pattern-file=EXCLUDE_NAME_PATTERN_FILE,
|
|
-X EXCLUDE_NAME_PATTERN_FILE] [--readable-sizes, -r]
|
|
[--summarize, -s] [--total, -c] [--zero-terminator, -0]
|
|
[GCLOUD_WIDE_FLAG ...]
|
|
|
|
DESCRIPTION
|
|
(ALPHA) Displays the amount of space in bytes used by the objects in a
|
|
bucket, subdirectory, or project. This command calculates the current space
|
|
usage by making a series of object listing requests, which can take a long
|
|
time for large buckets. If your bucket contains hundreds of thousands of
|
|
objects, or if you want to monitor your bucket size over time, use
|
|
Monitoring instead, as described in Get bucket size
|
|
(https://cloud.google.com/storage/docs/getting-bucket-size)
|
|
|
|
EXAMPLES
|
|
To list the size of each object in a bucket:
|
|
|
|
$ gcloud alpha storage du gs://bucketname
|
|
|
|
To list the size of each object in the prefix subdirectory:
|
|
|
|
$ gcloud alpha storage du gs://bucketname/prefix/*
|
|
|
|
To print the total number of bytes in a bucket in human-readable form:
|
|
|
|
$ gcloud alpha storage du -ch gs://bucketname
|
|
|
|
To see a summary of the total number of bytes in two given buckets:
|
|
|
|
$ gcloud alpha storage du -s gs://bucket1 gs://bucket2
|
|
|
|
To list the size of each object in a bucket with Object Versioning enabled,
|
|
including noncurrent objects:
|
|
|
|
$ gcloud alpha storage du -a gs://bucketname
|
|
|
|
To list the size of each object in a bucket, except objects that end in
|
|
".bak", with each object printed ending in a null byte:
|
|
|
|
$ gcloud alpha storage du -e "*.bak" -0 gs://bucketname
|
|
|
|
To list the size of each bucket in a project and the total size of the
|
|
project:
|
|
|
|
$ gcloud alpha storage du --summarize --readable-sizes --total
|
|
|
|
POSITIONAL ARGUMENTS
|
|
[URL ...]
|
|
The url of objects to list.
|
|
|
|
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 default storage/additional_headers property value for
|
|
this command invocation.
|
|
|
|
--all-versions, -a
|
|
Includes noncurrent object versions for a bucket with Object Versioning
|
|
enabled. Also prints the generation and metageneration number for each
|
|
listed object.
|
|
|
|
--exclude-name-pattern=EXCLUDE_NAME_PATTERN, -e EXCLUDE_NAME_PATTERN
|
|
Exclude a pattern from the report. Example: -e "*.o" excludes any
|
|
object that ends in ".o". Can be specified multiple times.
|
|
|
|
--exclude-name-pattern-file=EXCLUDE_NAME_PATTERN_FILE, -X EXCLUDE_NAME_PATTERN_FILE
|
|
Similar to -e, but excludes patterns from the given file. The patterns
|
|
to exclude should be listed one per line.
|
|
|
|
--readable-sizes, -r
|
|
Prints object sizes in human-readable format. For example, 1 KiB, 234
|
|
MiB, or 2GiB.
|
|
|
|
--summarize, -s
|
|
Displays only the summary for each argument.
|
|
|
|
--total, -c
|
|
Includes a total size of all input sources.
|
|
|
|
--zero-terminator, -0
|
|
Ends each output line with a 0 byte rather than a newline. You can use
|
|
this to make the output machine-readable.
|
|
|
|
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 du
|
|
|