Stay organized with collectionsSave and categorize content based on your preferences.
Returns metadata for the specified bucket.
Required permissions
The authenticated user must have thestorage.buckets.getIAM 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
[[["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-04 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."]]
