GET Bucket

Use a GET bucket request to:

• List Objects contained in a bucket
• List Multipart Uploads underway in a bucket
• Get Bucket ACLs
• Get Bucket Metadata

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

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
x-goog-if-metageneration-match	For the request to succeed, the value specified for this header must match the metageneration of the requested bucket. If it does not, the request fails with a 412 Precondition Failed status code. Note that this header is ignored in list requests.	No
x-goog-user-project	The project to be billed for charges associated with the request.	No