DefaultObjectAccessControls: insert

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

Request

POST https://www.googleapis.com/storage/v1/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` `project-team-projectId` `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 March 4, 2015.