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

Abort a multipart upload Stay organized with collections Save and categorize content based on your preferences.