Deletes an object.

If you make a DELETE request for an object that doesn't exist, you
will get a [404 Not Found](https://docs.cloud.google.com/storage/docs/xml-api/reference-status.md.txt) 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](https://docs.cloud.google.com/storage/docs/authentication/canonical-requests.md.txt#required-query-parameters) for information on the parameters
you include when creating and using [signed URLs](https://docs.cloud.google.com/storage/docs/access-control/signed-urls.md.txt).

## 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](https://docs.cloud.google.com/storage/docs/request-endpoints.md.txt). | Yes |
| `x-goog-if-generation-match` | In order for the request to succeed, the value you specify for this header must match the [generation](https://docs.cloud.google.com/storage/docs/metadata.md.txt#generation-number) 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](https://docs.cloud.google.com/storage/docs/metadata.md.txt#generation-number) 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
```