aws-cdk-lib 2.162.1__py3-none-any.whl → 2.163.1__py3-none-any.whl

aws_cdk/aws_stepfunctions/__init__.py

@@ -560,16 +560,150 @@ distributed_map = sfn.DistributedMap(self, "Distributed Map State",
 distributed_map.item_processor(sfn.Pass(self, "Pass State"))
 ```
 
-Map states in Distributed mode support multiple sources for an array to iterate:
-
-* JSON array from the state input payload
-* objects in an S3 bucket and optional prefix
+`DistributedMap` supports various input source types to determine a list of objects to iterate over:
+
+* JSON array from the JSON state input
+
+  * By default, `DistributedMap` assumes whole JSON state input is an JSON array and iterates over it:
+
+  ```python
+  #
+  # JSON state input:
+  #  [
+  #    "item1",
+  #    "item2"
+  #  ]
+  #
+  distributed_map = sfn.DistributedMap(self, "DistributedMap")
+  distributed_map.item_processor(sfn.Pass(self, "Pass"))
+  ```
+
+  * When input source is present at a specific path in JSON state input, then `itemsPath` can be utilised to configure the iterator source.
+
+  ```python
+  #
+  # JSON state input:
+  #  {
+  #    "distributedMapItemList": [
+  #      "item1",
+  #      "item2"
+  #    ]
+  #  }
+  #
+  distributed_map = sfn.DistributedMap(self, "DistributedMap",
+      items_path="$.distributedMapItemList"
+  )
+  distributed_map.item_processor(sfn.Pass(self, "Pass"))
+  ```
+* Objects in a S3 bucket with an optional prefix.
+
+  * When `DistributedMap` is required to iterate over objects stored in a S3 bucket, then an object of `S3ObjectsItemReader` can be passed to `itemReader` to configure the iterator source as follows:
+
+  ```python
+  import aws_cdk.aws_s3 as s3
+
+
+  #
+  # Tree view of bucket:
+  #  my-bucket
+  #  |
+  #  +--item1
+  #  |
+  #  +--otherItem
+  #  |
+  #  +--item2
+  #  |
+  #  ...
+  #
+  bucket = s3.Bucket(self, "Bucket",
+      bucket_name="my-bucket"
+  )
+
+  distributed_map = sfn.DistributedMap(self, "DistributedMap",
+      item_reader=sfn.S3ObjectsItemReader(
+          bucket=bucket,
+          prefix="item"
+      )
+  )
+  distributed_map.item_processor(sfn.Pass(self, "Pass"))
+  ```
+
+  * If information about `bucket` is only known while starting execution of `StateMachine` (dynamically or at run-time) via JSON state input:
+
+  ```python
+  #
+  # JSON state input:
+  #  {
+  #    "bucketName": "my-bucket",
+  #    "prefix": "item"
+  #  }
+  #
+  distributed_map = sfn.DistributedMap(self, "DistributedMap",
+      item_reader=sfn.S3ObjectsItemReader(
+          bucket_name_path=sfn.JsonPath.string_at("$.bucketName"),
+          prefix=sfn.JsonPath.string_at("$.prefix")
+      )
+  )
+  distributed_map.item_processor(sfn.Pass(self, "Pass"))
+  ```
+
+  * Both `bucket` and `bucketNamePath` are mutually exclusive.
 * JSON array in a JSON file stored in S3
+
+  * When `DistributedMap` is required to iterate over a JSON array stored in a JSON file in a S3 bucket, then an object of `S3JsonItemReader` can be passed to `itemReader` to configure the iterator source as follows:
+
+  ```python
+  import aws_cdk.aws_s3 as s3
+
+
+  #
+  # Tree view of bucket:
+  #  my-bucket
+  #  |
+  #  +--input.json
+  #  |
+  #  ...
+  #
+  # File content of input.json:
+  #  [
+  #    "item1",
+  #    "item2"
+  #  ]
+  #
+  bucket = s3.Bucket(self, "Bucket",
+      bucket_name="my-bucket"
+  )
+
+  distributed_map = sfn.DistributedMap(self, "DistributedMap",
+      item_reader=sfn.S3JsonItemReader(
+          bucket=bucket,
+          key="input.json"
+      )
+  )
+  distributed_map.item_processor(sfn.Pass(self, "Pass"))
+  ```
+
+  * If information about `bucket` is only known while starting execution of `StateMachine` (dynamically or at run-time) via state input:
+
+  ```python
+  #
+  # JSON state input:
+  #  {
+  #    "bucketName": "my-bucket",
+  #    "key": "input.json"
+  #  }
+  #
+  distributed_map = sfn.DistributedMap(self, "DistributedMap",
+      item_reader=sfn.S3JsonItemReader(
+          bucket_name_path=sfn.JsonPath.string_at("$.bucketName"),
+          key=sfn.JsonPath.string_at("$.key")
+      )
+  )
+  distributed_map.item_processor(sfn.Pass(self, "Pass"))
+  ```
 * CSV file stored in S3
 * S3 inventory manifest stored in S3
 
-There are multiple classes that implement `IItemReader` that can be used to configure the iterator source.  These can be provided via the optional `itemReader` property.  The default behavior if `itemReader` is omitted is to use the input payload.
-
 Map states in Distributed mode also support writing results of the iterator to an S3 bucket and optional prefix.  Use a `ResultWriter` object provided via the optional `resultWriter` property to configure which S3 location iterator results will be written. The default behavior id `resultWriter` is omitted is to use the state output payload. However, if the iterator results are larger than the 256 kb limit for Step Functions payloads then the State Machine will fail.
 
 ```python
@@ -580,10 +714,6 @@ import aws_cdk.aws_s3 as s3
 bucket = s3.Bucket(self, "Bucket")
 
 distributed_map = sfn.DistributedMap(self, "Distributed Map State",
-    item_reader=sfn.S3JsonItemReader(
-        bucket=bucket,
-        key="my-key.json"
-    ),
     result_writer=sfn.ResultWriter(
         bucket=bucket,
         prefix="my-prefix"
@@ -6043,6 +6173,12 @@ class IItemReader(typing_extensions.Protocol):
         '''The Amazon S3 API action that Step Functions must invoke depending on the specified dataset.'''
         ...
 
+    @builtins.property
+    @jsii.member(jsii_name="bucketNamePath")
+    def bucket_name_path(self) -> typing.Optional[builtins.str]:
+        '''S3 bucket name containing objects to iterate over or a file with a list to iterate over, as JsonPath.'''
+        ...
+
     @builtins.property
     @jsii.member(jsii_name="maxItems")
     def max_items(self) -> typing.Optional[jsii.Number]:
@@ -6062,6 +6198,14 @@ class IItemReader(typing_extensions.Protocol):
         '''Render the ItemReader as JSON object.'''
         ...
 
+    @jsii.member(jsii_name="validateItemReader")
+    def validate_item_reader(self) -> typing.List[builtins.str]:
+        '''Validate that ItemReader contains exactly either.
+
+        :see: bucketNamePath
+        '''
+        ...
+
 
 class _IItemReaderProxy:
     '''Base interface for Item Reader configurations.'''
@@ -6080,6 +6224,12 @@ class _IItemReaderProxy:
         '''The Amazon S3 API action that Step Functions must invoke depending on the specified dataset.'''
         return typing.cast(builtins.str, jsii.get(self, "resource"))
 
+    @builtins.property
+    @jsii.member(jsii_name="bucketNamePath")
+    def bucket_name_path(self) -> typing.Optional[builtins.str]:
+        '''S3 bucket name containing objects to iterate over or a file with a list to iterate over, as JsonPath.'''
+        return typing.cast(typing.Optional[builtins.str], jsii.get(self, "bucketNamePath"))
+
     @builtins.property
     @jsii.member(jsii_name="maxItems")
     def max_items(self) -> typing.Optional[jsii.Number]:
@@ -6099,6 +6249,14 @@ class _IItemReaderProxy:
         '''Render the ItemReader as JSON object.'''
         return typing.cast(typing.Any, jsii.invoke(self, "render", []))
 
+    @jsii.member(jsii_name="validateItemReader")
+    def validate_item_reader(self) -> typing.List[builtins.str]:
+        '''Validate that ItemReader contains exactly either.
+
+        :see: bucketNamePath
+        '''
+        return typing.cast(typing.List[builtins.str], jsii.invoke(self, "validateItemReader", []))
+
 # Adding a "__jsii_proxy_class__(): typing.Type" function to the interface
 typing.cast(typing.Any, IItemReader).__jsii_proxy_class__ = lambda : _IItemReaderProxy
 
@@ -7157,18 +7315,24 @@ class ItemBatcherProps:
 @jsii.data_type(
     jsii_type="aws-cdk-lib.aws_stepfunctions.ItemReaderProps",
     jsii_struct_bases=[],
-    name_mapping={"bucket": "bucket", "max_items": "maxItems"},
+    name_mapping={
+        "bucket": "bucket",
+        "bucket_name_path": "bucketNamePath",
+        "max_items": "maxItems",
+    },
 )
 class ItemReaderProps:
     def __init__(
         self,
         *,
-        bucket: _IBucket_42e086fd,
+        bucket: typing.Optional[_IBucket_42e086fd] = None,
+        bucket_name_path: typing.Optional[builtins.str] = None,
         max_items: typing.Optional[jsii.Number] = None,
     ) -> None:
         '''Base interface for Item Reader configuration properties.
 
-        :param bucket: S3 Bucket containing objects to iterate over or a file with a list to iterate over.
+        :param bucket: S3 Bucket containing objects to iterate over or a file with a list to iterate over. Default: - S3 bucket will be determined from
+        :param bucket_name_path: S3 bucket name containing objects to iterate over or a file with a list to iterate over, as JsonPath. Default: - S3 bucket will be determined from
         :param max_items: Limits the number of items passed to the Distributed Map state. Default: - Distributed Map state will iterate over all items provided by the ItemReader
 
         :exampleMetadata: fixture=_generated
@@ -7184,27 +7348,44 @@ class ItemReaderProps:
             
             item_reader_props = stepfunctions.ItemReaderProps(
                 bucket=bucket,
-            
-                # the properties below are optional
+                bucket_name_path="bucketNamePath",
                 max_items=123
             )
         '''
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__e8df53cde2f82ea6228f0c9a5a5ba0a4dd36c18fba9835f9f3150547f7cee754)
             check_type(argname="argument bucket", value=bucket, expected_type=type_hints["bucket"])
+            check_type(argname="argument bucket_name_path", value=bucket_name_path, expected_type=type_hints["bucket_name_path"])
             check_type(argname="argument max_items", value=max_items, expected_type=type_hints["max_items"])
-        self._values: typing.Dict[builtins.str, typing.Any] = {
-            "bucket": bucket,
-        }
+        self._values: typing.Dict[builtins.str, typing.Any] = {}
+        if bucket is not None:
+            self._values["bucket"] = bucket
+        if bucket_name_path is not None:
+            self._values["bucket_name_path"] = bucket_name_path
         if max_items is not None:
             self._values["max_items"] = max_items
 
     @builtins.property
-    def bucket(self) -> _IBucket_42e086fd:
-        '''S3 Bucket containing objects to iterate over or a file with a list to iterate over.'''
+    def bucket(self) -> typing.Optional[_IBucket_42e086fd]:
+        '''S3 Bucket containing objects to iterate over or a file with a list to iterate over.
+
+        :default: - S3 bucket will be determined from
+
+        :see: bucketNamePath
+        '''
         result = self._values.get("bucket")
-        assert result is not None, "Required property 'bucket' is missing"
-        return typing.cast(_IBucket_42e086fd, result)
+        return typing.cast(typing.Optional[_IBucket_42e086fd], result)
+
+    @builtins.property
+    def bucket_name_path(self) -> typing.Optional[builtins.str]:
+        '''S3 bucket name containing objects to iterate over or a file with a list to iterate over, as JsonPath.
+
+        :default: - S3 bucket will be determined from
+
+        :see: bucket
+        '''
+        result = self._values.get("bucket_name_path")
+        return typing.cast(typing.Optional[builtins.str], result)
 
     @builtins.property
     def max_items(self) -> typing.Optional[jsii.Number]:
@@ -7278,19 +7459,20 @@ class JsonPath(
 
     Example::
 
-        submit_job_activity = sfn.Activity(self, "SubmitJob")
-        
-        tasks.StepFunctionsInvokeActivity(self, "Submit Job",
-            activity=submit_job_activity,
-            parameters={
-                "comment": "Selecting what I care about.",
-                "MyDetails": {
-                    "size": sfn.JsonPath.string_at("$.product.details.size"),
-                    "exists": sfn.JsonPath.string_at("$.product.availability"),
-                    "StaticValue": "foo"
-                }
-            }
+        #
+        # JSON state input:
+        #  {
+        #    "bucketName": "my-bucket",
+        #    "prefix": "item"
+        #  }
+        #
+        distributed_map = sfn.DistributedMap(self, "DistributedMap",
+            item_reader=sfn.S3ObjectsItemReader(
+                bucket_name_path=sfn.JsonPath.string_at("$.bucketName"),
+                prefix=sfn.JsonPath.string_at("$.prefix")
+            )
         )
+        distributed_map.item_processor(sfn.Pass(self, "Pass"))
     '''
 
     @jsii.member(jsii_name="array")
@@ -8983,10 +9165,6 @@ class ResultWriter(
         bucket = s3.Bucket(self, "Bucket")
         
         distributed_map = sfn.DistributedMap(self, "Distributed Map State",
-            item_reader=sfn.S3JsonItemReader(
-                bucket=bucket,
-                key="my-key.json"
-            ),
             result_writer=sfn.ResultWriter(
                 bucket=bucket,
                 prefix="my-prefix"
@@ -9063,10 +9241,6 @@ class ResultWriterProps:
             bucket = s3.Bucket(self, "Bucket")
             
             distributed_map = sfn.DistributedMap(self, "Distributed Map State",
-                item_reader=sfn.S3JsonItemReader(
-                    bucket=bucket,
-                    key="my-key.json"
-                ),
                 result_writer=sfn.ResultWriter(
                     bucket=bucket,
                     prefix="my-prefix"
@@ -9287,10 +9461,11 @@ class S3CsvItemReader(
         # csv_headers: stepfunctions.CsvHeaders
         
         s3_csv_item_reader = stepfunctions.S3CsvItemReader(
-            bucket=bucket,
             key="key",
         
             # the properties below are optional
+            bucket=bucket,
+            bucket_name_path="bucketNamePath",
             csv_headers=csv_headers,
             max_items=123
         )
@@ -9301,17 +9476,23 @@ class S3CsvItemReader(
         *,
         csv_headers: typing.Optional[CsvHeaders] = None,
         key: builtins.str,
-        bucket: _IBucket_42e086fd,
+        bucket: typing.Optional[_IBucket_42e086fd] = None,
+        bucket_name_path: typing.Optional[builtins.str] = None,
         max_items: typing.Optional[jsii.Number] = None,
     ) -> None:
         '''
         :param csv_headers: CSV file header configuration. Default: - CsvHeaders with CsvHeadersLocation.FIRST_ROW
         :param key: Key of file stored in S3 bucket containing an array to iterate over.
-        :param bucket: S3 Bucket containing objects to iterate over or a file with a list to iterate over.
+        :param bucket: S3 Bucket containing objects to iterate over or a file with a list to iterate over. Default: - S3 bucket will be determined from
+        :param bucket_name_path: S3 bucket name containing objects to iterate over or a file with a list to iterate over, as JsonPath. Default: - S3 bucket will be determined from
         :param max_items: Limits the number of items passed to the Distributed Map state. Default: - Distributed Map state will iterate over all items provided by the ItemReader
         '''
         props = S3CsvItemReaderProps(
-            csv_headers=csv_headers, key=key, bucket=bucket, max_items=max_items
+            csv_headers=csv_headers,
+            key=key,
+            bucket=bucket,
+            bucket_name_path=bucket_name_path,
+            max_items=max_items,
         )
 
         jsii.create(self.__class__, self, [props])
@@ -9326,6 +9507,14 @@ class S3CsvItemReader(
         '''Renders the ItemReader configuration as JSON object.'''
         return typing.cast(typing.Any, jsii.invoke(self, "render", []))
 
+    @jsii.member(jsii_name="validateItemReader")
+    def validate_item_reader(self) -> typing.List[builtins.str]:
+        '''Validate that ItemReader contains exactly either.
+
+        :see: bucketNamePath
+        '''
+        return typing.cast(typing.List[builtins.str], jsii.invoke(self, "validateItemReader", []))
+
     @builtins.property
     @jsii.member(jsii_name="bucket")
     def bucket(self) -> _IBucket_42e086fd:
@@ -9355,6 +9544,12 @@ class S3CsvItemReader(
         '''ARN for the ``getObject`` method of the S3 API This API method is used to iterate all objects in the S3 bucket/prefix.'''
         return typing.cast(builtins.str, jsii.get(self, "resource"))
 
+    @builtins.property
+    @jsii.member(jsii_name="bucketNamePath")
+    def bucket_name_path(self) -> typing.Optional[builtins.str]:
+        '''S3 bucket name containing objects to iterate over or a file with a list to iterate over, as JsonPath.'''
+        return typing.cast(typing.Optional[builtins.str], jsii.get(self, "bucketNamePath"))
+
     @builtins.property
     @jsii.member(jsii_name="maxItems")
     def max_items(self) -> typing.Optional[jsii.Number]:
@@ -9368,19 +9563,26 @@ class S3CsvItemReader(
 @jsii.data_type(
     jsii_type="aws-cdk-lib.aws_stepfunctions.S3FileItemReaderProps",
     jsii_struct_bases=[ItemReaderProps],
-    name_mapping={"bucket": "bucket", "max_items": "maxItems", "key": "key"},
+    name_mapping={
+        "bucket": "bucket",
+        "bucket_name_path": "bucketNamePath",
+        "max_items": "maxItems",
+        "key": "key",
+    },
 )
 class S3FileItemReaderProps(ItemReaderProps):
     def __init__(
         self,
         *,
-        bucket: _IBucket_42e086fd,
+        bucket: typing.Optional[_IBucket_42e086fd] = None,
+        bucket_name_path: typing.Optional[builtins.str] = None,
         max_items: typing.Optional[jsii.Number] = None,
         key: builtins.str,
     ) -> None:
         '''Base interface for Item Reader configuration properties the iterate over entries in a S3 file.
 
-        :param bucket: S3 Bucket containing objects to iterate over or a file with a list to iterate over.
+        :param bucket: S3 Bucket containing objects to iterate over or a file with a list to iterate over. Default: - S3 bucket will be determined from
+        :param bucket_name_path: S3 bucket name containing objects to iterate over or a file with a list to iterate over, as JsonPath. Default: - S3 bucket will be determined from
         :param max_items: Limits the number of items passed to the Distributed Map state. Default: - Distributed Map state will iterate over all items provided by the ItemReader
         :param key: Key of file stored in S3 bucket containing an array to iterate over.
 
@@ -9391,39 +9593,69 @@ class S3FileItemReaderProps(ItemReaderProps):
             import aws_cdk.aws_s3 as s3
             
             
-            # create a bucket
-            bucket = s3.Bucket(self, "Bucket")
+            #
+            # Tree view of bucket:
+            #  my-bucket
+            #  |
+            #  +--input.json
+            #  |
+            #  ...
+            #
+            # File content of input.json:
+            #  [
+            #    "item1",
+            #    "item2"
+            #  ]
+            #
+            bucket = s3.Bucket(self, "Bucket",
+                bucket_name="my-bucket"
+            )
             
-            distributed_map = sfn.DistributedMap(self, "Distributed Map State",
+            distributed_map = sfn.DistributedMap(self, "DistributedMap",
                 item_reader=sfn.S3JsonItemReader(
                     bucket=bucket,
-                    key="my-key.json"
-                ),
-                result_writer=sfn.ResultWriter(
-                    bucket=bucket,
-                    prefix="my-prefix"
+                    key="input.json"
                 )
             )
-            distributed_map.item_processor(sfn.Pass(self, "Pass State"))
+            distributed_map.item_processor(sfn.Pass(self, "Pass"))
         '''
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__fc17fd96c577f0b5f18e9d0043337043a5db7cf7c35fdc1b09e959cf7f58221c)
             check_type(argname="argument bucket", value=bucket, expected_type=type_hints["bucket"])
+            check_type(argname="argument bucket_name_path", value=bucket_name_path, expected_type=type_hints["bucket_name_path"])
             check_type(argname="argument max_items", value=max_items, expected_type=type_hints["max_items"])
             check_type(argname="argument key", value=key, expected_type=type_hints["key"])
         self._values: typing.Dict[builtins.str, typing.Any] = {
-            "bucket": bucket,
             "key": key,
         }
+        if bucket is not None:
+            self._values["bucket"] = bucket
+        if bucket_name_path is not None:
+            self._values["bucket_name_path"] = bucket_name_path
         if max_items is not None:
             self._values["max_items"] = max_items
 
     @builtins.property
-    def bucket(self) -> _IBucket_42e086fd:
-        '''S3 Bucket containing objects to iterate over or a file with a list to iterate over.'''
+    def bucket(self) -> typing.Optional[_IBucket_42e086fd]:
+        '''S3 Bucket containing objects to iterate over or a file with a list to iterate over.
+
+        :default: - S3 bucket will be determined from
+
+        :see: bucketNamePath
+        '''
         result = self._values.get("bucket")
-        assert result is not None, "Required property 'bucket' is missing"
-        return typing.cast(_IBucket_42e086fd, result)
+        return typing.cast(typing.Optional[_IBucket_42e086fd], result)
+
+    @builtins.property
+    def bucket_name_path(self) -> typing.Optional[builtins.str]:
+        '''S3 bucket name containing objects to iterate over or a file with a list to iterate over, as JsonPath.
+
+        :default: - S3 bucket will be determined from
+
+        :see: bucket
+        '''
+        result = self._values.get("bucket_name_path")
+        return typing.cast(typing.Optional[builtins.str], result)
 
     @builtins.property
     def max_items(self) -> typing.Optional[jsii.Number]:
@@ -9467,35 +9699,53 @@ class S3JsonItemReader(
         import aws_cdk.aws_s3 as s3
         
         
-        # create a bucket
-        bucket = s3.Bucket(self, "Bucket")
+        #
+        # Tree view of bucket:
+        #  my-bucket
+        #  |
+        #  +--input.json
+        #  |
+        #  ...
+        #
+        # File content of input.json:
+        #  [
+        #    "item1",
+        #    "item2"
+        #  ]
+        #
+        bucket = s3.Bucket(self, "Bucket",
+            bucket_name="my-bucket"
+        )
         
-        distributed_map = sfn.DistributedMap(self, "Distributed Map State",
+        distributed_map = sfn.DistributedMap(self, "DistributedMap",
             item_reader=sfn.S3JsonItemReader(
                 bucket=bucket,
-                key="my-key.json"
-            ),
-            result_writer=sfn.ResultWriter(
-                bucket=bucket,
-                prefix="my-prefix"
+                key="input.json"
             )
         )
-        distributed_map.item_processor(sfn.Pass(self, "Pass State"))
+        distributed_map.item_processor(sfn.Pass(self, "Pass"))
     '''
 
     def __init__(
         self,
         *,
         key: builtins.str,
-        bucket: _IBucket_42e086fd,
+        bucket: typing.Optional[_IBucket_42e086fd] = None,
+        bucket_name_path: typing.Optional[builtins.str] = None,
         max_items: typing.Optional[jsii.Number] = None,
     ) -> None:
         '''
         :param key: Key of file stored in S3 bucket containing an array to iterate over.
-        :param bucket: S3 Bucket containing objects to iterate over or a file with a list to iterate over.
+        :param bucket: S3 Bucket containing objects to iterate over or a file with a list to iterate over. Default: - S3 bucket will be determined from
+        :param bucket_name_path: S3 bucket name containing objects to iterate over or a file with a list to iterate over, as JsonPath. Default: - S3 bucket will be determined from
         :param max_items: Limits the number of items passed to the Distributed Map state. Default: - Distributed Map state will iterate over all items provided by the ItemReader
         '''
-        props = S3FileItemReaderProps(key=key, bucket=bucket, max_items=max_items)
+        props = S3FileItemReaderProps(
+            key=key,
+            bucket=bucket,
+            bucket_name_path=bucket_name_path,
+            max_items=max_items,
+        )
 
         jsii.create(self.__class__, self, [props])
 
@@ -9512,6 +9762,14 @@ class S3JsonItemReader(
         '''
         return typing.cast(typing.Any, jsii.invoke(self, "render", []))
 
+    @jsii.member(jsii_name="validateItemReader")
+    def validate_item_reader(self) -> typing.List[builtins.str]:
+        '''Validate that ItemReader contains exactly either.
+
+        :see: bucketNamePath
+        '''
+        return typing.cast(typing.List[builtins.str], jsii.invoke(self, "validateItemReader", []))
+
     @builtins.property
     @jsii.member(jsii_name="bucket")
     def bucket(self) -> _IBucket_42e086fd:
@@ -9535,6 +9793,12 @@ class S3JsonItemReader(
         '''ARN for the ``getObject`` method of the S3 API This API method is used to iterate all objects in the S3 bucket/prefix.'''
         return typing.cast(builtins.str, jsii.get(self, "resource"))
 
+    @builtins.property
+    @jsii.member(jsii_name="bucketNamePath")
+    def bucket_name_path(self) -> typing.Optional[builtins.str]:
+        '''S3 bucket name containing objects to iterate over or a file with a list to iterate over, as JsonPath.'''
+        return typing.cast(typing.Optional[builtins.str], jsii.get(self, "bucketNamePath"))
+
     @builtins.property
     @jsii.member(jsii_name="maxItems")
     def max_items(self) -> typing.Optional[jsii.Number]:
@@ -9564,10 +9828,11 @@ class S3ManifestItemReader(
         # bucket: s3.Bucket
         
         s3_manifest_item_reader = stepfunctions.S3ManifestItemReader(
-            bucket=bucket,
             key="key",
         
             # the properties below are optional
+            bucket=bucket,
+            bucket_name_path="bucketNamePath",
             max_items=123
         )
     '''
@@ -9576,15 +9841,22 @@ class S3ManifestItemReader(
         self,
         *,
         key: builtins.str,
-        bucket: _IBucket_42e086fd,
+        bucket: typing.Optional[_IBucket_42e086fd] = None,
+        bucket_name_path: typing.Optional[builtins.str] = None,
         max_items: typing.Optional[jsii.Number] = None,
     ) -> None:
         '''
         :param key: Key of file stored in S3 bucket containing an array to iterate over.
-        :param bucket: S3 Bucket containing objects to iterate over or a file with a list to iterate over.
+        :param bucket: S3 Bucket containing objects to iterate over or a file with a list to iterate over. Default: - S3 bucket will be determined from
+        :param bucket_name_path: S3 bucket name containing objects to iterate over or a file with a list to iterate over, as JsonPath. Default: - S3 bucket will be determined from
         :param max_items: Limits the number of items passed to the Distributed Map state. Default: - Distributed Map state will iterate over all items provided by the ItemReader
         '''
-        props = S3FileItemReaderProps(key=key, bucket=bucket, max_items=max_items)
+        props = S3FileItemReaderProps(
+            key=key,
+            bucket=bucket,
+            bucket_name_path=bucket_name_path,
+            max_items=max_items,
+        )
 
         jsii.create(self.__class__, self, [props])
 
@@ -9601,6 +9873,14 @@ class S3ManifestItemReader(
         '''
         return typing.cast(typing.Any, jsii.invoke(self, "render", []))
 
+    @jsii.member(jsii_name="validateItemReader")
+    def validate_item_reader(self) -> typing.List[builtins.str]:
+        '''Validate that ItemReader contains exactly either.
+
+        :see: bucketNamePath
+        '''
+        return typing.cast(typing.List[builtins.str], jsii.invoke(self, "validateItemReader", []))
+
     @builtins.property
     @jsii.member(jsii_name="bucket")
     def bucket(self) -> _IBucket_42e086fd:
@@ -9624,6 +9904,12 @@ class S3ManifestItemReader(
         '''ARN for the ``getObject`` method of the S3 API This API method is used to iterate all objects in the S3 bucket/prefix.'''
         return typing.cast(builtins.str, jsii.get(self, "resource"))
 
+    @builtins.property
+    @jsii.member(jsii_name="bucketNamePath")
+    def bucket_name_path(self) -> typing.Optional[builtins.str]:
+        '''S3 bucket name containing objects to iterate over or a file with a list to iterate over, as JsonPath.'''
+        return typing.cast(typing.Optional[builtins.str], jsii.get(self, "bucketNamePath"))
+
     @builtins.property
     @jsii.member(jsii_name="maxItems")
     def max_items(self) -> typing.Optional[jsii.Number]:
@@ -9641,40 +9927,57 @@ class S3ObjectsItemReader(
 ):
     '''Item Reader configuration for iterating over objects in an S3 bucket.
 
-    :exampleMetadata: fixture=_generated
+    :exampleMetadata: infused
 
     Example::
 
-        # The code below shows an example of how to instantiate this type.
-        # The values are placeholders you should change.
-        from aws_cdk import aws_s3 as s3
-        from aws_cdk import aws_stepfunctions as stepfunctions
+        import aws_cdk.aws_s3 as s3
         
-        # bucket: s3.Bucket
         
-        s3_objects_item_reader = stepfunctions.S3ObjectsItemReader(
-            bucket=bucket,
+        #
+        # Tree view of bucket:
+        #  my-bucket
+        #  |
+        #  +--item1
+        #  |
+        #  +--otherItem
+        #  |
+        #  +--item2
+        #  |
+        #  ...
+        #
+        bucket = s3.Bucket(self, "Bucket",
+            bucket_name="my-bucket"
+        )
         
-            # the properties below are optional
-            max_items=123,
-            prefix="prefix"
+        distributed_map = sfn.DistributedMap(self, "DistributedMap",
+            item_reader=sfn.S3ObjectsItemReader(
+                bucket=bucket,
+                prefix="item"
+            )
         )
+        distributed_map.item_processor(sfn.Pass(self, "Pass"))
     '''
 
     def __init__(
         self,
         *,
         prefix: typing.Optional[builtins.str] = None,
-        bucket: _IBucket_42e086fd,
+        bucket: typing.Optional[_IBucket_42e086fd] = None,
+        bucket_name_path: typing.Optional[builtins.str] = None,
         max_items: typing.Optional[jsii.Number] = None,
     ) -> None:
         '''
         :param prefix: S3 prefix used to limit objects to iterate over. Default: - No prefix
-        :param bucket: S3 Bucket containing objects to iterate over or a file with a list to iterate over.
+        :param bucket: S3 Bucket containing objects to iterate over or a file with a list to iterate over. Default: - S3 bucket will be determined from
+        :param bucket_name_path: S3 bucket name containing objects to iterate over or a file with a list to iterate over, as JsonPath. Default: - S3 bucket will be determined from
         :param max_items: Limits the number of items passed to the Distributed Map state. Default: - Distributed Map state will iterate over all items provided by the ItemReader
         '''
         props = S3ObjectsItemReaderProps(
-            prefix=prefix, bucket=bucket, max_items=max_items
+            prefix=prefix,
+            bucket=bucket,
+            bucket_name_path=bucket_name_path,
+            max_items=max_items,
         )
 
         jsii.create(self.__class__, self, [props])
@@ -9692,6 +9995,14 @@ class S3ObjectsItemReader(
         '''
         return typing.cast(typing.Any, jsii.invoke(self, "render", []))
 
+    @jsii.member(jsii_name="validateItemReader")
+    def validate_item_reader(self) -> typing.List[builtins.str]:
+        '''Validate that ItemReader contains exactly either.
+
+        :see: bucketNamePath
+        '''
+        return typing.cast(typing.List[builtins.str], jsii.invoke(self, "validateItemReader", []))
+
     @builtins.property
     @jsii.member(jsii_name="bucket")
     def bucket(self) -> _IBucket_42e086fd:
@@ -9704,6 +10015,12 @@ class S3ObjectsItemReader(
         '''ARN for the ``listObjectsV2`` method of the S3 API This API method is used to iterate all objects in the S3 bucket/prefix.'''
         return typing.cast(builtins.str, jsii.get(self, "resource"))
 
+    @builtins.property
+    @jsii.member(jsii_name="bucketNamePath")
+    def bucket_name_path(self) -> typing.Optional[builtins.str]:
+        '''S3 bucket name containing objects to iterate over or a file with a list to iterate over, as JsonPath.'''
+        return typing.cast(typing.Optional[builtins.str], jsii.get(self, "bucketNamePath"))
+
     @builtins.property
     @jsii.member(jsii_name="maxItems")
     def max_items(self) -> typing.Optional[jsii.Number]:
@@ -9726,60 +10043,97 @@ class S3ObjectsItemReader(
 @jsii.data_type(
     jsii_type="aws-cdk-lib.aws_stepfunctions.S3ObjectsItemReaderProps",
     jsii_struct_bases=[ItemReaderProps],
-    name_mapping={"bucket": "bucket", "max_items": "maxItems", "prefix": "prefix"},
+    name_mapping={
+        "bucket": "bucket",
+        "bucket_name_path": "bucketNamePath",
+        "max_items": "maxItems",
+        "prefix": "prefix",
+    },
 )
 class S3ObjectsItemReaderProps(ItemReaderProps):
     def __init__(
         self,
         *,
-        bucket: _IBucket_42e086fd,
+        bucket: typing.Optional[_IBucket_42e086fd] = None,
+        bucket_name_path: typing.Optional[builtins.str] = None,
         max_items: typing.Optional[jsii.Number] = None,
         prefix: typing.Optional[builtins.str] = None,
     ) -> None:
         '''Properties for configuring an Item Reader that iterates over objects in an S3 bucket.
 
-        :param bucket: S3 Bucket containing objects to iterate over or a file with a list to iterate over.
+        :param bucket: S3 Bucket containing objects to iterate over or a file with a list to iterate over. Default: - S3 bucket will be determined from
+        :param bucket_name_path: S3 bucket name containing objects to iterate over or a file with a list to iterate over, as JsonPath. Default: - S3 bucket will be determined from
         :param max_items: Limits the number of items passed to the Distributed Map state. Default: - Distributed Map state will iterate over all items provided by the ItemReader
         :param prefix: S3 prefix used to limit objects to iterate over. Default: - No prefix
 
-        :exampleMetadata: fixture=_generated
+        :exampleMetadata: infused
 
         Example::
 
-            # The code below shows an example of how to instantiate this type.
-            # The values are placeholders you should change.
-            from aws_cdk import aws_s3 as s3
-            from aws_cdk import aws_stepfunctions as stepfunctions
+            import aws_cdk.aws_s3 as s3
             
-            # bucket: s3.Bucket
             
-            s3_objects_item_reader_props = stepfunctions.S3ObjectsItemReaderProps(
-                bucket=bucket,
+            #
+            # Tree view of bucket:
+            #  my-bucket
+            #  |
+            #  +--item1
+            #  |
+            #  +--otherItem
+            #  |
+            #  +--item2
+            #  |
+            #  ...
+            #
+            bucket = s3.Bucket(self, "Bucket",
+                bucket_name="my-bucket"
+            )
             
-                # the properties below are optional
-                max_items=123,
-                prefix="prefix"
+            distributed_map = sfn.DistributedMap(self, "DistributedMap",
+                item_reader=sfn.S3ObjectsItemReader(
+                    bucket=bucket,
+                    prefix="item"
+                )
             )
+            distributed_map.item_processor(sfn.Pass(self, "Pass"))
         '''
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__0839027a57f578b6a339286602923b0024b1f5e10dc2fb3ce8ac185f643a3bbc)
             check_type(argname="argument bucket", value=bucket, expected_type=type_hints["bucket"])
+            check_type(argname="argument bucket_name_path", value=bucket_name_path, expected_type=type_hints["bucket_name_path"])
             check_type(argname="argument max_items", value=max_items, expected_type=type_hints["max_items"])
             check_type(argname="argument prefix", value=prefix, expected_type=type_hints["prefix"])
-        self._values: typing.Dict[builtins.str, typing.Any] = {
-            "bucket": bucket,
-        }
+        self._values: typing.Dict[builtins.str, typing.Any] = {}
+        if bucket is not None:
+            self._values["bucket"] = bucket
+        if bucket_name_path is not None:
+            self._values["bucket_name_path"] = bucket_name_path
         if max_items is not None:
             self._values["max_items"] = max_items
         if prefix is not None:
             self._values["prefix"] = prefix
 
     @builtins.property
-    def bucket(self) -> _IBucket_42e086fd:
-        '''S3 Bucket containing objects to iterate over or a file with a list to iterate over.'''
+    def bucket(self) -> typing.Optional[_IBucket_42e086fd]:
+        '''S3 Bucket containing objects to iterate over or a file with a list to iterate over.
+
+        :default: - S3 bucket will be determined from
+
+        :see: bucketNamePath
+        '''
         result = self._values.get("bucket")
-        assert result is not None, "Required property 'bucket' is missing"
-        return typing.cast(_IBucket_42e086fd, result)
+        return typing.cast(typing.Optional[_IBucket_42e086fd], result)
+
+    @builtins.property
+    def bucket_name_path(self) -> typing.Optional[builtins.str]:
+        '''S3 bucket name containing objects to iterate over or a file with a list to iterate over, as JsonPath.
+
+        :default: - S3 bucket will be determined from
+
+        :see: bucket
+        '''
+        result = self._values.get("bucket_name_path")
+        return typing.cast(typing.Optional[builtins.str], result)
 
     @builtins.property
     def max_items(self) -> typing.Optional[jsii.Number]:
@@ -14961,14 +15315,20 @@ class DistributedMapProps(MapBaseProps):
 
         Example::
 
+            #
+            # JSON state input:
+            #  {
+            #    "bucketName": "my-bucket",
+            #    "prefix": "item"
+            #  }
+            #
             distributed_map = sfn.DistributedMap(self, "DistributedMap",
-                map_execution_type=sfn.StateMachineType.EXPRESS
-            )
-            
-            distributed_map.item_processor(sfn.Pass(self, "Pass"),
-                mode=sfn.ProcessorMode.DISTRIBUTED,
-                execution_type=sfn.ProcessorType.STANDARD
+                item_reader=sfn.S3ObjectsItemReader(
+                    bucket_name_path=sfn.JsonPath.string_at("$.bucketName"),
+                    prefix=sfn.JsonPath.string_at("$.prefix")
+                )
             )
+            distributed_map.item_processor(sfn.Pass(self, "Pass"))
         '''
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__e484af477b46c0e70f635ed9610c7183f70c2184fd7a48f091a5477df9ee3d5d)
@@ -15650,26 +16010,15 @@ class Pass(
 
     Example::
 
-        # Define a state machine with one Pass state
-        child = sfn.StateMachine(self, "ChildStateMachine",
-            definition=sfn.Chain.start(sfn.Pass(self, "PassState"))
+        state_machine = stepfunctions.StateMachine(self, "MyStateMachine",
+            state_machine_type=stepfunctions.StateMachineType.EXPRESS,
+            definition=stepfunctions.Chain.start(stepfunctions.Pass(self, "Pass"))
         )
         
-        # Include the state machine in a Task state with callback pattern
-        task = tasks.StepFunctionsStartExecution(self, "ChildTask",
-            state_machine=child,
-            integration_pattern=sfn.IntegrationPattern.WAIT_FOR_TASK_TOKEN,
-            input=sfn.TaskInput.from_object({
-                "token": sfn.JsonPath.task_token,
-                "foo": "bar"
-            }),
-            name="MyExecutionName"
-        )
-        
-        # Define a second state machine with the Task state above
-        sfn.StateMachine(self, "ParentStateMachine",
-            definition=task
+        api = apigateway.RestApi(self, "Api",
+            rest_api_name="MyApi"
         )
+        api.root.add_method("GET", apigateway.StepFunctionsIntegration.start_execution(state_machine))
     '''
 
     def __init__(
@@ -15740,6 +16089,7 @@ class Pass(
     jsii_struct_bases=[S3FileItemReaderProps],
     name_mapping={
         "bucket": "bucket",
+        "bucket_name_path": "bucketNamePath",
         "max_items": "maxItems",
         "key": "key",
         "csv_headers": "csvHeaders",
@@ -15749,14 +16099,16 @@ class S3CsvItemReaderProps(S3FileItemReaderProps):
     def __init__(
         self,
         *,
-        bucket: _IBucket_42e086fd,
+        bucket: typing.Optional[_IBucket_42e086fd] = None,
+        bucket_name_path: typing.Optional[builtins.str] = None,
         max_items: typing.Optional[jsii.Number] = None,
         key: builtins.str,
         csv_headers: typing.Optional[CsvHeaders] = None,
     ) -> None:
         '''Properties for configuring an Item Reader that iterates over items in a CSV file in S3.
 
-        :param bucket: S3 Bucket containing objects to iterate over or a file with a list to iterate over.
+        :param bucket: S3 Bucket containing objects to iterate over or a file with a list to iterate over. Default: - S3 bucket will be determined from
+        :param bucket_name_path: S3 bucket name containing objects to iterate over or a file with a list to iterate over, as JsonPath. Default: - S3 bucket will be determined from
         :param max_items: Limits the number of items passed to the Distributed Map state. Default: - Distributed Map state will iterate over all items provided by the ItemReader
         :param key: Key of file stored in S3 bucket containing an array to iterate over.
         :param csv_headers: CSV file header configuration. Default: - CsvHeaders with CsvHeadersLocation.FIRST_ROW
@@ -15774,10 +16126,11 @@ class S3CsvItemReaderProps(S3FileItemReaderProps):
             # csv_headers: stepfunctions.CsvHeaders
             
             s3_csv_item_reader_props = stepfunctions.S3CsvItemReaderProps(
-                bucket=bucket,
                 key="key",
             
                 # the properties below are optional
+                bucket=bucket,
+                bucket_name_path="bucketNamePath",
                 csv_headers=csv_headers,
                 max_items=123
             )
@@ -15785,24 +16138,43 @@ class S3CsvItemReaderProps(S3FileItemReaderProps):
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__fd148cd8282abe643b20452cf3c099e0d66560a90ddb7ec54f83740859fe615d)
             check_type(argname="argument bucket", value=bucket, expected_type=type_hints["bucket"])
+            check_type(argname="argument bucket_name_path", value=bucket_name_path, expected_type=type_hints["bucket_name_path"])
             check_type(argname="argument max_items", value=max_items, expected_type=type_hints["max_items"])
             check_type(argname="argument key", value=key, expected_type=type_hints["key"])
             check_type(argname="argument csv_headers", value=csv_headers, expected_type=type_hints["csv_headers"])
         self._values: typing.Dict[builtins.str, typing.Any] = {
-            "bucket": bucket,
             "key": key,
         }
+        if bucket is not None:
+            self._values["bucket"] = bucket
+        if bucket_name_path is not None:
+            self._values["bucket_name_path"] = bucket_name_path
         if max_items is not None:
             self._values["max_items"] = max_items
         if csv_headers is not None:
             self._values["csv_headers"] = csv_headers
 
     @builtins.property
-    def bucket(self) -> _IBucket_42e086fd:
-        '''S3 Bucket containing objects to iterate over or a file with a list to iterate over.'''
+    def bucket(self) -> typing.Optional[_IBucket_42e086fd]:
+        '''S3 Bucket containing objects to iterate over or a file with a list to iterate over.
+
+        :default: - S3 bucket will be determined from
+
+        :see: bucketNamePath
+        '''
         result = self._values.get("bucket")
-        assert result is not None, "Required property 'bucket' is missing"
-        return typing.cast(_IBucket_42e086fd, result)
+        return typing.cast(typing.Optional[_IBucket_42e086fd], result)
+
+    @builtins.property
+    def bucket_name_path(self) -> typing.Optional[builtins.str]:
+        '''S3 bucket name containing objects to iterate over or a file with a list to iterate over, as JsonPath.
+
+        :default: - S3 bucket will be determined from
+
+        :see: bucket
+        '''
+        result = self._values.get("bucket_name_path")
+        return typing.cast(typing.Optional[builtins.str], result)
 
     @builtins.property
     def max_items(self) -> typing.Optional[jsii.Number]:
@@ -15863,14 +16235,11 @@ class DistributedMap(
 
     Example::
 
-        distributed_map = sfn.DistributedMap(self, "DistributedMap",
-            map_execution_type=sfn.StateMachineType.EXPRESS
-        )
-        
-        distributed_map.item_processor(sfn.Pass(self, "Pass"),
-            mode=sfn.ProcessorMode.DISTRIBUTED,
-            execution_type=sfn.ProcessorType.STANDARD
+        distributed_map = sfn.DistributedMap(self, "Distributed Map State",
+            max_concurrency=1,
+            items_path=sfn.JsonPath.string_at("$.inputForMap")
         )
+        distributed_map.item_processor(sfn.Pass(self, "Pass State"))
     '''
 
     def __init__(
@@ -17303,7 +17672,8 @@ def _typecheckingstub__28b90617c58a85778754752511df05551643031e0ec1d9e5687a61bed
 
 def _typecheckingstub__e8df53cde2f82ea6228f0c9a5a5ba0a4dd36c18fba9835f9f3150547f7cee754(
     *,
-    bucket: _IBucket_42e086fd,
+    bucket: typing.Optional[_IBucket_42e086fd] = None,
+    bucket_name_path: typing.Optional[builtins.str] = None,
     max_items: typing.Optional[jsii.Number] = None,
 ) -> None:
     """Type checking stubs"""
@@ -17585,7 +17955,8 @@ def _typecheckingstub__984afa5a2055f0c35fc8c3cf6882093d3a32a8b56c725bd4e3c643f69
 
 def _typecheckingstub__fc17fd96c577f0b5f18e9d0043337043a5db7cf7c35fdc1b09e959cf7f58221c(
     *,
-    bucket: _IBucket_42e086fd,
+    bucket: typing.Optional[_IBucket_42e086fd] = None,
+    bucket_name_path: typing.Optional[builtins.str] = None,
     max_items: typing.Optional[jsii.Number] = None,
     key: builtins.str,
 ) -> None:
@@ -17594,7 +17965,8 @@ def _typecheckingstub__fc17fd96c577f0b5f18e9d0043337043a5db7cf7c35fdc1b09e959cf7
 
 def _typecheckingstub__0839027a57f578b6a339286602923b0024b1f5e10dc2fb3ce8ac185f643a3bbc(
     *,
-    bucket: _IBucket_42e086fd,
+    bucket: typing.Optional[_IBucket_42e086fd] = None,
+    bucket_name_path: typing.Optional[builtins.str] = None,
     max_items: typing.Optional[jsii.Number] = None,
     prefix: typing.Optional[builtins.str] = None,
 ) -> None:
@@ -18446,7 +18818,8 @@ def _typecheckingstub__f4f3a4b985638e018cf9da160ea401084953cf6a22e9ff97cb9b82310
 
 def _typecheckingstub__fd148cd8282abe643b20452cf3c099e0d66560a90ddb7ec54f83740859fe615d(
     *,
-    bucket: _IBucket_42e086fd,
+    bucket: typing.Optional[_IBucket_42e086fd] = None,
+    bucket_name_path: typing.Optional[builtins.str] = None,
     max_items: typing.Optional[jsii.Number] = None,
     key: builtins.str,
     csv_headers: typing.Optional[CsvHeaders] = None,