Abort a multipart upload
Aborts anXML API multipart upload.
Once a multipart upload is aborted, any parts in the process of being uploadedfail, 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 |
Seesigned URL query string parameters for information on the parametersyou include when creating and usingsigned 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, seeRequest 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.1Host:BUCKET_NAME.storage.googleapis.comDate:DATEContent-Length: 0Authorization:AUTHENTICATION_STRING
Response headers
The request can return a variety of response headers depending on the requestheaders 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 namedparis.jpg.
Request
DELETE /paris.jpg?uploadId=VXBsb2FkIElEIGZvciBlbHZpbmcncyBteS1tb3ZpZS5tMnRzIHVwbG9hZA HTTP/1.1Host: travel-maps.storage.googleapis.comDate: Tue, 23 Mar 2021 11:00:00 GMTContent-Length: 0Authorization: Bearer ya29.AHES6ZRVmB7fkLtd1XTmq6mo0S1wqZZi3-Lh_s-6Uw7p8vtgSwg
Response
HTTP/1.1 204 OKDate: Tue, 23 Mar 2021 11:00:01 GMT
Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-12-17 UTC.