GET Bucket

Lists the objects that are contained in a bucket, or gets a bucket's ACLs, CORS configuration, lifecycle configuration, logging configuration, versioning configuration, or website configuration.

If you make a GET 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.

Use a GET bucket request to:

Common request headers

The following are common request headers for GET bucket requests.

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

Monitor your resources on the go

Get the Google Cloud Console app to help you manage your projects.

Send feedback about...

Cloud Storage Documentation