aws-cdk-lib 2.143.1__py3-none-any.whl → 2.145.0__py3-none-any.whl

aws_cdk/aws_stepfunctions/__init__.py

@@ -477,6 +477,16 @@ fail = sfn.Fail(self, "Fail",
 )
 ```
 
+You can also use an intrinsic function that returns a string to specify CausePath and ErrorPath.
+The available functions include States.Format, States.JsonToString, States.ArrayGetItem, States.Base64Encode, States.Base64Decode, States.Hash, and States.UUID.
+
+```python
+fail = sfn.Fail(self, "Fail",
+    error_path=sfn.JsonPath.format("error: {}.", sfn.JsonPath.string_at("$.someError")),
+    cause_path="States.Format('cause: {}.', $.someCause)"
+)
+```
+
 ### Map
 
 A `Map` state can be used to run a set of steps for each element of an input array.
@@ -5043,10 +5053,10 @@ class FailProps:
         '''Properties for defining a Fail state.
 
         :param cause: A description for the cause of the failure. Default: - No description
-        :param cause_path: JsonPath expression to select part of the state to be the cause to this state. Default: - No cause path
+        :param cause_path: JsonPath expression to select part of the state to be the cause to this state. You can also use an intrinsic function that returns a string to specify this property. The allowed functions include States.Format, States.JsonToString, States.ArrayGetItem, States.Base64Encode, States.Base64Decode, States.Hash, and States.UUID. Default: - No cause path
         :param comment: An optional description for this state. Default: - No comment
         :param error: Error code used to represent this failure. Default: - No error code
-        :param error_path: JsonPath expression to select part of the state to be the error to this state. Default: - No error path
+        :param error_path: JsonPath expression to select part of the state to be the error to this state. You can also use an intrinsic function that returns a string to specify this property. The allowed functions include States.Format, States.JsonToString, States.ArrayGetItem, States.Base64Encode, States.Base64Decode, States.Hash, and States.UUID. Default: - No error path
         :param state_name: Optional name for this state. Default: - The construct ID will be used as state name
 
         :exampleMetadata: infused
@@ -5054,8 +5064,8 @@ class FailProps:
         Example::
 
             fail = sfn.Fail(self, "Fail",
-                error_path=sfn.JsonPath.string_at("$.someError"),
-                cause_path=sfn.JsonPath.string_at("$.someCause")
+                error_path=sfn.JsonPath.format("error: {}.", sfn.JsonPath.string_at("$.someError")),
+                cause_path="States.Format('cause: {}.', $.someCause)"
             )
         '''
         if __debug__:
@@ -5093,6 +5103,9 @@ class FailProps:
     def cause_path(self) -> typing.Optional[builtins.str]:
         '''JsonPath expression to select part of the state to be the cause to this state.
 
+        You can also use an intrinsic function that returns a string to specify this property.
+        The allowed functions include States.Format, States.JsonToString, States.ArrayGetItem, States.Base64Encode, States.Base64Decode, States.Hash, and States.UUID.
+
         :default: - No cause path
         '''
         result = self._values.get("cause_path")
@@ -5120,6 +5133,9 @@ class FailProps:
     def error_path(self) -> typing.Optional[builtins.str]:
         '''JsonPath expression to select part of the state to be the error to this state.
 
+        You can also use an intrinsic function that returns a string to specify this property.
+        The allowed functions include States.Format, States.JsonToString, States.ArrayGetItem, States.Base64Encode, States.Base64Decode, States.Hash, and States.UUID.
+
         :default: - No error path
         '''
         result = self._values.get("error_path")
@@ -6318,25 +6334,33 @@ class IntegrationPattern(enum.Enum):
 
     Example::
 
-        # Define a state machine with one Pass state
-        child = sfn.StateMachine(self, "ChildStateMachine",
-            definition=sfn.Chain.start(sfn.Pass(self, "PassState"))
-        )
+        import aws_cdk.aws_codebuild as codebuild
         
-        # 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"
+        
+        project = codebuild.Project(self, "Project",
+            project_name="MyTestProject",
+            build_spec=codebuild.BuildSpec.from_object_to_yaml({
+                "version": 0.2,
+                "batch": {
+                    "build-list": [{
+                        "identifier": "id",
+                        "buildspec": "version: 0.2\nphases:\n  build:\n    commands:\n      - echo \"Hello, from small!\""
+                    }
+                    ]
+                }
+            })
         )
+        project.enable_batch_builds()
         
-        # Define a second state machine with the Task state above
-        sfn.StateMachine(self, "ParentStateMachine",
-            definition=task
+        task = tasks.CodeBuildStartBuildBatch(self, "buildBatchTask",
+            project=project,
+            integration_pattern=sfn.IntegrationPattern.REQUEST_RESPONSE,
+            environment_variables_override={
+                "test": codebuild.BuildEnvironmentVariable(
+                    type=codebuild.BuildEnvironmentVariableType.PLAINTEXT,
+                    value="testValue"
+                )
+            }
         )
     '''
 
@@ -14559,8 +14583,8 @@ class Fail(
     Example::
 
         fail = sfn.Fail(self, "Fail",
-            error_path=sfn.JsonPath.string_at("$.someError"),
-            cause_path=sfn.JsonPath.string_at("$.someCause")
+            error_path=sfn.JsonPath.format("error: {}.", sfn.JsonPath.string_at("$.someError")),
+            cause_path="States.Format('cause: {}.', $.someCause)"
         )
     '''
 
@@ -14580,10 +14604,10 @@ class Fail(
         :param scope: -
         :param id: Descriptive identifier for this chainable.
         :param cause: A description for the cause of the failure. Default: - No description
-        :param cause_path: JsonPath expression to select part of the state to be the cause to this state. Default: - No cause path
+        :param cause_path: JsonPath expression to select part of the state to be the cause to this state. You can also use an intrinsic function that returns a string to specify this property. The allowed functions include States.Format, States.JsonToString, States.ArrayGetItem, States.Base64Encode, States.Base64Decode, States.Hash, and States.UUID. Default: - No cause path
         :param comment: An optional description for this state. Default: - No comment
         :param error: Error code used to represent this failure. Default: - No error code
-        :param error_path: JsonPath expression to select part of the state to be the error to this state. Default: - No error path
+        :param error_path: JsonPath expression to select part of the state to be the error to this state. You can also use an intrinsic function that returns a string to specify this property. The allowed functions include States.Format, States.JsonToString, States.ArrayGetItem, States.Base64Encode, States.Base64Decode, States.Hash, and States.UUID. Default: - No error path
         :param state_name: Optional name for this state. Default: - The construct ID will be used as state name
         '''
         if __debug__:
@@ -14606,6 +14630,11 @@ class Fail(
         '''Return the Amazon States Language object for this state.'''
         return typing.cast(typing.Mapping[typing.Any, typing.Any], jsii.invoke(self, "toStateJson", []))
 
+    @jsii.member(jsii_name="validateState")
+    def _validate_state(self) -> typing.List[builtins.str]:
+        '''Validate this state.'''
+        return typing.cast(typing.List[builtins.str], jsii.invoke(self, "validateState", []))
+
     @builtins.property
     @jsii.member(jsii_name="endStates")
     def end_states(self) -> typing.List[INextable]: