Abort a multipart upload

Aborts an XML API multipart upload.

Once a multipart upload is aborted, any parts in the process of being uploaded fail, and future requests that use the relevant upload ID fail.

Query string parameters

Parameter Description Required
uploadId The multipart upload you want to abort. Yes

See signed URL query string parameters for information on the parameters you include when creating and using signed URLs.

Request headers

Header Description Required
Authorization The authentication string for the request. Yes
Content-Length

The length of the request body without headers (in bytes).

* Not required for requests that use chunked transfer encoding.

 Yes*
Date The date and time of the request. Yes
Host The URI for Cloud Storage. For more information, see Request Endpoints. Yes
x-goog-user-project The project to be billed for charges associated with the request. No

Request body elements

This request does not include an XML document in the request body.

Request syntax

DELETE /OBJECT_NAME?uploadId=UPLOAD_ID HTTP/1.1
Host: BUCKET_NAME.storage.googleapis.com
Date: DATE
Content-Length: 0
Authorization: AUTHENTICATION_STRING

Response headers

The request can return a variety of response headers depending on the request headers you use.

Response body elements

The response does not include an XML document in the response body.

Example

The following sample aborts a multipart upload for an object named paris.jpg.

Request

DELETE /paris.jpg?uploadId=VXBsb2FkIElEIGZvciBlbHZpbmcncyBteS1tb3ZpZS5tMnRzIHVwbG9hZA HTTP/1.1
Host: travel-maps.storage.googleapis.com
Date: Tue, 23 Mar  2021 11:00:00 GMT
Content-Length: 0
Authorization: Bearer ya29.AHES6ZRVmB7fkLtd1XTmq6mo0S1wqZZi3-Lh_s-6Uw7p8vtgSwg

Response

HTTP/1.1 204 OK
Date: Tue, 23 Mar  2021 11:00:01 GMT