Skip to main content

executions

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

Overview

Nameexecutions
TypeResource
Idgoogle.run.executions

Fields

NameDatatypeDescription
namestringOutput only. The unique name of this Execution.
annotationsobjectOutput 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.
cancelledCountintegerOutput only. The number of tasks which reached phase Cancelled.
completionTimestringOutput only. Represents time when the execution was completed. It is not guaranteed to be set in happens-before order across separate operations.
conditionsarrayOutput only. The Condition of this Execution, containing its readiness status, and detailed error information in case it did not reach the desired state.
createTimestringOutput 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.
deleteTimestringOutput only. For a deleted resource, the deletion time. It is only populated as a response to a Delete request.
etagstringOutput only. A system-generated fingerprint for this version of the resource. May be used to detect modification conflict during updates.
expireTimestringOutput 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.
failedCountintegerOutput only. The number of tasks which reached phase Failed.
generationstringOutput only. A number that monotonically increases every time the user modifies the desired state.
jobstringOutput only. The name of the parent Job.
labelsobjectOutput 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
launchStagestringThe 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.
logUristringOutput only. URI where logs for this execution can be found in Cloud Console.
observedGenerationstringOutput only. The generation of this Execution. See comments in reconciling for additional information on reconciliation process in Cloud Run.
parallelismintegerOutput 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.
reconcilingbooleanOutput 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.
retriedCountintegerOutput only. The number of tasks which have retried at least once.
runningCountintegerOutput only. The number of actively running tasks.
satisfiesPzsbooleanOutput only. Reserved for future use.
startTimestringOutput only. Represents time when the execution started to run. It is not guaranteed to be set in happens-before order across separate operations.
succeededCountintegerOutput only. The number of tasks which reached phase Succeeded.
taskCountintegerOutput 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.
templateobjectTaskTemplate describes the data a task should have when created from a template.
uidstringOutput only. Server assigned unique identifier for the Execution. The value is a UUID4 string and guaranteed to remain unchanged until the resource is deleted.
updateTimestringOutput only. The last-modified time.

Methods

NameAccessible byRequired ParamsDescription
getSELECTexecutionsId, jobsId, locationsId, projectsIdGets information about an Execution.
listSELECTjobsId, locationsId, projectsIdLists Executions from a Job. Results are sorted by creation time, descending.
deleteDELETEexecutionsId, jobsId, locationsId, projectsIdDeletes an Execution.
cancelEXECexecutionsId, jobsId, locationsId, projectsIdCancels an Execution.
export_statusEXECexecutionsId, executionsId1, jobsId, locationsId, projectsIdRead the status of an image export operation.

SELECT examples

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

SELECT
name,
annotations,
cancelledCount,
completionTime,
conditions,
createTime,
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 jobsId = '{{ jobsId }}'
AND locationsId = '{{ locationsId }}'
AND projectsId = '{{ projectsId }}';

DELETE example

Deletes the specified executions resource.

/*+ delete */
DELETE FROM google.run.executions
WHERE executionsId = '{{ executionsId }}'
AND jobsId = '{{ jobsId }}'
AND locationsId = '{{ locationsId }}'
AND projectsId = '{{ projectsId }}';