gcloud: Thu Jul 20 11:47:24 UTC 2023

gcloud/storage/du

@@ -0,0 +1,100 @@
+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
+