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

Interface LambdaInvokeJsonPathProps

All Superinterfaces:
AssignableStateOptions, software.amazon.jsii.JsiiSerializable, JsonPathCommonOptions, StateBaseProps, TaskStateBaseOptions, TaskStateJsonPathBaseProps
All Known Implementing Classes:
LambdaInvokeJsonPathProps.Jsii$Proxy
@Generated(value="jsii-pacmak/1.109.0 (build c221850)", date="2025-03-14T03:25:06.466Z") @Stability(Stable) public interface LambdaInvokeJsonPathProps extends software.amazon.jsii.JsiiSerializable, TaskStateJsonPathBaseProps
Properties for invoking a Lambda function with LambdaInvoke using JsonPath.

Example: 

 // The code below shows an example of how to instantiate this type.
 // The values are placeholders you should change.
 import software.amazon.awscdk.*;
 import software.amazon.awscdk.services.lambda.*;
 import software.amazon.awscdk.services.stepfunctions.*;
 import software.amazon.awscdk.services.stepfunctions.tasks.*;
 Object assign;
 Function function_;
 Object resultSelector;
 TaskInput taskInput;
 TaskRole taskRole;
 Timeout timeout;
 LambdaInvokeJsonPathProps lambdaInvokeJsonPathProps = LambdaInvokeJsonPathProps.builder()
         .lambdaFunction(function_)
         // the properties below are optional
         .assign(Map.of(
                 "assignKey", assign))
         .clientContext("clientContext")
         .comment("comment")
         .credentials(Credentials.builder()
                 .role(taskRole)
                 .build())
         .heartbeat(Duration.minutes(30))
         .heartbeatTimeout(timeout)
         .inputPath("inputPath")
         .integrationPattern(IntegrationPattern.REQUEST_RESPONSE)
         .invocationType(LambdaInvocationType.REQUEST_RESPONSE)
         .outputPath("outputPath")
         .payload(taskInput)
         .payloadResponseOnly(false)
         .qualifier("qualifier")
         .queryLanguage(QueryLanguage.JSON_PATH)
         .resultPath("resultPath")
         .resultSelector(Map.of(
                 "resultSelectorKey", resultSelector))
         .retryOnServiceExceptions(false)
         .stateName("stateName")
         .taskTimeout(timeout)
         .timeout(Duration.minutes(30))
         .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 LambdaInvokeJsonPathProps.Builder builder()
      Returns:
      a LambdaInvokeJsonPathProps.Builder of LambdaInvokeJsonPathProps