Google Cloud Platform
Cloud Storage

BucketAccessControls: insert

Creates a new ACL entry on the specified bucket. Try it now or see an example.


HTTP request



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

Request body

In the request body, supply a BucketAccessControls resource with the following properties:

Property name Value Description Notes
Required Properties
entity string The entity holding the permission, in one of the following forms:
  • user-userId
  • user-email
  • group-groupId
  • group-email
  • domain-domain
  • project-team-projectId
  • allUsers
  • allAuthenticatedUsers
  • The user would be
  • The group would be
  • To refer to all members of the Google Apps for Business domain, the entity would be
role string The access permission for the entity. Can be READER, WRITER, or OWNER. writable


If successful, this method returns a BucketAccessControls resource in the response body.


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().insert(
        body={'entity': 'allAuthenticatedUsers', 'role': 'READER'})
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.