全部产品
Search
文档中心

对象存储 OSS:AbortMultipartUpload

更新时间:Oct 18, 2023

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

注意事项

  • 获取uploadId

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

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

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

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

    • 且在已调用CompleteMutipartUpload接口将分片合成完整的Object的情况下,此次调用AbortMultipartUpload接口不会删除任何分片或者Object,且报错NoSuchUpload,原因是在已完成CompleteMutipartUpload操作后无法再使用该uploadId进行任何操作。

    • 在未调用CompleteMutipartUpload接口将分片合成完整的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 qn6qrrqxo2oawuk53otf****:J/lICfXEvPmmSW86bBAfMmUm****
  • 返回示例

    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不存在。