aws:invokeLambdaFunction –
Invoke an Amazon Lambda function
Invokes the specified Amazon Lambda function.
Note
Each aws:invokeLambdaFunction action can run up to a maximum duration
of 300 seconds (5 minutes). You can limit the timeout by specifying the
timeoutSeconds parameter for an
aws:invokeLambdaFunction step.
Note
The aws:invokeLambdaFunction action supports automatic throttling
retry. For more information, see Configuring automatic retry for
throttled operations.
Input
This action supports most invoked parameters for the Lambda service. For more information, see Invoke.
- FunctionName
-
The name of the Lambda function. This function must exist.
Type: String
Required: Yes
- Qualifier
-
The function version or alias name.
Type: String
Required: No
- InvocationType
-
The invocation type. The default value is
RequestResponse.Type: String
Valid values:
Event|RequestResponse|DryRunRequired: No
- LogType
-
If the default value is
Tail, the invocation type must beRequestResponse. Lambda returns the last 4 KB of log data produced by your Lambda function, base64-encoded.Type: String
Valid values:
None|TailRequired: No
- ClientContext
-
The client-specific information.
Required: No
- InputPayload
-
A YAML or JSON object that is passed to the first parameter of the handler. You can use this input to pass data to the function. This input provides more flexibility and support than the legacy
Payloadinput. If you define bothInputPayloadandPayloadfor the action,InputPayloadtakes precedence and thePayloadvalue is not used.Type: StringMap
Required: No
- Payload
-
A JSON string that's passed to the first parameter of the handler. This can be used to pass input data to the function. We recommend using
InputPayloadinput for added functionality.Type: String
Required: No
Output
- StatusCode
-
The HTTP status code.
- FunctionError
-
If present, it indicates that an error occurred while executing the function. Error details are included in the response payload.
- LogResult
-
The base64-encoded logs for the Lambda function invocation. Logs are present only if the invocation type is
RequestResponse, and the logs were requested. - Payload
-
The JSON representation of the object returned by the Lambda function. Payload is present only if the invocation type is
RequestResponse.
The following is a portion from the AWS-PatchInstanceWithRollback runbook
demonstrating how to reference outputs from the aws:invokeLambdaFunction
action.