CompleteMultipartUpload
Completes a multipart upload by assembling previously uploaded parts.
Request Syntax
POST /bucket/Key+?uploadId=UploadId HTTP/1.1 Host: msdps3.server:8443 <?xml version="1.0" encoding="UTF-8"?> <CompleteMultipartUpload xmlns="http://s3.amazonaws.com/doc/2006-03-01/"> <Part> <ETag>string</ETag> <PartNumber>integer</PartNumber> </Part> ... </CompleteMultipartUpload>
Request Parameters
Bucket
Name of the bucket.
Required: Yes
Type: String
Key
The name of the object.
Required: Yes
Type: String
uploadId
Upload ID of multipart upload.
Required: Yes
Type: String
Request body
CompleteMultipartUpload
Root level tag for the CompleteMultipartUpload parameters.
Required: Yes
Part
List of parts to create final object. It contains ETag and PartNumber.
ETag
ETag of the uploaded part.
PartNumber
PartNumber of the uploaded part.
Response Syntax
HTTP/1.1 200
x-amz-version-id: VersionId
<?xml version="1.0" encoding="UTF-8"?>
<CompleteMultipartUploadResult>
<Bucket>string</Bucket>
<Key>string</Key>
<ETag>string</ETag>
</CompleteMultipartUploadResult>
Response Headers
x-amz-version-id
Version ID of the created object.
Response Body
CompleteMultipartUploadResult
Root level tag for the CompleteMultipartUploadResult parameters.
Required: Yes
Bucket
Name of the bucket.
Required: Yes
Type: String
Key
The name of the object.
Required: Yes
Type: String
ETag
SHA256 digest of the object.
Possible Error Response
Success
HTTP status code 200.
InvalidDigest
The Content-MD5 you specified did not match what was received.
HTTP status code 400.
InvalidArgument
Invalid Argument.
Part number must be an integer between 1 and 10000, inclusive.
HTTP status code 400.
InvalidPartOrder
The list of parts was not in ascending order.
The parts list must be specified in order of the part number.
HTTP status code 400.
EntityTooLarge
Your proposed upload exceeds the maximum allowed object size.
HTTP status code 400.
ErrEntityTooSmall
Your proposed upload is smaller than the minimum allowed object size.
HTTP status code 400.
ErrNoSuchUpload
The specified multipart upload does not exist. The upload ID might not be valid, or the multipart upload might have been aborted or completed.
HTTP status code 400.
ErrInvalidPart
One or more of the specified parts could not be found. The part may not have been uploaded, or the specified entity tag may not match the part's entity tag.
HTTP status code 400.
MalformedPOSTRequest
The body of your POST request is not well-formed multipart/form-data.
HTTP status code 400.
AccessDenied
Request was rejected because user authentication failed.
HTTP status code 403.
NoSuchBucket
The specified bucket does not exist.
HTTP status code 404.
InternalError
Request failed because of an internal server error.
HTTP status code 500.