Console
    Start free

    gcloud alpha storage du

    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
    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
    Create a Mobile Website
    View Site in Mobile | Classic
    Share by: