Stay organized with collections
Save and categorize content based on your preferences.
Returns the ACL entry for the specified entity on the specified object.
Arguments
Parameters
bucket
string
Required. Name of a bucket.
entity
string
Required. The entity holding the permission. Can be user-userId, user-emailAddress, group-groupId, group-emailAddress, allUsers, or allAuthenticatedUsers.
object
string
Required. Name of the object. For information about how to URL encode object names to be path safe, see Encoding URI Path Parts.
[[["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-29 UTC."],[],[],null,["# Method: googleapis.storage.v1.objectAccessControls.get\n\n| **Note:** You should URL-encode object names to be path safe. You can use the [`url_encode`](/workflows/docs/reference/stdlib/text/url_encode) and [`url_encode_plus`](/workflows/docs/reference/stdlib/text/url_encode_plus) functions to encode applicable characters when they appear in either the object name or query string of a request URL. If you don't url-encode your object name and your storage bucket has [folders](/storage/docs/folders), the request will fail. For more information, see [Encoding URL path parts](/storage/docs/request-endpoints#encoding) and [Cloud Storage naming considerations](/storage/docs/objects#naming).\n\nReturns the ACL entry for the specified entity on the specified object.\n\nArguments\n---------\n\nRaised exceptions\n-----------------\n\nResponse\n--------\n\nIf successful, the response contains an instance of [`ObjectAccessControl`](https://cloud.google.com/workflows/docs/reference/googleapis/storage/v1/Overview#ObjectAccessControl).\n\nSubworkflow snippet\n-------------------\n\nSome fields might be optional or required.\nTo identify required fields, refer to the [API documentation](https://cloud.google.com/storage/docs/json_api/v1/objectAccessControls/get). \n\n### YAML\n\n```yaml\n- get:\n call: googleapis.storage.v1.objectAccessControls.get\n args:\n bucket: ...\n entity: ...\n object: ...\n generation: ...\n userProject: ...\n result: getResult\n```\n\n### JSON\n\n```json\n[\n {\n \"get\": {\n \"call\": \"googleapis.storage.v1.objectAccessControls.get\",\n \"args\": {\n \"bucket\": \"...\",\n \"entity\": \"...\",\n \"object\": \"...\",\n \"generation\": \"...\",\n \"userProject\": \"...\"\n },\n \"result\": \"getResult\"\n }\n }\n]\n```"]]