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