Sign in

v1

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

Creates a new ACL entry on the specified object.

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

Path parameters

bucketstring required

Name of a bucket.

objectstring required

Name of the object. For information about how to URL encode object names to be path safe, see Encoding URI Path Parts.

Query parameters

generationstring

If present, selects a specific revision of this object (as opposed to the latest version, the default).

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.

generationstring int64

The content generation of the object, if applied to an object.

idstring

The ID of the access-control entry.

kindstring

The kind of item this is. For object access control entries, this is always storage#objectAccessControl.

objectstring

The name of the object, if applied to an object.

rolestring

The access permission for the entity.

selfLinkstring

The link to this access-control entry.

Response

Successful response