Workflow Executions API Connector Overview (original) (raw)

The Workflows connector defines the built-in functions that can be used to access other Google Cloud products within a workflow.

This page provides an overview of the individual connector. There is no need to import or load connector libraries in a workflow—connectors work out of the box when used in a call step.

Execute workflows created with Workflows API. To learn more, see the Workflow Executions API documentation.

Helper Method

You can use the helper method run to launch a workflow execution. This is simpler than using the create API as it doesn't require workflow arguments in a JSON string format. To learn more, see the run documentation.

Workflow Executions connector sample

YAML

JSON

Module: googleapis.workflowexecutions.v1.projects.locations.workflows

Functions
triggerPubsubExecution Triggers a new execution using the latest revision of the given workflow by a Pub/Sub push notification.

Module: googleapis.workflowexecutions.v1.projects.locations.workflows.executions

Functions
cancel Cancels an execution of the given name.
create Creates a new execution using the latest revision of the given workflow. Input parameters must be represented as a JSON string.
deleteExecutionHistory Deletes all step entries for an execution.
exportData Returns all metadata stored about an execution, excluding most data that is already accessible using other API methods.
get Returns an execution of the given name.
list Returns a list of executions which belong to the workflow with the given name. The method returns executions of all workflow revisions. Returned executions are ordered by their start time (newest first).
run Starts a workflow execution and waits for it to finish. This provides a simpler interface to launch a workflow execution than the create() method. Note that run() calls create() to start a new execution, and optionally accepts execution parameters defined in the YAML source code as either integer, float, bool, string, list, or map data types.

Module: googleapis.workflowexecutions.v1.projects.locations.workflows.executions.callbacks

Functions
list Returns a list of active callbacks that belong to the execution with the given name. The returned callbacks are ordered by callback ID.

Module: googleapis.workflowexecutions.v1.projects.locations.workflows.executions.stepEntries

Functions
get Gets a step entry.
list Lists step entries for the corresponding workflow execution. Returned entries are ordered by their create_time.

Module: googleapis.workflowexecutions.v1beta.projects.locations.workflows.executions

Functions
cancel Cancels an execution of the given name.
create Creates a new execution using the latest revision of the given workflow.
get Returns an execution of the given name.
list Returns a list of executions which belong to the workflow with the given name. The method returns executions of all workflow revisions. Returned executions are ordered by their start time (newest first).
run Starts a workflow execution and waits for it to finish. This provides a simpler interface to launch a workflow execution than the create() method. Note that run() calls create() to start a new execution, and optionally accepts execution parameters defined in the YAML source code as either integer, float, bool, string, list, or map data types.