Retrieves ACL entries on the specified object.
Required permissions
The authenticated user must have one of the following permissions to use this method:
- The
storage.objects.getIamPolicyIAM permission for the bucket containing the object - The
OWNERACL permission for the object
Request
HTTP request
GET https://storage.googleapis.com/storage/v1/b/bucket/o/object/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. |
object | string | Name of the object. For information about how to URL encode object names to be path safe, see Encoding URI path parts. |
| Optional query parameters | ||
generation | 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 objectAccessControls. |
Try it!
Use the APIs Explorer below to call this method on live data and see the response.