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, youwill get a404 Not Found statuscode.
Query string parameters
This request does not typically include query string parameters.
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). | No |
Date | The date and time of the request. | No |
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
HEAD / HTTP/1.1Host:BUCKET_NAME.storage.googleapis.comDate:DATEContent-Length: 0Authorization: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. Errorresponses to HEAD requests also do not contain a response body.
Example
The following sample shows a HEAD request for a bucket namedtravel-maps.
Request
HEAD / HTTP/1.1Host: travel-maps.storage.googleapis.comAuthorization: Bearer ya29.AHES6ZRVmB7fkLtd1XTmq6mo0S1wqZZi3-Lh_s-6Uw7p8vtgSwg
Response
HTTP/1.1 200 OK...
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 2026-02-19 UTC.