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	Optional. Snapshot of the investigation contents at this revision. (id: Investigation)

list

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	Optional. Snapshot of the investigation contents at this revision. (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.
create	insert	projectsId, locationsId, investigationsId	investigationRevisionId, requestId	Deprecated: Investigations should only be modified by the agent. 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.
modify	exec	projectsId, locationsId, investigationsId, revisionsId		Deprecated: Investigations should only be modified by the agent. Modifies an existing investigation revision in place. This is intended for use by callers that are modifying as part of an investigation session, and do not want to create a new revision. Other callers should use UpdateInvestigation, which will create a new revision if the investigation is RUNNING.
run	exec	projectsId, locationsId, investigationsId, revisionsId		Deprecated: Investigations should only be run by the agent. 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
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

Deprecated: Investigations should only be modified by the agent. Creates a new revision of a given Investigation.

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

Manifest

# Description fields are for documentation purposes
- name: revisions
props:
  - name: projectsId
    value: "{{ projectsId }}"
    description: Required parameter for the revisions resource.
  - name: locationsId
    value: "{{ locationsId }}"
    description: Required parameter for the revisions resource.
  - name: investigationsId
    value: "{{ investigationsId }}"
    description: Required parameter for the revisions resource.
  - name: labels
    value: "{{ labels }}"
    description: |
      Optional. User-defined labels for the revision.
  - name: name
    value: "{{ name }}"
    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
    description: |
      Optional. Snapshot of the investigation contents at this revision.
    value:
      annotations:
        extrasMap: "{{ extrasMap }}"
        pagePath: "{{ pagePath }}"
        revisionLastRunInterval:
          endTime: "{{ endTime }}"
          startTime: "{{ startTime }}"
        supportCase: "{{ supportCase }}"
      createTime: "{{ createTime }}"
      error:
        code: {{ code }}
        details: "{{ details }}"
        message: "{{ message }}"
      executionState: "{{ executionState }}"
      labels: "{{ labels }}"
      name: "{{ name }}"
      observations: "{{ observations }}"
      observerStatuses: "{{ observerStatuses }}"
      operation: "{{ operation }}"
      revision: "{{ revision }}"
      revisionIndex: {{ revisionIndex }}
      revisionPredecessor: "{{ revisionPredecessor }}"
      title: "{{ title }}"
      updateTime: "{{ updateTime }}"
  - name: investigationRevisionId
    value: "{{ investigationRevisionId }}"
  - name: requestId
    value: "{{ requestId }}"

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

modify

Deprecated: Investigations should only be modified by the agent. Modifies an existing investigation revision in place. This is intended for use by callers that are modifying as part of an investigation session, and do not want to create a new revision. Other callers should use UpdateInvestigation, which will create a new revision if the investigation is RUNNING.

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

run

Deprecated: Investigations should only be run by the agent. 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 }}"
}'
;