CompleteMultipartUpload
The request completes the composite download.
When receiving an Object Storage request:
- Assembles the final object from the parts obtained during the download process in the order of their numbers
- Removes the download ID so that all subsequent requests with the download ID will return an error
NoSuchUpload.
When the download is complete, the client must provide a list of the parts that he sent. The description of each part should contain
ETag, which the client receives in response to each downloaded part. See section The UploadPart Method .Depending on the size of the object and the number of parts, the operation may take several minutes.
If the request fails, then the client application should be ready to retry the request.
POST /{bucket}/{key}?uploadId=UploadId HTTP/1.1
Parameter | Description |
bucket | Bucket name. |
key | Object key. |
Parameter | Description |
uploadId |
The list of parts of a composite download is sent 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 about the loaded part of the object.
Path: /CompleteMultipartUpload/Part. |
PartNumber | Part number.
A unique identifier that identifies the position of the part among other parts in the load.
Path: /CompleteMultipartUpload/Part/PartNumber. |
ETag | The identifier that the client received from ColdStack in response to downloading the part.
Path: /CompleteMultipartUpload/Part/ETag. |
Additionally, ColdStack may return the errors described in the table below.
Mistake | Description | HTTP code |
NoSuchUpload | The specified download does not exist. The download ID may be incorrect, or the download may have completed or been deleted. | 404 Not Found |
InvalidPart | Some of the specified parts have not been found.
Possible causes:
- Parts not loaded.
- The transmitted one ETagdoes not match the saved one. | 400 Bad Request |
InvalidPartOrder | The list of parts is not transmitted in ascending order.
The list should be sorted in ascending order by part number. | 400 Bad Request |
The successful response contains additional data in XML format, the schema of which is described below.
<CompleteMultipartUploadResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
<Location>http://Example-Bucket.s3.coldstack.io/Example-Object</Location>
<Bucket>Example-Bucket</Bucket>
<Key>Example-Object</Key>
<ETag>"3858f62230ac3c915f300c664312c11f-9"</ETag>
</CompleteMultipartUploadResult>
Tag | Description |
CompleteMultipartUploadResult | Response data.
Path: /CompleteMultipartUploadResult. |
Location | The URI of the resulting download of the object.
Path: /CompleteMultipartUploadResult/Location. |
Bucket | The name of the bucket in which the object is located.
Path: /CompleteMultipartUploadResult/Bucket. |
Key | The key of the created object.
Path: /CompleteMultipartUploadResult/Key. |
ETag | The hash of the object.
ETag may or may not be MD5.
Path: /CompleteMultipartUploadResult/ETag. |
Last modified 2yr ago