younifyd
Menu

Run.projects.locations.jobs.list

Lists Jobs.

GET/v2/{parent}/jobs

Use it in a workflow

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

Request

Path parameters

parentstringrequired

Required. The location and project to list resources on. Format: projects/{project}/locations/{location}, where {project} can be project id or number.

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 Jobs to return in this call.

pageTokenstring

A page token received from a previous call to ListJobs. 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 {{runProjectsLocationsJobsList.response.data.<field>}}.

jobsarray<object>

The resulting list of Jobs.

annotationsobject

KRM-style annotations for the resource. 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. Cloud Run API v2 does not support annotations with `run.googleapis.com`, `cloud.googleapis.com`, `serving.knative.dev`, or `autoscaling.knative.dev` namespaces, and they will be rejected on new resources. All system annotations in v1 now have a corresponding field in v2 Job. This field follows Kubernetes annotations' namespacing, limits, and rules.

binaryAuthorizationobject2 fields

Settings for Binary Authorization feature.

clientstring

Arbitrary identifier for the API client.

clientVersionstring

Arbitrary version identifier for the API client.

conditionsarray<object>8 fields

Output only. The Conditions of all other associated sub-resources. They contain additional diagnostics information in case the Job does not reach its desired state. See comments in `reconciling` for additional information on reconciliation process in Cloud Run.

createTimestring (google-datetime)

Output only. The creation time.

creatorstring

Output only. Email address of the authenticated creator.

deleteTimestring (google-datetime)

Output only. The deletion time.

etagstring

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

executionCountinteger (int32)

Output only. Number of executions created for this job.

expireTimestring (google-datetime)

Output only. For a deleted resource, the time after which it will be permamently deleted.

generationstring (int64)

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

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 Cloud Run API v2 does not support labels with `run.googleapis.com`, `cloud.googleapis.com`, `serving.knative.dev`, or `autoscaling.knative.dev` namespaces, and they will be rejected. All system labels in v1 now have a corresponding field in v2 Job.

lastModifierstring

Output only. Email address of the last authenticated modifier.

latestCreatedExecutionobject3 fields

Reference to an Execution. Use /Executions.GetExecution with the given name to get full execution including the latest status.

launchStagestring

The launch stage as defined by [Google Cloud Platform Launch Stages](https://cloud.google.com/terms/launch-stages). Cloud Run supports `ALPHA`, `BETA`, and `GA`. If no value is specified, GA is assumed. Set the launch stage to a preview stage on input to allow use of preview features in that stage. On read (or output), describes whether the resource uses preview features. For example, if ALPHA is provided as input, but only BETA and GA-level features are used, this field will be BETA on output.

One ofLAUNCH_STAGE_UNSPECIFIEDUNIMPLEMENTEDPRELAUNCHEARLY_ACCESSALPHABETAGADEPRECATED

namestring

The fully qualified name of this Job. Format: projects/{project}/locations/{location}/jobs/{job}

observedGenerationstring (int64)

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

reconcilingboolean

Output only. Returns true if the Job is currently being acted upon by the system to bring it into the desired state. When a new Job is created, or an existing one is updated, Cloud Run will asynchronously perform all necessary steps to bring the Job to the desired state. This process is called reconciliation. While reconciliation is in process, `observed_generation` and `latest_succeeded_execution`, will have transient values that might mismatch the intended state: Once reconciliation is over (and this field is false), there are two possible outcomes: reconciliation succeeded and the state matches the Job, or there was an error, and reconciliation failed. This state can be found in `terminal_condition.state`. If reconciliation succeeded, the following fields will match: `observed_generation` and `generation`, `latest_succeeded_execution` and `latest_created_execution`. If reconciliation failed, `observed_generation` and `latest_succeeded_execution` will have the state of the last succeeded execution or empty for newly created Job. Additional information on the failure can be found in `terminal_condition` and `conditions`.

satisfiesPzsboolean

Output only. Reserved for future use.

templateobject5 fields

ExecutionTemplate describes the data an execution should have when created from a template.

terminalConditionobject8 fields

Defines a status condition for a resource.

uidstring

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.

updateTimestring (google-datetime)

Output only. The last-modified time.

nextPageTokenstring

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

json
{
  "jobs": [
    {
      "annotations": {},
      "binaryAuthorization": {
        "breakglassJustification": "string",
        "useDefault": false
      },
      "client": "string",
      "clientVersion": "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"
        }
      ],
      "createTime": "string",
      "creator": "string",
      "deleteTime": "string",
      "etag": "string",
      "executionCount": 0,
      "expireTime": "string",
      "generation": "string"
    }
  ],
  "nextPageToken": "string"
}

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