.TH "GCLOUD_ALPHA_STORAGE_DU" 1



.SH "NAME"
.HP
gcloud alpha storage du \- displays the amount of space in bytes used by storage resources



.SH "SYNOPSIS"
.HP
\f5gcloud alpha storage du\fR [\fIURL\fR\ ...] [\fB\-\-additional\-headers\fR=\fIHEADER\fR=\fIVALUE\fR] [\fB\-\-all\-versions\fR,\ \fB\-a\fR] [\fB\-\-exclude\-name\-pattern\fR=\fIEXCLUDE_NAME_PATTERN\fR,\ \fB\-e\fR\ \fIEXCLUDE_NAME_PATTERN\fR] [\fB\-\-exclude\-name\-pattern\-file\fR=\fIEXCLUDE_NAME_PATTERN_FILE\fR,\ \fB\-X\fR\ \fIEXCLUDE_NAME_PATTERN_FILE\fR] [\fB\-\-metadata\-filter\fR=\fIMETADATA_FILTER\fR] [\fB\-\-readable\-sizes\fR,\ \fB\-r\fR] [\fB\-\-summarize\fR,\ \fB\-s\fR] [\fB\-\-total\fR,\ \fB\-c\fR] [\fB\-\-zero\-terminator\fR,\ \fB\-0\fR] [\fIGCLOUD_WIDE_FLAG\ ...\fR]



.SH "DESCRIPTION"

\fB(ALPHA)\fR 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)



.SH "EXAMPLES"

To list the size of each object in a bucket:

.RS 2m
$ gcloud alpha storage du gs://bucketname
.RE

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

.RS 2m
$ gcloud alpha storage du gs://bucketname/prefix/*
.RE

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

.RS 2m
$ gcloud alpha storage du \-c gs://bucketname
.RE

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

.RS 2m
$ gcloud alpha storage du \-s gs://bucket1 gs://bucket2
.RE

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

.RS 2m
$ gcloud alpha storage du \-a gs://bucketname
.RE

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:

.RS 2m
$ gcloud alpha storage du \-e "*.bak" \-0 gs://bucketname
.RE

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

.RS 2m
$ gcloud alpha storage du \-\-summarize \-\-readable\-sizes \-\-total
.RE

The following command summarizes the size of objects that match the specified
filter.

.RS 2m
$ gcloud alpha storage du gs://my\-bucket \e
    \-\-metadata\-filter='contexts."foo"="bar"' \-\-summarize
.RE



.SH "POSITIONAL ARGUMENTS"

.RS 2m
.TP 2m
[\fIURL\fR ...]

The url of objects to list.


.RE
.sp

.SH "FLAGS"

.RS 2m
.TP 2m
\fB\-\-additional\-headers\fR=\fIHEADER\fR=\fIVALUE\fR

Includes arbitrary headers in storage API calls. Accepts a comma separated list
of key=value pairs, e.g. \f5header1=value1,header2=value2\fR. Overrides the
default \fBstorage/additional_headers\fR property value for this command
invocation.

.TP 2m
\fB\-\-all\-versions\fR, \fB\-a\fR

Includes noncurrent object versions for a bucket with Object Versioning enabled.
Also prints the generation and metageneration number for each listed object.

.TP 2m
\fB\-\-exclude\-name\-pattern\fR=\fIEXCLUDE_NAME_PATTERN\fR, \fB\-e\fR \fIEXCLUDE_NAME_PATTERN\fR

Exclude a pattern from the report. Example: \f5\-e "*.o"\fR excludes any object
that ends in ".o". Can be specified multiple times.

.TP 2m
\fB\-\-exclude\-name\-pattern\-file\fR=\fIEXCLUDE_NAME_PATTERN_FILE\fR, \fB\-X\fR \fIEXCLUDE_NAME_PATTERN_FILE\fR

Similar to \-e, but excludes patterns from the given file. The patterns to
exclude should be listed one per line.

.TP 2m
\fB\-\-metadata\-filter\fR=\fIMETADATA_FILTER\fR

Server side filtering for objects. Works only for Google Cloud Storage URLs. The
filter only works for objects, and not directories or buckets, which means
commands like \f5storage ls\fR and \f5storage du\fR will still list directories
or buckets even if they do not contain any objects matching the filter. See
https://cloud.google.com/storage/docs/listing\-objects#filter\-by\-object\-contexts\-syntax
for more details.

.TP 2m
\fB\-\-readable\-sizes\fR, \fB\-r\fR

Prints object sizes in human\-readable format. For example, 1 KiB, 234 MiB, or
2GiB.

.TP 2m
\fB\-\-summarize\fR, \fB\-s\fR

Displays only the summary for each argument.

.TP 2m
\fB\-\-total\fR, \fB\-c\fR

Includes a total size of all input sources.

.TP 2m
\fB\-\-zero\-terminator\fR, \fB\-0\fR

Ends each output line with a 0 byte rather than a newline. You can use this to
make the output machine\-readable.


.RE
.sp

.SH "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 \fB$ gcloud help\fR for details.



.SH "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:

.RS 2m
$ gcloud storage du
.RE