On this Page

Overview

Triggered Tasks offer the method of invoking your Pipelines with an HTTP endpoint. Your Pipeline can now be treated as a service, to and from which clients can invoke to send or get data. Likewise, you can invoke the Pipeline underlying a Triggered Task from an on-premise system or from the Cloud via the control plane.

Key Features

Create URL from a Pipeline. You can create the URL through the Task creation workflow in Designer or select a Target Pipeline in Manager. 

Run as APIs. Once you have the Task URL, you can pass data into pipelines or invoke the pipeline with predefined parameters. 

Access Control. You can set up an IP Allowlist and a CORS list at the Project level to enforce access control of Triggered Tasks.

Network Configuration Options. You can configure your Snaplex instances and the Triggered Tasks that run on them for High Availability and Disaster Recovery scenarios. 

Triggered Task Architecture

Cloud Triggered Task via the Control Plane

Open

Ground Triggered Task

Open

Comparison of Triggered Task Types

Triggered Task Workflow

This workflow represents actions taken by both SnapLogic Org admins and users.

Prerequisites

• You must have permissions to Project Space and Project to create and update Triggered Tasks

• You must have a Cloudplex or Groundplex set up to run a Triggered Tasks successfully.

Support and Limitations

• Triggered Tasks support the following HTTP Methods:

  • GET

  • POST

  • DELETE

  • PUT

  • PATCH

  • HEAD
    
    
    

• The Open API specification (also known as Swagger) is supported. You can download your Triggered Tasks in API form in SnapLogic Manager > Assets.
  
  
  

• The Cloud URL has a 15-minute connection limit regardless of whether the connection is idle or not, so it should not be used for Tasks that stream data in or out beyond that time period.
  
  
  

• A Snaplex consists of multiple nodes. If the Triggered Task is set to run on a Groundplex (also known as an On-premises Snaplex), options for Task URLs include one that is reachable from the Cloud (Cloud URL), and others that are limited to the on-premise network (On-premises URL and an Override URL).
  
  

• A cloud URL Triggered Task will fail when the Task owner's password is expired. The Task execution requires that the Task owner’s password be reset. When using an on-premise URL, you can still trigger the Task with the bearer token (see Task Details), even if the Task owner’s password is expired. However, the Task execution will fail when using an expired password as authentication until the Task owner's password is reset.
  
  

• When you access the URL for a Triggered or Ultra Task that is in an Org different from the one you last selected, SnapLogic Manager displays the Task details, but the Org does not automatically change to the one that owns the Task. Use the selector at the top right in Manager to switch to a different Org.
  
  

• Since the connection to the client has a 15-minute timeout, long running Pipelines invoked as Triggered or Ultra Tasks through a Cloudplex URL might not complete before the timeout occurs. For Groundplex users, this timeout does not apply to the On-premise URL.
  
  

Known Issues

• When you create a Triggered Task and change the Run Policy to Scheduled, the Triggered Task URLs are not disabled. Therefore, the underlying pipeline is still executable through the Triggered Task URLs, even though the Task is now a Scheduled Task.

  Workaround: create a new Scheduled Task asset referencing the target pipeline and disable or delete the Triggered Task.

See Also:

• Scheduled Tasks

• Ultra Pipelines

• Resumable Pipelines

• SnapLogic API Management

• Blog: Human Intervention with Error Handling

• Some Questions on Pipeline Execution Mechanism