Package software.amazon.awscdk.services.stepfunctions

Interface DistributedMapJsonPathProps

All Superinterfaces:
AssignableStateOptions, software.amazon.jsii.JsiiSerializable, JsonPathCommonOptions, MapBaseJsonPathOptions, MapBaseOptions, StateBaseProps
All Known Implementing Classes:
DistributedMapJsonPathProps.Jsii$Proxy
@Generated(value="jsii-pacmak/1.116.0 (build 0eddcff)", date="2025-10-24T13:34:47.824Z") @Stability(Stable) public interface DistributedMapJsonPathProps extends software.amazon.jsii.JsiiSerializable, StateBaseProps, MapBaseOptions, MapBaseJsonPathOptions
Properties for configuring a Distribute Map state that 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.services.stepfunctions.*;
 Object assign;
 ItemBatcher itemBatcher;
 IItemReader itemReader;
 Object itemSelector;
 Object resultSelector;
 ResultWriter resultWriter;
 ResultWriterV2 resultWriterV2;
 DistributedMapJsonPathProps distributedMapJsonPathProps = DistributedMapJsonPathProps.builder()
         .assign(Map.of(
                 "assignKey", assign))
         .comment("comment")
         .inputPath("inputPath")
         .itemBatcher(itemBatcher)
         .itemReader(itemReader)
         .itemSelector(Map.of(
                 "itemSelectorKey", itemSelector))
         .itemsPath("itemsPath")
         .jsonataItemSelector("jsonataItemSelector")
         .label("label")
         .mapExecutionType(StateMachineType.EXPRESS)
         .maxConcurrency(123)
         .maxConcurrencyPath("maxConcurrencyPath")
         .outputPath("outputPath")
         .queryLanguage(QueryLanguage.JSON_PATH)
         .resultPath("resultPath")
         .resultSelector(Map.of(
                 "resultSelectorKey", resultSelector))
         .resultWriter(resultWriter)
         .resultWriterV2(resultWriterV2)
         .stateName("stateName")
         .toleratedFailureCount(123)
         .toleratedFailureCountPath("toleratedFailureCountPath")
         .toleratedFailurePercentage(123)
         .toleratedFailurePercentagePath("toleratedFailurePercentagePath")
         .build();

  • Method Details

    • getItemBatcher

      @Stability(Stable) @Nullable default ItemBatcher getItemBatcher()
      Specifies to process a group of items in a single child workflow execution.

      Default: - No itemBatcher

    • getItemReader

      @Stability(Stable) @Nullable default IItemReader getItemReader()
      ItemReader.

      Configuration for where to read items dataset in S3 to iterate

      Default: - No itemReader

    • getLabel

      @Stability(Stable) @Nullable default String getLabel()
      Label.

      Unique name for the Distributed Map state added to each Map Run

      Default: - No label

    • getMapExecutionType

      @Stability(Stable) @Nullable default StateMachineType getMapExecutionType()
      MapExecutionType.

      The execution type of the distributed map state

      This property overwrites ProcessorConfig.executionType

      Default: StateMachineType.STANDARD

    • getResultWriter

      @Stability(Deprecated) @Deprecated @Nullable default ResultWriter getResultWriter()
      Deprecated.
      Use
      invalid reference 
      resultWriterV2
      (deprecated) Configuration for S3 location in which to save Map Run results.

      Default: - No resultWriter

    • getResultWriterV2

      @Stability(Stable) @Nullable default ResultWriterV2 getResultWriterV2()
      Configuration for S3 location in which to save Map Run results Enable "@aws-cdk/aws-stepfunctions:useDistributedMapResultWriterV2" feature in the context to use resultWriterV2 Example: stack.node.setContext("@aws-cdk/aws-stepfunctions:useDistributedMapResultWriterV2", true);

      Default: - No resultWriterV2

    • getToleratedFailureCount

      @Stability(Stable) @Nullable default Number getToleratedFailureCount()
      ToleratedFailureCount.

      Number of failed items to tolerate in a Map Run, as static number

      Default: - No toleratedFailureCount

    • getToleratedFailureCountPath

      @Stability(Stable) @Nullable default String getToleratedFailureCountPath()
      ToleratedFailureCountPath.

      Number of failed items to tolerate in a Map Run, as JsonPath

      Default: - No toleratedFailureCountPath

    • getToleratedFailurePercentage

      @Stability(Stable) @Nullable default Number getToleratedFailurePercentage()
      ToleratedFailurePercentage.

      Percentage of failed items to tolerate in a Map Run, as static number

      Default: - No toleratedFailurePercentage

    • getToleratedFailurePercentagePath

      @Stability(Stable) @Nullable default String getToleratedFailurePercentagePath()
      ToleratedFailurePercentagePath.

      Percentage of failed items to tolerate in a Map Run, as JsonPath

      Default: - No toleratedFailurePercentagePath

    • builder

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