接口描述
- 接口名称:AbortMultipartUpload
- 接口功能:该接口用于实现舍弃一个分块上传并删除已上传的块。当您调用 AbortMultipartUpload 时,如果有正在使用 UploadParts 上传块的请求,则 UploadParts 会返回失败。当该 UploadId 不存在时,会返回404 NoSuchUpload。
注意:建议您及时完成分块上传或者舍弃分块上传,因为已上传但是未终止的块会占用存储空间,进而产生存储费用。
请求
请求示例
DELETE /<CofferNane-APPID>/<ObjectKey>?uploadId=UploadId HTTP/1.1
Host: cdcs.<Region>.myqcloud.com
Date: GMT Date
Authorization: Auth String
说明:Authorization: Auth String 详情,请参见 请求签名 文档。
请求参数
具体内容如下:
参数名称 | 必选 | 类型 | 描述 |
---|---|---|---|
uploadId | 是 | String | 标识本次分块上传的 ID。 使用 InitiateMultipartUpload 接口初始化分片上传时会得到一个 uploadId,该 ID 不但唯一标识这一分块数据,也标识了这分块数据在整个文件内的相对位置。 |
请求头
此接口仅使用公共请求头部,详情请参见 公共请求头部 文档。
请求体
该请求的请求体为空。
响应
响应头
此接口仅返回公共响应头部,详情请参见 公共响应头部 文档。
响应体
该请求的响应体为空。
示例
请求
DELETE /examplecoffer-1250000000/exampleobject?uploadId=1484727270323ddb949d528c629235314a9ead80f0ba5d993a3d76b460e6a9cceb9633b08e HTTP/1.1
Host: cdcs.ap-beijing.myqcloud.com
Date: Tue, 26 Oct 2013 21:22:00 GMT
Authorization: [Auth String]
响应
HTTP/1.1 204 OK
Content-Type: application/xml
Content-Length: 0
Connection: keep-alive
Date: Tue, 26 Oct 2013 21:22:00 GMT
Server: tencent-cdcs
x-cdcs-request-id: NTg3ZjI5MzlfOTgxZjRlXzZhYjNfMjBh