...

AWS Lambda is a serverless compute service that runs your code in response to events and automatically manages the underlying compute resources for you. You can use AWS Lambda to extend other AWS services with custom logic, or create your own back-end services that operate at AWS scale, performance, and security.

AWS Lambda can automatically run code in response to multiple events, such as:

• HTTP requests via Amazon API Gateway
• Modifications to objects in Amazon S3 buckets
• Table updates in Amazon DynamoDB
• State transitions in AWS Step Functions

Lambda runs your code on high-availability compute infrastructure and performs all the administration of the compute resources, including:

• Server and operating system maintenance
• Capacity provisioning and automatic scaling
• Code and security patch deployment
• Code monitoring and logging.

All you need to do is supply the code.

Image Removed

This Universal Extension provides the capability to execute a AWS Lambda function and return the result of that execution.

Version Information

Refer to Changelog for version history information.

Software Requirements

This integration requires a Universal Agent and a Python runtime to execute the Universal Task.

Software Requirements for Universal Template and Universal Task

Requires Python 3.7.0 or higher. Tested with the Universal Agent bundled Python distribution.

...

Extension's Universal Agent host should be able to reach AWS Lambda REST endpoints.

Key Features

This Universal Extension provides the following key features:

...

To use the Universal Template, you first must perform the following steps:.

1. This Universal Task requires the Resolvable Credentials feature. Check that the Resolvable Credentials Permitted system property has been set to true.

2. Download the provided ZIP file.

3. In the Universal Controller UI, select Administration >Configuration > Universal Templates to display the current list of Universal Templates.

4. Click Import Template.

5. Select the template ZIP file and Import.

...

1. To import the Universal Template into your Controller, follow the instructions here.

2. When the files have been imported successfully, refresh the Universal Templates list; the Universal Template will appear on the list

...

1. .

Configure Universal Task

For the new Universal Task type AWS Lambda, create a new task, and enter the task-specific details that were created in the Universal Template.

...

Extension Cancellation

...

...

...

Task Examples

Trigger Lambda Synchronously with Log

Triggering a Lambda function Sychronously Synchronously with Log Type equals "Tail".

Syncronously Synchronicity is set by Invocation Type equals "Request_Response".

Image RemovedImage Added

Trigger Lambda Asynchronously with Role Based Access and HTTPS Proxy

Triggering Lambda function Asychronously, Asynchronously with:

• Role Based Access

...

• HTTPS Proxy connection

...

...

• Payload Source

...

• Client Context Source

...

Also, Qualifier is set to "3", meaning the 3rd version of the Lambda function will be triggered.

Asyncronously is set by Invocation Type equals "Event". "Proxy" needs to be on the correct format and "Proxy CA Bundle File" on correct format and path.

Image Removed

Image Added

Trigger Lambda Synchronously with HTTPS with Credentials Proxy

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

Note that the Log Type is set to "None" and Qualifier is blank, meaning that the latest version of the Lambda function will be called.

Image Removed

Image 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 Added

Task Output

Exit Codes

The exit codes for AWS Lambda Extension are described in the following table.

Extension Output

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

Attribute changed is populated as follows.

• true in case the job is triggered successfully
• false otherwise

result section includes the following attributes.

An example of the Extension Output for AWS Lambda Universal Task successful execution is described a successful triggering job is presented below.

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

...

1.0",
      "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": null,
          "qualifier": null,
          "use_proxy": false,
          "proxy_type": null,
          "proxy": null,
          "proxy_credentials_user": null,
          "proxy_credentials_password": null,
          "proxy_ca_bundle_file": null
      }
  },
  "result": {
      "status_code": 200,
      "log_result": "Multiline Log text",
      "payload": "{\"statusCode\": 999, \"body\": {\"message\": \"Hello World\"}}",
      "executed_version": "$LATEST",
      "function_error": null,
    }
  }
}

Task Status

The task instance with Status equals to "Success" and Exit Code equals "0".

Image Removed

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 References

This document references the following documents:.

Changelog

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

Enhancements

• Added: Provide the capability to rely on AWS credentials set-up on the environment where the extension is running and therefore it is not mandatory to be passed on the task definition as input fields. The same applies to AWS Region. (#29115)

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

Fixes

• Fixed Change of template SysId. (#27744)