Returns metadata for the specified bucket. Try it now or see an example .
The caller must have
READER
permissions on the
bucket
.
Request
HTTP request
GET https://www.googleapis.com/storage/v1beta2/b/bucket
Parameters
Parameter name | Value | Description |
---|---|---|
Path parameters | ||
bucket
|
string
|
Name of a bucket. |
Optional query parameters | ||
ifMetagenerationMatch
|
unsigned long
|
Makes the return of the bucket metadata conditional on whether the bucket's current metageneration matches the given value. |
ifMetagenerationNotMatch
|
unsigned long
|
Makes the return of the bucket metadata conditional on whether the bucket's current metageneration does not match the given value. |
projection
|
string
|
Set of properties to return. Defaults to
noAcl
.
Acceptable values are:
|
Request body
Do not supply a request body with this method.
Response
If successful, this method returns a bucket resource in the response body.
Examples
Note: The code examples available for this method do not represent all supported programming languages (see the client libraries page for a list of supported languages).
Java
Uses the Java client library .
Storage.Buckets.Get getBucket = storage.buckets().get(settings.getBucket()); getBucket.setProjection("full"); Bucket bucket = getBucket.execute();
Python
Uses the Python client library .
req = client.buckets().get( bucket=bucket_name, fields='location,website(mainPageSuffix)') # optional resp = req.execute() print json.dumps(resp, indent=2)
Try it!
Use the APIs Explorer below to call this method on live data and see the response. Alternatively, try the standalone Explorer .