v1

latestOpenAPI 3.0.0Creative Commons Attribution 3.02026-07-138134216.7 KB
objects

Concatenates a list of existing objects into a new object in the same bucket.

post/b/{destinationBucket}/o/{destinationObject}/compose

Path parameters

destinationBucketstring required

Name of the bucket containing the source objects. The destination object is stored in this bucket.

destinationObjectstring required

Name of the new object. For information about how to URL encode object names to be path safe, see Encoding URI Path Parts.

Query parameters

destinationPredefinedAcl'authenticatedRead' | 'bucketOwnerFullControl' | 'bucketOwnerRead' | 'private' | 'projectPrivate' | 'publicRead'

Apply a predefined set of access controls to the destination object.

dropContextGroupsstring[]

Specifies which groups of Object Contexts from the source object(s) should be dropped from the destination object.

ifGenerationMatchstring

Makes the operation conditional on whether the object's current generation matches the given value. Setting to 0 makes the operation succeed only if there are no live versions of the object.

ifMetagenerationMatchstring

Makes the operation conditional on whether the object's current metageneration matches the given value.

kmsKeyNamestring

Resource name of the Cloud KMS key, of the form projects/my-project/locations/global/keyRings/my-kr/cryptoKeys/my-key, that will be used to encrypt the object. Overrides the object metadata's kms_key_name value, if any.

userProjectstring

The project to be billed for this request. Required for Requester Pays buckets.

Request body

kindstring

The kind of item this is.

deleteSourceObjectsboolean

If true, the source objects will be deleted.

Response

Successful response