List
|
|||||
|
|
||||
Retrieves default object ACL entries on the specified bucket
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 5 input parameters
| Name | Format | Description |
|---|---|---|
bucket Required |
STRING |
Name of a bucket |
ifMetagenerationMatch |
INTEGER |
If present, only return default ACL listing if the bucket's current metageneration matches this value |
ifMetagenerationNotMatch |
INTEGER |
If present, only return default ACL listing if the bucket's current metageneration does not match the given value |
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 |
|
ifMetagenerationMatch INTEGER If present, only return default ACL listing if the bucket's current metageneration matches this value |
|
ifMetagenerationNotMatch INTEGER If present, only return default ACL listing if the bucket's current metageneration does not match the given value |
|
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 17 output parameters
| Name | Format | Description |
|---|---|---|
items[] |
OBJECT |
An access-control entry |
items[].bucket |
STRING |
The name of the bucket |
items[].domain |
STRING |
The domain associated with the entity, if any |
items[].email |
STRING |
The email address associated with the entity, if any |
items[].entity |
STRING |
The entity holding the permission, in one of the following forms:
|
items[].entityId |
STRING |
The ID for the entity, if any |
items[].etag |
STRING |
HTTP 1.1 Entity tag for the access-control entry |
items[].generation |
INTEGER |
The content generation of the object, if applied to an object |
items[].id |
STRING |
The ID of the access-control entry |
items[].kind |
STRING |
The kind of item this is. For object access control entries, this is always storage#objectAccessControl |
items[].object |
STRING |
The name of the object, if applied to an object |
items[].projectTeam |
OBJECT |
The project team associated with the entity, if any |
items[].projectTeam.projectNumber |
STRING |
The project number |
items[].projectTeam.team |
STRING |
The team |
items[].role |
STRING |
The access permission for the entity |
items[].selfLink |
STRING |
The link to this access-control entry |
kind |
STRING |
The kind of item this is. For lists of object access control entries, this is always storage#objectAccessControls |
= Parameter name
= Format
|
items[] OBJECT An access-control entry |
|
items[].bucket STRING The name of the bucket |
|
items[].domain STRING The domain associated with the entity, if any |
|
items[].email STRING The email address associated with the entity, if any |
|
items[].entity STRING The entity holding the permission, in one of the following forms:
|
|
items[].entityId STRING The ID for the entity, if any |
|
items[].etag STRING HTTP 1.1 Entity tag for the access-control entry |
|
items[].generation INTEGER The content generation of the object, if applied to an object |
|
items[].id STRING The ID of the access-control entry |
|
items[].kind STRING The kind of item this is. For object access control entries, this is always storage#objectAccessControl |
|
items[].object STRING The name of the object, if applied to an object |
|
items[].projectTeam OBJECT The project team associated with the entity, if any |
|
items[].projectTeam.projectNumber STRING The project number |
|
items[].projectTeam.team STRING The team |
|
items[].role STRING The access permission for the entity |
|
items[].selfLink STRING The link to this access-control entry |
|
kind STRING The kind of item this is. For lists of object access control entries, this is always storage#objectAccessControls |