1
0
Fork 0
mirror of https://github.com/imjasonh/gcloud-help synced 2026-07-08 18:45:13 +00:00
gcloud-help/gcloud/alpha/storage/objects/compose
2022-08-24 09:45:53 +00:00

56 lines
2 KiB
Text

NAME
gcloud alpha storage objects compose - concatenate a sequence of objects
into a new composite object
SYNOPSIS
gcloud alpha storage objects compose SOURCE [SOURCE ...] DESTINATION
[--if-generation-match=GENERATION
--if-metageneration-match=METAGENERATION] [GCLOUD_WIDE_FLAG ...]
DESCRIPTION
(ALPHA) gcloud alpha 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 alpha 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 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.