You can use a DELETE request 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. Canceling a multipart write will not terminate any part uploads still in progress.
Updates — If you are canceling a multipart write that was intended to modify an existing object, the deletion only deletes the multipart write and leaves the original object intact.
Warning
If you fail to include the
UploadID on the abort deletion for an object that previously existed in the cluster, Swarm will attempt to delete the original object. You must include the uploadId query argument to ensure only the multipart write operation is deleted.Example
Example of canceling a multipart write:
DELETE /ObjectName?uploadId=UPLOAD_ID HTTP/1.1
- Success: When the cancel is completed, Swarm returns a
200 OKcode. - Failure: Any failure to write one of the parts triggers an immediate upload cancellation. The upload is cleaned up and will be retried as a whole at a later point in time.