CDN加速

AbortMultipartUpload

更新时间:2021-06-17 14:15:32

AbortMultipartUpload

如果用户希望取消一个多段上传任务,可以调用取消多段上传任务接口取消任务。合并段或者取消任务接口被调用后,用户不能再对任务进行上传段和列举段的操作,并且之前已经上传的分片所占用的空间会被释放。然而如果当前存在分片正在上传中,则这些分片上传不会成功。所以,有必要多次终止一个分片上传任务以完全释放分片占据的存储空间,之后用户可以通过List Parts接口确认分片列表是否为空。

请求语法

DELETE /ObjectName?uploadId=uplaodID HTTP/1.1
Host: Bucket.Endpoint
Date: date
Authorization: authorizatiion

URI请求参数

参数名称 描述 是否必填
uploadId Initiate Multipart Upload响应的上传id yes

请求头部

仅使用公共请求头部

请求主体

响应语法

HTTP/1.1 status_code
x-wos-request-id: request id
Date: date
Content-Length: 0
Connection: close
Server: WS-Web-Server

响应头部

仅使用公共响应头部

响应元素

特殊错误

Situation Http Status Error Code Message
指定不存在的uploadId,如已经complete或者abort的uploadId 404 Not Found NoSuchUpload The specified upload does not exist. The upload ID may be invalid, or the upload may have been aborted or completed.

示例

DELETE /example-object?uploadId=VXBsb2FkIElEIGZvciBlbHZpbmcncyBteS1tb3ZpZS5tMnRzIHVwbG9hZ HTTP/1.1
Host: bucket.s3-cn-east-1.wcsapi.com
Date: Mon, 1 Nov 2010 20:34:56 GMT
Authorization: WOS AKIAIOSFODNN7EXAMPLE:0RQf3/cRonhpaBX5sCYVf1bNRuU=


HTTP/1.1 200 OK
x-wos-request-id: 996c76696e6727732072657175657374
Date: Mon, 1 Nov 2020 20:34:56 GMT
Content-Length: 0
Connection: close
Server: WS-Web-Server