Put bbucketoobjectaclentity — storage

v1

latestOpenAPI 3.0.0Creative Commons Attribution 3.02026-07-138134216.7 KB

objectAccessControls

Updates an ACL entry on the specified object.

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

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.

entitystring required

The entity holding the permission. Can be user-userId, user-emailAddress, group-groupId, group-emailAddress, allUsers, or allAuthenticatedUsers.

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.

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.

Successful response