Cloud Storage JSON API
  1. bucketAccessControls
Cloud Storage JSON API
  • buckets
    • /b
      GET
    • /b
      POST
    • /b/{bucket}
      DELETE
    • /b/{bucket}
      GET
    • /b/{bucket}
      PATCH
    • /b/{bucket}
      PUT
  • bucketAccessControls
    • /b/{bucket}/acl
      GET
    • /b/{bucket}/acl
      POST
    • /b/{bucket}/acl/{entity}
      DELETE
    • /b/{bucket}/acl/{entity}
      GET
    • /b/{bucket}/acl/{entity}
      PATCH
    • /b/{bucket}/acl/{entity}
      PUT
  • defaultObjectAccessControls
    • /b/{bucket}/defaultObjectAcl
      GET
    • /b/{bucket}/defaultObjectAcl
      POST
    • /b/{bucket}/defaultObjectAcl/{entity}
      DELETE
    • /b/{bucket}/defaultObjectAcl/{entity}
      GET
    • /b/{bucket}/defaultObjectAcl/{entity}
      PATCH
    • /b/{bucket}/defaultObjectAcl/{entity}
      PUT
  • objects
    • /b/{bucket}/o
      GET
    • /b/{bucket}/o
      POST
    • /b/{bucket}/o/watch
      POST
    • /b/{bucket}/o/{object}
      DELETE
    • /b/{bucket}/o/{object}
      GET
    • /b/{bucket}/o/{object}
      PATCH
    • /b/{bucket}/o/{object}
      PUT
    • /b/{destinationBucket}/o/{destinationObject}/compose
      POST
    • /b/{sourceBucket}/o/{sourceObject}/copyTo/b/{destinationBucket}/o/{destinationObject}
      POST
  • objectAccessControls
    • /b/{bucket}/o/{object}/acl
    • /b/{bucket}/o/{object}/acl
    • /b/{bucket}/o/{object}/acl/{entity}
    • /b/{bucket}/o/{object}/acl/{entity}
    • /b/{bucket}/o/{object}/acl/{entity}
    • /b/{bucket}/o/{object}/acl/{entity}
  • channels
    • /channels/stop
  1. bucketAccessControls

/b/{bucket}/acl

GET
/b/{bucket}/acl
bucketAccessControls
Retrieves ACL entries on the specified bucket.
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://storage.googleapis.com/storage/v1beta2/b//acl'
Response Response Example
{
    "items": [
        {
            "bucket": "string",
            "domain": "string",
            "email": "string",
            "entity": "string",
            "entityId": "string",
            "etag": "string",
            "id": "string",
            "kind": "storage#bucketAccessControl",
            "role": "string",
            "selfLink": "string"
        }
    ],
    "kind": "storage#bucketAccessControls"
}

Request

Path Params
bucket
string 
required
Name of a bucket.

Responses

🟢200Successful response
application/json
Body
An access-control list.
items
array[object (BucketAccessControl) {10}] 
optional
The list of items.
bucket
string 
optional
The name of the bucket.
domain
string 
optional
The domain associated with the entity, if any.
email
string 
optional
The email address associated with the entity, if any.
entity
string 
optional
The entity holding the permission, in one of the following forms:
user-userId
user-email
group-groupId
group-email
domain-domain
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 Google Apps for Business domain example.com, the entity would be domain-example.com.
entityId
string 
optional
The ID for the entity, if any.
etag
string 
optional
HTTP 1.1 Entity tag for the access-control entry.
id
string 
optional
The ID of the access-control entry.
kind
string 
optional
The kind of item this is. For bucket access control entries, this is always storage#bucketAccessControl.
Default:
storage#bucketAccessControl
role
string 
optional
The access permission for the entity. Can be READER, WRITER, or OWNER.
selfLink
string 
optional
The link to this access-control entry.
kind
string 
optional
The kind of item this is. For lists of bucket access control entries, this is always storage#bucketAccessControls.
Default:
storage#bucketAccessControls
Modified at 2023-08-15 08:12:16
Previous
/b/{bucket}
Next
/b/{bucket}/acl
Built with