[[["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,["# BucketAccessControls: update\n\nUpdates an ACL entry on the specified\n[bucket](/storage/docs/json_api/v1/buckets#resource).\n| **Important:** This method fails with a `400 Bad Request` response for buckets with uniform bucket-level access enabled. Use [`storage.buckets.getIamPolicy`](/storage/docs/json_api/v1/buckets/getIamPolicy) and [`storage.buckets.setIamPolicy`](/storage/docs/json_api/v1/buckets/setIamPolicy) to control access instead.\n\nRequired permissions\n--------------------\n\nThe authenticated user must have the following IAM permissions on the bucket to\nuse this method:\n\n- `storage.buckets.get`\n- `storage.buckets.getIamPolicy`\n- `storage.buckets.setIamPolicy`\n- `storage.buckets.update`\n\nAs an alternative to having IAM permissions, the authenticated user can use this method by having the `OWNER` ACL permission for the bucket.\n\n\u003cbr /\u003e\n\nRequest\n-------\n\n### HTTP request\n\n```\nPUT https://storage.googleapis.com/storage/v1/b/bucket/acl/entity\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 a [BucketAccessControls resource](/storage/docs/json_api/v1/bucketAccessControls#resource) with the following properties:\n\nResponse\n--------\n\nIf successful, this method returns a\n[BucketAccessControls resource](/storage/docs/json_api/v1/bucketAccessControls#resource)\nin 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."]]
