Object Storage Service：CompleteMultipartUpload

注意事項

調用CompleteMultipartUpload操作時，使用者必須提供所有有效Part列表（包括PartNumber和ETag）。OSS收到使用者提交的Part列表後，會逐一驗證每個Part的有效性。當所有的Part驗證通過後，OSS將把這些Part組合成一個完整的Object。

• 確認Part的大小

  在調用CompleteMultipartUpload時會確認除最後一個Part以外所有Part的大小是否都大於或等於100 KB，並檢查使用者提交的Part列表中的每一個PartNumber和ETag。因此，在上傳Part時，用戶端除了需要記錄Part號碼外，還需要記錄每次上傳Part成功後伺服器返回的ETag值。

• 處理請求

  由於OSS處理CompleteMultipartUpload請求時會持續一定的時間。在這段時間內，如果用戶端與OSS之間串連中斷，OSS仍會繼續處理該請求。

• PartNumber

  服務端在調用CompleteMultipartUpload介面時會對PartNumber做校正。

  PartNumber取值為1~10000。PartNumber可以不連續，但必須升序排列。例如第一個Part的PartNumber是1，第二個Part的PartNumber可以是5。

• UploadId

  同一個Object可以同時擁有不同的UploadId，當Complete一個UploadId後，此UploadId將無效，但該Object的其他UploadId不受影響。

• x-oss-server-side-encryption要求標頭

  如果調用InitiateMultipartUpload介面時，指定了x-oss-server-side-encryption要求標頭，則在CompleteMultipartUpload的回應標頭中返回x-oss-server-side-encryption，其值表示該Object的伺服器端密碼編譯演算法。

版本控制

在開啟版本控制的情況下，調用CompleteMultipartUpload介面來完成整個檔案的MultipartUpload，OSS會為整個檔案產生唯一的版本ID，並在響應header中以x-oss-version-id的形式返回。

請求文法

POST /ObjectName?uploadId=UploadId HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Content-Length: Size
Authorization: Signature
<CompleteMultipartUpload>
<Part>
<PartNumber>PartNumber</PartNumber>
<ETag>ETag</ETag>
</Part>
...
</CompleteMultipartUpload>

請求參數（Request Parameters）

調用CompleteMultipartUpload介面時，可以通過Encoding-type對返回結果中的Key進行編碼。

要求標頭

此介面還需要包含Host、Date等公用要求標頭。關於公用要求標頭的更多資訊，請參見公用HTTP頭定義。

請求元素

響應元素

樣本

• 未開啟版本控制

  請求樣本

  POST /multipart.data?uploadId=0004B9B2D2F7815C432C9057C031****&encoding-type=url HTTP/1.1
  Host: oss-example.oss-cn-hangzhou.aliyuncs.com
  Content-Length: 1056
  Date: Fri, 24 Feb 2012 10:19:18 GMT
  Authorization: OSS qn6q**************:77Dv****************
  <CompleteMultipartUpload> 
      <Part> 
          <PartNumber>1</PartNumber>  
          <ETag>"3349DC700140D7F86A0784842780****"</ETag> 
      </Part>  
      <Part> 
          <PartNumber>5</PartNumber>  
          <ETag>"8EFDA8BE206636A695359836FE0A****"</ETag> 
      </Part>  
      <Part> 
          <PartNumber>8</PartNumber>  
          <ETag>"8C315065167132444177411FDA14****"</ETag> 
      </Part> 
  </CompleteMultipartUpload>

  返回樣本

  HTTP/1.1 200 OK
  Server: AliyunOSS
  Content-Length: 329
  Content-Type: Application/xml
  Connection: keep-alive
  x-oss-request-id: 594f0751-3b1e-168f-4501-4ac71d21****
  Date: Fri, 24 Feb 2012 10:19:18 GMT
  <?xml version="1.0" encoding="UTF-8"?>
  <CompleteMultipartUploadResult xmlns=”http://doc.oss-cn-hangzhou.aliyuncs.com”>
      <EncodingType>url</EncodingType>
      <Location>http://oss-example.oss-cn-hangzhou.aliyuncs.com /multipart.data</Location>
      <Bucket>oss-example</Bucket>
      <Key>multipart.data</Key>
      <ETag>"B864DB6A936D376F9F8D3ED3BBE540****"</ETag>
  </CompleteMultipartUploadResult>

• 已啟用版本控制

  請求樣本

  POST /multipart.data?uploadId=63C06A5CFF6F4AE4A6BB3AD7F01C****  HTTP/1.1
  Host: oss-example.oss-cn-hangzhou.aliyuncs.com
  Content-Length: 223
  Date: Tue, 09 Apr 2019 07:01:56 GMT
  Authorization: OSS qn6q**************:77Dv****************
  <CompleteMultipartUpload> 
      <Part> 
          <PartNumber>1</PartNumber>  
          <ETag>"25A9F4ABFCC05743DF6E2C886C56****"</ETag> 
      </Part>  
      <Part> 
          <PartNumber>5</PartNumber>  
          <ETag>"25A9F4ABFCC05743DF6E2C886C56****"</ETag> 
      </Part>  
  </CompleteMultipartUpload>

  返回樣本

  HTTP/1.1 200 OK
  Server: AliyunOSS
  Content-Length: 314
  Content-Type: Application/xml
  Connection: keep-alive
  x-oss-version-id: CAEQMxiBgID6v86D0BYiIDc3ZDI0YTBjZGQzYjQ2Mjk4OWVjYWNiMDljYzhlN****
  x-oss-request-id: 5CAC4364B7AEADE017000662
  Date: Tue, 09 Apr 2019 07:01:56 GMT
  <?xml version="1.0" encoding="UTF-8"?>
  <CompleteMultipartUploadResult>
    <Location>http://oss-example.oss-cn-hangzhou.aliyuncs.com/multipart.data</Location>
    <Bucket>oss-example</Bucket>
    <Key>multipart.data</Key>
    <ETag>"097DE458AD02B5F89F9D0530231876****"</ETag>
  </CompleteMultipartUploadResult>

SDK

此介面所對應的各語言SDK如下：

• Java

• Python

• Go

• C++

• .NET

• PHP

• C

• Node.js

• Android

錯誤碼