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 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)
  },
  "bigqueryAction": {
    object (BigQueryAction)
  }
}
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.
bigqueryAction

object (BigQueryAction)

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

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.

BigQueryAction

Represents a workflow action that will run against BigQuery.

JSON representation 
{
  "sqlScript": string
}
Fields
sqlScript

string

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