Returns the ACL entry for the specified entity 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
OWNER
ACL permission for the bucket.
Request
HTTP request
GET 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 an existing bucket. |
entity |
string |
The entity holding the permission. Can be user-emailAddress ,
group-groupId , group-emailAddress ,
allUsers , or allAuthenticatedUsers .
|
Request body
Do not supply a request body with this method.
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.