- NAME
-
- gcloud storage du - displays the amount of space in bytes used by storage resources
- SYNOPSIS
-
-
gcloud 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
- 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
- EXAMPLES
-
To list the size of each object in a bucket:
gcloud storage du gs://bucketname
To list the size of each object in the prefix subdirectory:
gcloud storage du gs://bucketname/prefix/*
To print the total number of bytes in a bucket in human-readable form:
gcloud storage du -c gs://bucketname
To see a summary of the total number of bytes in two given buckets:
gcloud 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 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 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 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 defaultstorage/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 variant is also available:
gcloud alpha storage du
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-05-29 UTC.