Run.projects.locations.jobs.executions.tasks.list

Lists Tasks from an Execution of a Job.

GET/v2/{parent}/tasks

Use it in a workflow

Add a step and choose the Google Cloud Run Jobs connector.
Pick the Run.projects.locations.jobs.executions.tasks.list action (under projects).
Fill in the fields below, then reference the result from later steps as {{runProjectsLocationsJobsExecutionsTasksList.response.data}}.

Request

Path parameters

parentstringrequired

Required. The Execution from which the Tasks should be listed. To list all Tasks across Executions of a Job, use "-" instead of Execution name. To list all Tasks across Jobs, use "-" instead of Job name. Format: projects/{project}/locations/{location}/jobs/{job}/executions/{execution}

Query parameters

$.xgafvstring

V1 error format.

One of12

access_tokenstring

OAuth access token.

altstring

Data format for response.

One ofjsonmediaproto

callbackstring

JSONP

fieldsstring

Selector specifying which fields to include in a partial response.

keystring

API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.

oauth_tokenstring

OAuth 2.0 token for the current user.

prettyPrintboolean

Returns response with indentations and line breaks.

quotaUserstring

Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.

upload_protocolstring

Upload protocol for media (e.g. "raw", "multipart").

uploadTypestring

Legacy upload protocol for media (e.g. "media", "multipart").

pageSizeinteger

Maximum number of Tasks to return in this call.

pageTokenstring

A page token received from a previous call to ListTasks. All other parameters must match.

showDeletedboolean

If true, returns deleted (but unexpired) resources along with active ones.

Response

Returns 200 with an object. Read it in later steps with {{runProjectsLocationsJobsExecutionsTasksList.response.data.<field>}}.

nextPageTokenstring

A token indicating there are more items than page_size. Use it in the next ListTasks request to continue.

tasksarray<object>

The resulting list of Tasks.

annotationsobject

KRM-style annotations for the resource.

completionTimestring (google-datetime)

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

conditionsarray<object>8 fields

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

containersarray<object>11 fields

Holds the single container that defines the unit of execution for this task.

createTimestring (google-datetime)

Output only. Represents time when the task was created by the job controller. It is not guaranteed to be set in happens-before order across separate operations.

deleteTimestring (google-datetime)

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

encryptionKeystring

Output only. A reference to a customer managed encryption key (CMEK) to use to encrypt this container image. For more information, go to https://cloud.google.com/run/docs/securing/using-cmek

etagstring

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

executionstring

Output only. The name of the parent Execution.

executionEnvironmentstring

The execution environment being used to host this Task.

One ofEXECUTION_ENVIRONMENT_UNSPECIFIEDEXECUTION_ENVIRONMENT_GEN1EXECUTION_ENVIRONMENT_GEN2

expireTimestring (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.

generationstring (int64)

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

indexinteger (int32)

Output only. Index of the Task, unique per execution, and beginning at 0.

jobstring

Output only. The name of the parent Job.

labelsobject

KRM-style labels for the resource. 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

lastAttemptResultobject2 fields

Result of a task attempt.

logUristring

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

maxRetriesinteger (int32)

Number of retries allowed per Task, before marking this Task failed.

namestring

Output only. The unique name of this Task.

observedGenerationstring (int64)

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

reconcilingboolean

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.

retriedinteger (int32)

Output only. The number of times this Task was retried. Tasks are retried when they fail up to the maxRetries limit.

satisfiesPzsboolean

Output only. Reserved for future use.

serviceAccountstring

Email address of the IAM service account associated with the Task of a Job. The service account represents the identity of the running task, and determines what permissions the task has. If not provided, the task will use the project's default service account.

startTimestring (google-datetime)

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

timeoutstring (google-duration)

Max allowed time duration the Task may be active before the system will actively try to mark it failed and kill associated containers. This applies per attempt of a task, meaning each retry can run for the full timeout.

uidstring

Output only. Server assigned unique identifier for the Task. The value is a UUID4 string and guaranteed to remain unchanged until the resource is deleted.

updateTimestring (google-datetime)

Output only. The last-modified time.

volumesarray<object>3 fields

A list of Volumes to make available to containers.

vpcAccessobject2 fields

VPC Access settings. For more information on creating a VPC Connector, visit https://cloud.google.com/vpc/docs/configure-serverless-vpc-access For information on how to configure Cloud Run with an existing VPC Connector, visit https://cloud.google.com/run/docs/configuring/connecting-vpc

json

{
  "nextPageToken": "string",
  "tasks": [
    {
      "annotations": {},
      "completionTime": "string",
      "conditions": [
        {
          "executionReason": "EXECUTION_REASON_UNDEFINED",
          "lastTransitionTime": "string",
          "message": "string",
          "reason": "COMMON_REASON_UNDEFINED",
          "revisionReason": "REVISION_REASON_UNDEFINED",
          "severity": "SEVERITY_UNSPECIFIED",
          "state": "STATE_UNSPECIFIED",
          "type": "string"
        }
      ],
      "containers": [
        {
          "args": [
            "string"
          ],
          "command": [
            "string"
          ],
          "env": [
            {
              "name": null,
              "value": null,
              "valueSource": null
            }
          ],
          "image": "string",
          "livenessProbe": {
            "failureThreshold": 0,
            "grpc": {
              "port": null,
              "service": null
            },
            "httpGet": {
              "httpHeaders": null,
              "path": null,
              "port": null
            },
            "initialDelaySeconds": 0,
            "periodSeconds": 0,
            "tcpSocket": {
              "port": null
            },
            "timeoutSeconds": 0
          },
          "name": "string",
          "ports": [
            {
              "containerPort": null,
              "name": null
            }
          ],
          "resources": {
            "cpuIdle": false,
            "limits": {},
            "startupCpuBoost": false
          },
          "startupProbe": {
            "failureThreshold": 0,
            "grpc": {
              "port": null,
              "service": null
            },
            "httpGet": {
              "httpHeaders": null,
              "path": null,
              "port": null
            },
            "initialDelaySeconds": 0,
            "periodSeconds": 0,
            "tcpSocket": {
              "port": null
            },
            "timeoutSeconds": 0
          },
          "volumeMounts": [
            {
              "mountPath": null,
              "name": null
            }
          ],
          "workingDir": "string"
        }
      ],
      "createTime": "string",
      "deleteTime": "string",
      "encryptionKey": "string",
      "etag": "string",
      "execution": "string",
      "executionEnvironment": "EXECUTION_ENVIRONMENT_UNSPECIFIED",
      "expireTime": "string",
      "generation": "string"
    }
  ]
}

Need more? See the Google Cloud Run Jobs guide for connection setup and behaviour shared by every action.

Was this page helpful?