UploadPart
初始化一個MultipartUpload后，調(diào)用UploadPart接口根據(jù)指定的Object名和uploadId來分塊（Part）上傳數(shù)據(jù)。
注意事項
調(diào)用UploadPart接口上傳Part數(shù)據(jù)前，必須先調(diào)用InitiateMultipartUpload接口來獲取OSS服務(wù)器生成的uploadId。
如果使用同一個partNumber上傳了新的數(shù)據(jù)，則OSS上已有的partNumber對應(yīng)的Part數(shù)據(jù)將被覆蓋。
OSS會將服務(wù)器端收到Part數(shù)據(jù)的MD5值放在ETag頭返回給用戶。
如果調(diào)用InitiateMultipartUpload接口時，指定了x-oss-server-side-encryption請求頭，則會對上傳的Part進(jìn)行加密編碼，并在UploadPart響應(yīng)頭中返回x-oss-server-side-encryption頭，其值表明該Part的服務(wù)器端加密算法。更多信息，請參見InitiateMultipartUpload。
請求語法
PUT /ObjectName?partNumber=PartNumber&uploadId=UploadId HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Content-Length: Size
Authorization: SignatureValue當(dāng)您在OSS ON云盒中調(diào)用該接口時，您需要將Host替換為云盒Endpoint。更多信息，請參見云盒Endpoint。
請求頭
此接口僅涉及公共請求頭。更多信息，請參見公共請求頭（Common Request Headers）。
請求元素
名稱 | 類型 | 是否必選 | 示例值 | 描述 |
partNumber | 正整數(shù) | 是 | 1 | 每一個上傳的Part都有一個標(biāo)識它的號碼（partNumber）。 取值：1~10000 單個Part的大小限制為100 KB~5 GB。 說明 MultipartUpload事件中除最后一個Part以外，其他Part的大小都要大于或等于100 KB。因不確定是否為最后一個Part，UploadPart接口并不會立即校驗上傳Part的大小，只有當(dāng)CompleteMultipartUpload時才會校驗。 |
uploadId | 字符串 | 是 | 0004B9895DBBB6EC9**** | uploadId用于唯一標(biāo)識上傳的Part屬于哪個Object。 |
響應(yīng)頭
名稱 | 類型 | 示例值 | 描述 |
Content-MD5 | 字符串 | 1B2M2Y8AsgTpgAmY7PhC**** | 表示Part的MD5值。 重要 Part的MD5值指的是客戶端上傳完成后獲取到的分片MD5，并非響應(yīng)體的MD5。 |
x-oss-hash-crc64ecma | 字符串 | 316181249502703**** | 表示Part的CRC64值。 |
此接口還涉及其他公共響應(yīng)頭，例如Date、x-oss-request-id等。更多信息，請參見公共響應(yīng)頭（Common Response Headers）。
示例
請求示例
PUT /multipart.data?partNumber=1&uploadId=0004B9895DBBB6EC9**** HTTP/1.1
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Content-Length：6291456
Date: Wed, 22 Feb 2012 08:32:21 GMT
Authorization: OSS qn6q**************:77Dv****************
[6291456 bytes data]返回示例
HTTP/1.1 200 OK
Server: AliyunOSS
Content-length: 0
Connection: keep-alive
ETag: "7265F4D211B56873A381D321F586****"
x-oss-request-id: 3e6aba62-1eae-d246-6118-8ff42cd0****
Date: Wed, 22 Feb 2012 08:32:21 GMT
Content-MD5: 1B2M2Y8AsgTpgAmY7Ph****
x-oss-hash-crc64ecma: 316181249502703****
x-oss-server-time: 77SDK
錯誤碼
錯誤碼 | HTTP狀態(tài)碼 | 描述 |
NoSuchUpload | 404 | 分片上傳ID不存在。 |
InvalidArgument | 400 | 超出partNumber范圍（1~10000）。 |
InvalidDigest | 400 | 為了保證數(shù)據(jù)在網(wǎng)絡(luò)傳輸過程中不出現(xiàn)錯誤，用戶發(fā)送請求時可以攜帶Content-MD5，OSS計算上傳數(shù)據(jù)的MD5與用戶上傳的MD5值不一致則表示數(shù)據(jù)傳輸出現(xiàn)錯誤。 |