aws-cdk-lib 2.178.2__py3-none-any.whl → 2.180.0__py3-none-any.whl

aws_cdk/aws_elasticloadbalancingv2/__init__.py

@@ -325,6 +325,22 @@ lb = elbv2.ApplicationLoadBalancer(self, "LB",
 )
 ```
 
+### Defining a reserved Application Load Balancer Capacity Unit (LCU)
+
+You can define a [reserved LCU for your Application Load Balancer](https://docs.aws.amazon.com/elasticloadbalancing/latest/application/capacity-unit-reservation.html).
+To reserve an LCU, you must specify a `minimumCapacityUnit`.
+
+```python
+# vpc: ec2.Vpc
+
+
+lb = elbv2.ApplicationLoadBalancer(self, "LB",
+    vpc=vpc,
+    # Valid value is between 100 and 1500.
+    minimum_capacity_unit=100
+)
+```
+
 ## Defining a Network Load Balancer
 
 Network Load Balancers are defined in a similar way to Application Load
@@ -481,6 +497,26 @@ lb.add_security_group(sg2)
 lb.connections.allow_from_any_ipv4(ec2.Port.tcp(80))
 ```
 
+### Defining a reserved Network Load Balancer Capacity Unit (LCU)
+
+You can define a [reserved LCU for your Network Load Balancer](https://docs.aws.amazon.com/elasticloadbalancing/latest/network/capacity-unit-reservation.html).
+
+When requesting a LCU reservation, convert your capacity needs from Mbps to LCUs using the conversion rate of 1 LCU to 2.2 Mbps.
+
+To reserve an LCU, you must specify a `minimumCapacityUnit`.
+
+```python
+# vpc: ec2.Vpc
+
+
+lb = elbv2.NetworkLoadBalancer(self, "LB",
+    vpc=vpc,
+    minimum_capacity_unit=5500
+)
+```
+
+**Note**: The `minimumCapacityUnit` value is evenly distributed across all active Availability Zones (AZs) for the network load balancer. The distributed value per AZ must be between 2,750 and 45,000 units.
+
 ## Targets and Target Groups
 
 Application and Network Load Balancers organize load balancing targets in Target
@@ -3033,6 +3069,7 @@ class BaseLoadBalancerLookupOptions:
         "deny_all_igw_traffic": "denyAllIgwTraffic",
         "internet_facing": "internetFacing",
         "load_balancer_name": "loadBalancerName",
+        "minimum_capacity_unit": "minimumCapacityUnit",
         "vpc_subnets": "vpcSubnets",
     },
 )
@@ -3046,6 +3083,7 @@ class BaseLoadBalancerProps:
         deny_all_igw_traffic: typing.Optional[builtins.bool] = None,
         internet_facing: typing.Optional[builtins.bool] = None,
         load_balancer_name: typing.Optional[builtins.str] = None,
+        minimum_capacity_unit: typing.Optional[jsii.Number] = None,
         vpc_subnets: typing.Optional[typing.Union[_SubnetSelection_e57d76df, typing.Dict[builtins.str, typing.Any]]] = None,
     ) -> None:
         '''Shared properties of both Application and Network Load Balancers.
@@ -3056,6 +3094,7 @@ class BaseLoadBalancerProps:
         :param deny_all_igw_traffic: Indicates whether the load balancer blocks traffic through the Internet Gateway (IGW). Default: - false for internet-facing load balancers and true for internal load balancers
         :param internet_facing: Whether the load balancer has an internet-routable address. Default: false
         :param load_balancer_name: Name of the load balancer. Default: - Automatically generated name.
+        :param minimum_capacity_unit: The minimum capacity (LCU) for a load balancer. Default: undefined - ELB default is 0 LCU
         :param vpc_subnets: Which subnets place the load balancer in. Default: - the Vpc default strategy.
 
         :exampleMetadata: fixture=_generated
@@ -3080,6 +3119,7 @@ class BaseLoadBalancerProps:
                 deny_all_igw_traffic=False,
                 internet_facing=False,
                 load_balancer_name="loadBalancerName",
+                minimum_capacity_unit=123,
                 vpc_subnets=ec2.SubnetSelection(
                     availability_zones=["availabilityZones"],
                     one_per_az=False,
@@ -3100,6 +3140,7 @@ class BaseLoadBalancerProps:
             check_type(argname="argument deny_all_igw_traffic", value=deny_all_igw_traffic, expected_type=type_hints["deny_all_igw_traffic"])
             check_type(argname="argument internet_facing", value=internet_facing, expected_type=type_hints["internet_facing"])
             check_type(argname="argument load_balancer_name", value=load_balancer_name, expected_type=type_hints["load_balancer_name"])
+            check_type(argname="argument minimum_capacity_unit", value=minimum_capacity_unit, expected_type=type_hints["minimum_capacity_unit"])
             check_type(argname="argument vpc_subnets", value=vpc_subnets, expected_type=type_hints["vpc_subnets"])
         self._values: typing.Dict[builtins.str, typing.Any] = {
             "vpc": vpc,
@@ -3114,6 +3155,8 @@ class BaseLoadBalancerProps:
             self._values["internet_facing"] = internet_facing
         if load_balancer_name is not None:
             self._values["load_balancer_name"] = load_balancer_name
+        if minimum_capacity_unit is not None:
+            self._values["minimum_capacity_unit"] = minimum_capacity_unit
         if vpc_subnets is not None:
             self._values["vpc_subnets"] = vpc_subnets
 
@@ -3174,6 +3217,17 @@ class BaseLoadBalancerProps:
         result = self._values.get("load_balancer_name")
         return typing.cast(typing.Optional[builtins.str], result)
 
+    @builtins.property
+    def minimum_capacity_unit(self) -> typing.Optional[jsii.Number]:
+        '''The minimum capacity (LCU) for a load balancer.
+
+        :default: undefined - ELB default is 0 LCU
+
+        :see: https://exampleloadbalancer.com/ondemand_capacity_reservation_calculator.html
+        '''
+        result = self._values.get("minimum_capacity_unit")
+        return typing.cast(typing.Optional[jsii.Number], result)
+
     @builtins.property
     def vpc_subnets(self) -> typing.Optional[_SubnetSelection_e57d76df]:
         '''Which subnets place the load balancer in.
@@ -4964,11 +5018,11 @@ class CfnListener(
             mode: typing.Optional[builtins.str] = None,
             trust_store_arn: typing.Optional[builtins.str] = None,
         ) -> None:
-            '''Specifies the configuration information for mutual authentication.
+            '''The mutual authentication configuration information.
 
-            :param advertise_trust_store_ca_names: 
+            :param advertise_trust_store_ca_names: Indicates whether trust store CA certificate names are advertised. The default value is ``off`` .
             :param ignore_client_certificate_expiry: Indicates whether expired client certificates are ignored.
-            :param mode: The client certificate handling method. Options are ``off`` , ``passthrough`` or ``verify`` . The default value is ``off`` .
+            :param mode: The client certificate handling method. The possible values are ``off`` , ``passthrough`` , and ``verify`` . The default value is ``off`` .
             :param trust_store_arn: The Amazon Resource Name (ARN) of the trust store.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-elasticloadbalancingv2-listener-mutualauthentication.html
@@ -5005,7 +5059,10 @@ class CfnListener(
 
         @builtins.property
         def advertise_trust_store_ca_names(self) -> typing.Optional[builtins.str]:
-            '''
+            '''Indicates whether trust store CA certificate names are advertised.
+
+            The default value is ``off`` .
+
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-elasticloadbalancingv2-listener-mutualauthentication.html#cfn-elasticloadbalancingv2-listener-mutualauthentication-advertisetruststorecanames
             '''
             result = self._values.get("advertise_trust_store_ca_names")
@@ -5026,7 +5083,7 @@ class CfnListener(
         def mode(self) -> typing.Optional[builtins.str]:
             '''The client certificate handling method.
 
-            Options are ``off`` , ``passthrough`` or ``verify`` . The default value is ``off`` .
+            The possible values are ``off`` , ``passthrough`` , and ``verify`` . The default value is ``off`` .
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-elasticloadbalancingv2-listener-mutualauthentication.html#cfn-elasticloadbalancingv2-listener-mutualauthentication-mode
             '''
@@ -17294,6 +17351,7 @@ class NetworkLoadBalancer(
         deny_all_igw_traffic: typing.Optional[builtins.bool] = None,
         internet_facing: typing.Optional[builtins.bool] = None,
         load_balancer_name: typing.Optional[builtins.str] = None,
+        minimum_capacity_unit: typing.Optional[jsii.Number] = None,
         vpc_subnets: typing.Optional[typing.Union[_SubnetSelection_e57d76df, typing.Dict[builtins.str, typing.Any]]] = None,
     ) -> None:
         '''
@@ -17311,6 +17369,7 @@ class NetworkLoadBalancer(
         :param deny_all_igw_traffic: Indicates whether the load balancer blocks traffic through the Internet Gateway (IGW). Default: - false for internet-facing load balancers and true for internal load balancers
         :param internet_facing: Whether the load balancer has an internet-routable address. Default: false
         :param load_balancer_name: Name of the load balancer. Default: - Automatically generated name.
+        :param minimum_capacity_unit: The minimum capacity (LCU) for a load balancer. Default: undefined - ELB default is 0 LCU
         :param vpc_subnets: Which subnets place the load balancer in. Default: - the Vpc default strategy.
         '''
         if __debug__:
@@ -17330,6 +17389,7 @@ class NetworkLoadBalancer(
             deny_all_igw_traffic=deny_all_igw_traffic,
             internet_facing=internet_facing,
             load_balancer_name=load_balancer_name,
+            minimum_capacity_unit=minimum_capacity_unit,
             vpc_subnets=vpc_subnets,
         )
 
@@ -18118,6 +18178,7 @@ class NetworkLoadBalancerLookupOptions(BaseLoadBalancerLookupOptions):
         "deny_all_igw_traffic": "denyAllIgwTraffic",
         "internet_facing": "internetFacing",
         "load_balancer_name": "loadBalancerName",
+        "minimum_capacity_unit": "minimumCapacityUnit",
         "vpc_subnets": "vpcSubnets",
         "client_routing_policy": "clientRoutingPolicy",
         "enable_prefix_for_ipv6_source_nat": "enablePrefixForIpv6SourceNat",
@@ -18137,6 +18198,7 @@ class NetworkLoadBalancerProps(BaseLoadBalancerProps):
         deny_all_igw_traffic: typing.Optional[builtins.bool] = None,
         internet_facing: typing.Optional[builtins.bool] = None,
         load_balancer_name: typing.Optional[builtins.str] = None,
+        minimum_capacity_unit: typing.Optional[jsii.Number] = None,
         vpc_subnets: typing.Optional[typing.Union[_SubnetSelection_e57d76df, typing.Dict[builtins.str, typing.Any]]] = None,
         client_routing_policy: typing.Optional[ClientRoutingPolicy] = None,
         enable_prefix_for_ipv6_source_nat: typing.Optional[builtins.bool] = None,
@@ -18153,6 +18215,7 @@ class NetworkLoadBalancerProps(BaseLoadBalancerProps):
         :param deny_all_igw_traffic: Indicates whether the load balancer blocks traffic through the Internet Gateway (IGW). Default: - false for internet-facing load balancers and true for internal load balancers
         :param internet_facing: Whether the load balancer has an internet-routable address. Default: false
         :param load_balancer_name: Name of the load balancer. Default: - Automatically generated name.
+        :param minimum_capacity_unit: The minimum capacity (LCU) for a load balancer. Default: undefined - ELB default is 0 LCU
         :param vpc_subnets: Which subnets place the load balancer in. Default: - the Vpc default strategy.
         :param client_routing_policy: The AZ affinity routing policy. Default: - AZ affinity is disabled.
         :param enable_prefix_for_ipv6_source_nat: Indicates whether to use an IPv6 prefix from each subnet for source NAT. The IP address type must be IpAddressType.DUALSTACK. Default: undefined - NLB default behavior is false
@@ -18189,6 +18252,7 @@ class NetworkLoadBalancerProps(BaseLoadBalancerProps):
             check_type(argname="argument deny_all_igw_traffic", value=deny_all_igw_traffic, expected_type=type_hints["deny_all_igw_traffic"])
             check_type(argname="argument internet_facing", value=internet_facing, expected_type=type_hints["internet_facing"])
             check_type(argname="argument load_balancer_name", value=load_balancer_name, expected_type=type_hints["load_balancer_name"])
+            check_type(argname="argument minimum_capacity_unit", value=minimum_capacity_unit, expected_type=type_hints["minimum_capacity_unit"])
             check_type(argname="argument vpc_subnets", value=vpc_subnets, expected_type=type_hints["vpc_subnets"])
             check_type(argname="argument client_routing_policy", value=client_routing_policy, expected_type=type_hints["client_routing_policy"])
             check_type(argname="argument enable_prefix_for_ipv6_source_nat", value=enable_prefix_for_ipv6_source_nat, expected_type=type_hints["enable_prefix_for_ipv6_source_nat"])
@@ -18209,6 +18273,8 @@ class NetworkLoadBalancerProps(BaseLoadBalancerProps):
             self._values["internet_facing"] = internet_facing
         if load_balancer_name is not None:
             self._values["load_balancer_name"] = load_balancer_name
+        if minimum_capacity_unit is not None:
+            self._values["minimum_capacity_unit"] = minimum_capacity_unit
         if vpc_subnets is not None:
             self._values["vpc_subnets"] = vpc_subnets
         if client_routing_policy is not None:
@@ -18281,6 +18347,17 @@ class NetworkLoadBalancerProps(BaseLoadBalancerProps):
         result = self._values.get("load_balancer_name")
         return typing.cast(typing.Optional[builtins.str], result)
 
+    @builtins.property
+    def minimum_capacity_unit(self) -> typing.Optional[jsii.Number]:
+        '''The minimum capacity (LCU) for a load balancer.
+
+        :default: undefined - ELB default is 0 LCU
+
+        :see: https://exampleloadbalancer.com/ondemand_capacity_reservation_calculator.html
+        '''
+        result = self._values.get("minimum_capacity_unit")
+        return typing.cast(typing.Optional[jsii.Number], result)
+
     @builtins.property
     def vpc_subnets(self) -> typing.Optional[_SubnetSelection_e57d76df]:
         '''Which subnets place the load balancer in.
@@ -21280,6 +21357,7 @@ class ApplicationLoadBalancerLookupOptions(BaseLoadBalancerLookupOptions):
         "deny_all_igw_traffic": "denyAllIgwTraffic",
         "internet_facing": "internetFacing",
         "load_balancer_name": "loadBalancerName",
+        "minimum_capacity_unit": "minimumCapacityUnit",
         "vpc_subnets": "vpcSubnets",
         "client_keep_alive": "clientKeepAlive",
         "desync_mitigation_mode": "desyncMitigationMode",
@@ -21305,6 +21383,7 @@ class ApplicationLoadBalancerProps(BaseLoadBalancerProps):
         deny_all_igw_traffic: typing.Optional[builtins.bool] = None,
         internet_facing: typing.Optional[builtins.bool] = None,
         load_balancer_name: typing.Optional[builtins.str] = None,
+        minimum_capacity_unit: typing.Optional[jsii.Number] = None,
         vpc_subnets: typing.Optional[typing.Union[_SubnetSelection_e57d76df, typing.Dict[builtins.str, typing.Any]]] = None,
         client_keep_alive: typing.Optional[_Duration_4839e8c3] = None,
         desync_mitigation_mode: typing.Optional[DesyncMitigationMode] = None,
@@ -21327,6 +21406,7 @@ class ApplicationLoadBalancerProps(BaseLoadBalancerProps):
         :param deny_all_igw_traffic: Indicates whether the load balancer blocks traffic through the Internet Gateway (IGW). Default: - false for internet-facing load balancers and true for internal load balancers
         :param internet_facing: Whether the load balancer has an internet-routable address. Default: false
         :param load_balancer_name: Name of the load balancer. Default: - Automatically generated name.
+        :param minimum_capacity_unit: The minimum capacity (LCU) for a load balancer. Default: undefined - ELB default is 0 LCU
         :param vpc_subnets: Which subnets place the load balancer in. Default: - the Vpc default strategy.
         :param client_keep_alive: The client keep alive duration. The valid range is 60 to 604800 seconds (1 minute to 7 days). Default: - Duration.seconds(3600)
         :param desync_mitigation_mode: Determines how the load balancer handles requests that might pose a security risk to your application. Default: DesyncMitigationMode.DEFENSIVE
@@ -21386,6 +21466,7 @@ class ApplicationLoadBalancerProps(BaseLoadBalancerProps):
             check_type(argname="argument deny_all_igw_traffic", value=deny_all_igw_traffic, expected_type=type_hints["deny_all_igw_traffic"])
             check_type(argname="argument internet_facing", value=internet_facing, expected_type=type_hints["internet_facing"])
             check_type(argname="argument load_balancer_name", value=load_balancer_name, expected_type=type_hints["load_balancer_name"])
+            check_type(argname="argument minimum_capacity_unit", value=minimum_capacity_unit, expected_type=type_hints["minimum_capacity_unit"])
             check_type(argname="argument vpc_subnets", value=vpc_subnets, expected_type=type_hints["vpc_subnets"])
             check_type(argname="argument client_keep_alive", value=client_keep_alive, expected_type=type_hints["client_keep_alive"])
             check_type(argname="argument desync_mitigation_mode", value=desync_mitigation_mode, expected_type=type_hints["desync_mitigation_mode"])
@@ -21412,6 +21493,8 @@ class ApplicationLoadBalancerProps(BaseLoadBalancerProps):
             self._values["internet_facing"] = internet_facing
         if load_balancer_name is not None:
             self._values["load_balancer_name"] = load_balancer_name
+        if minimum_capacity_unit is not None:
+            self._values["minimum_capacity_unit"] = minimum_capacity_unit
         if vpc_subnets is not None:
             self._values["vpc_subnets"] = vpc_subnets
         if client_keep_alive is not None:
@@ -21496,6 +21579,17 @@ class ApplicationLoadBalancerProps(BaseLoadBalancerProps):
         result = self._values.get("load_balancer_name")
         return typing.cast(typing.Optional[builtins.str], result)
 
+    @builtins.property
+    def minimum_capacity_unit(self) -> typing.Optional[jsii.Number]:
+        '''The minimum capacity (LCU) for a load balancer.
+
+        :default: undefined - ELB default is 0 LCU
+
+        :see: https://exampleloadbalancer.com/ondemand_capacity_reservation_calculator.html
+        '''
+        result = self._values.get("minimum_capacity_unit")
+        return typing.cast(typing.Optional[jsii.Number], result)
+
     @builtins.property
     def vpc_subnets(self) -> typing.Optional[_SubnetSelection_e57d76df]:
         '''Which subnets place the load balancer in.
@@ -23634,35 +23728,18 @@ class ApplicationLoadBalancer(
 
     Example::
 
-        from aws_cdk.aws_autoscaling import AutoScalingGroup
-        # asg: AutoScalingGroup
         # vpc: ec2.Vpc
         
         
-        # Create the load balancer in a VPC. 'internetFacing' is 'false'
-        # by default, which creates an internal load balancer.
+        security_group1 = ec2.SecurityGroup(self, "SecurityGroup1", vpc=vpc)
         lb = elbv2.ApplicationLoadBalancer(self, "LB",
             vpc=vpc,
-            internet_facing=True
-        )
-        
-        # Add a listener and open up the load balancer's security group
-        # to the world.
-        listener = lb.add_listener("Listener",
-            port=80,
-        
-            # 'open: true' is the default, you can leave it out if you want. Set it
-            # to 'false' and use `listener.connections` if you want to be selective
-            # about who can access the load balancer.
-            open=True
+            internet_facing=True,
+            security_group=security_group1
         )
         
-        # Create an AutoScaling group and add it as a load balancing
-        # target to the listener.
-        listener.add_targets("ApplicationFleet",
-            port=8080,
-            targets=[asg]
-        )
+        security_group2 = ec2.SecurityGroup(self, "SecurityGroup2", vpc=vpc)
+        lb.add_security_group(security_group2)
     '''
 
     def __init__(
@@ -23688,6 +23765,7 @@ class ApplicationLoadBalancer(
         deny_all_igw_traffic: typing.Optional[builtins.bool] = None,
         internet_facing: typing.Optional[builtins.bool] = None,
         load_balancer_name: typing.Optional[builtins.str] = None,
+        minimum_capacity_unit: typing.Optional[jsii.Number] = None,
         vpc_subnets: typing.Optional[typing.Union[_SubnetSelection_e57d76df, typing.Dict[builtins.str, typing.Any]]] = None,
     ) -> None:
         '''
@@ -23711,6 +23789,7 @@ class ApplicationLoadBalancer(
         :param deny_all_igw_traffic: Indicates whether the load balancer blocks traffic through the Internet Gateway (IGW). Default: - false for internet-facing load balancers and true for internal load balancers
         :param internet_facing: Whether the load balancer has an internet-routable address. Default: false
         :param load_balancer_name: Name of the load balancer. Default: - Automatically generated name.
+        :param minimum_capacity_unit: The minimum capacity (LCU) for a load balancer. Default: undefined - ELB default is 0 LCU
         :param vpc_subnets: Which subnets place the load balancer in. Default: - the Vpc default strategy.
         '''
         if __debug__:
@@ -23736,6 +23815,7 @@ class ApplicationLoadBalancer(
             deny_all_igw_traffic=deny_all_igw_traffic,
             internet_facing=internet_facing,
             load_balancer_name=load_balancer_name,
+            minimum_capacity_unit=minimum_capacity_unit,
             vpc_subnets=vpc_subnets,
         )
 
@@ -26160,6 +26240,7 @@ def _typecheckingstub__36614588a5e075aa6e7ea0a4d41053b09874f2590b227cd5d62f34299
     deny_all_igw_traffic: typing.Optional[builtins.bool] = None,
     internet_facing: typing.Optional[builtins.bool] = None,
     load_balancer_name: typing.Optional[builtins.str] = None,
+    minimum_capacity_unit: typing.Optional[jsii.Number] = None,
     vpc_subnets: typing.Optional[typing.Union[_SubnetSelection_e57d76df, typing.Dict[builtins.str, typing.Any]]] = None,
 ) -> None:
     """Type checking stubs"""
@@ -27528,6 +27609,7 @@ def _typecheckingstub__e1c7a4c1332bdc807d1e25aa5d69eea6e1f3bf6a88ddd30dac9a64c93
     deny_all_igw_traffic: typing.Optional[builtins.bool] = None,
     internet_facing: typing.Optional[builtins.bool] = None,
     load_balancer_name: typing.Optional[builtins.str] = None,
+    minimum_capacity_unit: typing.Optional[jsii.Number] = None,
     vpc_subnets: typing.Optional[typing.Union[_SubnetSelection_e57d76df, typing.Dict[builtins.str, typing.Any]]] = None,
 ) -> None:
     """Type checking stubs"""
@@ -27621,6 +27703,7 @@ def _typecheckingstub__195ab659ca9cd1c401d6d2d1a1f5cb0aaf7dd80f06dbc724020ac0cc3
     deny_all_igw_traffic: typing.Optional[builtins.bool] = None,
     internet_facing: typing.Optional[builtins.bool] = None,
     load_balancer_name: typing.Optional[builtins.str] = None,
+    minimum_capacity_unit: typing.Optional[jsii.Number] = None,
     vpc_subnets: typing.Optional[typing.Union[_SubnetSelection_e57d76df, typing.Dict[builtins.str, typing.Any]]] = None,
     client_routing_policy: typing.Optional[ClientRoutingPolicy] = None,
     enable_prefix_for_ipv6_source_nat: typing.Optional[builtins.bool] = None,
@@ -27873,6 +27956,7 @@ def _typecheckingstub__e43cf75024913d9be0d5d621a5f2c2c7be60a57898a54967cd54179b2
     deny_all_igw_traffic: typing.Optional[builtins.bool] = None,
     internet_facing: typing.Optional[builtins.bool] = None,
     load_balancer_name: typing.Optional[builtins.str] = None,
+    minimum_capacity_unit: typing.Optional[jsii.Number] = None,
     vpc_subnets: typing.Optional[typing.Union[_SubnetSelection_e57d76df, typing.Dict[builtins.str, typing.Any]]] = None,
     client_keep_alive: typing.Optional[_Duration_4839e8c3] = None,
     desync_mitigation_mode: typing.Optional[DesyncMitigationMode] = None,
@@ -28272,6 +28356,7 @@ def _typecheckingstub__22d249b6cdbe3ce0dfc1a873ef276c65fe89ce6a5dba0603fae0a5755
     deny_all_igw_traffic: typing.Optional[builtins.bool] = None,
     internet_facing: typing.Optional[builtins.bool] = None,
     load_balancer_name: typing.Optional[builtins.str] = None,
+    minimum_capacity_unit: typing.Optional[jsii.Number] = None,
     vpc_subnets: typing.Optional[typing.Union[_SubnetSelection_e57d76df, typing.Dict[builtins.str, typing.Any]]] = None,
 ) -> None:
     """Type checking stubs"""

aws_cdk/aws_emrcontainers/__init__.py

@@ -102,6 +102,7 @@ class CfnVirtualCluster(
             name="name",
         
             # the properties below are optional
+            security_configuration_id="securityConfigurationId",
             tags=[CfnTag(
                 key="key",
                 value="value"
@@ -116,6 +117,7 @@ class CfnVirtualCluster(
         *,
         container_provider: typing.Union[_IResolvable_da3f097b, typing.Union["CfnVirtualCluster.ContainerProviderProperty", typing.Dict[builtins.str, typing.Any]]],
         name: builtins.str,
+        security_configuration_id: typing.Optional[builtins.str] = None,
         tags: typing.Optional[typing.Sequence[typing.Union[_CfnTag_f6864754, typing.Dict[builtins.str, typing.Any]]]] = None,
     ) -> None:
         '''
@@ -123,6 +125,7 @@ class CfnVirtualCluster(
         :param id: Construct identifier for this resource (unique in its scope).
         :param container_provider: The container provider of the virtual cluster.
         :param name: The name of the virtual cluster.
+        :param security_configuration_id: The ID of the security configuration.
         :param tags: An array of key-value pairs to apply to this resource. For more information, see `Tag <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-resource-tags.html>`_ .
         '''
         if __debug__:
@@ -130,7 +133,10 @@ class CfnVirtualCluster(
             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 = CfnVirtualClusterProps(
-            container_provider=container_provider, name=name, tags=tags
+            container_provider=container_provider,
+            name=name,
+            security_configuration_id=security_configuration_id,
+            tags=tags,
         )
 
         jsii.create(self.__class__, self, [scope, id, props])
@@ -225,6 +231,19 @@ class CfnVirtualCluster(
             check_type(argname="argument value", value=value, expected_type=type_hints["value"])
         jsii.set(self, "name", value) # pyright: ignore[reportArgumentType]
 
+    @builtins.property
+    @jsii.member(jsii_name="securityConfigurationId")
+    def security_configuration_id(self) -> typing.Optional[builtins.str]:
+        '''The ID of the security configuration.'''
+        return typing.cast(typing.Optional[builtins.str], jsii.get(self, "securityConfigurationId"))
+
+    @security_configuration_id.setter
+    def security_configuration_id(self, value: typing.Optional[builtins.str]) -> None:
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__d05d102efa2c9eb1d454519ceade8e11615a54a4a6a9f26f4883e2051aa27414)
+            check_type(argname="argument value", value=value, expected_type=type_hints["value"])
+        jsii.set(self, "securityConfigurationId", value) # pyright: ignore[reportArgumentType]
+
     @builtins.property
     @jsii.member(jsii_name="tagsRaw")
     def tags_raw(self) -> typing.Optional[typing.List[_CfnTag_f6864754]]:
@@ -463,6 +482,7 @@ class CfnVirtualCluster(
     name_mapping={
         "container_provider": "containerProvider",
         "name": "name",
+        "security_configuration_id": "securityConfigurationId",
         "tags": "tags",
     },
 )
@@ -472,12 +492,14 @@ class CfnVirtualClusterProps:
         *,
         container_provider: typing.Union[_IResolvable_da3f097b, typing.Union[CfnVirtualCluster.ContainerProviderProperty, typing.Dict[builtins.str, typing.Any]]],
         name: builtins.str,
+        security_configuration_id: typing.Optional[builtins.str] = None,
         tags: typing.Optional[typing.Sequence[typing.Union[_CfnTag_f6864754, typing.Dict[builtins.str, typing.Any]]]] = None,
     ) -> None:
         '''Properties for defining a ``CfnVirtualCluster``.
 
         :param container_provider: The container provider of the virtual cluster.
         :param name: The name of the virtual cluster.
+        :param security_configuration_id: The ID of the security configuration.
         :param tags: An array of key-value pairs to apply to this resource. For more information, see `Tag <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-resource-tags.html>`_ .
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-emrcontainers-virtualcluster.html
@@ -502,6 +524,7 @@ class CfnVirtualClusterProps:
                 name="name",
             
                 # the properties below are optional
+                security_configuration_id="securityConfigurationId",
                 tags=[CfnTag(
                     key="key",
                     value="value"
@@ -512,11 +535,14 @@ class CfnVirtualClusterProps:
             type_hints = typing.get_type_hints(_typecheckingstub__79f93ead2a436b8c5a2fc364fff5d9da849a851543aa1433cd7ab649d79d55f9)
             check_type(argname="argument container_provider", value=container_provider, expected_type=type_hints["container_provider"])
             check_type(argname="argument name", value=name, expected_type=type_hints["name"])
+            check_type(argname="argument security_configuration_id", value=security_configuration_id, expected_type=type_hints["security_configuration_id"])
             check_type(argname="argument tags", value=tags, expected_type=type_hints["tags"])
         self._values: typing.Dict[builtins.str, typing.Any] = {
             "container_provider": container_provider,
             "name": name,
         }
+        if security_configuration_id is not None:
+            self._values["security_configuration_id"] = security_configuration_id
         if tags is not None:
             self._values["tags"] = tags
 
@@ -542,6 +568,15 @@ class CfnVirtualClusterProps:
         assert result is not None, "Required property 'name' is missing"
         return typing.cast(builtins.str, result)
 
+    @builtins.property
+    def security_configuration_id(self) -> typing.Optional[builtins.str]:
+        '''The ID of the security configuration.
+
+        :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-emrcontainers-virtualcluster.html#cfn-emrcontainers-virtualcluster-securityconfigurationid
+        '''
+        result = self._values.get("security_configuration_id")
+        return typing.cast(typing.Optional[builtins.str], result)
+
     @builtins.property
     def tags(self) -> typing.Optional[typing.List[_CfnTag_f6864754]]:
         '''An array of key-value pairs to apply to this resource.
@@ -578,6 +613,7 @@ def _typecheckingstub__a06dc2760ceb0de7a449a23941f15987094157d1a540c30fa67c9e49a
     *,
     container_provider: typing.Union[_IResolvable_da3f097b, typing.Union[CfnVirtualCluster.ContainerProviderProperty, typing.Dict[builtins.str, typing.Any]]],
     name: builtins.str,
+    security_configuration_id: typing.Optional[builtins.str] = None,
     tags: typing.Optional[typing.Sequence[typing.Union[_CfnTag_f6864754, typing.Dict[builtins.str, typing.Any]]]] = None,
 ) -> None:
     """Type checking stubs"""
@@ -607,6 +643,12 @@ def _typecheckingstub__aea4d0052a5a6cb82d57b5655349988466e02d75bbcc22aec370e6810
     """Type checking stubs"""
     pass
 
+def _typecheckingstub__d05d102efa2c9eb1d454519ceade8e11615a54a4a6a9f26f4883e2051aa27414(
+    value: typing.Optional[builtins.str],
+) -> None:
+    """Type checking stubs"""
+    pass
+
 def _typecheckingstub__b3436f23ae2ca4313aacb96519980906e71e5bc37e7a466a53353480f948e674(
     value: typing.Optional[typing.List[_CfnTag_f6864754]],
 ) -> None:
@@ -640,6 +682,7 @@ def _typecheckingstub__79f93ead2a436b8c5a2fc364fff5d9da849a851543aa1433cd7ab649d
     *,
     container_provider: typing.Union[_IResolvable_da3f097b, typing.Union[CfnVirtualCluster.ContainerProviderProperty, typing.Dict[builtins.str, typing.Any]]],
     name: builtins.str,
+    security_configuration_id: typing.Optional[builtins.str] = None,
     tags: typing.Optional[typing.Sequence[typing.Union[_CfnTag_f6864754, typing.Dict[builtins.str, typing.Any]]]] = None,
 ) -> None:
     """Type checking stubs"""

aws_cdk/aws_events/__init__.py

@@ -10629,27 +10629,21 @@ class RuleProps(EventCommonOptions):
 
         Example::
 
-            import aws_cdk.aws_lambda as lambda_
+            import aws_cdk.aws_redshiftserverless as redshiftserverless
             
+            # workgroup: redshiftserverless.CfnWorkgroup
             
-            fn = lambda_.Function(self, "MyFunc",
-                runtime=lambda_.Runtime.NODEJS_LATEST,
-                handler="index.handler",
-                code=lambda_.Code.from_inline("exports.handler = handler.toString()")
-            )
             
-            rule = events.Rule(self, "rule",
-                event_pattern=events.EventPattern(
-                    source=["aws.ec2"]
-                )
+            rule = events.Rule(self, "Rule",
+                schedule=events.Schedule.rate(cdk.Duration.hours(1))
             )
             
-            queue = sqs.Queue(self, "Queue")
+            dlq = sqs.Queue(self, "DeadLetterQueue")
             
-            rule.add_target(targets.LambdaFunction(fn,
-                dead_letter_queue=queue,  # Optional: add a dead letter queue
-                max_event_age=Duration.hours(2),  # Optional: set the maxEventAge retry policy
-                retry_attempts=2
+            rule.add_target(targets.RedshiftQuery(workgroup.attr_workgroup_workgroup_arn,
+                database="dev",
+                dead_letter_queue=dlq,
+                sql=["SELECT * FROM foo", "SELECT * FROM baz"]
             ))
         '''
         if isinstance(event_pattern, dict):
@@ -11930,18 +11924,15 @@ class EventBus(
 
     Example::
 
-        bus = events.EventBus(self, "bus",
-            event_bus_name="MyCustomEventBus",
-            description="MyCustomEventBus"
-        )
+        import aws_cdk.aws_events as events
         
-        bus.archive("MyArchive",
-            archive_name="MyCustomEventBusArchive",
-            description="MyCustomerEventBus Archive",
-            event_pattern=events.EventPattern(
-                account=[Stack.of(self).account]
-            ),
-            retention=Duration.days(365)
+        # my_configuration_set: ses.ConfigurationSet
+        
+        
+        bus = events.EventBus.from_event_bus_name(self, "EventBus", "default")
+        
+        my_configuration_set.add_event_destination("ToEventBus",
+            destination=ses.EventDestination.event_bus(bus)
         )
     '''