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/{entity}

PUT
/b/{bucket}/acl/{entity}
bucketAccessControls
Updates an ACL entry on the specified bucket.
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request PUT 'https://storage.googleapis.com/storage/v1beta2/b//acl/' \
--header 'Content-Type: application/json' \
--data-raw '{
    "bucket": "string",
    "domain": "string",
    "email": "string",
    "entity": "string",
    "entityId": "string",
    "etag": "string",
    "id": "string",
    "kind": "storage#bucketAccessControl",
    "role": "string",
    "selfLink": "string"
}'
Response Response Example
{
    "bucket": "string",
    "domain": "string",
    "email": "string",
    "entity": "string",
    "entityId": "string",
    "etag": "string",
    "id": "string",
    "kind": "storage#bucketAccessControl",
    "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.
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.
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.
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.
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.
Modified at 2023-08-15 08:12:16
Previous
/b/{bucket}/acl/{entity}
Next
/b/{bucket}/defaultObjectAcl
Built with