BucketAccessControls: patch
Updates an ACL entry on the specifiedbucket.This method supportspatch semantics.
Important: This method fails with a400 Bad Request response for buckets with uniform bucket-level access enabled. Usestorage.buckets.getIamPolicyandstorage.buckets.setIamPolicyto control access instead.Required permissions
The authenticated user must have the following IAM permissions on the bucket touse 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 tostandard query parameters, the following query parameters apply to this method.
To see an example of how to include query parameters in a request, see theJSON API Overview page.
Parameters
| Parameter name | Value | Description |
|---|---|---|
| Path parameters | ||
bucket | string | Name of a bucket. |
entity | string | The entity holding the permission. Can beuser-emailAddress,group-groupId,group-emailAddress,allUsers, orallAuthenticatedUsers. |
| Optional query parameters | ||
Request body
In the request body, supply the relevant portions of aBucketAccessControls resource, according to the rules of patch semantics.
Response
If successful, this method returns aBucketAccessControls resource in the response body.
Try it!
Use the APIs Explorer below to call this method on live data and see the response.
Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-12-17 UTC.