帮你快速理解、总结文档立即下载
文档中心>对象存储>高性能存储>API 文档>分块上传操作>AbortMultipartUpload

AbortMultipartUpload

最近更新时间：2026-10-21 18:34:04
本文档已由 AI 辅助审校
我的收藏

本页目录：

AbortMultipartUpload 接口请求用于舍弃一个分块上传任务并删除其已上传的所有分块。当客户端不再需要继续上传或合并某个 UploadId 时，可调用本接口释放该任务在存储桶中占用的存储空间。

注意事项

目标对象键

本接口要求 URL 路径中的 <ObjectKey> 与 InitiateMultipartUpload 调用时使用的对象键完全一致（包括大小写、路径层级与末尾 /），不一致时本接口返回 NoSuchUpload。

请求

请求语法

DELETE /<ObjectKey>?uploadId=<UploadId> HTTP/1.1
Host: <BucketName-APPID>.cosrapid.<Region>.myqcloud.com
Date: <GMT Date>
Authorization: <Auth String>
说明：
Authorization 字段的具体格式见 公共请求头部。

请求参数

参数名称
描述
类型
是否必选
uploadId
调用 InitiateMultipartUpload 接口初始化分块上传时返回的 UploadId
string
是

请求头部

此接口仅使用 公共请求头部，无私有请求头部。

请求体

该请求的请求体为空。

响应

响应头部

仅返回 公共响应头部，本接口无私有响应头部。

响应体

请求成功，响应状态码为 204 No Content，响应体为空。

错误码

本接口遵循统一的错误响应和错误码，详情请参见 错误码 文档。

实际案例

舍弃一个分块上传任务

请求

DELETE /exampleobject?uploadId=1484727270323ddb949d528c629235314a9ead80f0ba5d993a3d76b460e6a9cceb9633b08e HTTP/1.1
Host: examplebucket-x--1250000000.cosrapid.ap-guangzhou.myqcloud.com
Date: Tue, 26 Oct 2013 21:22:00 GMT
Authorization: q-sign-algorithm=sha1&q-ak=AKIDXXXXXXXX&q-sign-time=1484728626;32557624626&q-key-time=1484728626;32557624626&q-header-list=date;host&q-url-param-list=uploadid&q-signature=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

响应

HTTP/1.1 204 No Content
Connection: keep-alive
Date: Tue, 26 Oct 2013 21:22:00 GMT
x-cos-request-id: NjUwMDAwMDAwMDAwMDAwMDAw

中国站