completeUpload method

The request completes multipart upload.

When receiving the Object Storage request:

• Combines the parts obtained during the upload in the order of their numbering to form a target object.
• Deletes the upload ID, which means that any subsequent requests with that ID will return the NoSuchUpload error.

When completing the upload, the client must provide the list of the parts it sent. Each part's description must contain the ETag which the client receives in response to each uploaded part. See uploadPart method.

The operation may take several minutes, depending on the object size and the number of parts.

If the request failed, the client app must be ready to repeat the request.

RequestRequest

POST /{bucket}/{key}?uploadId=UploadId HTTP/2

Path parametersPath parameters

Query parametersQuery parameters

HeadersHeaders

Use the necessary common request headers in requests.

Data schemaData schema

The list of parts of a multipart upload is passed as an XML file in the following format:

<CompleteMultipartUpload>
  <Part>
    <PartNumber>PartNumber</PartNumber>
    <ETag>ETag</ETag>
  </Part>
  ...
</CompleteMultipartUpload>

ResponseResponse

HeadersHeaders

Responses can only contain common response headers.

Response codesResponse codes

For a list of possible responses, see Responses.

Additionally, Object Storage may return errors described in the table below.

A successful response contains additional data in XML format with the schema described below.

Data schemaData schema

<CompleteMultipartUploadResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
  <Location>http://Example-Bucket.storage.yandexcloud.net/Example-Object</Location>
  <Bucket>Example-Bucket</Bucket>
  <Key>Example-Object</Key>
  <ETag>"3858f62230ac3c915f300c664312c11f-9"</ETag>
</CompleteMultipartUploadResult>