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

Name	Datatype	Description
name	string	Identifier. The name of the revision resource, of the form: projects/{project_number}/locations/{location_id}/investigations/{investigation_id}/revisions/{revision_id}
createTime	string (google-datetime)	Output only. The time when the revision was created.
index	integer (int32)	Output only. Revision index number, in order of creation.
labels	object	Optional. User-defined labels for the revision.
snapshot	object	Holds the contents of a Gemini Cloud Assist Troubleshooting investigation. (id: Investigation)

list

Name	Datatype	Description

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.
create	insert	projectsId, locationsId, investigationsId	requestId, investigationRevisionId	Creates a new revision of a given Investigation.
delete	delete	projectsId, locationsId, investigationsId, revisionsId	requestId	Deletes a single revision of an Investigation. Fails if the revision is the investigation's most recent 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

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.

SELECT
*
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,
requestId,
investigationRevisionId
)
SELECT 
'{{ name }}',
'{{ snapshot }}',
'{{ labels }}',
'{{ projectsId }}',
'{{ locationsId }}',
'{{ investigationsId }}',
'{{ requestId }}',
'{{ investigationRevisionId }}'
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. The name of the revision resource, of the form: projects/{project_number}/locations/{location_id}/investigations/{investigation_id}/revisions/{revision_id}
        
    - name: snapshot
      value: object
      description: >
        Holds the contents of a Gemini Cloud Assist Troubleshooting investigation.
        
    - name: labels
      value: object
      description: >
        Optional. User-defined labels for the revision.
        
    - name: requestId
      value: string
    - name: investigationRevisionId
      value: string

DELETE examples

delete

Deletes a single revision of an Investigation. Fails if the revision is the investigation's most recent 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 }}"
}'
;