Invoke Ultra Tasks

Important: The invocation methods described in this topic apply to Low-latency Ultra Tasks only. Headless Ultra Tasks use a listening Snap (such as JMS Consumer) to consume messages directly and are not invoked via HTTP endpoints or FeedMaster URIs. See Pipeline requirements for Ultra Tasks for the distinction between the two types.

Invoke the task through URI patterns

You can call an Ultra Task by its task name or, if configured for high availability, its alias.

  1. In Manager, navigate to the target Project, and click the Tasks tab.
  2. Click on the inverted arrow by the target Task, and click Details.
  3. In the Task Details page, click the copy icon for the URL from HTTP Endpoint.
  4. (Optional) You can view the CA certificate generated by SnapLogic by clicking Download the CA Certificate for your SnapLogic organization.
    Note: In cases where IP Address and port number are used as part of the URL, you must replace them with the name of the host before you can invoke the Task.

Using task name

feed_master_uri/api/1/rest/feed-master/queue/org/project_space/project/task_name

Using alias

feed_master_uri/api/1/rest/feed-master/queue/org/project_space/project/alias

For information on configuring an alias, see Ultra Tasks in production.

Send an HTTP Request to the pipeline

To send HTTP requests to the pipeline, use the HTTP Authorization header and endpoint from the Task Details page.

The Authorization header must be included in requests sent to the endpoint if a Bearer token is configured. Otherwise, an HTTP 401 Unauthorized error is returned.

The HTTP endpoint belongs to the FeedMaster that is part of the Snaplex on which the Task is configured to run. As an example, the following cURL command line sends a GET request to the FeedMaster with the Authorization header.

Using task name

$ curl -k -H 'Authorization: Bearer jH6ofxtn3qe8jGoiSWbW3adW0N6KXziV'
https://groundplex.local:8084/api/1/rest/feed-master/queue/org/projects/llfeed-demo/hello-world-task

Using alias

$ curl -k -H 'Authorization: Bearer jH6ofxtn3qe8jGoiSWbW3adW0N6KXziV'
https://groundplex.local:8084/api/1/rest/feed-master/queue/org/projects/llfeed-demo/hello-world-task-alias