Stay organized with collections
Save and categorize content based on your preferences.
Returns metadata for the specified bucket.
Required permissions
The authenticated user must have the storage.buckets.get IAM permission to use
this method. Additionally, to return specific bucket metadata, the authenticated user must have the following permissions:
To return the IAM policies: storage.buckets.getIamPolicy
To return the bucket IP filtering rules: storage.buckets.getIpFilter
Request
HTTP request
GET https://storage.googleapis.com/storage/v1/b/bucket
To see an example of how to include query parameters in a request, see the
JSON API Overview page.
Parameters
Parameter name
Value
Description
Path parameters
bucket
string
Name of a bucket.
Optional query parameters
generation
long
If present, selects a specific soft-deleted version of this bucket instead of the live version.
This parameter is required if softDeleted is set to true.
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.
softDeleted
boolean
If true, returns the soft-deleted bucket. This parameter is required if generation is specified.
Request body
Do not supply a request body with this method.
Response
If successful, this method returns a bucket
resource in the response body.
For information about status and error codes returned by this API, see the
reference page.
Try it!
Use the APIs Explorer below to call this method on live data and see the response.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-09-03 UTC."],[],[],null,["# Buckets: get\n\nReturns metadata for the specified bucket.\n\nRequired permissions\n--------------------\n\nThe authenticated user must have the `storage.buckets.get` IAM permission to use\nthis method. Additionally, to return specific bucket metadata, the authenticated user must have the following permissions:\n\n- To return the IAM policies: `storage.buckets.getIamPolicy`\n- To return the bucket IP filtering rules: `storage.buckets.getIpFilter`\n\nRequest\n-------\n\n### HTTP request\n\n```\nGET https://storage.googleapis.com/storage/v1/b/bucket\n```\n\nIn addition to [standard query parameters](/storage/docs/json_api/v1/parameters#query),\nthe following query parameters apply to this method.\n\nTo see an example of how to include query parameters in a request, see the\n[JSON API Overview](/storage/docs/json_api#query_parameters) page.\n\n### Parameters\n\n### Request body\n\nDo not supply a request body with this method.\n\nResponse\n--------\n\nIf successful, this method returns a [bucket\nresource](/storage/docs/json_api/v1/buckets#resource) in the response body.\n\nFor information about status and error codes returned by this API, see the\n[reference page](/storage/docs/json_api/v1/status-codes).\n\nTry it!\n-------\n\n\nUse the APIs Explorer below to call this method on live data and see the response."]]