aws-cdk-lib 2.187.0__py3-none-any.whl → 2.189.0__py3-none-any.whl

aws_cdk/aws_apigatewayv2/__init__.py

@@ -106,6 +106,15 @@ apigwv2.HttpApi(self, "HttpProxyApi",
 )
 ```
 
+You can configure IP address type for the API endpoint using `ipAddressType` property.
+Valid values are `IPV4` (default) and `DUAL_STACK`.
+
+```python
+apigwv2.HttpApi(self, "HttpApi",
+    ip_address_type=apigwv2.IpAddressType.DUAL_STACK
+)
+```
+
 ### Cross Origin Resource Sharing (CORS)
 
 [Cross-origin resource sharing (CORS)](https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS) is a browser security
@@ -450,6 +459,15 @@ arn = api.arn_for_execute_api_v2("$connect", "dev")
 
 For a detailed explanation of this function, including usage and examples, please refer to the [Generating ARN for Execute API](#generating-arn-for-execute-api) section under HTTP API.
 
+You can configure IP address type for the API endpoint using `ipAddressType` property.
+Valid values are `IPV4` (default) and `DUAL_STACK`.
+
+```python
+apigwv2.WebSocketApi(self, "WebSocketApi",
+    ip_address_type=apigwv2.IpAddressType.DUAL_STACK
+)
+```
+
 ### Manage Connections Permission
 
 Grant permission to use API Gateway Management API of a WebSocket API by calling the `grantManageConnections` API.
@@ -842,6 +860,7 @@ class CfnApi(
             disable_execute_api_endpoint=False,
             disable_schema_validation=False,
             fail_on_warnings=False,
+            ip_address_type="ipAddressType",
             name="name",
             protocol_type="protocolType",
             route_key="routeKey",
@@ -869,6 +888,7 @@ class CfnApi(
         disable_execute_api_endpoint: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,
         disable_schema_validation: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,
         fail_on_warnings: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,
+        ip_address_type: typing.Optional[builtins.str] = None,
         name: typing.Optional[builtins.str] = None,
         protocol_type: typing.Optional[builtins.str] = None,
         route_key: typing.Optional[builtins.str] = None,
@@ -890,6 +910,7 @@ class CfnApi(
         :param disable_execute_api_endpoint: Specifies whether clients can invoke your API by using the default ``execute-api`` endpoint. By default, clients can invoke your API with the default https://{api_id}.execute-api.{region}.amazonaws.com endpoint. To require that clients use a custom domain name to invoke your API, disable the default endpoint.
         :param disable_schema_validation: Avoid validating models when creating a deployment. Supported only for WebSocket APIs.
         :param fail_on_warnings: Specifies whether to rollback the API creation when a warning is encountered. By default, API creation continues if a warning is encountered.
+        :param ip_address_type: The IP address types that can invoke the API. Use ``ipv4`` to allow only IPv4 addresses to invoke your API, or use ``dualstack`` to allow both IPv4 and IPv6 addresses to invoke your API. Don’t use IP address type for an HTTP API based on an OpenAPI specification. Instead, specify the IP address type in the OpenAPI specification.
         :param name: The name of the API. Required unless you specify an OpenAPI definition for ``Body`` or ``S3BodyLocation`` .
         :param protocol_type: The API protocol. Valid values are ``WEBSOCKET`` or ``HTTP`` . Required unless you specify an OpenAPI definition for ``Body`` or ``S3BodyLocation`` .
         :param route_key: This property is part of quick create. If you don't specify a ``routeKey`` , a default route of ``$default`` is created. The ``$default`` route acts as a catch-all for any request made to your API, for a particular stage. The ``$default`` route key can't be modified. You can add routes after creating the API, and you can update the route keys of additional routes. Supported only for HTTP APIs.
@@ -913,6 +934,7 @@ class CfnApi(
             disable_execute_api_endpoint=disable_execute_api_endpoint,
             disable_schema_validation=disable_schema_validation,
             fail_on_warnings=fail_on_warnings,
+            ip_address_type=ip_address_type,
             name=name,
             protocol_type=protocol_type,
             route_key=route_key,
@@ -1143,6 +1165,19 @@ class CfnApi(
             check_type(argname="argument value", value=value, expected_type=type_hints["value"])
         jsii.set(self, "failOnWarnings", value) # pyright: ignore[reportArgumentType]
 
+    @builtins.property
+    @jsii.member(jsii_name="ipAddressType")
+    def ip_address_type(self) -> typing.Optional[builtins.str]:
+        '''The IP address types that can invoke the API.'''
+        return typing.cast(typing.Optional[builtins.str], jsii.get(self, "ipAddressType"))
+
+    @ip_address_type.setter
+    def ip_address_type(self, value: typing.Optional[builtins.str]) -> None:
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__2a1eb652a1c167ca6cb7d9b75ef226df1b04d95736668747822e7afa0766e2fd)
+            check_type(argname="argument value", value=value, expected_type=type_hints["value"])
+        jsii.set(self, "ipAddressType", value) # pyright: ignore[reportArgumentType]
+
     @builtins.property
     @jsii.member(jsii_name="name")
     def name(self) -> typing.Optional[builtins.str]:
@@ -2732,6 +2767,7 @@ class CfnApiMappingProps:
         "disable_execute_api_endpoint": "disableExecuteApiEndpoint",
         "disable_schema_validation": "disableSchemaValidation",
         "fail_on_warnings": "failOnWarnings",
+        "ip_address_type": "ipAddressType",
         "name": "name",
         "protocol_type": "protocolType",
         "route_key": "routeKey",
@@ -2755,6 +2791,7 @@ class CfnApiProps:
         disable_execute_api_endpoint: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,
         disable_schema_validation: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,
         fail_on_warnings: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,
+        ip_address_type: typing.Optional[builtins.str] = None,
         name: typing.Optional[builtins.str] = None,
         protocol_type: typing.Optional[builtins.str] = None,
         route_key: typing.Optional[builtins.str] = None,
@@ -2775,6 +2812,7 @@ class CfnApiProps:
         :param disable_execute_api_endpoint: Specifies whether clients can invoke your API by using the default ``execute-api`` endpoint. By default, clients can invoke your API with the default https://{api_id}.execute-api.{region}.amazonaws.com endpoint. To require that clients use a custom domain name to invoke your API, disable the default endpoint.
         :param disable_schema_validation: Avoid validating models when creating a deployment. Supported only for WebSocket APIs.
         :param fail_on_warnings: Specifies whether to rollback the API creation when a warning is encountered. By default, API creation continues if a warning is encountered.
+        :param ip_address_type: The IP address types that can invoke the API. Use ``ipv4`` to allow only IPv4 addresses to invoke your API, or use ``dualstack`` to allow both IPv4 and IPv6 addresses to invoke your API. Don’t use IP address type for an HTTP API based on an OpenAPI specification. Instead, specify the IP address type in the OpenAPI specification.
         :param name: The name of the API. Required unless you specify an OpenAPI definition for ``Body`` or ``S3BodyLocation`` .
         :param protocol_type: The API protocol. Valid values are ``WEBSOCKET`` or ``HTTP`` . Required unless you specify an OpenAPI definition for ``Body`` or ``S3BodyLocation`` .
         :param route_key: This property is part of quick create. If you don't specify a ``routeKey`` , a default route of ``$default`` is created. The ``$default`` route acts as a catch-all for any request made to your API, for a particular stage. The ``$default`` route key can't be modified. You can add routes after creating the API, and you can update the route keys of additional routes. Supported only for HTTP APIs.
@@ -2817,6 +2855,7 @@ class CfnApiProps:
                 disable_execute_api_endpoint=False,
                 disable_schema_validation=False,
                 fail_on_warnings=False,
+                ip_address_type="ipAddressType",
                 name="name",
                 protocol_type="protocolType",
                 route_key="routeKey",
@@ -2840,6 +2879,7 @@ class CfnApiProps:
             check_type(argname="argument disable_execute_api_endpoint", value=disable_execute_api_endpoint, expected_type=type_hints["disable_execute_api_endpoint"])
             check_type(argname="argument disable_schema_validation", value=disable_schema_validation, expected_type=type_hints["disable_schema_validation"])
             check_type(argname="argument fail_on_warnings", value=fail_on_warnings, expected_type=type_hints["fail_on_warnings"])
+            check_type(argname="argument ip_address_type", value=ip_address_type, expected_type=type_hints["ip_address_type"])
             check_type(argname="argument name", value=name, expected_type=type_hints["name"])
             check_type(argname="argument protocol_type", value=protocol_type, expected_type=type_hints["protocol_type"])
             check_type(argname="argument route_key", value=route_key, expected_type=type_hints["route_key"])
@@ -2868,6 +2908,8 @@ class CfnApiProps:
             self._values["disable_schema_validation"] = disable_schema_validation
         if fail_on_warnings is not None:
             self._values["fail_on_warnings"] = fail_on_warnings
+        if ip_address_type is not None:
+            self._values["ip_address_type"] = ip_address_type
         if name is not None:
             self._values["name"] = name
         if protocol_type is not None:
@@ -3001,6 +3043,19 @@ class CfnApiProps:
         result = self._values.get("fail_on_warnings")
         return typing.cast(typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]], result)
 
+    @builtins.property
+    def ip_address_type(self) -> typing.Optional[builtins.str]:
+        '''The IP address types that can invoke the API.
+
+        Use ``ipv4`` to allow only IPv4 addresses to invoke your API, or use ``dualstack`` to allow both IPv4 and IPv6 addresses to invoke your API.
+
+        Don’t use IP address type for an HTTP API based on an OpenAPI specification. Instead, specify the IP address type in the OpenAPI specification.
+
+        :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-apigatewayv2-api.html#cfn-apigatewayv2-api-ipaddresstype
+        '''
+        result = self._values.get("ip_address_type")
+        return typing.cast(typing.Optional[builtins.str], result)
+
     @builtins.property
     def name(self) -> typing.Optional[builtins.str]:
         '''The name of the API.
@@ -3970,6 +4025,7 @@ class CfnDomainName(
                 certificate_arn="certificateArn",
                 certificate_name="certificateName",
                 endpoint_type="endpointType",
+                ip_address_type="ipAddressType",
                 ownership_verification_certificate_arn="ownershipVerificationCertificateArn",
                 security_policy="securityPolicy"
             )],
@@ -4156,6 +4212,7 @@ class CfnDomainName(
             "certificate_arn": "certificateArn",
             "certificate_name": "certificateName",
             "endpoint_type": "endpointType",
+            "ip_address_type": "ipAddressType",
             "ownership_verification_certificate_arn": "ownershipVerificationCertificateArn",
             "security_policy": "securityPolicy",
         },
@@ -4167,6 +4224,7 @@ class CfnDomainName(
             certificate_arn: typing.Optional[builtins.str] = None,
             certificate_name: typing.Optional[builtins.str] = None,
             endpoint_type: typing.Optional[builtins.str] = None,
+            ip_address_type: typing.Optional[builtins.str] = None,
             ownership_verification_certificate_arn: typing.Optional[builtins.str] = None,
             security_policy: typing.Optional[builtins.str] = None,
         ) -> None:
@@ -4177,6 +4235,7 @@ class CfnDomainName(
             :param certificate_arn: An AWS -managed certificate that will be used by the edge-optimized endpoint for this domain name. AWS Certificate Manager is the only supported source.
             :param certificate_name: The user-friendly name of the certificate that will be used by the edge-optimized endpoint for this domain name.
             :param endpoint_type: The endpoint type.
+            :param ip_address_type: The IP address types that can invoke the domain name. Use ``ipv4`` to allow only IPv4 addresses to invoke your domain name, or use ``dualstack`` to allow both IPv4 and IPv6 addresses to invoke your domain name.
             :param ownership_verification_certificate_arn: The Amazon resource name (ARN) for the public certificate issued by AWS Certificate Manager . This ARN is used to validate custom domain ownership. It's required only if you configure mutual TLS and use either an ACM-imported or a private CA certificate ARN as the regionalCertificateArn.
             :param security_policy: The Transport Layer Security (TLS) version of the security policy for this domain name. The valid values are ``TLS_1_0`` and ``TLS_1_2`` .
 
@@ -4193,6 +4252,7 @@ class CfnDomainName(
                     certificate_arn="certificateArn",
                     certificate_name="certificateName",
                     endpoint_type="endpointType",
+                    ip_address_type="ipAddressType",
                     ownership_verification_certificate_arn="ownershipVerificationCertificateArn",
                     security_policy="securityPolicy"
                 )
@@ -4202,6 +4262,7 @@ class CfnDomainName(
                 check_type(argname="argument certificate_arn", value=certificate_arn, expected_type=type_hints["certificate_arn"])
                 check_type(argname="argument certificate_name", value=certificate_name, expected_type=type_hints["certificate_name"])
                 check_type(argname="argument endpoint_type", value=endpoint_type, expected_type=type_hints["endpoint_type"])
+                check_type(argname="argument ip_address_type", value=ip_address_type, expected_type=type_hints["ip_address_type"])
                 check_type(argname="argument ownership_verification_certificate_arn", value=ownership_verification_certificate_arn, expected_type=type_hints["ownership_verification_certificate_arn"])
                 check_type(argname="argument security_policy", value=security_policy, expected_type=type_hints["security_policy"])
             self._values: typing.Dict[builtins.str, typing.Any] = {}
@@ -4211,6 +4272,8 @@ class CfnDomainName(
                 self._values["certificate_name"] = certificate_name
             if endpoint_type is not None:
                 self._values["endpoint_type"] = endpoint_type
+            if ip_address_type is not None:
+                self._values["ip_address_type"] = ip_address_type
             if ownership_verification_certificate_arn is not None:
                 self._values["ownership_verification_certificate_arn"] = ownership_verification_certificate_arn
             if security_policy is not None:
@@ -4245,6 +4308,17 @@ class CfnDomainName(
             result = self._values.get("endpoint_type")
             return typing.cast(typing.Optional[builtins.str], result)
 
+        @builtins.property
+        def ip_address_type(self) -> typing.Optional[builtins.str]:
+            '''The IP address types that can invoke the domain name.
+
+            Use ``ipv4`` to allow only IPv4 addresses to invoke your domain name, or use ``dualstack`` to allow both IPv4 and IPv6 addresses to invoke your domain name.
+
+            :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-apigatewayv2-domainname-domainnameconfiguration.html#cfn-apigatewayv2-domainname-domainnameconfiguration-ipaddresstype
+            '''
+            result = self._values.get("ip_address_type")
+            return typing.cast(typing.Optional[builtins.str], result)
+
         @builtins.property
         def ownership_verification_certificate_arn(
             self,
@@ -4403,6 +4477,7 @@ class CfnDomainNameProps:
                     certificate_arn="certificateArn",
                     certificate_name="certificateName",
                     endpoint_type="endpointType",
+                    ip_address_type="ipAddressType",
                     ownership_verification_certificate_arn="ownershipVerificationCertificateArn",
                     security_policy="securityPolicy"
                 )],
@@ -8976,6 +9051,7 @@ class HttpApiAttributes:
         "default_integration": "defaultIntegration",
         "description": "description",
         "disable_execute_api_endpoint": "disableExecuteApiEndpoint",
+        "ip_address_type": "ipAddressType",
         "route_selection_expression": "routeSelectionExpression",
     },
 )
@@ -8992,6 +9068,7 @@ class HttpApiProps:
         default_integration: typing.Optional["HttpRouteIntegration"] = None,
         description: typing.Optional[builtins.str] = None,
         disable_execute_api_endpoint: typing.Optional[builtins.bool] = None,
+        ip_address_type: typing.Optional["IpAddressType"] = None,
         route_selection_expression: typing.Optional[builtins.bool] = None,
     ) -> None:
         '''Properties to initialize an instance of ``HttpApi``.
@@ -9005,6 +9082,7 @@ class HttpApiProps:
         :param default_integration: An integration that will be configured on the catch-all route ($default). Default: - none
         :param description: The description of the API. Default: - none
         :param disable_execute_api_endpoint: Specifies whether clients can invoke your API using the default endpoint. By default, clients can invoke your API with the default ``https://{api_id}.execute-api.{region}.amazonaws.com`` endpoint. Set this to true if you would like clients to use your custom domain name. Default: false execute-api endpoint enabled.
+        :param ip_address_type: The IP address types that can invoke the API. Default: undefined - AWS default is IPV4
         :param route_selection_expression: Whether to set the default route selection expression for the API. When enabled, "${request.method} ${request.path}" is set as the default route selection expression. Default: false
 
         :exampleMetadata: infused
@@ -9041,6 +9119,7 @@ class HttpApiProps:
             check_type(argname="argument default_integration", value=default_integration, expected_type=type_hints["default_integration"])
             check_type(argname="argument description", value=description, expected_type=type_hints["description"])
             check_type(argname="argument disable_execute_api_endpoint", value=disable_execute_api_endpoint, expected_type=type_hints["disable_execute_api_endpoint"])
+            check_type(argname="argument ip_address_type", value=ip_address_type, expected_type=type_hints["ip_address_type"])
             check_type(argname="argument route_selection_expression", value=route_selection_expression, expected_type=type_hints["route_selection_expression"])
         self._values: typing.Dict[builtins.str, typing.Any] = {}
         if api_name is not None:
@@ -9061,6 +9140,8 @@ class HttpApiProps:
             self._values["description"] = description
         if disable_execute_api_endpoint is not None:
             self._values["disable_execute_api_endpoint"] = disable_execute_api_endpoint
+        if ip_address_type is not None:
+            self._values["ip_address_type"] = ip_address_type
         if route_selection_expression is not None:
             self._values["route_selection_expression"] = route_selection_expression
 
@@ -9155,6 +9236,17 @@ class HttpApiProps:
         result = self._values.get("disable_execute_api_endpoint")
         return typing.cast(typing.Optional[builtins.bool], result)
 
+    @builtins.property
+    def ip_address_type(self) -> typing.Optional["IpAddressType"]:
+        '''The IP address types that can invoke the API.
+
+        :default: undefined - AWS default is IPV4
+
+        :see: https://docs.aws.amazon.com/apigateway/latest/developerguide/http-api-ip-address-type.html
+        '''
+        result = self._values.get("ip_address_type")
+        return typing.cast(typing.Optional["IpAddressType"], result)
+
     @builtins.property
     def route_selection_expression(self) -> typing.Optional[builtins.bool]:
         '''Whether to set the default route selection expression for the API.
@@ -10970,6 +11062,17 @@ class IHttpApi(IApi, typing_extensions.Protocol):
         '''
         ...
 
+    @builtins.property
+    @jsii.member(jsii_name="defaultStage")
+    def default_stage(self) -> typing.Optional["IHttpStage"]:
+        '''The default stage of this API.
+
+        :default: - a stage will be created
+
+        :attribute: true
+        '''
+        ...
+
     @jsii.member(jsii_name="addVpcLink")
     def add_vpc_link(
         self,
@@ -11241,6 +11344,17 @@ class _IHttpApiProxy(
         '''
         return typing.cast(typing.Optional["IHttpRouteAuthorizer"], jsii.get(self, "defaultAuthorizer"))
 
+    @builtins.property
+    @jsii.member(jsii_name="defaultStage")
+    def default_stage(self) -> typing.Optional["IHttpStage"]:
+        '''The default stage of this API.
+
+        :default: - a stage will be created
+
+        :attribute: true
+        '''
+        return typing.cast(typing.Optional["IHttpStage"], jsii.get(self, "defaultStage"))
+
     @jsii.member(jsii_name="addVpcLink")
     def add_vpc_link(
         self,
@@ -12175,6 +12289,25 @@ class _IntegrationCredentialsProxy(IntegrationCredentials):
 typing.cast(typing.Any, IntegrationCredentials).__jsii_proxy_class__ = lambda : _IntegrationCredentialsProxy
 
 
+@jsii.enum(jsii_type="aws-cdk-lib.aws_apigatewayv2.IpAddressType")
+class IpAddressType(enum.Enum):
+    '''Supported IP Address Types.
+
+    :exampleMetadata: infused
+
+    Example::
+
+        apigwv2.HttpApi(self, "HttpApi",
+            ip_address_type=apigwv2.IpAddressType.DUAL_STACK
+        )
+    '''
+
+    IPV4 = "IPV4"
+    '''IPv4 address type.'''
+    DUAL_STACK = "DUAL_STACK"
+    '''IPv4 and IPv6 address type.'''
+
+
 @jsii.data_type(
     jsii_type="aws-cdk-lib.aws_apigatewayv2.MTLSConfig",
     jsii_struct_bases=[],
@@ -13229,6 +13362,7 @@ class WebSocketApi(
         default_route_options: typing.Optional[typing.Union["WebSocketRouteOptions", typing.Dict[builtins.str, typing.Any]]] = None,
         description: typing.Optional[builtins.str] = None,
         disconnect_route_options: typing.Optional[typing.Union["WebSocketRouteOptions", typing.Dict[builtins.str, typing.Any]]] = None,
+        ip_address_type: typing.Optional[IpAddressType] = None,
         route_selection_expression: typing.Optional[builtins.str] = None,
     ) -> None:
         '''
@@ -13240,6 +13374,7 @@ class WebSocketApi(
         :param default_route_options: Options to configure a '$default' route. Default: - no '$default' route configured
         :param description: The description of the API. Default: - none
         :param disconnect_route_options: Options to configure a '$disconnect' route. Default: - no '$disconnect' route configured
+        :param ip_address_type: The IP address types that can invoke the API. Default: undefined - AWS default is IPV4
         :param route_selection_expression: The route selection expression for the API. Default: '$request.body.action'
         '''
         if __debug__:
@@ -13253,6 +13388,7 @@ class WebSocketApi(
             default_route_options=default_route_options,
             description=description,
             disconnect_route_options=disconnect_route_options,
+            ip_address_type=ip_address_type,
             route_selection_expression=route_selection_expression,
         )
 
@@ -13561,6 +13697,7 @@ class WebSocketApiKeySelectionExpression(
         "default_route_options": "defaultRouteOptions",
         "description": "description",
         "disconnect_route_options": "disconnectRouteOptions",
+        "ip_address_type": "ipAddressType",
         "route_selection_expression": "routeSelectionExpression",
     },
 )
@@ -13574,6 +13711,7 @@ class WebSocketApiProps:
         default_route_options: typing.Optional[typing.Union["WebSocketRouteOptions", typing.Dict[builtins.str, typing.Any]]] = None,
         description: typing.Optional[builtins.str] = None,
         disconnect_route_options: typing.Optional[typing.Union["WebSocketRouteOptions", typing.Dict[builtins.str, typing.Any]]] = None,
+        ip_address_type: typing.Optional[IpAddressType] = None,
         route_selection_expression: typing.Optional[builtins.str] = None,
     ) -> None:
         '''Props for WebSocket API.
@@ -13584,6 +13722,7 @@ class WebSocketApiProps:
         :param default_route_options: Options to configure a '$default' route. Default: - no '$default' route configured
         :param description: The description of the API. Default: - none
         :param disconnect_route_options: Options to configure a '$disconnect' route. Default: - no '$disconnect' route configured
+        :param ip_address_type: The IP address types that can invoke the API. Default: undefined - AWS default is IPV4
         :param route_selection_expression: The route selection expression for the API. Default: '$request.body.action'
 
         :exampleMetadata: infused
@@ -13625,6 +13764,7 @@ class WebSocketApiProps:
             check_type(argname="argument default_route_options", value=default_route_options, expected_type=type_hints["default_route_options"])
             check_type(argname="argument description", value=description, expected_type=type_hints["description"])
             check_type(argname="argument disconnect_route_options", value=disconnect_route_options, expected_type=type_hints["disconnect_route_options"])
+            check_type(argname="argument ip_address_type", value=ip_address_type, expected_type=type_hints["ip_address_type"])
             check_type(argname="argument route_selection_expression", value=route_selection_expression, expected_type=type_hints["route_selection_expression"])
         self._values: typing.Dict[builtins.str, typing.Any] = {}
         if api_key_selection_expression is not None:
@@ -13639,6 +13779,8 @@ class WebSocketApiProps:
             self._values["description"] = description
         if disconnect_route_options is not None:
             self._values["disconnect_route_options"] = disconnect_route_options
+        if ip_address_type is not None:
+            self._values["ip_address_type"] = ip_address_type
         if route_selection_expression is not None:
             self._values["route_selection_expression"] = route_selection_expression
 
@@ -13700,6 +13842,17 @@ class WebSocketApiProps:
         result = self._values.get("disconnect_route_options")
         return typing.cast(typing.Optional["WebSocketRouteOptions"], result)
 
+    @builtins.property
+    def ip_address_type(self) -> typing.Optional[IpAddressType]:
+        '''The IP address types that can invoke the API.
+
+        :default: undefined - AWS default is IPV4
+
+        :see: https://docs.aws.amazon.com/apigateway/latest/developerguide/http-api-ip-address-type.html
+        '''
+        result = self._values.get("ip_address_type")
+        return typing.cast(typing.Optional[IpAddressType], result)
+
     @builtins.property
     def route_selection_expression(self) -> typing.Optional[builtins.str]:
         '''The route selection expression for the API.
@@ -16255,6 +16408,7 @@ class HttpApi(
         default_integration: typing.Optional[HttpRouteIntegration] = None,
         description: typing.Optional[builtins.str] = None,
         disable_execute_api_endpoint: typing.Optional[builtins.bool] = None,
+        ip_address_type: typing.Optional[IpAddressType] = None,
         route_selection_expression: typing.Optional[builtins.bool] = None,
     ) -> None:
         '''
@@ -16269,6 +16423,7 @@ class HttpApi(
         :param default_integration: An integration that will be configured on the catch-all route ($default). Default: - none
         :param description: The description of the API. Default: - none
         :param disable_execute_api_endpoint: Specifies whether clients can invoke your API using the default endpoint. By default, clients can invoke your API with the default ``https://{api_id}.execute-api.{region}.amazonaws.com`` endpoint. Set this to true if you would like clients to use your custom domain name. Default: false execute-api endpoint enabled.
+        :param ip_address_type: The IP address types that can invoke the API. Default: undefined - AWS default is IPV4
         :param route_selection_expression: Whether to set the default route selection expression for the API. When enabled, "${request.method} ${request.path}" is set as the default route selection expression. Default: false
         '''
         if __debug__:
@@ -16285,6 +16440,7 @@ class HttpApi(
             default_integration=default_integration,
             description=description,
             disable_execute_api_endpoint=disable_execute_api_endpoint,
+            ip_address_type=ip_address_type,
             route_selection_expression=route_selection_expression,
         )
 
@@ -18735,6 +18891,7 @@ __all__ = [
     "IWebSocketRouteAuthorizer",
     "IWebSocketStage",
     "IntegrationCredentials",
+    "IpAddressType",
     "MTLSConfig",
     "MappingValue",
     "ParameterMapping",
@@ -18812,6 +18969,7 @@ def _typecheckingstub__1db7633eb849c7234f54cf8f50ef6e4c6273ca1ab60db537f47e511e2
     disable_execute_api_endpoint: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,
     disable_schema_validation: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,
     fail_on_warnings: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,
+    ip_address_type: typing.Optional[builtins.str] = None,
     name: typing.Optional[builtins.str] = None,
     protocol_type: typing.Optional[builtins.str] = None,
     route_key: typing.Optional[builtins.str] = None,
@@ -18895,6 +19053,12 @@ def _typecheckingstub__2ce8eb7264be44ff3a6ae79c6be6a193c31eb617518209aeb51c346aa
     """Type checking stubs"""
     pass
 
+def _typecheckingstub__2a1eb652a1c167ca6cb7d9b75ef226df1b04d95736668747822e7afa0766e2fd(
+    value: typing.Optional[builtins.str],
+) -> None:
+    """Type checking stubs"""
+    pass
+
 def _typecheckingstub__6de2f3d46e4a0275374cdfba39222daec1a50d7516f00756e898551462523fb6(
     value: typing.Optional[builtins.str],
 ) -> None:
@@ -19139,6 +19303,7 @@ def _typecheckingstub__de72efdeda792916a7e0a8d8953153208abe93b442ac8056802f749d4
     disable_execute_api_endpoint: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,
     disable_schema_validation: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,
     fail_on_warnings: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,
+    ip_address_type: typing.Optional[builtins.str] = None,
     name: typing.Optional[builtins.str] = None,
     protocol_type: typing.Optional[builtins.str] = None,
     route_key: typing.Optional[builtins.str] = None,
@@ -19375,6 +19540,7 @@ def _typecheckingstub__faaf4905cea99e081f1f881fa68755b4ec1bc0ed8f4e145c30baf36d9
     certificate_arn: typing.Optional[builtins.str] = None,
     certificate_name: typing.Optional[builtins.str] = None,
     endpoint_type: typing.Optional[builtins.str] = None,
+    ip_address_type: typing.Optional[builtins.str] = None,
     ownership_verification_certificate_arn: typing.Optional[builtins.str] = None,
     security_policy: typing.Optional[builtins.str] = None,
 ) -> None:
@@ -20221,6 +20387,7 @@ def _typecheckingstub__cae61f98d904e8d8d184da1dff09df331c70ac82ebd0d24c6d28a445a
     default_integration: typing.Optional[HttpRouteIntegration] = None,
     description: typing.Optional[builtins.str] = None,
     disable_execute_api_endpoint: typing.Optional[builtins.bool] = None,
+    ip_address_type: typing.Optional[IpAddressType] = None,
     route_selection_expression: typing.Optional[builtins.bool] = None,
 ) -> None:
     """Type checking stubs"""
@@ -20592,6 +20759,7 @@ def _typecheckingstub__8f37be20ee015faaaf9283fe203dc28d2dcc56800f6007ae9105e3ad4
     default_route_options: typing.Optional[typing.Union[WebSocketRouteOptions, typing.Dict[builtins.str, typing.Any]]] = None,
     description: typing.Optional[builtins.str] = None,
     disconnect_route_options: typing.Optional[typing.Union[WebSocketRouteOptions, typing.Dict[builtins.str, typing.Any]]] = None,
+    ip_address_type: typing.Optional[IpAddressType] = None,
     route_selection_expression: typing.Optional[builtins.str] = None,
 ) -> None:
     """Type checking stubs"""
@@ -20677,6 +20845,7 @@ def _typecheckingstub__c8895a8e636238eeb0c7336ab16a74480a8a8620f13eb92f05d4074fb
     default_route_options: typing.Optional[typing.Union[WebSocketRouteOptions, typing.Dict[builtins.str, typing.Any]]] = None,
     description: typing.Optional[builtins.str] = None,
     disconnect_route_options: typing.Optional[typing.Union[WebSocketRouteOptions, typing.Dict[builtins.str, typing.Any]]] = None,
+    ip_address_type: typing.Optional[IpAddressType] = None,
     route_selection_expression: typing.Optional[builtins.str] = None,
 ) -> None:
     """Type checking stubs"""
@@ -20994,6 +21163,7 @@ def _typecheckingstub__2805f7eeb5fa5bd355806013fdce32506e639134d31910f71d0b86917
     default_integration: typing.Optional[HttpRouteIntegration] = None,
     description: typing.Optional[builtins.str] = None,
     disable_execute_api_endpoint: typing.Optional[builtins.bool] = None,
+    ip_address_type: typing.Optional[IpAddressType] = None,
     route_selection_expression: typing.Optional[builtins.bool] = None,
 ) -> None:
     """Type checking stubs"""