BucketAccessControls: insert
Stay organized with collections
Save and categorize content based on your preferences.
Creates a new ACL entry on the specified
bucket.
Required permissions
The authenticated user must have the following IAM permissions on the bucket to
use this method:
storage.buckets.get
storage.buckets.getIamPolicy
storage.buckets.setIamPolicy
storage.buckets.update
As an alternative to having IAM permissions, the authenticated user can use this
method by having the OWNER
ACL permission for the bucket.
Request
HTTP request
POST https://storage.googleapis.com/storage/v1/b/bucket/acl
In addition to standard query parameters,
the following query parameters apply to this method.
To see an example of how to include query parameters in a request, see the
JSON API Overview page.
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:
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 domain
example.com ,
the entity would be domain-example.com .
|
writable
|
role |
string |
The access permission for the entity.
Acceptable values are:
- "
OWNER "
- "
READER "
- "
WRITER "
|
writable
|
Try it!
Use the APIs Explorer below to call this method on live data and see the response.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2024-09-18 UTC.
[{
"type": "thumb-down",
"id": "hardToUnderstand",
"label":"Hard to understand"
},{
"type": "thumb-down",
"id": "incorrectInformationOrSampleCode",
"label":"Incorrect information or sample code"
},{
"type": "thumb-down",
"id": "missingTheInformationSamplesINeed",
"label":"Missing the information/samples I need"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"Other"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"Easy to understand"
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"Solved my problem"
},{
"type": "thumb-up",
"id": "otherUp",
"label":"Other"
}]
{"lastModified": "Last updated 2024-09-18 UTC."}