Google Cloud Platform
Cloud Storage

BucketAccessControls: insert

Creates a new ACL entry on the specified bucket.


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.