Package software.amazon.awscdk.services.stepfunctions.tasks

Interface LambdaInvokeJsonataProps

All Superinterfaces:
AssignableStateOptions, software.amazon.jsii.JsiiSerializable, JsonataCommonOptions, StateBaseProps, TaskStateBaseOptions, TaskStateJsonataBaseProps
All Known Implementing Classes:
LambdaInvokeJsonataProps.Jsii$Proxy
@Generated(value="jsii-pacmak/1.118.0 (build 02eec31)", date="2025-11-04T09:27:51.609Z") @Stability(Stable) public interface LambdaInvokeJsonataProps extends software.amazon.jsii.JsiiSerializable, TaskStateJsonataBaseProps
Properties for invoking a Lambda function with LambdaInvoke using Jsonata.

Example: 

 import software.amazon.awscdk.services.lambda.*;
 Function callApiFunc;
 Function useVariableFunc;
 LambdaInvoke step1 = LambdaInvoke.jsonata(this, "Step 1", LambdaInvokeJsonataProps.builder()
         .lambdaFunction(callApiFunc)
         .assign(Map.of(
                 "x", "{% $states.result.Payload.x %}"))
         .build());
 Pass step2 = Pass.jsonata(this, "Step 2");
 Pass step3 = Pass.jsonata(this, "Step 3");
 Pass step4 = Pass.jsonata(this, "Step 4");
 LambdaInvoke step5 = LambdaInvoke.jsonata(this, "Step 5", LambdaInvokeJsonataProps.builder()
         .lambdaFunction(useVariableFunc)
         .payload(TaskInput.fromObject(Map.of(
                 "x", "{% $x %}")))
         .build());

  • Method Details

    • getLambdaFunction

      @Stability(Stable) @NotNull IFunction getLambdaFunction()
      Lambda function to invoke.

    • getClientContext

      @Stability(Stable) @Nullable default String getClientContext()
      Up to 3583 bytes of base64-encoded data about the invoking client to pass to the function.

      Default: - No context

    • getInvocationType

      @Stability(Stable) @Nullable default LambdaInvocationType getInvocationType()
      Invocation type of the Lambda function.

      Default: InvocationType.REQUEST_RESPONSE

    • getPayload

      @Stability(Stable) @Nullable default TaskInput getPayload()
      The JSON that will be supplied as input to the Lambda function.

      Default: - The state input (JSONata: '{% $states.input %}', JSONPath: '$')

    • getPayloadResponseOnly

      @Stability(Stable) @Nullable default Boolean getPayloadResponseOnly()
      Invoke the Lambda in a way that only returns the payload response without additional metadata.

      The payloadResponseOnly property cannot be used if integrationPattern, invocationType, clientContext, or qualifier are specified. It always uses the REQUEST_RESPONSE behavior.

      Default: false

    • getQualifier

      @Stability(Deprecated) @Deprecated @Nullable default String getQualifier()
      Deprecated.
      pass a Version or Alias object as lambdaFunction instead
      (deprecated) Version or alias to invoke a published version of the function.

      You only need to supply this if you want the version of the Lambda Function to depend on data in the state machine state. If not, you can pass the appropriate Alias or Version object directly as the lambdaFunction argument.

      Default: - Version or alias inherent to the `lambdaFunction` object.

    • getRetryOnServiceExceptions

      @Stability(Stable) @Nullable default Boolean getRetryOnServiceExceptions()
      Whether to retry on Lambda service exceptions.

      This handles Lambda.ServiceException, Lambda.AWSLambdaException, Lambda.SdkClientException, and Lambda.ClientExecutionTimeoutException with an interval of 2 seconds, a back-off rate of 2 and 6 maximum attempts.

      Default: true

      See Also:

    • builder

      @Stability(Stable) static LambdaInvokeJsonataProps.Builder builder()
      Returns:
      a LambdaInvokeJsonataProps.Builder of LambdaInvokeJsonataProps