Docs / Strand / connectors/aws-lambda
AWS Lambda
Direction: Read / Write | Type: aws.lambda
Amazon Lambda connector for invoking serverless functions. Supports synchronous (request/response) and asynchronous (fire-and-forget) invocations.
Required Permissions#
The IAM user or role must have the following permissions:
| Operation | Required IAM Permissions |
|---|---|
invoke |
lambda:InvokeFunction |
Tip: Scope permissions to specific function ARNs to follow the principle of least privilege.
Operations#
| Operation | Direction | Description |
|---|---|---|
invoke |
Write | Invoke a Lambda function |
Connector Configuration#
| Field | Required | Default | Description |
|---|---|---|---|
| Authentication Type | No | api_key |
Uses explicit credentials (the fields below). |
| Region | Yes | - | AWS region code (e.g., us-east-1) |
| Endpoint URL | No | - | Custom endpoint for a self-managed target or an AWS VPC endpoint. Leave empty for AWS. |
| Access Key ID | Conditional | - | AWS access key (encrypted). Required when Authentication Type is api_key |
| Secret Access Key | Conditional | - | AWS secret key (encrypted). Required when Authentication Type is api_key |
| Function Name | No | - | Default Lambda function name or ARN (can be overridden at node level) |
Node Configuration#
| Field | Required | Description |
|---|---|---|
| Function Name | No | Lambda function name or ARN (overrides connector default) |
| Invocation Type | No | RequestResponse (synchronous, default) or Event (asynchronous) |
Output#
Synchronous (RequestResponse)#
json
{
"success": true,
"status": "completed",
"data": {
"function_name": "my-function",
"response": {"result": "value"}
},
"service": "aws.lambda",
"operation": "invoke"
}
Access the Lambda response:
jinja2
{{ payload.data.response.result }}
Asynchronous (Event)#
json
{
"success": true,
"status": "invoked",
"data": {
"function_name": "my-function",
"request_id": "abc-123"
},
"service": "aws.lambda",
"operation": "invoke"
}
Example#
Connector Setup:
json
{
"region": "us-east-1",
"access_key_id": "AKIAIOSFODNN7EXAMPLE",
"secret_access_key": "wJalrXUtnFEMI/K7MDENG...",
"function_name": "process-order"
}
Node Configuration (sync):
- Invocation Type:
RequestResponse
Node Configuration (async):
- Invocation Type:
Event
Tendrl