Template Name	Extension Name	Extension Version
AWS Lambda	ue-aws-lambda	1.1.01

Refer to Changelog for version history information.

...

Field	Input type	Default value	Type	Description
Action	Required	Trigger Lambda function	Choice	The action performed upon the task execution. Available action: Trigger Lambda function
AWS Region Optional since version 1.1.0	Optional	-	Text	Region for the Amazon Web Service. Find more information about the AWS Service endpoints and quotas here. When AWS Region is not populated as part of the task definition, during task execution the integration will look for credentials on the task execution environment. Refer to configuration options for more information.
AWS Credentials Optional since version 1.1.0	Optional	-	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 Access	Optional	False	Boolean	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 ARN	Optional	-	Text	Role Arn: Amazon Role, which is applied for the connection. Role ARN format: `Example RoleArn: arn:aws:iam::119322085622:role`. Required when Role Based Access="True".
Function Name	Required	-	Text	Name of the Lambda function, which will be triggered. For example, my-function (name-only) or my-function:v1 (with alias).
Invocation Type	Required	Request Response	Choice	Type of execution for the function being triggered. Available choices are: Request Response (Synchronously) Event (Asynchronously)
Log Type	Optional	None	Choice	Can be set to Tail to include the execution log in the response. Available choices are: None Tail Visible only when Invocation Type="Request Response".
Payload Source	Optional	None	Choice	Source of payload to be sent. None Script
Payload Script	Optional	-	Script Field	Script field where the payload can be entered. The scripts must evaluate to a proper JSON format. Required when Payload Source = "Script".
Client Context Source	Optional	None	Choice	Client context that's provided to Lambda function by the client application. None Script
Client Context Script	Optional	-	Script	Script passing parameters using the ClientContext object. The scripts must evaluate to a proper JSON format. Required when Client Context Source= "Script".
Use Proxy	Optional	False	Boolean	Flag to indicate whether Proxy shall be used in the communication with AWS.
Proxy Type	Optional	HTTP	Choice	Type of proxy connection to be used. Available options are the following. HTTP HTTPS HTTPS with Credentials Visible only when Use Proxy = "True".
Proxy	Optional	-	Text	Comma separated list of Proxy servers. Valid formats are the following. `http://proxyip:port` or `http://proxyip:port,https://proxyip:port`. Required when Use Proxy is checked.
Proxy CA Bundle File	Optional	-	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 Credentials	Optional	-	Credentials	Credentials to be used for the proxy communication. The credential definition should be as follows. Proxy Username as "Runtime User". Proxy Password as "Runtime Password". Required when "Proxy Type" is configured for "HTTPS With Credentials".
Qualifier	Optional	-	Text	Version or alias to invoke a published version of the function. Example for version 1 Qualifier = "1". If empty, default value is the latest version.
Wait For Completion Timeout Introduced in version 1.1.1	Required	60	Integer	The time in seconds that the task will wait for a server response until it throws a timeout exception. This is linked with the read_timeout config value that is passed to the AWS client.

Task Examples

Trigger Lambda Synchronously with Log

...

Synchronicity is set by Invocation Type equals "Request_Response".

Image RemovedImage Added

Trigger Lambda Asynchronously with Role Based Access and HTTPS Proxy

...

Role Based Access
HTTPS Proxy connection
Payload Source
Client Context Source

Image RemovedImage Added

Trigger Lambda Synchronously with HTTPS with Credentials Proxy

Triggering a Lambda function Synchronously with "HTTPS with Credentials" Proxy connection.

Image RemovedImage Added

Trigger Lambda Synchronously with Log

Triggering a Lambda function Synchronously with "Region" provided as environment variables and without AWS Credentials. Please refer to AWS Credentials input field for more information.

Image RemovedImage Added

Task Output

Exit Codes

...

Exit Code	Status Classification Code	Status Classification Description	Status Description
0	SUCCESS	Successful Execution	SUCCESS: Successful Task execution
1	FAIL	Failed Execution	FAIL: < Error Description >
2	AUTHENTICATION_ERROR	Bad credentials	AUTHENTICATION_ERROR: Account cannot be authenticated.
3	AUTHORIZATION_ERROR	Insufficient Permissions	AUTHORIZATION_ERROR: Account is not authorized to perform the requested action.
10	CONNECTION_ERROR	Bad connection data or connection timed out	CONNECTION_ERROR: < Error Description >
11	CONNECTION_ERROR	Extension specific connection error	CONNECTION_ERROR: ProxyConnectionError: Failed to connect to proxy URL `<url>`
20	DATA_VALIDATION_ERROR	Input fields validation error	DATA_VALIDATION_ERROR: Some of the input fields cannot be validated. See STDOUT for more details.
21	READ_TIMEOUT_ERROR	Lambda function completion timeout error	READ_TIMEOUT_ERROR: Did not receive a server response within the allotted time frame (wait_for_completion_timeout).

Extension Output

In the context of a workflow, subsequent tasks can rely on the information provided by this integration as Extension Output.

...

An example of the Extension Output for a successful triggering job is presented below.

Code Block

language	text

{
  "exit_code": 0,
  "status_description": "SUCCESS: AWS Lambda function invoked successfully",
  "changed": true,
  "invocation": {
      "extension": "ue-aws-lambda",
      "version": "1.1.

...

1",
      "fields": {
          "action": "Trigger Lambda Function",
          "credentials_user": "test-user",
          "credentials_password": "****",
          "region": "us-east-1",
          "role_based_access": false,
          "role_arn": null,
          "function_name": "test-function",
          "invocation_type": "RequestResponse",
          "payload_source": null,
          "payload_script": null,
          "client_context_source": null,
          "client_context_script": null,
          "log_type":

...

"None",

...

"qualifier": null,

...

"use_proxy": false,

...

"proxy_type": null,

...

"proxy": null,

...

  "proxy_credentials_user": null,

...

"proxy_credentials_password": null,  "proxy_ca_bundle_file": null,
          "

...

wait_

...

for_

...

completion_

...

timeout":

...

},

...

  "result": {

...

"status_code": 200,

...

"log_result": "Multiline Log text",

...

"payload": "{\"statusCode\": 999, \"body\": {\"message\": \"Hello World\"}}",

...

"executed_version": "$LATEST",

...

  "function_error": null,

...

} }

...

STDOUT and STDERR

STDOUT and STDERR provide additional information to User. The populated content can be changed in future versions of this extension without notice. Backward compatibility is not guaranteed.

...

Document Link	Description
Universal Templates	User documentation for creating, working with and understanding Universal Templates and Integrations.
Universal Tasks	User documentation for creating Universal Tasks in the Universal Controller user interface.
AWS Lambda	Documentation for AWS Lambda.
IAM RBAC authorization model	User Documentation for Comparing ABAC to the traditional RBAC model.

Changelog

ue-aws-lambda-1.1.1 (2023-02-24)

Fixes

Fixed: Provide the capability to define the completion timeout of the lambda function and avoid lambda function re-execution if the completion timeout is exceeded. (#31671)

ue-aws-lambda-1.1.0 (2022-06-30)

...

ue-aws-lambda-1.0.1 (2022-03-14)

Fixes

Fixed: Change of template SysId. (#27744)

Versions Compared

Old Version 9

New Version 10

Key

Task Examples

Trigger Lambda Synchronously with Log

Trigger Lambda Asynchronously with Role Based Access and HTTPS Proxy

Trigger Lambda Synchronously with HTTPS with Credentials Proxy

Trigger Lambda Synchronously with Log

Task Output

Exit Codes

Extension Output

STDOUT and STDERR

Changelog

ue-aws-lambda-1.1.1 (2023-02-24)

Fixes

ue-aws-lambda-1.1.0 (2022-06-30)

ue-aws-lambda-1.0.1 (2022-03-14)

Fixes

Page Comparison

Versions Compared

Old Version 9

New Version 10

Key

Task Examples

Trigger Lambda Synchronously with Log

Trigger Lambda Asynchronously with Role Based Access and HTTPS Proxy

Trigger Lambda Synchronously with HTTPS with Credentials Proxy

Trigger Lambda Synchronously with Log

Task Output

Exit Codes

Extension Output

STDOUT and STDERR

Changelog

ue-aws-lambda-1.1.1 (2023-02-24)

Fixes

ue-aws-lambda-1.1.0 (2022-06-30)

ue-aws-lambda-1.0.1 (2022-03-14)

Fixes