AbortMultipartUpload

注意事项

• 获取uploadId

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

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

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

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

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

  • 在未调用CompleteMultipartUpload接口将分片合成完整的Object的情况下，此时调用AbortMultipartUpload接口仅删除已上传的分片。

• 降低存储费用

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

权限说明

阿里云账号默认拥有全部权限。阿里云账号下的RAM用户或RAM角色默认没有任何权限，需要阿里云账号或账号管理员通过RAM Policy或Bucket Policy授予操作权限。

请求语法

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

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

请求元素

其他公共请求头例如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如下：

• Java

• Python

• Go V2

• C++

• .NET

• PHP

• C

• Node.js

• Android

命令行工具ossutil

AbortMultipartUpload接口所对应的ossutil命令，请参见abort-multipart-upload。

错误码