![[Google Cloud Documentation]](https://www.gstatic.com/devrel-devsite/prod/v0f3a5b8b76e4a120372a69044e02756e703b6140f9f1812c6e4a0407b19864b7/clouddocs/images/lockup_full_color.svg){kind=link}
![[]](https://docs.cloud.google.com/_static/clouddocs/images/icons/products/storage-color.svg){kind=link}
Updates an ACL entry on the specified bucket. This method supports patch semantics.
Important: This method fails with a400 Bad Request response for buckets with uniform bucket-level access enabled. Use
storage.buckets.getIamPolicy
and storage.buckets.setIamPolicy
to control access instead.
Required permissions
The authenticated user must have the following IAM permissions on the bucket to use this method:
storage.buckets.getstorage.buckets.getIamPolicystorage.buckets.setIamPolicystorage.buckets.update
OWNER ACL permission for the bucket.
Request
HTTP request
PATCH https://storage.googleapis.com/storage/v1/b/bucket/acl/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.
|
| Optional query parameters | ||
Request body
In the request body, supply the relevant portions of a BucketAccessControls resource, according to the rules of patch semantics.
Response
If successful, this method returns a BucketAccessControls resource in the response body.
Try it!
Use the APIs Explorer below to call this method on live data and see the response.