Buckets: get

Returns metadata for the specified bucket.

The caller must have READER permissions on the bucket. 

Request

HTTP request

GET https://www.googleapis.com/storage/v1/b/bucket

Parameters

Parameter name Value Description
Path parameters
bucket string Name of a bucket.
Optional query parameters
ifMetagenerationMatch long Makes the return of the bucket metadata conditional on whether the bucket's current metageneration matches the given value.
ifMetagenerationNotMatch 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:
  • "full": Include all properties.
  • "noAcl": Omit owner, acl and defaultObjectAcl properties.

Request body

Do not supply a request body with this method.

Response

If successful, this method returns a bucket resource in the response body.

Send feedback about...

Cloud Storage Documentation