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 |