功能描述
Abort Multipart Upload 用来实现舍弃一个分块上传并删除已上传的块。当您调用 Abort Multipart Upload 时,如果有正在使用这个 Upload Parts 上传块的请求,则 Upload Parts 会返回失败。当该 UploadId 不存在时,会返回404 NoSuchUpload。
说明
只有主账号或者被授权 Abort Multipart Upload 接口权限的子账号可以调用该接口。
注意
建议您及时完成分块上传或者舍弃分块上传,因为已上传但是未终止的块会占用存储空间进而产生存储费用。
授权说明
请求
请求示例
DELETE /<ObjectKey>?uploadId=UploadId HTTP/1.1Host: <BucketName-APPID>.cos.<Region>.myqcloud.comDate: GMT DateAuthorization: Auth String
说明
Host: <BucketName-APPID>.cos.<Region>.myqcloud.com,其中 <BucketName-APPID> 为带 APPID 后缀的存储桶名字,例如 examplebucket-1250000000,可参阅 存储桶概览 > 基本信息 和 存储桶概述 > 存储桶命名规范 文档;<Region> 为 COS 的可用地域,可参阅 地域和访问域名 文档。
Authorization: Auth String(详情请参见 请求签名 文档)。
请求参数
具体内容如下:
参数名称 | 描述 | 类型 | 是否必选 |
uploadId | 标识本次分块上传的 ID,使用 Initiate Multipart Upload 接口初始化分块上传时得到的 UploadId | String | 是 |
请求头
请求体
该请求的请求体为空。
响应
响应头
响应体
该响应体为空。
错误码
实际案例
请求
DELETE /exampleobject?uploadId=1484727270323ddb949d528c629235314a9ead80f0ba5d993a3d76b460e6a9cceb9633b08e HTTP/1.1Host: examplebucket-1250000000.cos.ap-beijing.myqcloud.comDate: Tue, 26 Oct 2013 21:22:00 GMTAuthorization: q-sign-algorithm=sha1&q-ak=************************************&q-sign-time=1484728626;32557624626&q-key-time=1484728626;32557624626&q-header-list=host&q-url-param-list=uploadId&q-signature=****************************************
响应
HTTP/1.1 204 OKContent-Type: application/xmlContent-Length: 0Connection: keep-aliveDate: Tue, 26 Oct 2013 21:22:00 GMTServer: tencent-cosx-cos-request-id: NTg3ZjI5MzlfOTgxZjRlXzZhYjNf****