Creates a new ACL entry on the specified bucket . Try it now or see an example .
You can create up to 100 ACL entries.
Request
HTTP request
POST https://www.googleapis.com/storage/v1beta2/b/bucket/acl
Parameters
| Parameter name | Value | Description |
|---|---|---|
| Path parameters | ||
bucket
|
string
|
Name of a bucket. |
Request body
In the request body, supply a BucketAccessControls 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:
|
writable |
role
|
string
|
The access permission for the entity. Can be
READER
,
WRITER
, or
OWNER
.
|
writable |
Response
If successful, this method returns a BucketAccessControls resource in the response body.
Examples
Note: The code examples available for this method do not represent all supported programming languages (see the client libraries page for a list of supported languages).
Python
Uses the Python client library .
req = client.bucketAccessControls().insert(
bucket=bucket_name,
body={'entity': 'allAuthenticatedUsers', 'role': 'READER'})
resp = req.execute()
print json.dumps(resp, indent=2)
Try it!
Use the APIs Explorer below to call this method on live data and see the response. Alternatively, try the standalone Explorer .