All Products
Search
Document Center

Object Storage Service:abort-multipart-upload

Last Updated:Mar 20, 2026

Cancels a multipart upload task and deletes all parts uploaded by that task.

Usage notes

  • You need the Upload ID of the task to cancel.

  • When you cancel a multipart upload task, parts that are being uploaded cannot be deleted.

  • After cancellation, the Upload ID becomes invalid and cannot be used for any further operations. The parts uploaded by the task are deleted.

  • Complete or cancel multipart upload tasks promptly. Uploaded parts consume storage space and incur storage fees until explicitly removed.

Permissions

By default, an Alibaba Cloud account has full permissions. RAM users and RAM roles have no permissions by default and must be granted permissions via RAM Policy or Bucket Policy.

APIActionDescription
AbortMultipartUploadoss:AbortMultipartUploadCancels a multipart upload task and deletes uploaded parts.

Command syntax

ossutil api abort-multipart-upload --bucket <bucket-name> --key <object-key> --upload-id <upload-id>
This command corresponds to the AbortMultipartUpload API operation. For supported global options, see Command-line options.
ParameterTypeDescription
--bucketstringName of the bucket.
--keystringFull path of the object.
--upload-idstringUpload ID of the multipart upload task.

Example

Cancel the multipart upload task for exampleobject with Upload ID 123, and delete all uploaded parts:

ossutil api abort-multipart-upload --bucket examplebucket --key exampleobject --upload-id 123