revisions

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

Overview

Name	revisions
Type	Resource
Id	google.geminicloudassist.revisions

Fields

The following fields are returned by SELECT queries:

get

Successful response

Name	Datatype	Description
name	string	Identifier. name of resource
createTime	string (google-datetime)	Output only. [Output only] Create time stamp
index	integer (int32)	Output only. Revision index number, in order of creation.
labels	object	Optional. Labels as key value pairs
snapshot	object	Message describing Investigation object Next Id: 24 (id: Investigation)

list

Successful response

Name	Datatype	Description
name	string	Identifier. name of resource
createTime	string (google-datetime)	Output only. [Output only] Create time stamp
index	integer (int32)	Output only. Revision index number, in order of creation.
labels	object	Optional. Labels as key value pairs
snapshot	object	Message describing Investigation object Next Id: 24 (id: Investigation)

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
get	select	projectsId, locationsId, investigationsId, revisionsId		Gets details of a single revision of an Investigation.
list	select	projectsId, locationsId, investigationsId	pageSize, pageToken	Lists Investigations in a given project and location.
create	insert	projectsId, locationsId, investigationsId	investigationRevisionId, requestId	Creates a new revision of a given Investigation.
patch	update	projectsId, locationsId, investigationsId, revisionsId	updateMask, requestId	Updates the parameters of a single Investigation.
delete	delete	projectsId, locationsId, investigationsId, revisionsId	requestId	Deletes a single revision of an Investigation. Fails if the revision is the investigation's active revision.
run	exec	projectsId, locationsId, investigationsId, revisionsId		Run an existing revision of an investigation.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

Name	Datatype	Description
investigationsId	string
locationsId	string
projectsId	string
revisionsId	string
investigationRevisionId	string
pageSize	integer (int32)
pageToken	string
requestId	string
updateMask	string (google-fieldmask)

SELECT examples

get

Gets details of a single revision of an Investigation.

SELECT
name,
createTime,
index,
labels,
snapshot
FROM google.geminicloudassist.revisions
WHERE projectsId = '{{ projectsId }}' -- required
AND locationsId = '{{ locationsId }}' -- required
AND investigationsId = '{{ investigationsId }}' -- required
AND revisionsId = '{{ revisionsId }}' -- required;

list

Lists Investigations in a given project and location.

SELECT
name,
createTime,
index,
labels,
snapshot
FROM google.geminicloudassist.revisions
WHERE projectsId = '{{ projectsId }}' -- required
AND locationsId = '{{ locationsId }}' -- required
AND investigationsId = '{{ investigationsId }}' -- required
AND pageSize = '{{ pageSize }}'
AND pageToken = '{{ pageToken }}';

INSERT examples

create

Creates a new revision of a given Investigation.

INSERT INTO google.geminicloudassist.revisions (
data__name,
data__snapshot,
data__labels,
projectsId,
locationsId,
investigationsId,
investigationRevisionId,
requestId
)
SELECT 
'{{ name }}',
'{{ snapshot }}',
'{{ labels }}',
'{{ projectsId }}',
'{{ locationsId }}',
'{{ investigationsId }}',
'{{ investigationRevisionId }}',
'{{ requestId }}'
RETURNING
name,
createTime,
index,
labels,
snapshot
;

Manifest

# Description fields are for documentation purposes
- name: revisions
  props:
    - name: projectsId
      value: string
      description: Required parameter for the revisions resource.
    - name: locationsId
      value: string
      description: Required parameter for the revisions resource.
    - name: investigationsId
      value: string
      description: Required parameter for the revisions resource.
    - name: name
      value: string
      description: >
        Identifier. name of resource
        
    - name: snapshot
      value: object
      description: >
        Message describing Investigation object Next Id: 24
        
    - name: labels
      value: object
      description: >
        Optional. Labels as key value pairs
        
    - name: investigationRevisionId
      value: string
    - name: requestId
      value: string

UPDATE examples

patch

Updates the parameters of a single Investigation.

UPDATE google.geminicloudassist.revisions
SET 
data__name = '{{ name }}',
data__snapshot = '{{ snapshot }}',
data__labels = '{{ labels }}'
WHERE 
projectsId = '{{ projectsId }}' --required
AND locationsId = '{{ locationsId }}' --required
AND investigationsId = '{{ investigationsId }}' --required
AND revisionsId = '{{ revisionsId }}' --required
AND updateMask = '{{ updateMask}}'
AND requestId = '{{ requestId}}'
RETURNING
name,
createTime,
index,
labels,
snapshot;

DELETE examples

delete

Deletes a single revision of an Investigation. Fails if the revision is the investigation's active revision.

DELETE FROM google.geminicloudassist.revisions
WHERE projectsId = '{{ projectsId }}' --required
AND locationsId = '{{ locationsId }}' --required
AND investigationsId = '{{ investigationsId }}' --required
AND revisionsId = '{{ revisionsId }}' --required
AND requestId = '{{ requestId }}';

Lifecycle Methods

run

Run an existing revision of an investigation.

EXEC google.geminicloudassist.revisions.run 
@projectsId='{{ projectsId }}' --required, 
@locationsId='{{ locationsId }}' --required, 
@investigationsId='{{ investigationsId }}' --required, 
@revisionsId='{{ revisionsId }}' --required 
@@json=
'{
"runParameters": "{{ runParameters }}", 
"updatedRevision": "{{ updatedRevision }}", 
"updateMask": "{{ updateMask }}"
}';