Cloud Storage JSON API
  1. defaultObjectAccessControls
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. defaultObjectAccessControls

/b/{bucket}/defaultObjectAcl/{entity}

GET
/b/{bucket}/defaultObjectAcl/{entity}
defaultObjectAccessControls
Returns the default object ACL entry for the specified entity on the specified bucket.
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://storage.googleapis.com/storage/v1beta2/b//defaultObjectAcl/'
Response Response Example
{
    "bucket": "string",
    "domain": "string",
    "email": "string",
    "entity": "string",
    "entityId": "string",
    "etag": "string",
    "generation": "string",
    "id": "string",
    "kind": "storage#objectAccessControl",
    "object": "string",
    "role": "string",
    "selfLink": "string"
}

Request

Path Params
bucket
string 
required
Name of a bucket.
entity
string 
required
The entity holding the permission. Can be user-userId, user-emailAddress, group-groupId, group-emailAddress, allUsers, or allAuthenticatedUsers.

Responses

🟢200Successful response
application/json
Body
An access-control entry.
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.
generation
string <int64>
optional
The content generation of the object.
id
string 
optional
The ID of the access-control entry.
kind
string 
optional
The kind of item this is. For object access control entries, this is always storage#objectAccessControl.
Default:
storage#objectAccessControl
object
string 
optional
The name of the object.
role
string 
optional
The access permission for the entity. Can be READER or OWNER.
selfLink
string 
optional
The link to this access-control entry.
Modified at 2023-08-15 08:12:16
Previous
/b/{bucket}/defaultObjectAcl/{entity}
Next
/b/{bucket}/defaultObjectAcl/{entity}
Built with