Deletes an object.
If you make a DELETE request for an object that doesn't exist, you
will get a 404 Not Found status
code and the body of the error response will contain NoSuchKey
in the Code
element.
Query string parameters
Parameter | Description | Required |
---|---|---|
generation |
You can use this if you want to delete a specific object generation. If this query parameter is used on a versioned bucket and the generation specified is the live version of the object, the version does not become a noncurrent version of the object, but instead is deleted completely. | No |
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-if-generation-match |
In order for the request to succeed, the value you specify for this
header must match the
generation
of the object you're requesting. If it does not, the request fails with a
412 Precondition Failed status code. |
No |
x-goog-if-metageneration-match |
In order for the request to succeed, the value you specify for this
header must match the
metageneration
of the object you're requesting. If it does not, the request fails with a
412 Precondition Failed status code. |
No |
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 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 deletes an object named paris.jpg.
Request
DELETE /paris.jpg HTTP/1.1 Host: travel-maps.storage.googleapis.com Date: Mon, 15 Feb 2010 11:00:00 GMT Content-Length: 0 Authorization: Bearer ya29.AHES6ZRVmB7fkLtd1XTmq6mo0S1wqZZi3-Lh_s-6Uw7p8vtgSwg
Response
HTTP/1.1 204 No Content Date: Mon, 15 Feb 2010 11:00:01 GMT