executions

Creates, updates, deletes, gets or lists an executions resource.

Overview

Name	executions
Type	Resource
Id	google.run.executions

Fields

The following fields are returned by SELECT queries:

get

Successful response

Name	Datatype	Description
name	string	Output only. The unique name of this Execution.
annotations	object	Output only. Unstructured key value map that may be set by external tools to store and arbitrary metadata. They are not queryable and should be preserved when modifying objects.
cancelledCount	integer (int32)	Output only. The number of tasks which reached phase Cancelled.
completionTime	string (google-datetime)	Output only. Represents time when the execution was completed. It is not guaranteed to be set in happens-before order across separate operations.
conditions	array	Output only. The Condition of this Execution, containing its readiness status, and detailed error information in case it did not reach the desired state.
createTime	string (google-datetime)	Output only. Represents time when the execution was acknowledged by the execution controller. It is not guaranteed to be set in happens-before order across separate operations.
creator	string	Output only. Email address of the authenticated creator.
deleteTime	string (google-datetime)	Output only. For a deleted resource, the deletion time. It is only populated as a response to a Delete request.
etag	string	Output only. A system-generated fingerprint for this version of the resource. May be used to detect modification conflict during updates.
expireTime	string (google-datetime)	Output only. For a deleted resource, the time after which it will be permamently deleted. It is only populated as a response to a Delete request.
failedCount	integer (int32)	Output only. The number of tasks which reached phase Failed.
generation	string (int64)	Output only. A number that monotonically increases every time the user modifies the desired state.
job	string	Output only. The name of the parent Job.
labels	object	Output only. Unstructured key value map that can be used to organize and categorize objects. User-provided labels are shared with Google's billing system, so they can be used to filter, or break down billing charges by team, component, environment, state, etc. For more information, visit https://cloud.google.com/resource-manager/docs/creating-managing-labels or https://cloud.google.com/run/docs/configuring/labels
launchStage	string	The least stable launch stage needed to create this resource, as defined by Google Cloud Platform Launch Stages. Cloud Run supports ALPHA, BETA, and GA. Note that this value might not be what was used as input. For example, if ALPHA was provided as input in the parent resource, but only BETA and GA-level features are were, this field will be BETA.
logUri	string	Output only. URI where logs for this execution can be found in Cloud Console.
observedGeneration	string (int64)	Output only. The generation of this Execution. See comments in reconciling for additional information on reconciliation process in Cloud Run.
parallelism	integer (int32)	Output only. Specifies the maximum desired number of tasks the execution should run at any given time. Must be <= task_count. The actual number of tasks running in steady state will be less than this number when ((.spec.task_count - .status.successful) < .spec.parallelism), i.e. when the work left to do is less than max parallelism.
reconciling	boolean	Output only. Indicates whether the resource's reconciliation is still in progress. See comments in Job.reconciling for additional information on reconciliation process in Cloud Run.
retriedCount	integer (int32)	Output only. The number of tasks which have retried at least once.
runningCount	integer (int32)	Output only. The number of actively running tasks.
satisfiesPzs	boolean	Output only. Reserved for future use.
startTime	string (google-datetime)	Output only. Represents time when the execution started to run. It is not guaranteed to be set in happens-before order across separate operations.
succeededCount	integer (int32)	Output only. The number of tasks which reached phase Succeeded.
taskCount	integer (int32)	Output only. Specifies the desired number of tasks the execution should run. Setting to 1 means that parallelism is limited to 1 and the success of that task signals the success of the execution.
template	object	Output only. The template used to create tasks for this execution. (id: GoogleCloudRunV2TaskTemplate)
uid	string	Output only. Server assigned unique identifier for the Execution. The value is a UUID4 string and guaranteed to remain unchanged until the resource is deleted.
updateTime	string (google-datetime)	Output only. The last-modified time.

list

Successful response

Name	Datatype	Description
name	string	Output only. The unique name of this Execution.
annotations	object	Output only. Unstructured key value map that may be set by external tools to store and arbitrary metadata. They are not queryable and should be preserved when modifying objects.
cancelledCount	integer (int32)	Output only. The number of tasks which reached phase Cancelled.
completionTime	string (google-datetime)	Output only. Represents time when the execution was completed. It is not guaranteed to be set in happens-before order across separate operations.
conditions	array	Output only. The Condition of this Execution, containing its readiness status, and detailed error information in case it did not reach the desired state.
createTime	string (google-datetime)	Output only. Represents time when the execution was acknowledged by the execution controller. It is not guaranteed to be set in happens-before order across separate operations.
creator	string	Output only. Email address of the authenticated creator.
deleteTime	string (google-datetime)	Output only. For a deleted resource, the deletion time. It is only populated as a response to a Delete request.
etag	string	Output only. A system-generated fingerprint for this version of the resource. May be used to detect modification conflict during updates.
expireTime	string (google-datetime)	Output only. For a deleted resource, the time after which it will be permamently deleted. It is only populated as a response to a Delete request.
failedCount	integer (int32)	Output only. The number of tasks which reached phase Failed.
generation	string (int64)	Output only. A number that monotonically increases every time the user modifies the desired state.
job	string	Output only. The name of the parent Job.
labels	object	Output only. Unstructured key value map that can be used to organize and categorize objects. User-provided labels are shared with Google's billing system, so they can be used to filter, or break down billing charges by team, component, environment, state, etc. For more information, visit https://cloud.google.com/resource-manager/docs/creating-managing-labels or https://cloud.google.com/run/docs/configuring/labels
launchStage	string	The least stable launch stage needed to create this resource, as defined by Google Cloud Platform Launch Stages. Cloud Run supports ALPHA, BETA, and GA. Note that this value might not be what was used as input. For example, if ALPHA was provided as input in the parent resource, but only BETA and GA-level features are were, this field will be BETA.
logUri	string	Output only. URI where logs for this execution can be found in Cloud Console.
observedGeneration	string (int64)	Output only. The generation of this Execution. See comments in reconciling for additional information on reconciliation process in Cloud Run.
parallelism	integer (int32)	Output only. Specifies the maximum desired number of tasks the execution should run at any given time. Must be <= task_count. The actual number of tasks running in steady state will be less than this number when ((.spec.task_count - .status.successful) < .spec.parallelism), i.e. when the work left to do is less than max parallelism.
reconciling	boolean	Output only. Indicates whether the resource's reconciliation is still in progress. See comments in Job.reconciling for additional information on reconciliation process in Cloud Run.
retriedCount	integer (int32)	Output only. The number of tasks which have retried at least once.
runningCount	integer (int32)	Output only. The number of actively running tasks.
satisfiesPzs	boolean	Output only. Reserved for future use.
startTime	string (google-datetime)	Output only. Represents time when the execution started to run. It is not guaranteed to be set in happens-before order across separate operations.
succeededCount	integer (int32)	Output only. The number of tasks which reached phase Succeeded.
taskCount	integer (int32)	Output only. Specifies the desired number of tasks the execution should run. Setting to 1 means that parallelism is limited to 1 and the success of that task signals the success of the execution.
template	object	Output only. The template used to create tasks for this execution. (id: GoogleCloudRunV2TaskTemplate)
uid	string	Output only. Server assigned unique identifier for the Execution. The value is a UUID4 string and guaranteed to remain unchanged until the resource is deleted.
updateTime	string (google-datetime)	Output only. The last-modified time.

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
get	select	projectsId, locationsId, jobsId, executionsId		Gets information about an Execution.
list	select	projectsId, locationsId, jobsId	pageSize, pageToken, showDeleted	Lists Executions from a Job. Results are sorted by creation time, descending.
delete	delete	projectsId, locationsId, jobsId, executionsId	validateOnly, etag	Deletes an Execution.
export_status	exec	projectsId, locationsId, jobsId, executionsId, executionsId1		Read the status of an image export operation.
cancel	exec	projectsId, locationsId, jobsId, executionsId		Cancels an Execution.

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
executionsId	string
executionsId1	string
jobsId	string
locationsId	string
projectsId	string
etag	string
pageSize	integer (int32)
pageToken	string
showDeleted	boolean
validateOnly	boolean

SELECT examples

get

Gets information about an Execution.

SELECT
name,
annotations,
cancelledCount,
completionTime,
conditions,
createTime,
creator,
deleteTime,
etag,
expireTime,
failedCount,
generation,
job,
labels,
launchStage,
logUri,
observedGeneration,
parallelism,
reconciling,
retriedCount,
runningCount,
satisfiesPzs,
startTime,
succeededCount,
taskCount,
template,
uid,
updateTime
FROM google.run.executions
WHERE projectsId = '{{ projectsId }}' -- required
AND locationsId = '{{ locationsId }}' -- required
AND jobsId = '{{ jobsId }}' -- required
AND executionsId = '{{ executionsId }}' -- required;

list

Lists Executions from a Job. Results are sorted by creation time, descending.

SELECT
name,
annotations,
cancelledCount,
completionTime,
conditions,
createTime,
creator,
deleteTime,
etag,
expireTime,
failedCount,
generation,
job,
labels,
launchStage,
logUri,
observedGeneration,
parallelism,
reconciling,
retriedCount,
runningCount,
satisfiesPzs,
startTime,
succeededCount,
taskCount,
template,
uid,
updateTime
FROM google.run.executions
WHERE projectsId = '{{ projectsId }}' -- required
AND locationsId = '{{ locationsId }}' -- required
AND jobsId = '{{ jobsId }}' -- required
AND pageSize = '{{ pageSize }}'
AND pageToken = '{{ pageToken }}'
AND showDeleted = '{{ showDeleted }}';

DELETE examples

delete

Deletes an Execution.

DELETE FROM google.run.executions
WHERE projectsId = '{{ projectsId }}' --required
AND locationsId = '{{ locationsId }}' --required
AND jobsId = '{{ jobsId }}' --required
AND executionsId = '{{ executionsId }}' --required
AND validateOnly = '{{ validateOnly }}'
AND etag = '{{ etag }}';

Lifecycle Methods

export_status

Read the status of an image export operation.

EXEC google.run.executions.export_status 
@projectsId='{{ projectsId }}' --required, 
@locationsId='{{ locationsId }}' --required, 
@jobsId='{{ jobsId }}' --required, 
@executionsId='{{ executionsId }}' --required, 
@executionsId1='{{ executionsId1 }}' --required;

cancel

Cancels an Execution.

EXEC google.run.executions.cancel 
@projectsId='{{ projectsId }}' --required, 
@locationsId='{{ locationsId }}' --required, 
@jobsId='{{ jobsId }}' --required, 
@executionsId='{{ executionsId }}' --required 
@@json=
'{
"validateOnly": {{ validateOnly }}, 
"etag": "{{ etag }}"
}';