Cancels a multipart upload task and deletes the parts uploaded in the task.
Usage notes
-
The upload ID of the task is required to call the AbortMutipartUpload operation.
-
After you call the AbortMutipartUpload operation, parts that are being uploaded are not deleted.
-
- If the CompleteMutipartUpload operation is called, no parts or objects are deleted and the NoSuchUpload error is reported after you call the AbortMutipartUpload operation. This is because no operations are allowed by using the upload ID of the task after the CompleteMutipartUpload operation is called.
- If the CompleteMutipartUpload operation is not called, only parts that are uploaded are deleted after you call the AbortMutipartUpload operation.
-
We recommend that you complete or cancel multipart upload tasks that are not complete in a timely manner because parts that are uploaded by these tasks consume storage space and incur storage fees.
Request syntax
DELETE /ObjectName?uploadId=UploadId HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: Signature
Request parameters
Parameter | Type | Required | Example | Description |
---|---|---|---|---|
uploadId | String | Yes | 0004B9895DBBB6E**** | The ID of the multipart upload task. |
For more information about other common request headers such as Host and Date, see Common HTTP headers.
Response headers
This request contains only common response headers. For more information, see Common response headers.
Examples
- Sample requests
Delete /multipart.data?&uploadId=0004B9895DBBB6E**** HTTP/1.1 Host: oss-example.oss-cn-hangzhou.aliyuncs.com Date: Wed, 22 Feb 2012 08:32:21 GMT Authorization: OSS qn6qrrqxo2oawuk53otf****:J/lICfXEvPmmSW86bBAfMmUm****
- Sample success responses
HTTP/1.1 204 Server: AliyunOSS Connection: keep-alive x-oss-request-id: 059a22ba-6ba9-daed-5f3a-e48027df**** Date: Wed, 22 Feb 2012 08:32:21 GMT
SDKs
You can use Object Storage Service (OSS) SDKs for the following programming languages to call the AbortMultipartUpload operation:
Error codes
Error code | HTTP status code | Description |
---|---|---|
NoSuchUpload | 404 | The error message returned because the specified upload ID does not exist. |