Retrieves ACL entries on the specified object . Try it now or see an example .
The invoking user must have
FULL_CONTROL
of the object to use this method.
Request
HTTP request
GET https://www.googleapis.com/storage/v1beta2/b/bucket/o/object/acl
Parameters
| Parameter name | Value | Description |
|---|---|---|
| Path parameters | ||
bucket
|
string
|
Name of a bucket. |
object
|
string
|
Name of the object. |
| Optional query parameters | ||
generation
|
unsigned long
|
If present, selects a specific revision of this object (as opposed to the latest version, the default). |
Request body
Do not supply a request body with this method.
Response
If successful, this method returns a response body with the following structure:
{
"kind": "storage#objectAccessControls",
"items": [
objectAccessControls Resource
]
}
| Property name | Value | Description | Notes |
|---|---|---|---|
kind
|
string
|
The kind of item this is. For lists of object access control entries, this is always
storage#objectAccessControls
.
|
|
items[]
|
list
|
The list of items. |
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.objectAccessControls().list(
bucket=bucket_name,
object=object_name,
fields='items(id,role)') # optional
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 .