gcloud: Wed Sep 14 09:28:28 UTC 2022

gcloud/storage/objects/compose

@@ -0,0 +1,55 @@
+NAME
+    gcloud storage objects compose - concatenate a sequence of objects into a
+        new composite object
+
+SYNOPSIS
+    gcloud storage objects compose SOURCE [SOURCE ...] DESTINATION
+        [--if-generation-match=GENERATION
+          --if-metageneration-match=METAGENERATION] [GCLOUD_WIDE_FLAG ...]
+
+DESCRIPTION
+    gcloud storage objects compose creates a new object whose content is the
+    concatenation of a given sequence of source objects in the same bucket. For
+    more information, please see: composite objects documentation
+    (https://cloud.google.com/storage/docs/composite-objects).
+
+    There is a limit (currently 32) to the number of components that can be
+    composed in a single operation.
+
+EXAMPLES
+    The following command creates a new object target.txt by concatenating
+    a.txt and b.txt:
+
+        $ gcloud storage objects compose gs://bucket/a.txt \
+            gs://bucket/b.txt gs://bucket/target.txt
+
+POSITIONAL ARGUMENTS
+     SOURCE [SOURCE ...]
+        The list of source objects that will be concatenated into a single
+        object.
+
+     DESTINATION
+        The destination object.
+
+PRECONDITION FLAGS
+     --if-generation-match=GENERATION
+        Execute only if the generation matches the generation of the requested
+        object.
+
+     --if-metageneration-match=METAGENERATION
+        Execute only if the metageneration matches the metageneration of the
+        requested object.
+
+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 objects compose
+