BucketAccessControls: insert

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

Request

POST https://www.googleapis.com/storage/v1beta1/b/bucket/acl

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

This request requires authorization with at least one of the following scopes ( read more about authentication and authorization ).

Scope
`https://www.googleapis.com/auth/devstorage.full_control`

In the request body, supply a BucketAccessControls 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` , `WRITER` , 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 , WRITER , or OWNER . writable

If successful, this method returns a BucketAccessControls 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 July 31, 2013.