aws-cdk-lib 2.215.0__py3-none-any.whl → 2.217.0__py3-none-any.whl

aws_cdk/aws_events/__init__.py

@@ -361,6 +361,24 @@ archive = Archive(stack, "Archive",
 
 To enable archives or schema discovery on an event bus, customers has the choice of using either an AWS owned key or a customer managed key.
 For more information, see [KMS key options for event bus encryption](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-encryption-at-rest-key-options.html).
+
+## Configuring logging
+
+To configure logging for an Event Bus, leverage the LogConfig property. It allows different level of logging (NONE, INFO, TRACE, ERROR) and wether to include details or not.
+
+```python
+from aws_cdk.aws_events import EventBus, IncludeDetail, Level
+
+
+bus = EventBus(self, "Bus",
+    log_config=events.LogConfig(
+        include_detail=IncludeDetail.FULL,
+        level=Level.TRACE
+    )
+)
+```
+
+See more [Specifying event bus log level](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-event-bus-logs.html#eb-event-bus-logs-level)
 '''
 from pkgutil import extend_path
 __path__ = extend_path(__path__, __name__)
@@ -3386,6 +3404,7 @@ class EventBusPolicyReference:
         "event_bus_name": "eventBusName",
         "event_source_name": "eventSourceName",
         "kms_key": "kmsKey",
+        "log_config": "logConfig",
     },
 )
 class EventBusProps:
@@ -3397,6 +3416,7 @@ class EventBusProps:
         event_bus_name: typing.Optional[builtins.str] = None,
         event_source_name: typing.Optional[builtins.str] = None,
         kms_key: typing.Optional[_IKey_5f11635f] = None,
+        log_config: typing.Optional[typing.Union["LogConfig", typing.Dict[builtins.str, typing.Any]]] = None,
     ) -> None:
         '''Properties to define an event bus.
 
@@ -3405,6 +3425,7 @@ class EventBusProps:
         :param event_bus_name: The name of the event bus you are creating Note: If 'eventSourceName' is passed in, you cannot set this. Default: - automatically generated name
         :param event_source_name: The partner event source to associate with this event bus resource Note: If 'eventBusName' is passed in, you cannot set this. Default: - no partner event source
         :param kms_key: The customer managed key that encrypt events on this event bus. Default: - Use an AWS managed key
+        :param log_config: The Logging Configuration of the Èvent Bus. Default: - no logging
 
         :exampleMetadata: infused
 
@@ -3428,6 +3449,8 @@ class EventBusProps:
                 )]
             )
         '''
+        if isinstance(log_config, dict):
+            log_config = LogConfig(**log_config)
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__298a8c4285f4e039344007a0deb097d820ddec52c59d396d7a8faa1aa9c8b743)
             check_type(argname="argument dead_letter_queue", value=dead_letter_queue, expected_type=type_hints["dead_letter_queue"])
@@ -3435,6 +3458,7 @@ class EventBusProps:
             check_type(argname="argument event_bus_name", value=event_bus_name, expected_type=type_hints["event_bus_name"])
             check_type(argname="argument event_source_name", value=event_source_name, expected_type=type_hints["event_source_name"])
             check_type(argname="argument kms_key", value=kms_key, expected_type=type_hints["kms_key"])
+            check_type(argname="argument log_config", value=log_config, expected_type=type_hints["log_config"])
         self._values: typing.Dict[builtins.str, typing.Any] = {}
         if dead_letter_queue is not None:
             self._values["dead_letter_queue"] = dead_letter_queue
@@ -3446,6 +3470,8 @@ class EventBusProps:
             self._values["event_source_name"] = event_source_name
         if kms_key is not None:
             self._values["kms_key"] = kms_key
+        if log_config is not None:
+            self._values["log_config"] = log_config
 
     @builtins.property
     def dead_letter_queue(self) -> typing.Optional[_IQueue_7ed6f679]:
@@ -3502,6 +3528,15 @@ class EventBusProps:
         result = self._values.get("kms_key")
         return typing.cast(typing.Optional[_IKey_5f11635f], result)
 
+    @builtins.property
+    def log_config(self) -> typing.Optional["LogConfig"]:
+        '''The Logging Configuration of the Èvent Bus.
+
+        :default: - no logging
+        '''
+        result = self._values.get("log_config")
+        return typing.cast(typing.Optional["LogConfig"], result)
+
     def __eq__(self, rhs: typing.Any) -> builtins.bool:
         return isinstance(rhs, self.__class__) and rhs._values == self._values
 
@@ -4860,6 +4895,142 @@ class _IRuleTargetProxy:
 typing.cast(typing.Any, IRuleTarget).__jsii_proxy_class__ = lambda : _IRuleTargetProxy
 
 
+@jsii.enum(jsii_type="aws-cdk-lib.aws_events.IncludeDetail")
+class IncludeDetail(enum.Enum):
+    '''Whether EventBridge include detailed event information in the records it generates.
+
+    Detailed data can be useful for troubleshooting and debugging.
+    This information includes details of the event itself, as well as target details.
+
+    :exampleMetadata: infused
+
+    Example::
+
+        from aws_cdk.aws_events import EventBus, IncludeDetail, Level
+        
+        
+        bus = EventBus(self, "Bus",
+            log_config=events.LogConfig(
+                include_detail=IncludeDetail.FULL,
+                level=Level.TRACE
+            )
+        )
+    '''
+
+    FULL = "FULL"
+    '''FULL: Include all details related to event itself and the request EventBridge sends to the target.
+
+    Detailed data can be useful for troubleshooting and debugging.
+    '''
+    NONE = "NONE"
+    '''NONE: Does not include any details.'''
+
+
+@jsii.enum(jsii_type="aws-cdk-lib.aws_events.Level")
+class Level(enum.Enum):
+    '''The level of logging detail to include.
+
+    This applies to all log destinations for the event bus.
+
+    :exampleMetadata: infused
+
+    Example::
+
+        from aws_cdk.aws_events import EventBus, IncludeDetail, Level
+        
+        
+        bus = EventBus(self, "Bus",
+            log_config=events.LogConfig(
+                include_detail=IncludeDetail.FULL,
+                level=Level.TRACE
+            )
+        )
+    '''
+
+    INFO = "INFO"
+    '''INFO: EventBridge sends any logs related to errors, as well as major steps performed during event processing.'''
+    ERROR = "ERROR"
+    '''ERROR: EventBridge sends any logs related to errors generated during event processing and target delivery.'''
+    TRACE = "TRACE"
+    '''TRACE: EventBridge sends any logs generated during all steps in the event processing.'''
+    OFF = "OFF"
+    '''OFF: EventBridge does not send any logs.
+
+    This is the default.
+    '''
+
+
+@jsii.data_type(
+    jsii_type="aws-cdk-lib.aws_events.LogConfig",
+    jsii_struct_bases=[],
+    name_mapping={"include_detail": "includeDetail", "level": "level"},
+)
+class LogConfig:
+    def __init__(
+        self,
+        *,
+        include_detail: typing.Optional[IncludeDetail] = None,
+        level: typing.Optional[Level] = None,
+    ) -> None:
+        '''Interface for Logging Configuration of the Event Bus.
+
+        :param include_detail: Whether EventBridge include detailed event information in the records it generates. Default: no details
+        :param level: Logging level. Default: OFF
+
+        :exampleMetadata: infused
+
+        Example::
+
+            from aws_cdk.aws_events import EventBus, IncludeDetail, Level
+            
+            
+            bus = EventBus(self, "Bus",
+                log_config=events.LogConfig(
+                    include_detail=IncludeDetail.FULL,
+                    level=Level.TRACE
+                )
+            )
+        '''
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__198ca7d856a2573ae11c3570c27c6ff5d3b3d059abd28650a790b698a11f30b9)
+            check_type(argname="argument include_detail", value=include_detail, expected_type=type_hints["include_detail"])
+            check_type(argname="argument level", value=level, expected_type=type_hints["level"])
+        self._values: typing.Dict[builtins.str, typing.Any] = {}
+        if include_detail is not None:
+            self._values["include_detail"] = include_detail
+        if level is not None:
+            self._values["level"] = level
+
+    @builtins.property
+    def include_detail(self) -> typing.Optional[IncludeDetail]:
+        '''Whether EventBridge include detailed event information in the records it generates.
+
+        :default: no details
+        '''
+        result = self._values.get("include_detail")
+        return typing.cast(typing.Optional[IncludeDetail], result)
+
+    @builtins.property
+    def level(self) -> typing.Optional[Level]:
+        '''Logging level.
+
+        :default: OFF
+        '''
+        result = self._values.get("level")
+        return typing.cast(typing.Optional[Level], 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 "LogConfig(%s)" % ", ".join(
+            k + "=" + repr(v) for k, v in self._values.items()
+        )
+
+
 @jsii.implements(_IResolvable_da3f097b)
 class Match(metaclass=jsii.JSIIMeta, jsii_type="aws-cdk-lib.aws_events.Match"):
     '''An event pattern matcher.
@@ -13153,6 +13324,7 @@ class EventBus(
         event_bus_name: typing.Optional[builtins.str] = None,
         event_source_name: typing.Optional[builtins.str] = None,
         kms_key: typing.Optional[_IKey_5f11635f] = None,
+        log_config: typing.Optional[typing.Union[LogConfig, typing.Dict[builtins.str, typing.Any]]] = None,
     ) -> None:
         '''
         :param scope: -
@@ -13162,6 +13334,7 @@ class EventBus(
         :param event_bus_name: The name of the event bus you are creating Note: If 'eventSourceName' is passed in, you cannot set this. Default: - automatically generated name
         :param event_source_name: The partner event source to associate with this event bus resource Note: If 'eventBusName' is passed in, you cannot set this. Default: - no partner event source
         :param kms_key: The customer managed key that encrypt events on this event bus. Default: - Use an AWS managed key
+        :param log_config: The Logging Configuration of the Èvent Bus. Default: - no logging
         '''
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__95a51d19a0503daf5e05f08738b44a6276eaa23c373c99735de37b1247783380)
@@ -13173,6 +13346,7 @@ class EventBus(
             event_bus_name=event_bus_name,
             event_source_name=event_source_name,
             kms_key=kms_key,
+            log_config=log_config,
         )
 
         jsii.create(self.__class__, self, [scope, id, props])
@@ -13417,6 +13591,9 @@ __all__ = [
     "IRule",
     "IRuleRef",
     "IRuleTarget",
+    "IncludeDetail",
+    "Level",
+    "LogConfig",
     "Match",
     "OAuthAuthorizationProps",
     "OnEventOptions",
@@ -13689,6 +13866,7 @@ def _typecheckingstub__298a8c4285f4e039344007a0deb097d820ddec52c59d396d7a8faa1aa
     event_bus_name: typing.Optional[builtins.str] = None,
     event_source_name: typing.Optional[builtins.str] = None,
     kms_key: typing.Optional[_IKey_5f11635f] = None,
+    log_config: typing.Optional[typing.Union[LogConfig, typing.Dict[builtins.str, typing.Any]]] = None,
 ) -> None:
     """Type checking stubs"""
     pass
@@ -13776,6 +13954,14 @@ def _typecheckingstub__ee62e84f884e0e5476947339e584feca527844abc70d56b2fe2d048cc
     """Type checking stubs"""
     pass
 
+def _typecheckingstub__198ca7d856a2573ae11c3570c27c6ff5d3b3d059abd28650a790b698a11f30b9(
+    *,
+    include_detail: typing.Optional[IncludeDetail] = None,
+    level: typing.Optional[Level] = None,
+) -> None:
+    """Type checking stubs"""
+    pass
+
 def _typecheckingstub__40e12e6e33c3e0969083091ee3865292a66ff488c5232a973beb73ef6c62c5fa(
     *matchers: typing.Any,
 ) -> None:
@@ -14977,6 +15163,7 @@ def _typecheckingstub__95a51d19a0503daf5e05f08738b44a6276eaa23c373c99735de37b124
     event_bus_name: typing.Optional[builtins.str] = None,
     event_source_name: typing.Optional[builtins.str] = None,
     kms_key: typing.Optional[_IKey_5f11635f] = None,
+    log_config: typing.Optional[typing.Union[LogConfig, typing.Dict[builtins.str, typing.Any]]] = None,
 ) -> None:
     """Type checking stubs"""
     pass

aws_cdk/aws_evs/__init__.py

@@ -210,7 +210,11 @@ class CfnEnvironmentProps:
                     ),
                     v_tep=evs.CfnEnvironment.InitialVlanInfoProperty(
                         cidr="cidr"
-                    )
+                    ),
+            
+                    # the properties below are optional
+                    hcx_network_acl_id="hcxNetworkAclId",
+                    is_hcx_public=False
                 ),
                 kms_key_id="kmsKeyId",
                 service_access_security_groups=evs.CfnEnvironment.ServiceAccessSecurityGroupsProperty(
@@ -644,7 +648,11 @@ class CfnEnvironment(
                 ),
                 v_tep=evs.CfnEnvironment.InitialVlanInfoProperty(
                     cidr="cidr"
-                )
+                ),
+        
+                # the properties below are optional
+                hcx_network_acl_id="hcxNetworkAclId",
+                is_hcx_public=False
             ),
             kms_key_id="kmsKeyId",
             service_access_security_groups=evs.CfnEnvironment.ServiceAccessSecurityGroupsProperty(
@@ -1432,6 +1440,8 @@ class CfnEnvironment(
             "v_motion": "vMotion",
             "v_san": "vSan",
             "v_tep": "vTep",
+            "hcx_network_acl_id": "hcxNetworkAclId",
+            "is_hcx_public": "isHcxPublic",
         },
     )
     class InitialVlansProperty:
@@ -1448,6 +1458,8 @@ class CfnEnvironment(
             v_motion: typing.Union[_IResolvable_da3f097b, typing.Union["CfnEnvironment.InitialVlanInfoProperty", typing.Dict[builtins.str, typing.Any]]],
             v_san: typing.Union[_IResolvable_da3f097b, typing.Union["CfnEnvironment.InitialVlanInfoProperty", typing.Dict[builtins.str, typing.Any]]],
             v_tep: typing.Union[_IResolvable_da3f097b, typing.Union["CfnEnvironment.InitialVlanInfoProperty", typing.Dict[builtins.str, typing.Any]]],
+            hcx_network_acl_id: typing.Optional[builtins.str] = None,
+            is_hcx_public: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,
         ) -> None:
             '''The initial VLAN subnets for the environment.
 
@@ -1456,13 +1468,15 @@ class CfnEnvironment(
             :param edge_v_tep: The edge VTEP VLAN subnet. This VLAN subnet manages traffic flowing between the internal network and external networks, including internet access and other site connections.
             :param expansion_vlan1: An additional VLAN subnet that can be used to extend VCF capabilities once configured. For example, you can configure an expansion VLAN subnet to use NSX Federation for centralized management and synchronization of multiple NSX deployments across different locations.
             :param expansion_vlan2: An additional VLAN subnet that can be used to extend VCF capabilities once configured. For example, you can configure an expansion VLAN subnet to use NSX Federation for centralized management and synchronization of multiple NSX deployments across different locations.
-            :param hcx: The HCX VLAN subnet. This VLAN subnet allows the HCX Interconnnect (IX) and HCX Network Extension (NE) to reach their peers and enable HCX Service Mesh creation.
+            :param hcx: The HCX VLAN subnet. This VLAN subnet allows the HCX Interconnnect (IX) and HCX Network Extension (NE) to reach their peers and enable HCX Service Mesh creation. If you plan to use a public HCX VLAN subnet, the following requirements must be met: - Must have a /28 netmask and be allocated from the IPAM public pool. Required for HCX internet access configuration. - The HCX public VLAN CIDR block must be added to the VPC as a secondary CIDR block. - Must have at least two Elastic IP addresses to be allocated from the public IPAM pool for HCX components.
             :param nsx_up_link: The NSX uplink VLAN subnet. This VLAN subnet allows connectivity to the NSX overlay network.
             :param vmk_management: The host VMkernel management VLAN subnet. This VLAN subnet carries traffic for managing ESXi hosts and communicating with VMware vCenter Server.
             :param vm_management: The VM management VLAN subnet. This VLAN subnet carries traffic for vSphere virtual machines.
             :param v_motion: The vMotion VLAN subnet. This VLAN subnet carries traffic for vSphere vMotion.
             :param v_san: The vSAN VLAN subnet. This VLAN subnet carries the communication between ESXi hosts to implement a vSAN shared storage pool.
             :param v_tep: The VTEP VLAN subnet. This VLAN subnet handles internal network traffic between virtual machines within a VCF instance.
+            :param hcx_network_acl_id: A unique ID for a network access control list that the HCX VLAN uses. Required when ``isHcxPublic`` is set to ``true`` .
+            :param is_hcx_public: Determines if the HCX VLAN that Amazon EVS provisions is public or private.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-evs-environment-initialvlans.html
             :exampleMetadata: fixture=_generated
@@ -1503,7 +1517,11 @@ class CfnEnvironment(
                     ),
                     v_tep=evs.CfnEnvironment.InitialVlanInfoProperty(
                         cidr="cidr"
-                    )
+                    ),
+                
+                    # the properties below are optional
+                    hcx_network_acl_id="hcxNetworkAclId",
+                    is_hcx_public=False
                 )
             '''
             if __debug__:
@@ -1518,6 +1536,8 @@ class CfnEnvironment(
                 check_type(argname="argument v_motion", value=v_motion, expected_type=type_hints["v_motion"])
                 check_type(argname="argument v_san", value=v_san, expected_type=type_hints["v_san"])
                 check_type(argname="argument v_tep", value=v_tep, expected_type=type_hints["v_tep"])
+                check_type(argname="argument hcx_network_acl_id", value=hcx_network_acl_id, expected_type=type_hints["hcx_network_acl_id"])
+                check_type(argname="argument is_hcx_public", value=is_hcx_public, expected_type=type_hints["is_hcx_public"])
             self._values: typing.Dict[builtins.str, typing.Any] = {
                 "edge_v_tep": edge_v_tep,
                 "expansion_vlan1": expansion_vlan1,
@@ -1530,6 +1550,10 @@ class CfnEnvironment(
                 "v_san": v_san,
                 "v_tep": v_tep,
             }
+            if hcx_network_acl_id is not None:
+                self._values["hcx_network_acl_id"] = hcx_network_acl_id
+            if is_hcx_public is not None:
+                self._values["is_hcx_public"] = is_hcx_public
 
         @builtins.property
         def edge_v_tep(
@@ -1581,6 +1605,12 @@ class CfnEnvironment(
 
             This VLAN subnet allows the HCX Interconnnect (IX) and HCX Network Extension (NE) to reach their peers and enable HCX Service Mesh creation.
 
+            If you plan to use a public HCX VLAN subnet, the following requirements must be met:
+
+            - Must have a /28 netmask and be allocated from the IPAM public pool. Required for HCX internet access configuration.
+            - The HCX public VLAN CIDR block must be added to the VPC as a secondary CIDR block.
+            - Must have at least two Elastic IP addresses to be allocated from the public IPAM pool for HCX components.
+
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-evs-environment-initialvlans.html#cfn-evs-environment-initialvlans-hcx
             '''
             result = self._values.get("hcx")
@@ -1671,6 +1701,28 @@ class CfnEnvironment(
             assert result is not None, "Required property 'v_tep' is missing"
             return typing.cast(typing.Union[_IResolvable_da3f097b, "CfnEnvironment.InitialVlanInfoProperty"], result)
 
+        @builtins.property
+        def hcx_network_acl_id(self) -> typing.Optional[builtins.str]:
+            '''A unique ID for a network access control list that the HCX VLAN uses.
+
+            Required when ``isHcxPublic`` is set to ``true`` .
+
+            :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-evs-environment-initialvlans.html#cfn-evs-environment-initialvlans-hcxnetworkaclid
+            '''
+            result = self._values.get("hcx_network_acl_id")
+            return typing.cast(typing.Optional[builtins.str], result)
+
+        @builtins.property
+        def is_hcx_public(
+            self,
+        ) -> typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]]:
+            '''Determines if the HCX VLAN that Amazon EVS provisions is public or private.
+
+            :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-evs-environment-initialvlans.html#cfn-evs-environment-initialvlans-ishcxpublic
+            '''
+            result = self._values.get("is_hcx_public")
+            return typing.cast(typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]], result)
+
         def __eq__(self, rhs: typing.Any) -> builtins.bool:
             return isinstance(rhs, self.__class__) and rhs._values == self._values
 
@@ -2261,6 +2313,8 @@ def _typecheckingstub__a70b9547ba64740f8b44168dbcdcd80e75a75a1dc2ed733c834ad336f
     v_motion: typing.Union[_IResolvable_da3f097b, typing.Union[CfnEnvironment.InitialVlanInfoProperty, typing.Dict[builtins.str, typing.Any]]],
     v_san: typing.Union[_IResolvable_da3f097b, typing.Union[CfnEnvironment.InitialVlanInfoProperty, typing.Dict[builtins.str, typing.Any]]],
     v_tep: typing.Union[_IResolvable_da3f097b, typing.Union[CfnEnvironment.InitialVlanInfoProperty, typing.Dict[builtins.str, typing.Any]]],
+    hcx_network_acl_id: typing.Optional[builtins.str] = None,
+    is_hcx_public: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,
 ) -> None:
     """Type checking stubs"""
     pass