Stay organized with collections
Save and categorize content based on your preferences.
Updates a bucket. Changes to the bucket will be readable immediately after writing, but
configuration changes may take time to propagate. This method supports
patch semantics.
Required permissions
To use this method,the authenticated user must have the storage.buckets.update IAM
permission. Additionally, to perform specific actions on a bucket, the authenticated user must have the following permissions:
To update public access prevention policies or access control lists
(ACLs): storage.buckets.setIamPolicy
To return ACLs on a bucket as part of the response: storage.buckets.getIamPolicy
To update bucket IP filtering rules: storage.buckets.setIpFilter
To return bucket IP filtering rules as part of the response: storage.buckets.getIpFilter
[[["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-08-07 UTC."],[],[],null,["# Buckets: patch\n\nUpdates a bucket. Changes to the bucket will be readable immediately after writing, but\nconfiguration changes may take time to propagate. This method supports\n[patch](/storage/docs/json_api#patch) semantics.\n\nRequired permissions\n--------------------\n\nTo use this method,the authenticated user must have the `storage.buckets.update` IAM\npermission. Additionally, to perform specific actions on a bucket, the authenticated user must have the following permissions:\n\n- To update public access prevention policies or access control lists (ACLs): `storage.buckets.setIamPolicy`\n- To return ACLs on a bucket as part of the response: `storage.buckets.getIamPolicy`\n- To update bucket IP filtering rules: `storage.buckets.setIpFilter`\n- To return bucket IP filtering rules as part of the response: `storage.buckets.getIpFilter`\n\nRequest\n-------\n\n### HTTP request\n\n```\nPATCH 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\nIn the request body, supply the relevant portions of a\n[bucket resource](/storage/docs/json_api/v1/buckets#resource), according to the rules\nof patch semantics.\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\nResponse\n--------\n\nIf successful, this method returns a\n[bucket resource](/storage/docs/json_api/v1/buckets#resource) in the response body.\n\nTry it!\n-------\n\n\nUse the APIs Explorer below to call this method on live data and see the response."]]