AbortMultipartUpload接口用于取消MultipartUpload事件并删除对应的Part数据。

注意事项

  • 获取uploadId

    调用AbortMutipartUpload接口时,需获取相应的uploadId。

  • uploadId对应的分片未上传完成

    调用AbortMutipartUpload接口过程中,如果所属的某些Part仍然在上传,则此次取消操作将无法删除这些Part。

  • uploadId对应的分片已上传完成
    • 且在已调用CompleteMutipartUpload接口将分片合成完整的Object的情况下,此次调用AbortMutipartUpload接口不会删除任何分片或者Object,且报错NoSuchUpload,原因是在已完成CompleteMutipartUpload操作后无法再使用该uploadId进行任何操作。
    • 在未调用CompleteMutipartUpload接口将分片合成完整的Object的情况下,此时调用AbortMutipartUpload接口仅删除已上传的分片。
  • 降低存储费用

    建议您及时完成分片上传或者取消分片上传,原因是已上传但未完成或未取消的分片会占用存储空间进而产生存储费用。

请求语法

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

当您在OSS ON云盒中调用该接口时,您需要将Host替换为云盒Endpoint。更多信息,请参见云盒Endpoint

请求元素

名称 类型 是否必选 示例值 描述
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 qn6qrrqxo2oawuk53otf****:J/lICfXEvPmmSW86bBAfMmUm****
  • 返回示例
    HTTP/1.1 204 
    Server: AliyunOSS
    Connection: keep-alive
    x-oss-request-id: 059a22ba-6ba9-daed-5f3a-e48027df****
    Date: Wed, 22 Feb 2012 08:32:21 GMT

SDK

此接口所对应的各语言SDK如下:

错误码

错误码 HTTP 状态码 描述
NoSuchUpload 404 此uploadId不存在。