NAME
    gcloud storage du - displays the amount of space in bytes used up 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 up by the objects in a bucket,
    subdirectory, or project.

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 -ch 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 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 variant is also available:

        $ gcloud alpha storage du

