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:

• List Objects
• Get Bucket ACLs
• Get Bucket CORS
• Get Bucket Default Storage Class
• Get Bucket Encryption Configuration
• Get Bucket Labels
• Get Bucket Lifecycle
• Get Bucket Location
• Get Bucket Logging
• Get Bucket Requester Pays
• Get Bucket Versioning
• Get Bucket Website

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