[[["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,["# BucketAccessControls: list\n\nRetrieves ACL entries on a 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\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```\nGET https://storage.googleapis.com/storage/v1/b/bucket/acl\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 response body with the following structure:\n\n```objective-c\n{\n \"kind\": \"storage#bucketAccessControls\",\n \"items\": [\n bucketAccessControls Resource\n ]\n}\n```\n\nTry it!\n-------\n\n\nUse the APIs Explorer below to call this method on live data and see the response."]]