Hide
Google Cloud Storage

ObjectAccessControls: list

Retrieves ACL entries on the specified object. Try it now or see an example.

Request

HTTP request

GET https://www.googleapis.com/storage/v1/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 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.