AbortMultipartUpload

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

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