Complete Multipart Upload

最近更新时间:2020-07-10 07:02:05

Complete Multipart Upload


Description

This operation will complete the block upload task before the object assembly.

After starting a block upload task, the user will use the Upload Parts interface to upload all blocks. After successfully uploading all related blocks, the user needs to call this interface to complete the block upload. After receiving the completion request, KS3 will assemble all the blocks according to the block sequence number to create a new object. In the user's task completion request, the user needs to provide a block list. Because KS3 will connect all blocks according to the list, the user is required to ensure that all blocks have been uploaded. For each block in the block list, the user needs to add the block number and the ETag header of the object when uploading the block, and KS3 will reply to complete the response after the block is uploaded.

Please note that if the Complete Multipart Upload request fails, the user application should be able to retry the operation.

Request

Syntax

POST /{ObjectKey}?uploadId={UploadId} HTTP/1.1
Host: {BucketName}.{endpoint}
Date: {Date}
Content-Length: {Size}
Authorization: {SignatureValue}

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

Attention:

Request Parameters

The request does not use the request parameter.

Request Headers

This request uses only the common request headers. For more information, please click Public Request Headers

Request Elements

Name Description Required
CompleteMultipartUpload Request information container.
Ancestors: None
Type: Container
Child Node: One or more Part elements
Yes
Part A specific uploaded block information container.
Ancestors: CompleteMultipartUpload
Type: Container
Child Node: PartNumber, ETag
Yes
PartNumber The block serial number used to identify the block.
Ancestors: Part
Type: Integer
Yes
ETag The entity label returned after the block is uploaded.
Ancestors: Part
Type: String
Yes

Response

Response Headers

This interface uses common response headers. For more information, please click Public Response Headers

Name Description
x-kss-server-side-encryption If server-side encryption is used to store object, the response will contain the header, and the value is the encryption algorithm used.
Type:String
x-kss-server-side-encryption-customer-algorithm If the server uses the encryption key provided by the user for encryption, the response will include the header to confirm the decryption algorithm used when the request is decrypted.
Type:String
Valid Value:AES256

Response Elements

Name Description
CompleteMultipartUploadResult Container for response information.
Type: Container
Child Node: Location, Bucket, Key, ETag
Ancestors: None
Location The URI used to identify the newly created object.
Type: URI
Ancestors: CompleteMultipartUploadResult
Bucket The name of the space containing the newly created object。
Type: String
Ancestors:CompleteMultipartUploadResult
Key The object key of the newly created object.
Type: String
Ancestors:CompleteMultipartUploadResult
ETag The 32-bit hexadecimal string used to identify the content of Object. Different content of Object corresponds to different ETag. For Object created by Put Object or Post Object request, ETag value is the MD5 value of its content. For Object created by block upload method, ETag value is the MD5 value of each block after string splicing. The ETag value can be used to check whether the Object content has changed.
Type: String
Ancestors: CompleteMultipartUploadResult

Special Errors

Error Code Description HTTP Status Code
EntityTooSmall The block size to be uploaded by the user is smaller than the minimum allowed by the object. Except for the last block, each block shall be at least 5MB. When the total size of the file is within 5M, each block can be at least 100k except the last block. 400 Bad Request
InvalidPart One or more of the specified blocks were not found. The block may not have been uploaded, or it may have been uploaded but the entity tags do not match. 400 Bad Request
InvalidPartOrder The chunked list is not in ascending order. The number of blocks must be specified in sequence. 400 Bad Request
NoSuchUpload The specified chunk upload task does not exist. It may be that the upload ID is invalid, or the block upload task has been completed or abandoned. 404 Not Found

Examples

Sample Request

POST /my-viedo.rm ?uploadId=1aa9cfad5e2e405c8f27965feb8b60cc HTTP/1.1
Host: ks3-example.ks3-cn-beijing.ksyun.com
Date: Mon, 1 Nov 2010 20:34:56 GMT
Content-Length: 391
Authorization: authorization string

<CompleteMultipartUpload>
    <Part>
        <PartNumber>1</PartNumber>
        <ETag>"a54357aff0632cce46d942af68356b38"</ETag>
    </Part>
    <Part>
        <PartNumber>2</PartNumber>
        <ETag>"0c78aef83f66abc1fa1e8477f296d394"</ETag>
    </Part>
    <Part>
        <PartNumber>3</PartNumber>
        <ETag>"acbd18db4cc2f85cedef654fccc4a4d8"</ETag>
    </Part>
</CompleteMultipartUpload>

Sample Response

HTTP/1.1 200 OK
Date: Mon, 1 Nov 2010 20:34:56 GMT
Connection: close
Server: Tengine

<?xml version="1.0" encoding="UTF-8"?>
<CompleteMultipartUploadResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
    <Location>http://ks3-example.ks3-cn-beijing.ksyun.com/my-video.rm</Location>
    <Bucket>ks3-example</Bucket>
    <Key>my-video.rm</Key>
    <ETag>"3858f62230ac3c915f300c664312c11f"</ETag>
</CompleteMultipartUploadResult>

Interface Detail Analysis

  • Except for the last block, each block shall be at least 5MB. When the total size of the file is within 5M, each block can be at least 100k except the last block.
  • The list of parts submitted by users must be in ascending order.
  • When the operation is completed, the corresponding UploadId will be invalid
  • The same Object can have different upload IDS at the same time. When an Upload ID is completed, other upload IDs of the object are not affected.
  • Each part in the submitted part list must exist. Otherwise, InvalidPartOrder will be reported

金山云,开启您的云计算之旅

免费注册