Cancelling a Multipart Write

A DELETE request can be used with the UploadID query argument to cancel an in-progress multipart write. This method enables the Health Processor to delete any completed or in-progress parts. Cancelling a multipart write does not terminate any part uploads still in progress.

Updates - The deletion deletes the multipart write and leaves the original object intact if cancelling a multipart write intended to modify an existing object.

Warning

Swarm attempts to delete the original object if the UploadID is not included in the abort deletion for an object previously existing in the cluster. The uploadId query argument must be included to verify the multipart write operation is deleted.

Example of cancelling a multipart write:

DELETE /ObjectName?uploadId=UPLOAD_ID HTTP/1.1

Success: Swarm returns a 200 OK code when the cancel is completed.
Failure: Any failure to write one of the parts triggers an immediate upload cancellation. The upload is cleaned up and retried as a whole at a later point in time.