HEAD Bucket

Indicates if a bucket exists and whether the requester has READ access to it.

If you make a HEAD request that's scoped to a bucket that doesn't exist, you will get a 404 Not Found status code and the body of the error response will contain NoSuchBucket in the Code element.

Query string parameters

This request does not include query string parameters.

Request headers

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

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

* Not required for requests that use chunked transfer encoding.

Date The date and time of the request. Yes
Host The URI for Cloud Storage. For more information, see Request URIs. Yes

Request body elements

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

Request syntax

Host: <bucket>.storage.googleapis.com
Date: <date>
Content-Length: 0
Authorization: <authentication string>

Response headers

The request returns standard response headers.

Response body elements

The response does not include an XML document in the response body. Error responses to HEAD requests also do not contain a response body.


The following sample shows a HEAD request for a bucket named travel-maps.


Host: travel-maps.storage.googleapis.com
Date: Fri, 19 Feb 2010 22:04:21 GMT
Authorization: Bearer ya29.AHES6ZRVmB7fkLtd1XTmq6mo0S1wqZZi3-Lh_s-6Uw7p8vtgSwg
Content-Length: 0


HTTP/1.1 200 OK
Last-Modified: Fri, 19 Feb 2010 22:04:23 GMT
Date: Fri, 19 Feb 2010 22:13:49 GMT

Send feedback about...

Cloud Storage Documentation