Cloud Storage

BucketAccessControls: list

Retrieves ACL entries on a specified bucket. Try it now or see an example.


HTTP request

GET https://www.googleapis.com/storage/v1/b/bucket/acl


Parameter name Value Description
Path parameters
bucket string Name of a bucket.

Request body

Do not supply a request body with this method.


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


Note: The code examples available for this method do not represent all supported programming languages (see the client libraries page for a list of supported languages).


Uses the Python client library.

req = client.bucketAccessControls().list(
        fields='items(id,role)')    # optional
resp = req.execute()
print json.dumps(resp, indent=2)

Try it!

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