BucketAccessControls: update

Updates an ACL entry on the specified bucket.

Important: This method fails with a 400 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.get
• storage.buckets.getIamPolicy
• storage.buckets.setIamPolicy
• storage.buckets.update

As an alternative to having IAM permissions, the authenticated user can use this method by having the OWNER ACL permission for the bucket.

Request

HTTP request

PUT 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.

Request body

In the request body, supply a BucketAccessControls resource with the following properties:

Property name	Value	Description	Notes
Optional Properties
role	string	The access permission for the entity. Acceptable values are: "OWNER" "READER" "WRITER"	writable

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.