文档中心>数据保险箱>API 文档>分片上传>舍弃一个分块上传并删除已上传的块

舍弃一个分块上传并删除已上传的块

最近更新时间:2023-02-03 11:03:48

接口描述

  • 接口名称: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