workflows_revisions

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

Overview

Name	workflows_revisions
Type	Resource
Id	google.workflows.workflows_revisions

Fields

The following fields are returned by SELECT queries:

list_revisions

Successful response

Name	Datatype	Description
name	string	The resource name of the workflow. Format: projects/{project}/locations/{location}/workflows/{workflow}. This is a workflow-wide field and is not tied to a specific revision.
allKmsKeys	array	Output only. A list of all KMS crypto keys used to encrypt or decrypt the data associated with the workflow.
allKmsKeysVersions	array	Output only. A list of all KMS crypto key versions used to encrypt or decrypt the data associated with the workflow.
callLogLevel	string	Optional. Describes the level of platform logging to apply to calls and call responses during executions of this workflow. If both the workflow and the execution specify a logging level, the execution level takes precedence.
createTime	string (google-datetime)	Output only. The timestamp for when the workflow was created. This is a workflow-wide field and is not tied to a specific revision.
cryptoKeyName	string	Optional. The resource name of a KMS crypto key used to encrypt or decrypt the data associated with the workflow. Format: projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{cryptoKey} Using - as a wildcard for the {project} or not providing one at all will infer the project from the account. If not provided, data associated with the workflow will not be CMEK-encrypted.
cryptoKeyVersion	string	Output only. The resource name of a KMS crypto key version used to encrypt or decrypt the data associated with the workflow. Format: projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{cryptoKey}/cryptoKeyVersions/{cryptoKeyVersion}
description	string	Description of the workflow provided by the user. Must be at most 1000 Unicode characters long. This is a workflow-wide field and is not tied to a specific revision.
executionHistoryLevel	string	Optional. Describes the execution history level to apply to this workflow.
labels	object	Labels associated with this workflow. Labels can contain at most 64 entries. Keys and values can be no longer than 63 characters and can only contain lowercase letters, numeric characters, underscores, and dashes. Label keys must start with a letter. International characters are allowed. This is a workflow-wide field and is not tied to a specific revision.
revisionCreateTime	string (google-datetime)	Output only. The timestamp for the latest revision of the workflow's creation.
revisionId	string	Output only. The revision of the workflow. A new revision of a workflow is created as a result of updating the following properties of a workflow: - Service account - Workflow code to be executed The format is "000001-a4d", where the first six characters define the zero-padded revision ordinal number. They are followed by a hyphen and three hexadecimal random characters.
serviceAccount	string	The service account associated with the latest workflow version. This service account represents the identity of the workflow and determines what permissions the workflow has. Format: projects/{project}/serviceAccounts/{account} or {account} Using - as a wildcard for the {project} or not providing one at all will infer the project from the account. The {account} value can be the email address or the unique_id of the service account. If not provided, workflow will use the project's default service account. Modifying this field for an existing workflow results in a new workflow revision.
sourceContents	string	Workflow code to be executed. The size limit is 128KB.
state	string	Output only. State of the workflow deployment.
stateError	object	Output only. Error regarding the state of the workflow. For example, this field will have error details if the execution data is unavailable due to revoked KMS key permissions. (id: StateError)
tags	object	Optional. Input only. Immutable. Tags associated with this workflow.
updateTime	string (google-datetime)	Output only. The timestamp for when the workflow was last updated. This is a workflow-wide field and is not tied to a specific revision.
userEnvVars	object	Optional. User-defined environment variables associated with this workflow revision. This map has a maximum length of 20. Each string can take up to 4KiB. Keys cannot be empty strings and cannot start with "GOOGLE" or "WORKFLOWS".

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
list_revisions	select	projectsId, locationsId, workflowsId	pageSize, pageToken	Lists revisions for a given workflow.

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
locationsId	string
projectsId	string
workflowsId	string
pageSize	integer (int32)
pageToken	string

SELECT examples

list_revisions

Lists revisions for a given workflow.

SELECT
name,
allKmsKeys,
allKmsKeysVersions,
callLogLevel,
createTime,
cryptoKeyName,
cryptoKeyVersion,
description,
executionHistoryLevel,
labels,
revisionCreateTime,
revisionId,
serviceAccount,
sourceContents,
state,
stateError,
tags,
updateTime,
userEnvVars
FROM google.workflows.workflows_revisions
WHERE projectsId = '{{ projectsId }}' -- required
AND locationsId = '{{ locationsId }}' -- required
AND workflowsId = '{{ workflowsId }}' -- required
AND pageSize = '{{ pageSize }}'
AND pageToken = '{{ pageToken }}';