Updates an ACL entry on the specified bucket.
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
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:
|
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.