全部產品
Search
文件中心

Object Storage Service:AbortMultipartUpload

更新時間:Jun 19, 2024

AbortMultipartUpload介面用於取消MultipartUpload事件並刪除對應的Part資料。

注意事項

  • 擷取uploadId

    調用AbortMultipartUpload介面時,需擷取相應的uploadId。

  • uploadId對應的分區未上傳完成

    調用AbortMultipartUpload介面過程中,如果所屬的某些Part仍然在上傳,則此次取消操作將無法刪除這些Part。

  • uploadId對應的分區已上傳完成

    • 且在已調用CompleteMultipartUpload介面將分區合成完整的Object的情況下,此次調用AbortMultipartUpload介面不會刪除任何分區或者Object,且報錯NoSuchUpload,原因是在已完成CompleteMultipartUpload操作後無法再使用該uploadId進行任何操作。

    • 在未調用CompleteMultipartUpload介面將分區合成完整的Object的情況下,此時調用AbortMultipartUpload介面僅刪除已上傳的分區。

  • 降低儲存費用

    建議您及時完成分區上傳或者取消分區上傳,原因是已上傳但未完成或未取消的分區會佔用儲存空間,從而產生儲存費用。

請求文法

DELETE /ObjectName?uploadId=UploadId HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: Signature

請求元素

名稱

類型

是否必選

樣本值

描述

uploadId

字串

0004B9895DBBB6E****

此次MultipartUpload事件的唯一標識。

其他公用要求標頭例如Host、Date等,詳情請參見公用HTTP頭定義

回應標頭

此介面僅涉及公用回應標頭。更多資訊,請參見公用回應標頭(Common Response Headers)

樣本

  • 請求樣本

    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

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

錯誤碼

錯誤碼

HTTP 狀態代碼

描述

NoSuchUpload

404

此uploadId不存在。