ObjectAccessControls: list

Retrieves ACL entries on the specified object .

Important:This method fails with a 400 Bad Request response for buckets with uniform bucket-level access enabled. Use storage.buckets.getIamPolicy and storage.buckets.setIamPolicy to control access instead.

Required permissions

The authenticated user must have one of the following permissions to use this method:

The storage.objects.getIamPolicy IAM permission for the bucket containing the object
The OWNER ACL permission for the object

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.

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).

Do not supply a request body with this method.

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 .

Use the APIs Explorer below to call this method on live data and see the response.