AbortMultipartUpload
AbortMultipartUpload接口用于取消MultipartUpload事件并刪除對(duì)應(yīng)的Part數(shù)據(jù)。
注意事項(xiàng)
獲取uploadId
調(diào)用AbortMultipartUpload接口時(shí),需獲取相應(yīng)的uploadId。
uploadId對(duì)應(yīng)的分片未上傳完成
調(diào)用AbortMultipartUpload接口過程中,如果所屬的某些Part仍然在上傳,則此次取消操作將無法刪除這些Part。
uploadId對(duì)應(yīng)的分片已上傳完成
且在已調(diào)用CompleteMultipartUpload接口將分片合成完整的Object的情況下,此次調(diào)用AbortMultipartUpload接口不會(huì)刪除任何分片或者Object,且報(bào)錯(cuò)NoSuchUpload,原因是在已完成CompleteMultipartUpload操作后無法再使用該uploadId進(jìn)行任何操作。
在未調(diào)用CompleteMultipartUpload接口將分片合成完整的Object的情況下,此時(shí)調(diào)用AbortMultipartUpload接口僅刪除已上傳的分片。
降低存儲(chǔ)費(fèi)用
建議您及時(shí)完成分片上傳或者取消分片上傳,原因是已上傳但未完成或未取消的分片會(huì)占用存儲(chǔ)空間,從而產(chǎn)生存儲(chǔ)費(fèi)用。
請(qǐng)求語法
DELETE /ObjectName?uploadId=UploadId HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: Signature
當(dāng)您在OSS ON云盒中調(diào)用該接口時(shí),您需要將Host替換為云盒Endpoint。更多信息,請(qǐng)參見云盒Endpoint。
請(qǐng)求元素
名稱 | 類型 | 是否必選 | 示例值 | 描述 |
uploadId | 字符串 | 是 | 0004B9895DBBB6E**** | 此次MultipartUpload事件的唯一標(biāo)識(shí)。 |
其他公共請(qǐng)求頭例如Host、Date等,詳情請(qǐng)參見公共HTTP頭定義。
響應(yīng)頭
此接口僅涉及公共響應(yīng)頭。更多信息,請(qǐng)參見公共響應(yīng)頭(Common Response Headers)。
示例
請(qǐng)求示例
Delete /multipart.data?&uploadId=0004B9895DBBB6E**** HTTP/1.1 Host: oss-example.oss-cn-hangzhou.aliyuncs.com Date: Wed, 22 Feb 2012 08:32:21 GMT Authorization: OSS qn6q**************:77Dv****************
返回示例
HTTP/1.1 204 Server: AliyunOSS Content-length: 0 Connection: keep-alive x-oss-request-id: 059a22ba-6ba9-daed-5f3a-e48027df**** Date: Wed, 22 Feb 2012 08:32:21 GMT x-oss-server-time: 86
SDK
此接口所對(duì)應(yīng)的各語言SDK如下:
錯(cuò)誤碼
錯(cuò)誤碼 | HTTP 狀態(tài)碼 | 描述 |
NoSuchUpload | 404 | 此uploadId不存在。 |