DefaultObjectAccessControls: patch
Updates a default object ACL entry on the specified bucket.
This method supports patch semantics.
Required permissions
To use this method, the authenticated user must have the following IAM permissions
for the bucket containing the default object ACL entry:
storage.buckets.getstorage.buckets.getIamPolicystorage.buckets.setIamPolicystorage.buckets.update
Request
HTTP request
PATCH https://storage.s3nsapis.fr/storage/v1/b/bucket/defaultObjectAcl/entity
In addition to standard query parameters,
the following query parameters apply to this method.
To see an example of how to include query parameters in a request, see the
JSON API Overview page.
Parameters
| Parameter name |
Value |
Description |
| Path parameters |
bucket |
string |
Name of a bucket.
|
entity |
string |
The entity holding the permission. Can be user-emailAddress,
group-groupId, group-emailAddress,
allUsers, or allAuthenticatedUsers.
|
Request body
In the request body, supply the relevant portions of a
DefaultObjectAccessControls resource,
according to the rules of patch semantics.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-08-07 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-07 UTC."],[],[],null,["# DefaultObjectAccessControls: patch\n\nUpdates a default object ACL entry on the specified [bucket](/storage/docs/json_api/v1/buckets).\nThis method supports [patch](/storage/docs/json_api#patch) semantics.\n\nRequired permissions\n--------------------\n\nTo use this method, the authenticated user must have the following IAM permissions\nfor the bucket containing the default object ACL entry:\n\n- `storage.buckets.get`\n- `storage.buckets.getIamPolicy`\n- `storage.buckets.setIamPolicy`\n- `storage.buckets.update`\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\nRequest\n-------\n\n### HTTP request\n\n```\nPATCH https://storage.googleapis.com/storage/v1/b/bucket/defaultObjectAcl/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 the relevant portions of a\n[DefaultObjectAccessControls resource](/storage/docs/json_api/v1/defaultObjectAccessControls#resource),\naccording to the rules of patch semantics.\n\nResponse\n--------\n\nIf successful, this method returns a [DefaultObjectAccessControls resource](/storage/docs/json_api/v1/defaultObjectAccessControls#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."]]
