BucketAccessControls: list

Retrieves ACL entries on a 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

Parameters

Parameter name	Value	Description
Path parameters
bucket	string	Name of a bucket.
Optional query parameters
userProject	string	The project to be billed for this request. Required for Requester Pays buckets.

Request body

Do not supply a request body with this method.

Response

If successful, this method returns a response body with the following structure:

{
  "kind": "storage#bucketAccessControls",
  "items": [
    bucketAccessControls Resource
  ]
}

Property name	Value	Description	Notes
kind	string	The kind of item this is. For lists of bucket access control entries, this is always storage#bucketAccessControls.
items[]	list	The list of bucketAccessControls.

Try it!

Use the APIs Explorer below to call this method on live data and see the response.