Get
|
|||||
|
|
Returns the ACL entry for the specified entity on the specified object
Authorization
To use this building block you will have to grant access to at least one of the following scopes:
- View and manage your data across Google Cloud Platform services
- Manage your data and permissions in Google Cloud Storage
Input
This building block consumes 6 input parameters
Name | Format | Description |
---|---|---|
bucket Required |
STRING |
Name of a bucket |
object Required |
STRING |
Name of the object. For information about how to URL encode object names to be path safe, see Encoding URI Path Parts |
entity Required |
STRING |
The entity holding the permission. Can be user-userId, user-emailAddress, group-groupId, group-emailAddress, allUsers, or allAuthenticatedUsers |
generation |
INTEGER |
If present, selects a specific revision of this object (as opposed to the latest version, the default) |
provisionalUserProject |
STRING |
The project to be billed for this request if the target bucket is requester-pays bucket |
userProject |
STRING |
The project to be billed for this request. Required for Requester Pays buckets |
= Parameter name
= Format
bucket STRING Required Name of a bucket |
object STRING Required Name of the object. For information about how to URL encode object names to be path safe, see Encoding URI Path Parts |
entity STRING Required The entity holding the permission. Can be user-userId, user-emailAddress, group-groupId, group-emailAddress, allUsers, or allAuthenticatedUsers |
generation INTEGER If present, selects a specific revision of this object (as opposed to the latest version, the default) |
provisionalUserProject STRING The project to be billed for this request if the target bucket is requester-pays bucket |
userProject STRING The project to be billed for this request. Required for Requester Pays buckets |
Output
This building block provides 15 output parameters
Name | Format | Description |
---|---|---|
bucket |
STRING |
The name of the bucket |
domain |
STRING |
The domain associated with the entity, if any |
email |
STRING |
The email address associated with the entity, if any |
entity |
STRING |
The entity holding the permission, in one of the following forms:
|
entityId |
STRING |
The ID for the entity, if any |
etag |
STRING |
HTTP 1.1 Entity tag for the access-control entry |
generation |
INTEGER |
The content generation of the object, if applied to an object |
id |
STRING |
The ID of the access-control entry |
kind |
STRING |
The kind of item this is. For object access control entries, this is always storage#objectAccessControl |
object |
STRING |
The name of the object, if applied to an object |
projectTeam |
OBJECT |
The project team associated with the entity, if any |
projectTeam.projectNumber |
STRING |
The project number |
projectTeam.team |
STRING |
The team |
role |
STRING |
The access permission for the entity |
selfLink |
STRING |
The link to this access-control entry |
= Parameter name
= Format
bucket STRING The name of the bucket |
domain STRING The domain associated with the entity, if any |
email STRING The email address associated with the entity, if any |
entity STRING The entity holding the permission, in one of the following forms:
|
entityId STRING The ID for the entity, if any |
etag STRING HTTP 1.1 Entity tag for the access-control entry |
generation INTEGER The content generation of the object, if applied to an object |
id STRING The ID of the access-control entry |
kind STRING The kind of item this is. For object access control entries, this is always storage#objectAccessControl |
object STRING The name of the object, if applied to an object |
projectTeam OBJECT The project team associated with the entity, if any |
projectTeam.projectNumber STRING The project number |
projectTeam.team STRING The team |
role STRING The access permission for the entity |
selfLink STRING The link to this access-control entry |