aws-cdk-lib 2.136.1__py3-none-any.whl → 2.138.0__py3-none-any.whl

aws_cdk/aws_stepfunctions_tasks/__init__.py

@@ -1183,6 +1183,32 @@ tasks.GlueDataBrewStartJobRun(self, "Task",
 )
 ```
 
+## Invoke HTTP API
+
+Step Functions supports [calling third-party APIs](https://docs.aws.amazon.com/step-functions/latest/dg/connect-third-party-apis.html) with credentials managed by Amazon EventBridge [Connections](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_Connection.html).
+
+The following snippet creates a new API destination connection, and uses it to make a POST request to the specified URL. The endpoint response is available at the `$.ResponseBody` path.
+
+```python
+import aws_cdk.aws_events as events
+
+
+connection = events.Connection(self, "Connection",
+    authorization=events.Authorization.basic("username", SecretValue.unsafe_plain_text("password"))
+)
+
+tasks.HttpInvoke(self, "Invoke HTTP API",
+    api_root="https://api.example.com",
+    api_endpoint=sfn.TaskInput.from_text("https://api.example.com/path/to/resource"),
+    body=sfn.TaskInput.from_object({"foo": "bar"}),
+    connection=connection,
+    headers=sfn.TaskInput.from_object({"Content-Type": "application/json"}),
+    method=sfn.TaskInput.from_text("POST"),
+    query_string_parameters=sfn.TaskInput.from_object({"id": "123"}),
+    url_encoding_format=tasks.URLEncodingFormat.BRACKETS
+)
+```
+
 ## Lambda
 
 Step Functions supports [AWS Lambda](https://docs.aws.amazon.com/step-functions/latest/dg/connect-lambda.html) through the service integration pattern.
@@ -1653,7 +1679,9 @@ from ..aws_ecs import (
     TaskDefinition as _TaskDefinition_a541a103,
 )
 from ..aws_eks import ICluster as _ICluster_6b2b80df
-from ..aws_events import IEventBus as _IEventBus_88d13111
+from ..aws_events import (
+    IConnection as _IConnection_afaa0769, IEventBus as _IEventBus_88d13111
+)
 from ..aws_iam import (
     IGrantable as _IGrantable_71c4f5de,
     IPrincipal as _IPrincipal_539bb2fd,
@@ -23490,6 +23518,543 @@ class GlueStartJobRunProps(_TaskStateBaseProps_3a62b6d0):
         )
 
 
+class HttpInvoke(
+    _TaskStateBase_b5c0a816,
+    metaclass=jsii.JSIIMeta,
+    jsii_type="aws-cdk-lib.aws_stepfunctions_tasks.HttpInvoke",
+):
+    '''A Step Functions Task to call a public third-party API.
+
+    :exampleMetadata: infused
+
+    Example::
+
+        import aws_cdk.aws_events as events
+        
+        
+        connection = events.Connection(self, "Connection",
+            authorization=events.Authorization.basic("username", SecretValue.unsafe_plain_text("password"))
+        )
+        
+        tasks.HttpInvoke(self, "Invoke HTTP API",
+            api_root="https://api.example.com",
+            api_endpoint=sfn.TaskInput.from_text("https://api.example.com/path/to/resource"),
+            body=sfn.TaskInput.from_object({"foo": "bar"}),
+            connection=connection,
+            headers=sfn.TaskInput.from_object({"Content-Type": "application/json"}),
+            method=sfn.TaskInput.from_text("POST"),
+            query_string_parameters=sfn.TaskInput.from_object({"id": "123"}),
+            url_encoding_format=tasks.URLEncodingFormat.BRACKETS
+        )
+    '''
+
+    def __init__(
+        self,
+        scope: _constructs_77d1e7e8.Construct,
+        id: builtins.str,
+        *,
+        api_endpoint: _TaskInput_91b91b91,
+        api_root: builtins.str,
+        connection: _IConnection_afaa0769,
+        method: _TaskInput_91b91b91,
+        body: typing.Optional[_TaskInput_91b91b91] = None,
+        headers: typing.Optional[_TaskInput_91b91b91] = None,
+        query_string_parameters: typing.Optional[_TaskInput_91b91b91] = None,
+        url_encoding_format: typing.Optional["URLEncodingFormat"] = None,
+        comment: typing.Optional[builtins.str] = None,
+        credentials: typing.Optional[typing.Union[_Credentials_2cd64c6b, typing.Dict[builtins.str, typing.Any]]] = None,
+        heartbeat: typing.Optional[_Duration_4839e8c3] = None,
+        heartbeat_timeout: typing.Optional[_Timeout_d7c10551] = None,
+        input_path: typing.Optional[builtins.str] = None,
+        integration_pattern: typing.Optional[_IntegrationPattern_949291bc] = None,
+        output_path: typing.Optional[builtins.str] = None,
+        result_path: typing.Optional[builtins.str] = None,
+        result_selector: typing.Optional[typing.Mapping[builtins.str, typing.Any]] = None,
+        state_name: typing.Optional[builtins.str] = None,
+        task_timeout: typing.Optional[_Timeout_d7c10551] = None,
+        timeout: typing.Optional[_Duration_4839e8c3] = None,
+    ) -> None:
+        '''
+        :param scope: -
+        :param id: Descriptive identifier for this chainable.
+        :param api_endpoint: The API endpoint to call, relative to ``apiRoot``.
+        :param api_root: Permissions are granted to call all resources under this path.
+        :param connection: The EventBridge Connection to use for authentication.
+        :param method: The HTTP method to use.
+        :param body: The body to send to the HTTP endpoint. Default: - No body is sent with the request.
+        :param headers: The headers to send to the HTTP endpoint. Default: - No additional headers are added to the request.
+        :param query_string_parameters: The query string parameters to send to the HTTP endpoint. Default: - No query string parameters are sent in the request.
+        :param url_encoding_format: Determines whether to apply URL encoding to the request body, and which array encoding format to use. ``URLEncodingFormat.NONE`` passes the JSON-serialized ``RequestBody`` field as the HTTP request body. Otherwise, the HTTP request body is the URL-encoded form data of the ``RequestBody`` field using the specified array encoding format, and the ``Content-Type`` header is set to ``application/x-www-form-urlencoded``. Default: - URLEncodingFormat.NONE
+        :param comment: An optional description for this state. Default: - No comment
+        :param credentials: Credentials for an IAM Role that the State Machine assumes for executing the task. This enables cross-account resource invocations. Default: - None (Task is executed using the State Machine's execution role)
+        :param heartbeat: (deprecated) Timeout for the heartbeat. Default: - None
+        :param heartbeat_timeout: Timeout for the heartbeat. [disable-awslint:duration-prop-type] is needed because all props interface in aws-stepfunctions-tasks extend this interface Default: - None
+        :param input_path: JSONPath expression to select part of the state to be the input to this state. May also be the special value JsonPath.DISCARD, which will cause the effective input to be the empty object {}. Default: - The entire task input (JSON path '$')
+        :param integration_pattern: AWS Step Functions integrates with services directly in the Amazon States Language. You can control these AWS services using service integration patterns. Depending on the AWS Service, the Service Integration Pattern availability will vary. Default: - ``IntegrationPattern.REQUEST_RESPONSE`` for most tasks. ``IntegrationPattern.RUN_JOB`` for the following exceptions: ``BatchSubmitJob``, ``EmrAddStep``, ``EmrCreateCluster``, ``EmrTerminationCluster``, and ``EmrContainersStartJobRun``.
+        :param output_path: JSONPath expression to select select a portion of the state output to pass to the next state. May also be the special value JsonPath.DISCARD, which will cause the effective output to be the empty object {}. Default: - The entire JSON node determined by the state input, the task result, and resultPath is passed to the next state (JSON path '$')
+        :param result_path: JSONPath expression to indicate where to inject the state's output. May also be the special value JsonPath.DISCARD, which will cause the state's input to become its output. Default: - Replaces the entire input with the result (JSON path '$')
+        :param result_selector: The JSON that will replace the state's raw result and become the effective result before ResultPath is applied. You can use ResultSelector to create a payload with values that are static or selected from the state's raw result. Default: - None
+        :param state_name: Optional name for this state. Default: - The construct ID will be used as state name
+        :param task_timeout: Timeout for the task. [disable-awslint:duration-prop-type] is needed because all props interface in aws-stepfunctions-tasks extend this interface Default: - None
+        :param timeout: (deprecated) Timeout for the task. Default: - None
+        '''
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__380dcb304dd02d709d798634fa365c757bcaa7593ab7542271009736c47d0329)
+            check_type(argname="argument scope", value=scope, expected_type=type_hints["scope"])
+            check_type(argname="argument id", value=id, expected_type=type_hints["id"])
+        props = HttpInvokeProps(
+            api_endpoint=api_endpoint,
+            api_root=api_root,
+            connection=connection,
+            method=method,
+            body=body,
+            headers=headers,
+            query_string_parameters=query_string_parameters,
+            url_encoding_format=url_encoding_format,
+            comment=comment,
+            credentials=credentials,
+            heartbeat=heartbeat,
+            heartbeat_timeout=heartbeat_timeout,
+            input_path=input_path,
+            integration_pattern=integration_pattern,
+            output_path=output_path,
+            result_path=result_path,
+            result_selector=result_selector,
+            state_name=state_name,
+            task_timeout=task_timeout,
+            timeout=timeout,
+        )
+
+        jsii.create(self.__class__, self, [scope, id, props])
+
+    @jsii.member(jsii_name="buildTaskPolicyStatements")
+    def _build_task_policy_statements(self) -> typing.List[_PolicyStatement_0fe33853]:
+        return typing.cast(typing.List[_PolicyStatement_0fe33853], jsii.invoke(self, "buildTaskPolicyStatements", []))
+
+    @builtins.property
+    @jsii.member(jsii_name="taskMetrics")
+    def _task_metrics(self) -> typing.Optional[_TaskMetricsConfig_32ea9403]:
+        return typing.cast(typing.Optional[_TaskMetricsConfig_32ea9403], jsii.get(self, "taskMetrics"))
+
+    @builtins.property
+    @jsii.member(jsii_name="taskPolicies")
+    def _task_policies(self) -> typing.Optional[typing.List[_PolicyStatement_0fe33853]]:
+        return typing.cast(typing.Optional[typing.List[_PolicyStatement_0fe33853]], jsii.get(self, "taskPolicies"))
+
+
+@jsii.data_type(
+    jsii_type="aws-cdk-lib.aws_stepfunctions_tasks.HttpInvokeProps",
+    jsii_struct_bases=[_TaskStateBaseProps_3a62b6d0],
+    name_mapping={
+        "comment": "comment",
+        "credentials": "credentials",
+        "heartbeat": "heartbeat",
+        "heartbeat_timeout": "heartbeatTimeout",
+        "input_path": "inputPath",
+        "integration_pattern": "integrationPattern",
+        "output_path": "outputPath",
+        "result_path": "resultPath",
+        "result_selector": "resultSelector",
+        "state_name": "stateName",
+        "task_timeout": "taskTimeout",
+        "timeout": "timeout",
+        "api_endpoint": "apiEndpoint",
+        "api_root": "apiRoot",
+        "connection": "connection",
+        "method": "method",
+        "body": "body",
+        "headers": "headers",
+        "query_string_parameters": "queryStringParameters",
+        "url_encoding_format": "urlEncodingFormat",
+    },
+)
+class HttpInvokeProps(_TaskStateBaseProps_3a62b6d0):
+    def __init__(
+        self,
+        *,
+        comment: typing.Optional[builtins.str] = None,
+        credentials: typing.Optional[typing.Union[_Credentials_2cd64c6b, typing.Dict[builtins.str, typing.Any]]] = None,
+        heartbeat: typing.Optional[_Duration_4839e8c3] = None,
+        heartbeat_timeout: typing.Optional[_Timeout_d7c10551] = None,
+        input_path: typing.Optional[builtins.str] = None,
+        integration_pattern: typing.Optional[_IntegrationPattern_949291bc] = None,
+        output_path: typing.Optional[builtins.str] = None,
+        result_path: typing.Optional[builtins.str] = None,
+        result_selector: typing.Optional[typing.Mapping[builtins.str, typing.Any]] = None,
+        state_name: typing.Optional[builtins.str] = None,
+        task_timeout: typing.Optional[_Timeout_d7c10551] = None,
+        timeout: typing.Optional[_Duration_4839e8c3] = None,
+        api_endpoint: _TaskInput_91b91b91,
+        api_root: builtins.str,
+        connection: _IConnection_afaa0769,
+        method: _TaskInput_91b91b91,
+        body: typing.Optional[_TaskInput_91b91b91] = None,
+        headers: typing.Optional[_TaskInput_91b91b91] = None,
+        query_string_parameters: typing.Optional[_TaskInput_91b91b91] = None,
+        url_encoding_format: typing.Optional["URLEncodingFormat"] = None,
+    ) -> None:
+        '''Properties for calling an external HTTP endpoint with HttpInvoke.
+
+        :param comment: An optional description for this state. Default: - No comment
+        :param credentials: Credentials for an IAM Role that the State Machine assumes for executing the task. This enables cross-account resource invocations. Default: - None (Task is executed using the State Machine's execution role)
+        :param heartbeat: (deprecated) Timeout for the heartbeat. Default: - None
+        :param heartbeat_timeout: Timeout for the heartbeat. [disable-awslint:duration-prop-type] is needed because all props interface in aws-stepfunctions-tasks extend this interface Default: - None
+        :param input_path: JSONPath expression to select part of the state to be the input to this state. May also be the special value JsonPath.DISCARD, which will cause the effective input to be the empty object {}. Default: - The entire task input (JSON path '$')
+        :param integration_pattern: AWS Step Functions integrates with services directly in the Amazon States Language. You can control these AWS services using service integration patterns. Depending on the AWS Service, the Service Integration Pattern availability will vary. Default: - ``IntegrationPattern.REQUEST_RESPONSE`` for most tasks. ``IntegrationPattern.RUN_JOB`` for the following exceptions: ``BatchSubmitJob``, ``EmrAddStep``, ``EmrCreateCluster``, ``EmrTerminationCluster``, and ``EmrContainersStartJobRun``.
+        :param output_path: JSONPath expression to select select a portion of the state output to pass to the next state. May also be the special value JsonPath.DISCARD, which will cause the effective output to be the empty object {}. Default: - The entire JSON node determined by the state input, the task result, and resultPath is passed to the next state (JSON path '$')
+        :param result_path: JSONPath expression to indicate where to inject the state's output. May also be the special value JsonPath.DISCARD, which will cause the state's input to become its output. Default: - Replaces the entire input with the result (JSON path '$')
+        :param result_selector: The JSON that will replace the state's raw result and become the effective result before ResultPath is applied. You can use ResultSelector to create a payload with values that are static or selected from the state's raw result. Default: - None
+        :param state_name: Optional name for this state. Default: - The construct ID will be used as state name
+        :param task_timeout: Timeout for the task. [disable-awslint:duration-prop-type] is needed because all props interface in aws-stepfunctions-tasks extend this interface Default: - None
+        :param timeout: (deprecated) Timeout for the task. Default: - None
+        :param api_endpoint: The API endpoint to call, relative to ``apiRoot``.
+        :param api_root: Permissions are granted to call all resources under this path.
+        :param connection: The EventBridge Connection to use for authentication.
+        :param method: The HTTP method to use.
+        :param body: The body to send to the HTTP endpoint. Default: - No body is sent with the request.
+        :param headers: The headers to send to the HTTP endpoint. Default: - No additional headers are added to the request.
+        :param query_string_parameters: The query string parameters to send to the HTTP endpoint. Default: - No query string parameters are sent in the request.
+        :param url_encoding_format: Determines whether to apply URL encoding to the request body, and which array encoding format to use. ``URLEncodingFormat.NONE`` passes the JSON-serialized ``RequestBody`` field as the HTTP request body. Otherwise, the HTTP request body is the URL-encoded form data of the ``RequestBody`` field using the specified array encoding format, and the ``Content-Type`` header is set to ``application/x-www-form-urlencoded``. Default: - URLEncodingFormat.NONE
+
+        :exampleMetadata: infused
+
+        Example::
+
+            import aws_cdk.aws_events as events
+            
+            
+            connection = events.Connection(self, "Connection",
+                authorization=events.Authorization.basic("username", SecretValue.unsafe_plain_text("password"))
+            )
+            
+            tasks.HttpInvoke(self, "Invoke HTTP API",
+                api_root="https://api.example.com",
+                api_endpoint=sfn.TaskInput.from_text("https://api.example.com/path/to/resource"),
+                body=sfn.TaskInput.from_object({"foo": "bar"}),
+                connection=connection,
+                headers=sfn.TaskInput.from_object({"Content-Type": "application/json"}),
+                method=sfn.TaskInput.from_text("POST"),
+                query_string_parameters=sfn.TaskInput.from_object({"id": "123"}),
+                url_encoding_format=tasks.URLEncodingFormat.BRACKETS
+            )
+        '''
+        if isinstance(credentials, dict):
+            credentials = _Credentials_2cd64c6b(**credentials)
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__9c1bbcee50744a26bccfe1fdf126df22aaaf9a0e25bc51ef9803628b561dd275)
+            check_type(argname="argument comment", value=comment, expected_type=type_hints["comment"])
+            check_type(argname="argument credentials", value=credentials, expected_type=type_hints["credentials"])
+            check_type(argname="argument heartbeat", value=heartbeat, expected_type=type_hints["heartbeat"])
+            check_type(argname="argument heartbeat_timeout", value=heartbeat_timeout, expected_type=type_hints["heartbeat_timeout"])
+            check_type(argname="argument input_path", value=input_path, expected_type=type_hints["input_path"])
+            check_type(argname="argument integration_pattern", value=integration_pattern, expected_type=type_hints["integration_pattern"])
+            check_type(argname="argument output_path", value=output_path, expected_type=type_hints["output_path"])
+            check_type(argname="argument result_path", value=result_path, expected_type=type_hints["result_path"])
+            check_type(argname="argument result_selector", value=result_selector, expected_type=type_hints["result_selector"])
+            check_type(argname="argument state_name", value=state_name, expected_type=type_hints["state_name"])
+            check_type(argname="argument task_timeout", value=task_timeout, expected_type=type_hints["task_timeout"])
+            check_type(argname="argument timeout", value=timeout, expected_type=type_hints["timeout"])
+            check_type(argname="argument api_endpoint", value=api_endpoint, expected_type=type_hints["api_endpoint"])
+            check_type(argname="argument api_root", value=api_root, expected_type=type_hints["api_root"])
+            check_type(argname="argument connection", value=connection, expected_type=type_hints["connection"])
+            check_type(argname="argument method", value=method, expected_type=type_hints["method"])
+            check_type(argname="argument body", value=body, expected_type=type_hints["body"])
+            check_type(argname="argument headers", value=headers, expected_type=type_hints["headers"])
+            check_type(argname="argument query_string_parameters", value=query_string_parameters, expected_type=type_hints["query_string_parameters"])
+            check_type(argname="argument url_encoding_format", value=url_encoding_format, expected_type=type_hints["url_encoding_format"])
+        self._values: typing.Dict[builtins.str, typing.Any] = {
+            "api_endpoint": api_endpoint,
+            "api_root": api_root,
+            "connection": connection,
+            "method": method,
+        }
+        if comment is not None:
+            self._values["comment"] = comment
+        if credentials is not None:
+            self._values["credentials"] = credentials
+        if heartbeat is not None:
+            self._values["heartbeat"] = heartbeat
+        if heartbeat_timeout is not None:
+            self._values["heartbeat_timeout"] = heartbeat_timeout
+        if input_path is not None:
+            self._values["input_path"] = input_path
+        if integration_pattern is not None:
+            self._values["integration_pattern"] = integration_pattern
+        if output_path is not None:
+            self._values["output_path"] = output_path
+        if result_path is not None:
+            self._values["result_path"] = result_path
+        if result_selector is not None:
+            self._values["result_selector"] = result_selector
+        if state_name is not None:
+            self._values["state_name"] = state_name
+        if task_timeout is not None:
+            self._values["task_timeout"] = task_timeout
+        if timeout is not None:
+            self._values["timeout"] = timeout
+        if body is not None:
+            self._values["body"] = body
+        if headers is not None:
+            self._values["headers"] = headers
+        if query_string_parameters is not None:
+            self._values["query_string_parameters"] = query_string_parameters
+        if url_encoding_format is not None:
+            self._values["url_encoding_format"] = url_encoding_format
+
+    @builtins.property
+    def comment(self) -> typing.Optional[builtins.str]:
+        '''An optional description for this state.
+
+        :default: - No comment
+        '''
+        result = self._values.get("comment")
+        return typing.cast(typing.Optional[builtins.str], result)
+
+    @builtins.property
+    def credentials(self) -> typing.Optional[_Credentials_2cd64c6b]:
+        '''Credentials for an IAM Role that the State Machine assumes for executing the task.
+
+        This enables cross-account resource invocations.
+
+        :default: - None (Task is executed using the State Machine's execution role)
+
+        :see: https://docs.aws.amazon.com/step-functions/latest/dg/concepts-access-cross-acct-resources.html
+        '''
+        result = self._values.get("credentials")
+        return typing.cast(typing.Optional[_Credentials_2cd64c6b], result)
+
+    @builtins.property
+    def heartbeat(self) -> typing.Optional[_Duration_4839e8c3]:
+        '''(deprecated) Timeout for the heartbeat.
+
+        :default: - None
+
+        :deprecated: use ``heartbeatTimeout``
+
+        :stability: deprecated
+        '''
+        result = self._values.get("heartbeat")
+        return typing.cast(typing.Optional[_Duration_4839e8c3], result)
+
+    @builtins.property
+    def heartbeat_timeout(self) -> typing.Optional[_Timeout_d7c10551]:
+        '''Timeout for the heartbeat.
+
+        [disable-awslint:duration-prop-type] is needed because all props interface in
+        aws-stepfunctions-tasks extend this interface
+
+        :default: - None
+        '''
+        result = self._values.get("heartbeat_timeout")
+        return typing.cast(typing.Optional[_Timeout_d7c10551], result)
+
+    @builtins.property
+    def input_path(self) -> typing.Optional[builtins.str]:
+        '''JSONPath expression to select part of the state to be the input to this state.
+
+        May also be the special value JsonPath.DISCARD, which will cause the effective
+        input to be the empty object {}.
+
+        :default: - The entire task input (JSON path '$')
+        '''
+        result = self._values.get("input_path")
+        return typing.cast(typing.Optional[builtins.str], result)
+
+    @builtins.property
+    def integration_pattern(self) -> typing.Optional[_IntegrationPattern_949291bc]:
+        '''AWS Step Functions integrates with services directly in the Amazon States Language.
+
+        You can control these AWS services using service integration patterns.
+
+        Depending on the AWS Service, the Service Integration Pattern availability will vary.
+
+        :default:
+
+        - ``IntegrationPattern.REQUEST_RESPONSE`` for most tasks.
+        ``IntegrationPattern.RUN_JOB`` for the following exceptions:
+        ``BatchSubmitJob``, ``EmrAddStep``, ``EmrCreateCluster``, ``EmrTerminationCluster``, and ``EmrContainersStartJobRun``.
+
+        :see: https://docs.aws.amazon.com/step-functions/latest/dg/connect-supported-services.html
+        '''
+        result = self._values.get("integration_pattern")
+        return typing.cast(typing.Optional[_IntegrationPattern_949291bc], result)
+
+    @builtins.property
+    def output_path(self) -> typing.Optional[builtins.str]:
+        '''JSONPath expression to select select a portion of the state output to pass to the next state.
+
+        May also be the special value JsonPath.DISCARD, which will cause the effective
+        output to be the empty object {}.
+
+        :default:
+
+        - The entire JSON node determined by the state input, the task result,
+        and resultPath is passed to the next state (JSON path '$')
+        '''
+        result = self._values.get("output_path")
+        return typing.cast(typing.Optional[builtins.str], result)
+
+    @builtins.property
+    def result_path(self) -> typing.Optional[builtins.str]:
+        '''JSONPath expression to indicate where to inject the state's output.
+
+        May also be the special value JsonPath.DISCARD, which will cause the state's
+        input to become its output.
+
+        :default: - Replaces the entire input with the result (JSON path '$')
+        '''
+        result = self._values.get("result_path")
+        return typing.cast(typing.Optional[builtins.str], result)
+
+    @builtins.property
+    def result_selector(
+        self,
+    ) -> typing.Optional[typing.Mapping[builtins.str, typing.Any]]:
+        '''The JSON that will replace the state's raw result and become the effective result before ResultPath is applied.
+
+        You can use ResultSelector to create a payload with values that are static
+        or selected from the state's raw result.
+
+        :default: - None
+
+        :see: https://docs.aws.amazon.com/step-functions/latest/dg/input-output-inputpath-params.html#input-output-resultselector
+        '''
+        result = self._values.get("result_selector")
+        return typing.cast(typing.Optional[typing.Mapping[builtins.str, typing.Any]], result)
+
+    @builtins.property
+    def state_name(self) -> typing.Optional[builtins.str]:
+        '''Optional name for this state.
+
+        :default: - The construct ID will be used as state name
+        '''
+        result = self._values.get("state_name")
+        return typing.cast(typing.Optional[builtins.str], result)
+
+    @builtins.property
+    def task_timeout(self) -> typing.Optional[_Timeout_d7c10551]:
+        '''Timeout for the task.
+
+        [disable-awslint:duration-prop-type] is needed because all props interface in
+        aws-stepfunctions-tasks extend this interface
+
+        :default: - None
+        '''
+        result = self._values.get("task_timeout")
+        return typing.cast(typing.Optional[_Timeout_d7c10551], result)
+
+    @builtins.property
+    def timeout(self) -> typing.Optional[_Duration_4839e8c3]:
+        '''(deprecated) Timeout for the task.
+
+        :default: - None
+
+        :deprecated: use ``taskTimeout``
+
+        :stability: deprecated
+        '''
+        result = self._values.get("timeout")
+        return typing.cast(typing.Optional[_Duration_4839e8c3], result)
+
+    @builtins.property
+    def api_endpoint(self) -> _TaskInput_91b91b91:
+        '''The API endpoint to call, relative to ``apiRoot``.
+
+        Example::
+
+            sfn.TaskInput.from_text("path/to/resource")
+        '''
+        result = self._values.get("api_endpoint")
+        assert result is not None, "Required property 'api_endpoint' is missing"
+        return typing.cast(_TaskInput_91b91b91, result)
+
+    @builtins.property
+    def api_root(self) -> builtins.str:
+        '''Permissions are granted to call all resources under this path.
+
+        Example::
+
+            "https://api.example.com"
+        '''
+        result = self._values.get("api_root")
+        assert result is not None, "Required property 'api_root' is missing"
+        return typing.cast(builtins.str, result)
+
+    @builtins.property
+    def connection(self) -> _IConnection_afaa0769:
+        '''The EventBridge Connection to use for authentication.'''
+        result = self._values.get("connection")
+        assert result is not None, "Required property 'connection' is missing"
+        return typing.cast(_IConnection_afaa0769, result)
+
+    @builtins.property
+    def method(self) -> _TaskInput_91b91b91:
+        '''The HTTP method to use.
+
+        Example::
+
+            sfn.TaskInput.from_text("GET")
+        '''
+        result = self._values.get("method")
+        assert result is not None, "Required property 'method' is missing"
+        return typing.cast(_TaskInput_91b91b91, result)
+
+    @builtins.property
+    def body(self) -> typing.Optional[_TaskInput_91b91b91]:
+        '''The body to send to the HTTP endpoint.
+
+        :default: - No body is sent with the request.
+        '''
+        result = self._values.get("body")
+        return typing.cast(typing.Optional[_TaskInput_91b91b91], result)
+
+    @builtins.property
+    def headers(self) -> typing.Optional[_TaskInput_91b91b91]:
+        '''The headers to send to the HTTP endpoint.
+
+        :default: - No additional headers are added to the request.
+
+        Example::
+
+            sfn.TaskInput.from_object({"Content-Type": "application/json"})
+        '''
+        result = self._values.get("headers")
+        return typing.cast(typing.Optional[_TaskInput_91b91b91], result)
+
+    @builtins.property
+    def query_string_parameters(self) -> typing.Optional[_TaskInput_91b91b91]:
+        '''The query string parameters to send to the HTTP endpoint.
+
+        :default: - No query string parameters are sent in the request.
+        '''
+        result = self._values.get("query_string_parameters")
+        return typing.cast(typing.Optional[_TaskInput_91b91b91], result)
+
+    @builtins.property
+    def url_encoding_format(self) -> typing.Optional["URLEncodingFormat"]:
+        '''Determines whether to apply URL encoding to the request body, and which array encoding format to use.
+
+        ``URLEncodingFormat.NONE`` passes the JSON-serialized ``RequestBody`` field as the HTTP request body.
+        Otherwise, the HTTP request body is the URL-encoded form data of the ``RequestBody`` field using the
+        specified array encoding format, and the ``Content-Type`` header is set to ``application/x-www-form-urlencoded``.
+
+        :default: - URLEncodingFormat.NONE
+        '''
+        result = self._values.get("url_encoding_format")
+        return typing.cast(typing.Optional["URLEncodingFormat"], result)
+
+    def __eq__(self, rhs: typing.Any) -> builtins.bool:
+        return isinstance(rhs, self.__class__) and rhs._values == self._values
+
+    def __ne__(self, rhs: typing.Any) -> builtins.bool:
+        return not (rhs == self)
+
+    def __repr__(self) -> str:
+        return "HttpInvokeProps(%s)" % ", ".join(
+            k + "=" + repr(v) for k, v in self._values.items()
+        )
+
+
 @jsii.enum(jsii_type="aws-cdk-lib.aws_stepfunctions_tasks.HttpMethod")
 class HttpMethod(enum.Enum):
     '''Http Methods that API Gateway supports.
@@ -31672,6 +32237,59 @@ class TransformS3DataSource:
         )
 
 
+@jsii.enum(jsii_type="aws-cdk-lib.aws_stepfunctions_tasks.URLEncodingFormat")
+class URLEncodingFormat(enum.Enum):
+    '''The style used when applying URL encoding to array values.
+
+    :exampleMetadata: infused
+
+    Example::
+
+        import aws_cdk.aws_events as events
+        
+        
+        connection = events.Connection(self, "Connection",
+            authorization=events.Authorization.basic("username", SecretValue.unsafe_plain_text("password"))
+        )
+        
+        tasks.HttpInvoke(self, "Invoke HTTP API",
+            api_root="https://api.example.com",
+            api_endpoint=sfn.TaskInput.from_text("https://api.example.com/path/to/resource"),
+            body=sfn.TaskInput.from_object({"foo": "bar"}),
+            connection=connection,
+            headers=sfn.TaskInput.from_object({"Content-Type": "application/json"}),
+            method=sfn.TaskInput.from_text("POST"),
+            query_string_parameters=sfn.TaskInput.from_object({"id": "123"}),
+            url_encoding_format=tasks.URLEncodingFormat.BRACKETS
+        )
+    '''
+
+    BRACKETS = "BRACKETS"
+    '''Encode arrays using brackets.
+
+    For example, {'array': ['a','b','c']} encodes to 'array[]=a&array[]=b&array[]=c'
+    '''
+    COMMAS = "COMMAS"
+    '''Encode arrays using commas.
+
+    For example, {'array': ['a','b','c']} encodes to 'array=a,b,c,d'
+    '''
+    DEFAULT = "DEFAULT"
+    '''Apply the default URL encoding style (INDICES).'''
+    INDICES = "INDICES"
+    '''Encode arrays using the index value.
+
+    For example, {'array': ['a','b','c']} encodes to 'array[0]=a&array[1]=b&array[2]=c'
+    '''
+    NONE = "NONE"
+    '''Do not apply URL encoding.'''
+    REPEAT = "REPEAT"
+    '''Repeat key for each item in the array.
+
+    For example, {'array': ['a','b','c']} encodes to 'array[]=a&array[]=b&array[]=c'
+    '''
+
+
 class VirtualClusterInput(
     metaclass=jsii.JSIIMeta,
     jsii_type="aws-cdk-lib.aws_stepfunctions_tasks.VirtualClusterInput",
@@ -32151,6 +32769,8 @@ __all__ = [
     "GlueStartCrawlerRunProps",
     "GlueStartJobRun",
     "GlueStartJobRunProps",
+    "HttpInvoke",
+    "HttpInvokeProps",
     "HttpMethod",
     "HttpMethods",
     "IContainerDefinition",
@@ -32212,6 +32832,7 @@ __all__ = [
     "TransformOutput",
     "TransformResources",
     "TransformS3DataSource",
+    "URLEncodingFormat",
     "VirtualClusterInput",
     "VpcConfig",
 ]
@@ -34408,6 +35029,60 @@ def _typecheckingstub__6a5a6a067402f20efc3f218ecff8d7cae8c7206cf0bfb73907469d47f
     """Type checking stubs"""
     pass
 
+def _typecheckingstub__380dcb304dd02d709d798634fa365c757bcaa7593ab7542271009736c47d0329(
+    scope: _constructs_77d1e7e8.Construct,
+    id: builtins.str,
+    *,
+    api_endpoint: _TaskInput_91b91b91,
+    api_root: builtins.str,
+    connection: _IConnection_afaa0769,
+    method: _TaskInput_91b91b91,
+    body: typing.Optional[_TaskInput_91b91b91] = None,
+    headers: typing.Optional[_TaskInput_91b91b91] = None,
+    query_string_parameters: typing.Optional[_TaskInput_91b91b91] = None,
+    url_encoding_format: typing.Optional[URLEncodingFormat] = None,
+    comment: typing.Optional[builtins.str] = None,
+    credentials: typing.Optional[typing.Union[_Credentials_2cd64c6b, typing.Dict[builtins.str, typing.Any]]] = None,
+    heartbeat: typing.Optional[_Duration_4839e8c3] = None,
+    heartbeat_timeout: typing.Optional[_Timeout_d7c10551] = None,
+    input_path: typing.Optional[builtins.str] = None,
+    integration_pattern: typing.Optional[_IntegrationPattern_949291bc] = None,
+    output_path: typing.Optional[builtins.str] = None,
+    result_path: typing.Optional[builtins.str] = None,
+    result_selector: typing.Optional[typing.Mapping[builtins.str, typing.Any]] = None,
+    state_name: typing.Optional[builtins.str] = None,
+    task_timeout: typing.Optional[_Timeout_d7c10551] = None,
+    timeout: typing.Optional[_Duration_4839e8c3] = None,
+) -> None:
+    """Type checking stubs"""
+    pass
+
+def _typecheckingstub__9c1bbcee50744a26bccfe1fdf126df22aaaf9a0e25bc51ef9803628b561dd275(
+    *,
+    comment: typing.Optional[builtins.str] = None,
+    credentials: typing.Optional[typing.Union[_Credentials_2cd64c6b, typing.Dict[builtins.str, typing.Any]]] = None,
+    heartbeat: typing.Optional[_Duration_4839e8c3] = None,
+    heartbeat_timeout: typing.Optional[_Timeout_d7c10551] = None,
+    input_path: typing.Optional[builtins.str] = None,
+    integration_pattern: typing.Optional[_IntegrationPattern_949291bc] = None,
+    output_path: typing.Optional[builtins.str] = None,
+    result_path: typing.Optional[builtins.str] = None,
+    result_selector: typing.Optional[typing.Mapping[builtins.str, typing.Any]] = None,
+    state_name: typing.Optional[builtins.str] = None,
+    task_timeout: typing.Optional[_Timeout_d7c10551] = None,
+    timeout: typing.Optional[_Duration_4839e8c3] = None,
+    api_endpoint: _TaskInput_91b91b91,
+    api_root: builtins.str,
+    connection: _IConnection_afaa0769,
+    method: _TaskInput_91b91b91,
+    body: typing.Optional[_TaskInput_91b91b91] = None,
+    headers: typing.Optional[_TaskInput_91b91b91] = None,
+    query_string_parameters: typing.Optional[_TaskInput_91b91b91] = None,
+    url_encoding_format: typing.Optional[URLEncodingFormat] = None,
+) -> None:
+    """Type checking stubs"""
+    pass
+
 def _typecheckingstub__b1d56e9269c0540407e74b7d6334bbf508d8b37f4f0aa662ec8b33fee107376a(
     task: ISageMakerTask,
 ) -> None: