object_access_controls

Creates, updates, deletes, gets or lists a object_access_controls resource.

Overview

Name	object_access_controls
Type	Resource
Id	google.storage.object_access_controls

Fields

Name	Datatype	Description
id	string	The ID of the access-control entry.
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:

• 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. | | entityId | string | The ID for the entity, if any. | | etag | string | HTTP 1.1 Entity tag for the access-control entry. | | generation | string | The content generation of the object, if applied to an object. | | 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. | | role | string | The access permission for the entity. | | selfLink | string | The link to this access-control entry. |

Methods

Name	Accessible by	Required Params	Description
get	SELECT	bucket, entity, object	Returns the ACL entry for the specified entity on the specified object.
list	SELECT	bucket, object	Retrieves ACL entries on the specified object.
insert	INSERT	bucket, object	Creates a new ACL entry on the specified object.
delete	DELETE	bucket, entity, object	Permanently deletes the ACL entry for the specified entity on the specified object.
patch	UPDATE	bucket, entity, object	Patches an ACL entry on the specified object.
update	REPLACE	bucket, entity, object	Updates an ACL entry on the specified object.

SELECT examples

Retrieves ACL entries on the specified object.

SELECT
id,
bucket,
domain,
email,
entity,
entityId,
etag,
generation,
kind,
object,
projectTeam,
role,
selfLink
FROM google.storage.object_access_controls
WHERE bucket = '{{ bucket }}'
AND object = '{{ object }}';

INSERT example

Use the following StackQL query and manifest file to create a new object_access_controls resource.

All Properties

/*+ create */
INSERT INTO google.storage.object_access_controls (
bucket,
object,
bucket,
domain,
email,
entity,
entityId,
etag,
generation,
object,
projectTeam,
role
)
SELECT 
'{{ bucket }}',
'{{ object }}',
'{{ bucket }}',
'{{ domain }}',
'{{ email }}',
'{{ entity }}',
'{{ entityId }}',
'{{ etag }}',
'{{ generation }}',
'{{ object }}',
'{{ projectTeam }}',
'{{ role }}'
;

Manifest

- name: your_resource_model_name
  props:
    - name: bucket
      value: string
    - name: domain
      value: string
    - name: email
      value: string
    - name: entity
      value: string
    - name: entityId
      value: string
    - name: etag
      value: string
    - name: generation
      value: string
    - name: id
      value: string
    - name: kind
      value: string
    - name: object
      value: string
    - name: projectTeam
      value:
        - name: projectNumber
          value: string
        - name: team
          value: string
    - name: role
      value: string
    - name: selfLink
      value: string

UPDATE example

Updates a object_access_controls resource.

/*+ update */
UPDATE google.storage.object_access_controls
SET 
bucket = '{{ bucket }}',
domain = '{{ domain }}',
email = '{{ email }}',
entity = '{{ entity }}',
entityId = '{{ entityId }}',
etag = '{{ etag }}',
generation = '{{ generation }}',
object = '{{ object }}',
projectTeam = '{{ projectTeam }}',
role = '{{ role }}'
WHERE 
bucket = '{{ bucket }}'
AND entity = '{{ entity }}'
AND object = '{{ object }}';

REPLACE example

Replaces all fields in the specified object_access_controls resource.

/*+ update */
REPLACE google.storage.object_access_controls
SET 
bucket = '{{ bucket }}',
domain = '{{ domain }}',
email = '{{ email }}',
entity = '{{ entity }}',
entityId = '{{ entityId }}',
etag = '{{ etag }}',
generation = '{{ generation }}',
object = '{{ object }}',
projectTeam = '{{ projectTeam }}',
role = '{{ role }}'
WHERE 
bucket = '{{ bucket }}'
AND entity = '{{ entity }}'
AND object = '{{ object }}';

DELETE example

Deletes the specified object_access_controls resource.

/*+ delete */
DELETE FROM google.storage.object_access_controls
WHERE bucket = '{{ bucket }}'
AND entity = '{{ entity }}'
AND object = '{{ object }}';