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 |
x-goog-user-project |
The project to be billed for charges associated with the request. | No |