DefaultObjectAccessControls: insert

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

Request

HTTP request

POST https://www.googleapis.com/storage/v1/b/bucket/defaultObjectAcl

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

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
Examples:
  • The user liz@example.com would be user-liz@example.com.
  • The group example@googlegroups.com would be group-example@googlegroups.com.
  • To refer to all members of the Google Apps for Business domain example.com, the entity would be domain-example.com.
writable
role string The access permission for the entity.

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

Response

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.

Monitor your resources on the go

Get the Google Cloud Console app to help you manage your projects.

Send feedback about...

Cloud Storage Documentation