Sign in

v1

latestOpenAPI 3.0.0Creative Commons Attribution 3.02026-07-138134216.7 KB
bucketAccessControls

Creates a new ACL entry on the specified bucket.

post/b/{bucket}/acl

Path parameters

bucketstring required

Name of a bucket.

Query parameters

userProjectstring

The project to be billed for this request. Required for Requester Pays buckets.

Request body

bucketstring

The name of the bucket.

domainstring

The domain associated with the entity, if any.

emailstring

The email address associated with the entity, if any.

entitystring

The entity holding the permission, in one of the following forms:

  • user-userId
  • user-email
  • group-groupId
  • group-email
  • domain-domain
  • project-team-projectId
  • 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.
entityIdstring

The ID for the entity, if any.

etagstring

HTTP 1.1 Entity tag for the access-control entry.

idstring

The ID of the access-control entry.

kindstring

The kind of item this is. For bucket access control entries, this is always storage#bucketAccessControl.

rolestring

The access permission for the entity.

selfLinkstring

The link to this access-control entry.

Response

Successful response