REST Resource: projects.locations.jobs.executions

Resource: Execution

Execution represents the configuration of a single execution. A execution an immutable resource that references a container image which is run to completion.

JSON representation
{
  "name": string,
  "uid": string,
  "generation": string,
  "labels": {
    string: string,
    ...
  },
  "annotations": {
    string: string,
    ...
  },
  "createTime": string,
  "startTime": string,
  "completionTime": string,
  "updateTime": string,
  "deleteTime": string,
  "expireTime": string,
  "launchStage": enum (LaunchStage),
  "job": string,
  "parallelism": integer,
  "taskCount": integer,
  "template": {
    object (TaskTemplate)
  },
  "reconciling": boolean,
  "conditions": [
    {
      object (Condition)
    }
  ],
  "observedGeneration": string,
  "runningCount": integer,
  "succeededCount": integer,
  "failedCount": integer,
  "cancelledCount": integer,
  "retriedCount": integer,
  "logUri": string,
  "satisfiesPzs": boolean,
  "etag": string
}
Fields
name

string

Output only. The unique name of this Execution.

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.

generation

string (int64 format)

Output only. A number that monotonically increases every time the user modifies the desired state.

labels

map (key: string, value: string)

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

An object containing a list of "key": value pairs. Example: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

annotations

map (key: string, value: string)

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.

An object containing a list of "key": value pairs. Example: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

createTime

string (Timestamp format)

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.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".

startTime

string (Timestamp format)

Output only. Represents time when the execution started to run. It is not guaranteed to be set in happens-before order across separate operations.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".

completionTime

string (Timestamp format)

Output only. Represents time when the execution was completed. It is not guaranteed to be set in happens-before order across separate operations.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".

updateTime

string (Timestamp format)

Output only. The last-modified time.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".

deleteTime

string (Timestamp format)

Output only. For a deleted resource, the deletion time. It is only populated as a response to a Delete request.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".

expireTime

string (Timestamp format)

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.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".

launchStage

enum (LaunchStage)

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.

job

string

Output only. The name of the parent Job.

parallelism

integer

Output only. Specifies the maximum desired number of tasks the execution should run at any given time. Must be <= taskCount. 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.

taskCount

integer

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 (TaskTemplate)

Output only. The template used to create tasks for this execution.

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.

conditions[]

object (Condition)

Output only. The Condition of this Execution, containing its readiness status, and detailed error information in case it did not reach the desired state.

observedGeneration

string (int64 format)

Output only. The generation of this Execution. See comments in reconciling for additional information on reconciliation process in Cloud Run.

runningCount

integer

Output only. The number of actively running tasks.

succeededCount

integer

Output only. The number of tasks which reached phase Succeeded.

failedCount

integer

Output only. The number of tasks which reached phase Failed.

cancelledCount

integer

Output only. The number of tasks which reached phase Cancelled.

retriedCount

integer

Output only. The number of tasks which have retried at least once.

logUri

string

Output only. URI where logs for this execution can be found in Cloud Console.

satisfiesPzs

boolean

Output only. Reserved for future use.

etag

string

Output only. A system-generated fingerprint for this version of the resource. May be used to detect modification conflict during updates.

Methods

cancel

Cancels an Execution.

delete

Deletes an Execution.

get

Gets information about an Execution.

list

Lists Executions from a Job.