Stay organized with collections
Save and categorize content based on your preferences.
Updates an ACL entry 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.update\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\nUpdates an ACL entry 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/update). \n\n### YAML\n\n```yaml\n- update:\n call: googleapis.storage.v1.objectAccessControls.update\n args:\n bucket: ...\n entity: ...\n object: ...\n generation: ...\n userProject: ...\n body:\n bucket: ...\n domain: ...\n email: ...\n entity: ...\n entityId: ...\n etag: ...\n generation: ...\n id: ...\n kind: ...\n object: ...\n projectTeam:\n projectNumber: ...\n team: ...\n role: ...\n selfLink: ...\n result: updateResult\n```\n\n### JSON\n\n```json\n[\n {\n \"update\": {\n \"call\": \"googleapis.storage.v1.objectAccessControls.update\",\n \"args\": {\n \"bucket\": \"...\",\n \"entity\": \"...\",\n \"object\": \"...\",\n \"generation\": \"...\",\n \"userProject\": \"...\",\n \"body\": {\n \"bucket\": \"...\",\n \"domain\": \"...\",\n \"email\": \"...\",\n \"entity\": \"...\",\n \"entityId\": \"...\",\n \"etag\": \"...\",\n \"generation\": \"...\",\n \"id\": \"...\",\n \"kind\": \"...\",\n \"object\": \"...\",\n \"projectTeam\": {\n \"projectNumber\": \"...\",\n \"team\": \"...\"\n },\n \"role\": \"...\",\n \"selfLink\": \"...\"\n }\n },\n \"result\": \"updateResult\"\n }\n }\n]\n```"]]