completeUpload method
This request completes a multipart upload.
After receiving the request Object Storage:
- Assembles the object from parts of the upload in ascending order by part number.
- Deletes the upload ID, which means that any subsequent requests with that ID will return the
NoSuchUploaderror.
When completing the upload, you must provide the list of parts. The description of each part must contain an ETag value that is returned after that part has been uploaded. 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 should be ready to retry the request.
For more information on getting started with the API and the general request format, see How to use the S3 API.
Request
POST /{bucket}/{key}?uploadId=UploadId HTTP/2
Path parameters
| Parameter | Description |
|---|---|
bucket |
Bucket name. |
key |
Object key. |
Request parameters
| Parameter | Description |
|---|---|
uploadId |
ID of the multipart upload returned by Object Storage at startup. |
Headers
Use the appropriate common headers in your request.
| Header | Description |
|---|---|
If-Match |
Defines the condition for performing an operation. The operation will only be performed if the current version of the object matching the specified key exists and its ETag is identical to the value in the If-Match header. |
If-None-Match |
Defines the condition for performing an operation. The operation will only be performed if there is no object with the same key in the bucket. Specify * in the header value. |
Data schema
The list of parts of a multipart upload is provided as an XML file in the following format:
<CompleteMultipartUpload>
<Part>
<PartNumber>PartNumber</PartNumber>
<ETag>ETag</ETag>
</Part>
...
</CompleteMultipartUpload>
| Tag | Description |
|---|---|
CompleteMultipartUpload |
Request data. Path: /CompleteMultipartUpload. |
Part |
Data on the object's uploaded part. Path: /CompleteMultipartUpload/Part. |
PartNumber |
Part number. A unique ID that identifies the part's position among the other parts in the upload. Path: /CompleteMultipartUpload/Part/PartNumber. |
ETag |
ID that Object Storage returns after the part is uploaded. Path: /CompleteMultipartUpload/Part/ETag. |
Response
Headers
Responses can only contain common headers.
Response codes
For a list of possible responses, see Responses.
Additionally, Object Storage may return errors described in the table below.
| Error | Description | HTTP code |
|---|---|---|
NoSuchUpload |
The specified upload does not exist. This may happen if you specify a wrong upload ID or the upload was completed or deleted. | 404 Not Found |
InvalidPart |
Some of the specified parts were not found. Possible reasons: - These parts have not been uploaded. - The provided ETag does not match the saved one. |
400 Bad Request |
InvalidPartOrder |
The list of parts is not provided in ascending order. The list must be sorted by part number in ascending order. |
400 Bad Request |
A successful response contains additional data in XML format with the schema described below.
Data 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>
| Tag | Description |
|---|---|
CompleteMultipartUploadResult |
Response data. Path: /CompleteMultipartUploadResult. |
Location |
URI of the object created as a result of uploading. Path: /CompleteMultipartUploadResult/Location. |
Bucket |
Name of the bucket that contains the object. Path: /CompleteMultipartUploadResult/Bucket. |
Key |
Key of the created object. Path: /CompleteMultipartUploadResult/Key. |
ETag |
Object hash. ETag may or may not be an MD5. Path: /CompleteMultipartUploadResult/ETag. |