DefaultObjectAccessControls: insert

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

You can create up to 100 ACL entries.

Request

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

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

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

Property name Value Description Notes

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` `allUsers` `allAuthenticatedUsers` Examples: The user `[email protected]` would be `[email protected]` . The group `[email protected]` would be `[email protected]` . 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. Can be `READER` or `OWNER` .	writable

Required Properties


              entity


              string

The entity holding the permission, in one of the following forms:

Examples:

The user [email protected] would be [email protected] .
The group [email protected] would be [email protected] .
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. Can be READER or OWNER . writable

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

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

Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 3.0 License , and code samples are licensed under the Apache 2.0 License . For details, see our Site Policies .

Last updated April 30, 2014.