Cloud Storage JSON API
  1. objectAccessControls
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
      GET
    • /b/{bucket}/o/{object}/acl
      POST
    • /b/{bucket}/o/{object}/acl/{entity}
      DELETE
    • /b/{bucket}/o/{object}/acl/{entity}
      GET
    • /b/{bucket}/o/{object}/acl/{entity}
      PATCH
    • /b/{bucket}/o/{object}/acl/{entity}
      PUT
  • channels
    • /channels/stop
  1. objectAccessControls

/b/{bucket}/o/{object}/acl/{entity}

PUT
/b/{bucket}/o/{object}/acl/{entity}
objectAccessControls
Updates an ACL entry on the specified object.
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request PUT 'https://storage.googleapis.com/storage/v1beta2/b//o//acl/' \
--header 'Content-Type: application/json' \
--data-raw '{
    "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"
}'
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.
object
string 
required
Name of the object.
entity
string 
required
The entity holding the permission. Can be user-userId, user-emailAddress, group-groupId, group-emailAddress, allUsers, or allAuthenticatedUsers.
Query Params
generation
string 
optional
If present, selects a specific revision of this object (as opposed to the latest version, the default).
Body Params application/json
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.
Examples

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}/o/{object}/acl/{entity}
Next
/channels/stop
Built with