BucketAccessControls: get

Returns the ACL entry for the specified entity on the specified bucket. Try it now.

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.

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:

Parameters

Parameter name	Value	Description
Path parameters
bucket	string	Name of an existing bucket.
entity	string	The entity holding the permission. Can be user-userId, 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.