gcloud storage du

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,-eEXCLUDE_NAME_PATTERN][--exclude-name-pattern-file=EXCLUDE_NAME_PATTERN_FILE,-XEXCLUDE_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 bymaking a series of object listing requests, which can take a long time for largebuckets. If your bucket contains hundreds of thousands of objects, or if youwant to monitor your bucket size over time, use Monitoring instead, as describedinGetbucket size
EXAMPLES
To list the size of each object in a bucket:
gcloudstoragedugs://bucketname

To list the size of each object in the prefix subdirectory:

gcloudstoragedugs://bucketname/prefix/*

To print the total number of bytes in a bucket in human-readable form:

gcloudstoragedu-cgs://bucketname

To see a summary of the total number of bytes in two given buckets:

gcloudstoragedu-sgs://bucket1gs://bucket2

To list the size of each object in a bucket with Object Versioning enabled,including noncurrent objects:

gcloudstoragedu-ags://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:

gcloudstoragedu-e"*.bak"-0gs://bucketname

To list the size of each bucket in a project and the total size of the project:

gcloudstoragedu--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 listof key=value pairs, e.g.header1=value1,header2=value2. Overridesthe defaultstorage/additional_headers property value for thiscommand 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,-eEXCLUDE_NAME_PATTERN
Exclude a pattern from the report. Example:-e "*.o" excludes anyobject that ends in ".o". Can be specified multiple times.
--exclude-name-pattern-file=EXCLUDE_NAME_PATTERN_FILE,-XEXCLUDE_NAME_PATTERN_FILE
Similar to -e, but excludes patterns from the given file. The patterns toexclude should be listed one per line.
--readable-sizes,-r
Prints object sizes in human-readable format. For example, 1 KiB, 234 MiB, or2GiB.
--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 tomake 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:
gcloudalphastoragedu

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.