Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

FieldInput typeDefault valueTypeDescription
ActionRequiredStart Asynchronous ExecutionChoiceAction performed upon the task execution. Available actions are as follows.
  • Start Asynchronous Execution
AWS RegionOptional-TextRegion for the Amazon Web Service.

When AWS Region is not populated as part of the task definition, during task execution the integration will look for the region as configured on the task execution environment. Refer to configuration options for more information.
AWS CredentialsOptional-Credentials

The Credentials definition should be as follows.

  • AWS Access Key ID as "Runtime User".
  • AWS Secret Access Key as "Runtime Password".

When AWS Credentials are not populated as part of the task definition, during task execution the integration will look for AWS Credentials on the task execution environment. Refer to configuration options for more information.

Role Based AccessOptionalFalseBoolean

Special type of authorization is provided by Role Assumption where the client sends his own credentials and the role he wants to assume from another user.

If allowed, the client receives temporary credentials with limited time access to some resources.

Role ARNOptional-Text

Role Amazon Resource Name (ARN) that will be used to access and execute the Step Function.Role ARN format: arn:aws:iam::<AWS Account ID>:instance-profile/<Role name>.

Required when Role Based Access has been checked.

State Machine ArnRequired-TextThe Amazon Resource Name (ARN) of the state function to execute.
Execution NameOptional-Text

The name of the execution. For more information and restrictions refer to Limits Related to State Machine Executions in the AWS Step Functions Developer Guide.
If empty when execution, the Universal Task will generate a unique value for each instance.

Visible only when Action = “Start Asynchronous Execution”.

InputOptional-ScriptThe string that contains the JSON input data for the execution.
Wait for Success or FailureOptionalFalseBoolean

If selected, the task will continue running until the task reaches the "SUCCEEDED", "FAILED", "ABORTED" or "TIMEOUT" state.

Required when Action is "Start Asynchronous Execution".

Polling IntervalOptional10Integer

The polling interval in seconds between checking for the Step Function status.

Required when Wait for Success or Failure ="True".

Use ProxyOptionalFalseBooleanFlag to indicate whether Proxy shall be used in the communication with AWS.
Proxy TypeOptionalHTTPChoice

Type of proxy connection to be used. The following options are available.

  • HTTP
  • HTTPS
  • HTTPS With Credentials

Required when Use Proxy is checked.

ProxyOptional-Text

Comma separated list of Proxy servers. Valid formats: http://proxyip:port or http://proxyip:port,https://proxyip:port.

Required when Use Proxy is checked.

Proxy CA Bundle FileOptional-Text

The path to a custom certificate bundle to use when establishing SSL/TLS connections with proxy.

Used when Proxy Type is configured for "HTTPS" or "HTTPS With Credentials".

Proxy CredentialsOptional-Credentials

Credentials to be used for the proxy communication. Credential definition should be as follows.

  • "Proxy username Username as as "Runtime User".
  • "Proxy password Password as as "Runtime Password".

Required when Proxy Type

is

 is configured for "HTTPS With Credentials".

Task Examples

Start Asynchronous Execution

Example of AWS Step Functions Universal Task for triggering a Step Function with AWS Credentials and State Machine ARN only.

Start Asynchronous ExecutionImage RemovedImage Added

Start Asynchronous Execution With Proxy

...

  • Environment Variables for AWS Region
  • Input script
  • Execution Name
  • Proxy Type "HTTPS With Credentials"

Start Asynchronous ExecutionImage RemovedImage Added

Start Asynchronous Execution With IAM Role

...

  • SUCCESS
  • FAIL
  • ABORTED
  • TIMEOUT

Start Asynchronous ExecutionImage RemovedImage Added

Task Output

Cancellation logic

...

Document LinkDescription
Universal TemplatesUser documentation for creating, working with and understanding Universal Templates and Integrations.
Universal TasksUser documentation for creating Universal Tasks in the Universal Controller user interface.
AWS Step FunctionsUser guide for AWS Step Functions.
IAM RBAC authorization modelUser Documentation for Comparing ABAC to the traditional RBAC model.

Changelog

ue-aws-stepfunctions-1.0.

...

0 (2022-08-18)

  • Added: Basic Functionality for triggering an AWS Step Functions (#28543).