对象存储 > API 文档 > Object 接口 > 分片上传 v2 版 > 终止上传

终止上传

最近更新时间: 2021-11-12 16:29:39

描述

该接口根据 UploadId 终止 Multipart Upload 。

请求

请求语法

DELETE /buckets/<BucketName>/objects/<EncodedObjectName>/uploads/<UploadId> HTTP/1.1
Host: <UpHost>
Authorization: UpToken <UploadToken>

使用说明：

当调用该 API 终止 Multipart Upload 后，无法再使用这个 UploadId 做任何操作，已经上传的 Part 数据也会被删除。

请求参数

参数名称	必填	说明
BucketName	是	空间名称
EncodedObjectName	否	资源名，EncodedObjectName 需要经过 Base64 编码。具体可以参照：URL 安全的 Base64 编码
UploadId	是	在服务端申请的 Multipart Upload 任务 id

请求头

头部名称	必填	说明
Host	是	上传域名。七牛对象存储支持的区域和对应区域上传域名列表见存储区域列表
Authorization	是	该参数应严格按照上传凭证格式进行填充，否则会返回 401 错误码。一个合法的 Authorization 值应类似于 Authorization: UpToken QNJi_bYJlmO5LeY08FfoNj9w_r…

请求内容

该请求操作的请求体为空。

响应

响应头

该请求操作的实现使用了所有操作的公共响应头。有关详细信息，请查阅公共响应头。

响应内容

该请求操作的响应体为空。

响应状态码

该操作的实现不会返回特殊错误。有关错误和错误代码列表的一般信息，请查阅错误响应。

示例

请求示例

DELETE /buckets/myBucket/objects/bXlPYmplY3Q=/uploads/myUploadID/1 HTTP/1.1
Host: up.qiniup.com
Authorization: UpToken j853F3bLkWl59I5BOkWm6q1Z1mZClpr9Z9CLfDE0:nP7NSSyGo4x3W_nJ8T9X1gJrgpk=

响应示例

HTTP/1.1 200 OK
Content-Length: 2
Connection: keep-alive
Content-Type: application/json
Date: Wed, 18 Dec 2019 17:02:11 GMT
Server: nginx
X-Reqid: SFkAAAC8BDebTtsU

{
}

以上内容是否对您有帮助？