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] [--metadata-filter=METADATA_FILTER]
        [--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 -c 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

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

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

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.

     --metadata-filter=METADATA_FILTER
        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 storage ls and storage du 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.

     --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

