Method: projects.locations.repositories.workflowInvocations.query

Returns WorkflowInvocationActions in a given WorkflowInvocation.

HTTP request

GET https://dataform.googleapis.com/v1beta1/{name=projects/*/locations/*/repositories/*/workflowInvocations/*}:query

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
name

string

Required. The workflow invocation's name.

Authorization requires the following IAM permission on the specified resource name:

  • dataform.workflowInvocations.query

Query parameters

Parameters
pageSize

integer

Optional. Maximum number of workflow invocations to return. The server may return fewer items than requested. If unspecified, the server will pick an appropriate default.

pageToken

string

Optional. Page token received from a previous workflowInvocations.query call. Provide this to retrieve the subsequent page.

When paginating, all other parameters provided to workflowInvocations.query, with the exception of pageSize, must match the call that provided the page token.

Request body

The request body must be empty.

Response body

workflowInvocations.query response message.

If successful, the response body contains data with the following structure:

JSON representation
{
  "workflowInvocationActions": [
    {
      object (WorkflowInvocationAction)
    }
  ],
  "nextPageToken": string
}
Fields
workflowInvocationActions[]

object (WorkflowInvocationAction)

List of workflow invocation actions.

nextPageToken

string

A token, which can be sent as pageToken to retrieve the next page. If this field is omitted, there are no subsequent pages.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/cloud-platform

For more information, see the Authentication Overview.

IAM Permissions

Requires the following IAM permission on the name resource:

  • dataform.workflowInvocations.query

For more information, see the IAM documentation.

WorkflowInvocationAction

Represents a single action in a workflow invocation.

JSON representation
{
  "target": {
    object (Target)
  },
  "canonicalTarget": {
    object (Target)
  },
  "state": enum (State),
  "failureReason": string,
  "invocationTiming": {
    object (Interval)
  },

  // Union field action can be only one of the following:
  "bigqueryAction": {
    object (BigQueryAction)
  },
  "notebookAction": {
    object (NotebookAction)
  }
  // End of list of possible types for union field action.
}
Fields
target

object (Target)

Output only. This action's identifier. Unique within the workflow invocation.

canonicalTarget

object (Target)

Output only. The action's identifier if the project had been compiled without any overrides configured. Unique within the compilation result.

state

enum (State)

Output only. This action's current state.

failureReason

string

Output only. If and only if action's state is FAILED a failure reason is set.

invocationTiming

object (Interval)

Output only. This action's timing details. startTime will be set if the action is in [RUNNING, SUCCEEDED, CANCELLED, FAILED] state. endTime will be set if the action is in [SUCCEEDED, CANCELLED, FAILED] state.

Union field action.

action can be only one of the following:

bigqueryAction

object (BigQueryAction)

Output only. The workflow action's bigquery action details.

notebookAction

object (NotebookAction)

Output only. The workflow action's notebook action details.

BigQueryAction

Represents a workflow action that will run against BigQuery.

JSON representation
{
  "sqlScript": string,
  "jobId": string
}
Fields
sqlScript

string

Output only. The generated BigQuery SQL script that will be executed.

jobId

string

Output only. The ID of the BigQuery job that executed the SQL in sqlScript. Only set once the job has started to run.

NotebookAction

Represents a workflow action that will run against a Notebook runtime.

JSON representation
{
  "contents": string,
  "jobId": string
}
Fields
contents

string

Output only. The code contents of a Notebook to be run.

jobId

string

Output only. The ID of the Vertex job that executed the notebook in contents and also the ID used for the outputs created in GCS buckets. Only set once the job has started to run.

State

Represents the current state of a workflow invocation action.

Enums
PENDING The action has not yet been considered for invocation.
RUNNING The action is currently running.
SKIPPED Execution of the action was skipped because upstream dependencies did not all complete successfully. A terminal state.
DISABLED Execution of the action was disabled as per the configuration of the corresponding compilation result action. A terminal state.
SUCCEEDED The action succeeded. A terminal state.
CANCELLED The action was cancelled. A terminal state.
FAILED The action failed. A terminal state.