DefaultObjectAccessControls: insert

Creates a new default object ACL entry on the specified bucket. Try it now.


HTTP request



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

In the request body, supply a DefaultObjectAccessControls 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 GSuite for Business domain, the entity would be
role string The access permission for the entity.

Acceptable values are:
  • "OWNER"
  • "READER"


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

Try it!

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

Send feedback about...

Cloud Storage Documentation