aws-cdk-lib 2.149.0__py3-none-any.whl → 2.151.0__py3-none-any.whl

aws_cdk/aws_elasticloadbalancingv2/__init__.py

@@ -470,6 +470,27 @@ tg = elbv2.ApplicationTargetGroup(self, "TG",
 )
 ```
 
+### Weighted random routing algorithms and automatic target weights for your Application Load Balancer
+
+You can use the `weighted_random` routing algorithms by setting the `loadBalancingAlgorithmType` property.
+
+When using this algorithm, Automatic Target Weights (ATW) anomaly mitigation can be used by setting `enableAnomalyMitigation` to `true`.
+
+Also you can't use this algorithm with slow start mode.
+
+For more information, see [Routing algorithms](https://docs.aws.amazon.com/elasticloadbalancing/latest/application/load-balancer-target-groups.html#modify-routing-algorithm) and [Automatic Target Weights (ATW)](https://docs.aws.amazon.com/elasticloadbalancing/latest/application/load-balancer-target-groups.html#automatic-target-weights).
+
+```python
+# vpc: ec2.Vpc
+
+
+tg = elbv2.ApplicationTargetGroup(self, "TargetGroup",
+    vpc=vpc,
+    load_balancing_algorithm_type=elbv2.TargetGroupLoadBalancingAlgorithmType.WEIGHTED_RANDOM,
+    enable_anomaly_mitigation=True
+)
+```
+
 ## Using Lambda Targets
 
 To use a Lambda Function as a target, use the integration class in the
@@ -9281,7 +9302,7 @@ class CfnTargetGroup(
         ) -> None:
             '''Specifies a target group attribute.
 
-            :param key: The name of the attribute. The following attributes are supported by all load balancers: - ``deregistration_delay.timeout_seconds`` - The amount of time, in seconds, for Elastic Load Balancing to wait before changing the state of a deregistering target from ``draining`` to ``unused`` . The range is 0-3600 seconds. The default value is 300 seconds. If the target is a Lambda function, this attribute is not supported. - ``stickiness.enabled`` - Indicates whether target stickiness is enabled. The value is ``true`` or ``false`` . The default is ``false`` . - ``stickiness.type`` - Indicates the type of stickiness. The possible values are: - ``lb_cookie`` and ``app_cookie`` for Application Load Balancers. - ``source_ip`` for Network Load Balancers. - ``source_ip_dest_ip`` and ``source_ip_dest_ip_proto`` for Gateway Load Balancers. The following attributes are supported by Application Load Balancers and Network Load Balancers: - ``load_balancing.cross_zone.enabled`` - Indicates whether cross zone load balancing is enabled. The value is ``true`` , ``false`` or ``use_load_balancer_configuration`` . The default is ``use_load_balancer_configuration`` . - ``target_group_health.dns_failover.minimum_healthy_targets.count`` - The minimum number of targets that must be healthy. If the number of healthy targets is below this value, mark the zone as unhealthy in DNS, so that traffic is routed only to healthy zones. The possible values are ``off`` or an integer from 1 to the maximum number of targets. The default is ``off`` . - ``target_group_health.dns_failover.minimum_healthy_targets.percentage`` - The minimum percentage of targets that must be healthy. If the percentage of healthy targets is below this value, mark the zone as unhealthy in DNS, so that traffic is routed only to healthy zones. The possible values are ``off`` or an integer from 1 to 100. The default is ``off`` . - ``target_group_health.unhealthy_state_routing.minimum_healthy_targets.count`` - The minimum number of targets that must be healthy. If the number of healthy targets is below this value, send traffic to all targets, including unhealthy targets. The possible values are 1 to the maximum number of targets. The default is 1. - ``target_group_health.unhealthy_state_routing.minimum_healthy_targets.percentage`` - The minimum percentage of targets that must be healthy. If the percentage of healthy targets is below this value, send traffic to all targets, including unhealthy targets. The possible values are ``off`` or an integer from 1 to 100. The default is ``off`` . The following attributes are supported only if the load balancer is an Application Load Balancer and the target is an instance or an IP address: - ``load_balancing.algorithm.type`` - The load balancing algorithm determines how the load balancer selects targets when routing requests. The value is ``round_robin`` , ``least_outstanding_requests`` , or ``weighted_random`` . The default is ``round_robin`` . - ``load_balancing.algorithm.anomaly_mitigation`` - Only available when ``load_balancing.algorithm.type`` is ``weighted_random`` . Indicates whether anomaly mitigation is enabled. The value is ``on`` or ``off`` . The default is ``off`` . - ``slow_start.duration_seconds`` - The time period, in seconds, during which a newly registered target receives an increasing share of the traffic to the target group. After this time period ends, the target receives its full share of traffic. The range is 30-900 seconds (15 minutes). The default is 0 seconds (disabled). - ``stickiness.app_cookie.cookie_name`` - Indicates the name of the application-based cookie. Names that start with the following prefixes are not allowed: ``AWSALB`` , ``AWSALBAPP`` , and ``AWSALBTG`` ; they're reserved for use by the load balancer. - ``stickiness.app_cookie.duration_seconds`` - The time period, in seconds, during which requests from a client should be routed to the same target. After this time period expires, the application-based cookie is considered stale. The range is 1 second to 1 week (604800 seconds). The default value is 1 day (86400 seconds). - ``stickiness.lb_cookie.duration_seconds`` - The time period, in seconds, during which requests from a client should be routed to the same target. After this time period expires, the load balancer-generated cookie is considered stale. The range is 1 second to 1 week (604800 seconds). The default value is 1 day (86400 seconds). The following attribute is supported only if the load balancer is an Application Load Balancer and the target is a Lambda function: - ``lambda.multi_value_headers.enabled`` - Indicates whether the request and response headers that are exchanged between the load balancer and the Lambda function include arrays of values or strings. The value is ``true`` or ``false`` . The default is ``false`` . If the value is ``false`` and the request contains a duplicate header field name or query parameter key, the load balancer uses the last value sent by the client. The following attributes are supported only by Network Load Balancers: - ``deregistration_delay.connection_termination.enabled`` - Indicates whether the load balancer terminates connections at the end of the deregistration timeout. The value is ``true`` or ``false`` . For new UDP/TCP_UDP target groups the default is ``true`` . Otherwise, the default is ``false`` . - ``preserve_client_ip.enabled`` - Indicates whether client IP preservation is enabled. The value is ``true`` or ``false`` . The default is disabled if the target group type is IP address and the target group protocol is TCP or TLS. Otherwise, the default is enabled. Client IP preservation cannot be disabled for UDP and TCP_UDP target groups. - ``proxy_protocol_v2.enabled`` - Indicates whether Proxy Protocol version 2 is enabled. The value is ``true`` or ``false`` . The default is ``false`` . - ``target_health_state.unhealthy.connection_termination.enabled`` - Indicates whether the load balancer terminates connections to unhealthy targets. The value is ``true`` or ``false`` . The default is ``true`` . - ``target_health_state.unhealthy.draining_interval_seconds`` - The amount of time for Elastic Load Balancing to wait before changing the state of an unhealthy target from ``unhealthy.draining`` to ``unhealthy`` . The range is 0-360000 seconds. The default value is 0 seconds. Note: This attribute can only be configured when ``target_health_state.unhealthy.connection_termination.enabled`` is ``false`` . The following attributes are supported only by Gateway Load Balancers: - ``target_failover.on_deregistration`` - Indicates how the Gateway Load Balancer handles existing flows when a target is deregistered. The possible values are ``rebalance`` and ``no_rebalance`` . The default is ``no_rebalance`` . The two attributes ( ``target_failover.on_deregistration`` and ``target_failover.on_unhealthy`` ) can't be set independently. The value you set for both attributes must be the same. - ``target_failover.on_unhealthy`` - Indicates how the Gateway Load Balancer handles existing flows when a target is unhealthy. The possible values are ``rebalance`` and ``no_rebalance`` . The default is ``no_rebalance`` . The two attributes ( ``target_failover.on_deregistration`` and ``target_failover.on_unhealthy`` ) cannot be set independently. The value you set for both attributes must be the same.
+            :param key: The name of the attribute. The following attributes are supported by all load balancers: - ``deregistration_delay.timeout_seconds`` - The amount of time, in seconds, for Elastic Load Balancing to wait before changing the state of a deregistering target from ``draining`` to ``unused`` . The range is 0-3600 seconds. The default value is 300 seconds. If the target is a Lambda function, this attribute is not supported. - ``stickiness.enabled`` - Indicates whether target stickiness is enabled. The value is ``true`` or ``false`` . The default is ``false`` . - ``stickiness.type`` - Indicates the type of stickiness. The possible values are: - ``lb_cookie`` and ``app_cookie`` for Application Load Balancers. - ``source_ip`` for Network Load Balancers. - ``source_ip_dest_ip`` and ``source_ip_dest_ip_proto`` for Gateway Load Balancers. The following attributes are supported by Application Load Balancers and Network Load Balancers: - ``load_balancing.cross_zone.enabled`` - Indicates whether cross zone load balancing is enabled. The value is ``true`` , ``false`` or ``use_load_balancer_configuration`` . The default is ``use_load_balancer_configuration`` . - ``target_group_health.dns_failover.minimum_healthy_targets.count`` - The minimum number of targets that must be healthy. If the number of healthy targets is below this value, mark the zone as unhealthy in DNS, so that traffic is routed only to healthy zones. The possible values are ``off`` or an integer from 1 to the maximum number of targets. The default is ``1`` . - ``target_group_health.dns_failover.minimum_healthy_targets.percentage`` - The minimum percentage of targets that must be healthy. If the percentage of healthy targets is below this value, mark the zone as unhealthy in DNS, so that traffic is routed only to healthy zones. The possible values are ``off`` or an integer from 1 to 100. The default is ``off`` . - ``target_group_health.unhealthy_state_routing.minimum_healthy_targets.count`` - The minimum number of targets that must be healthy. If the number of healthy targets is below this value, send traffic to all targets, including unhealthy targets. The possible values are 1 to the maximum number of targets. The default is 1. - ``target_group_health.unhealthy_state_routing.minimum_healthy_targets.percentage`` - The minimum percentage of targets that must be healthy. If the percentage of healthy targets is below this value, send traffic to all targets, including unhealthy targets. The possible values are ``off`` or an integer from 1 to 100. The default is ``off`` . The following attributes are supported only if the load balancer is an Application Load Balancer and the target is an instance or an IP address: - ``load_balancing.algorithm.type`` - The load balancing algorithm determines how the load balancer selects targets when routing requests. The value is ``round_robin`` , ``least_outstanding_requests`` , or ``weighted_random`` . The default is ``round_robin`` . - ``load_balancing.algorithm.anomaly_mitigation`` - Only available when ``load_balancing.algorithm.type`` is ``weighted_random`` . Indicates whether anomaly mitigation is enabled. The value is ``on`` or ``off`` . The default is ``off`` . - ``slow_start.duration_seconds`` - The time period, in seconds, during which a newly registered target receives an increasing share of the traffic to the target group. After this time period ends, the target receives its full share of traffic. The range is 30-900 seconds (15 minutes). The default is 0 seconds (disabled). - ``stickiness.app_cookie.cookie_name`` - Indicates the name of the application-based cookie. Names that start with the following prefixes are not allowed: ``AWSALB`` , ``AWSALBAPP`` , and ``AWSALBTG`` ; they're reserved for use by the load balancer. - ``stickiness.app_cookie.duration_seconds`` - The time period, in seconds, during which requests from a client should be routed to the same target. After this time period expires, the application-based cookie is considered stale. The range is 1 second to 1 week (604800 seconds). The default value is 1 day (86400 seconds). - ``stickiness.lb_cookie.duration_seconds`` - The time period, in seconds, during which requests from a client should be routed to the same target. After this time period expires, the load balancer-generated cookie is considered stale. The range is 1 second to 1 week (604800 seconds). The default value is 1 day (86400 seconds). The following attribute is supported only if the load balancer is an Application Load Balancer and the target is a Lambda function: - ``lambda.multi_value_headers.enabled`` - Indicates whether the request and response headers that are exchanged between the load balancer and the Lambda function include arrays of values or strings. The value is ``true`` or ``false`` . The default is ``false`` . If the value is ``false`` and the request contains a duplicate header field name or query parameter key, the load balancer uses the last value sent by the client. The following attributes are supported only by Network Load Balancers: - ``deregistration_delay.connection_termination.enabled`` - Indicates whether the load balancer terminates connections at the end of the deregistration timeout. The value is ``true`` or ``false`` . For new UDP/TCP_UDP target groups the default is ``true`` . Otherwise, the default is ``false`` . - ``preserve_client_ip.enabled`` - Indicates whether client IP preservation is enabled. The value is ``true`` or ``false`` . The default is disabled if the target group type is IP address and the target group protocol is TCP or TLS. Otherwise, the default is enabled. Client IP preservation cannot be disabled for UDP and TCP_UDP target groups. - ``proxy_protocol_v2.enabled`` - Indicates whether Proxy Protocol version 2 is enabled. The value is ``true`` or ``false`` . The default is ``false`` . - ``target_health_state.unhealthy.connection_termination.enabled`` - Indicates whether the load balancer terminates connections to unhealthy targets. The value is ``true`` or ``false`` . The default is ``true`` . - ``target_health_state.unhealthy.draining_interval_seconds`` - The amount of time for Elastic Load Balancing to wait before changing the state of an unhealthy target from ``unhealthy.draining`` to ``unhealthy`` . The range is 0-360000 seconds. The default value is 0 seconds. Note: This attribute can only be configured when ``target_health_state.unhealthy.connection_termination.enabled`` is ``false`` . The following attributes are supported only by Gateway Load Balancers: - ``target_failover.on_deregistration`` - Indicates how the Gateway Load Balancer handles existing flows when a target is deregistered. The possible values are ``rebalance`` and ``no_rebalance`` . The default is ``no_rebalance`` . The two attributes ( ``target_failover.on_deregistration`` and ``target_failover.on_unhealthy`` ) can't be set independently. The value you set for both attributes must be the same. - ``target_failover.on_unhealthy`` - Indicates how the Gateway Load Balancer handles existing flows when a target is unhealthy. The possible values are ``rebalance`` and ``no_rebalance`` . The default is ``no_rebalance`` . The two attributes ( ``target_failover.on_deregistration`` and ``target_failover.on_unhealthy`` ) cannot be set independently. The value you set for both attributes must be the same.
             :param value: The value of the attribute.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-elasticloadbalancingv2-targetgroup-targetgroupattribute.html
@@ -9324,7 +9345,7 @@ class CfnTargetGroup(
             The following attributes are supported by Application Load Balancers and Network Load Balancers:
 
             - ``load_balancing.cross_zone.enabled`` - Indicates whether cross zone load balancing is enabled. The value is ``true`` , ``false`` or ``use_load_balancer_configuration`` . The default is ``use_load_balancer_configuration`` .
-            - ``target_group_health.dns_failover.minimum_healthy_targets.count`` - The minimum number of targets that must be healthy. If the number of healthy targets is below this value, mark the zone as unhealthy in DNS, so that traffic is routed only to healthy zones. The possible values are ``off`` or an integer from 1 to the maximum number of targets. The default is ``off`` .
+            - ``target_group_health.dns_failover.minimum_healthy_targets.count`` - The minimum number of targets that must be healthy. If the number of healthy targets is below this value, mark the zone as unhealthy in DNS, so that traffic is routed only to healthy zones. The possible values are ``off`` or an integer from 1 to the maximum number of targets. The default is ``1`` .
             - ``target_group_health.dns_failover.minimum_healthy_targets.percentage`` - The minimum percentage of targets that must be healthy. If the percentage of healthy targets is below this value, mark the zone as unhealthy in DNS, so that traffic is routed only to healthy zones. The possible values are ``off`` or an integer from 1 to 100. The default is ``off`` .
             - ``target_group_health.unhealthy_state_routing.minimum_healthy_targets.count`` - The minimum number of targets that must be healthy. If the number of healthy targets is below this value, send traffic to all targets, including unhealthy targets. The possible values are 1 to the maximum number of targets. The default is 1.
             - ``target_group_health.unhealthy_state_routing.minimum_healthy_targets.percentage`` - The minimum percentage of targets that must be healthy. If the percentage of healthy targets is below this value, send traffic to all targets, including unhealthy targets. The possible values are ``off`` or an integer from 1 to 100. The default is ``off`` .
@@ -11038,6 +11059,14 @@ class HttpCodeElb(enum.Enum):
     '''
     ELB_5XX_COUNT = "ELB_5XX_COUNT"
     '''The number of HTTP 5XX server error codes that originate from the load balancer.'''
+    ELB_500_COUNT = "ELB_500_COUNT"
+    '''The number of HTTP 500 server error codes that originate from the load balancer.'''
+    ELB_502_COUNT = "ELB_502_COUNT"
+    '''The number of HTTP 502 server error codes that originate from the load balancer.'''
+    ELB_503_COUNT = "ELB_503_COUNT"
+    '''The number of HTTP 503 server error codes that originate from the load balancer.'''
+    ELB_504_COUNT = "ELB_504_COUNT"
+    '''The number of HTTP 504 server error codes that originate from the load balancer.'''
 
 
 @jsii.enum(jsii_type="aws-cdk-lib.aws_elasticloadbalancingv2.HttpCodeTarget")
@@ -18041,12 +18070,28 @@ typing.cast(typing.Any, TargetGroupBase).__jsii_proxy_class__ = lambda : _Target
     jsii_type="aws-cdk-lib.aws_elasticloadbalancingv2.TargetGroupLoadBalancingAlgorithmType"
 )
 class TargetGroupLoadBalancingAlgorithmType(enum.Enum):
-    '''Load balancing algorithmm type for target groups.'''
+    '''Load balancing algorithmm type for target groups.
+
+    :exampleMetadata: infused
+
+    Example::
+
+        # vpc: ec2.Vpc
+        
+        
+        tg = elbv2.ApplicationTargetGroup(self, "TargetGroup",
+            vpc=vpc,
+            load_balancing_algorithm_type=elbv2.TargetGroupLoadBalancingAlgorithmType.WEIGHTED_RANDOM,
+            enable_anomaly_mitigation=True
+        )
+    '''
 
     ROUND_ROBIN = "ROUND_ROBIN"
     '''round_robin.'''
     LEAST_OUTSTANDING_REQUESTS = "LEAST_OUTSTANDING_REQUESTS"
     '''least_outstanding_requests.'''
+    WEIGHTED_RANDOM = "WEIGHTED_RANDOM"
+    '''weighted_random.'''
 
 
 @jsii.enum(jsii_type="aws-cdk-lib.aws_elasticloadbalancingv2.TargetType")
@@ -18463,6 +18508,7 @@ class AddApplicationTargetGroupsProps(AddRuleProps):
         "conditions": "conditions",
         "priority": "priority",
         "deregistration_delay": "deregistrationDelay",
+        "enable_anomaly_mitigation": "enableAnomalyMitigation",
         "health_check": "healthCheck",
         "load_balancing_algorithm_type": "loadBalancingAlgorithmType",
         "port": "port",
@@ -18482,6 +18528,7 @@ class AddApplicationTargetsProps(AddRuleProps):
         conditions: typing.Optional[typing.Sequence[ListenerCondition]] = None,
         priority: typing.Optional[jsii.Number] = None,
         deregistration_delay: typing.Optional[_Duration_4839e8c3] = None,
+        enable_anomaly_mitigation: typing.Optional[builtins.bool] = None,
         health_check: typing.Optional[typing.Union[HealthCheck, typing.Dict[builtins.str, typing.Any]]] = None,
         load_balancing_algorithm_type: typing.Optional[TargetGroupLoadBalancingAlgorithmType] = None,
         port: typing.Optional[jsii.Number] = None,
@@ -18498,6 +18545,7 @@ class AddApplicationTargetsProps(AddRuleProps):
         :param conditions: Rule applies if matches the conditions. Default: - No conditions.
         :param priority: Priority of this target group. The rule with the lowest priority will be used for every request. If priority is not given, these target groups will be added as defaults, and must not have conditions. Priorities must be unique. Default: Target groups are used as defaults
         :param deregistration_delay: The amount of time for Elastic Load Balancing to wait before deregistering a target. The range is 0-3600 seconds. Default: Duration.minutes(5)
+        :param enable_anomaly_mitigation: Indicates whether anomaly mitigation is enabled. Only available when ``loadBalancingAlgorithmType`` is ``TargetGroupLoadBalancingAlgorithmType.WEIGHTED_RANDOM`` Default: false
         :param health_check: Health check configuration. Default: - The default value for each property in this configuration varies depending on the target.
         :param load_balancing_algorithm_type: The load balancing algorithm to select targets for routing requests. Default: round_robin.
         :param port: The port on which the listener listens for requests. Default: Determined from protocol if known
@@ -18550,6 +18598,7 @@ class AddApplicationTargetsProps(AddRuleProps):
             check_type(argname="argument conditions", value=conditions, expected_type=type_hints["conditions"])
             check_type(argname="argument priority", value=priority, expected_type=type_hints["priority"])
             check_type(argname="argument deregistration_delay", value=deregistration_delay, expected_type=type_hints["deregistration_delay"])
+            check_type(argname="argument enable_anomaly_mitigation", value=enable_anomaly_mitigation, expected_type=type_hints["enable_anomaly_mitigation"])
             check_type(argname="argument health_check", value=health_check, expected_type=type_hints["health_check"])
             check_type(argname="argument load_balancing_algorithm_type", value=load_balancing_algorithm_type, expected_type=type_hints["load_balancing_algorithm_type"])
             check_type(argname="argument port", value=port, expected_type=type_hints["port"])
@@ -18567,6 +18616,8 @@ class AddApplicationTargetsProps(AddRuleProps):
             self._values["priority"] = priority
         if deregistration_delay is not None:
             self._values["deregistration_delay"] = deregistration_delay
+        if enable_anomaly_mitigation is not None:
+            self._values["enable_anomaly_mitigation"] = enable_anomaly_mitigation
         if health_check is not None:
             self._values["health_check"] = health_check
         if load_balancing_algorithm_type is not None:
@@ -18625,6 +18676,19 @@ class AddApplicationTargetsProps(AddRuleProps):
         result = self._values.get("deregistration_delay")
         return typing.cast(typing.Optional[_Duration_4839e8c3], result)
 
+    @builtins.property
+    def enable_anomaly_mitigation(self) -> typing.Optional[builtins.bool]:
+        '''Indicates whether anomaly mitigation is enabled.
+
+        Only available when ``loadBalancingAlgorithmType`` is ``TargetGroupLoadBalancingAlgorithmType.WEIGHTED_RANDOM``
+
+        :default: false
+
+        :see: https://docs.aws.amazon.com/elasticloadbalancing/latest/application/load-balancer-target-groups.html#automatic-target-weights
+        '''
+        result = self._values.get("enable_anomaly_mitigation")
+        return typing.cast(typing.Optional[builtins.bool], result)
+
     @builtins.property
     def health_check(self) -> typing.Optional[HealthCheck]:
         '''Health check configuration.
@@ -19646,6 +19710,7 @@ class ApplicationLoadBalancerProps(BaseLoadBalancerProps):
         "target_group_name": "targetGroupName",
         "target_type": "targetType",
         "vpc": "vpc",
+        "enable_anomaly_mitigation": "enableAnomalyMitigation",
         "load_balancing_algorithm_type": "loadBalancingAlgorithmType",
         "port": "port",
         "protocol": "protocol",
@@ -19665,6 +19730,7 @@ class ApplicationTargetGroupProps(BaseTargetGroupProps):
         target_group_name: typing.Optional[builtins.str] = None,
         target_type: typing.Optional[TargetType] = None,
         vpc: typing.Optional[_IVpc_f30d5663] = None,
+        enable_anomaly_mitigation: typing.Optional[builtins.bool] = None,
         load_balancing_algorithm_type: typing.Optional[TargetGroupLoadBalancingAlgorithmType] = None,
         port: typing.Optional[jsii.Number] = None,
         protocol: typing.Optional[ApplicationProtocol] = None,
@@ -19681,6 +19747,7 @@ class ApplicationTargetGroupProps(BaseTargetGroupProps):
         :param target_group_name: The name of the target group. This name must be unique per region per account, can have a maximum of 32 characters, must contain only alphanumeric characters or hyphens, and must not begin or end with a hyphen. Default: - Automatically generated.
         :param target_type: The type of targets registered to this TargetGroup, either IP or Instance. All targets registered into the group must be of this type. If you register targets to the TargetGroup in the CDK app, the TargetType is determined automatically. Default: - Determined automatically.
         :param vpc: The virtual private cloud (VPC). only if ``TargetType`` is ``Ip`` or ``InstanceId`` Default: - undefined
+        :param enable_anomaly_mitigation: Indicates whether anomaly mitigation is enabled. Only available when ``loadBalancingAlgorithmType`` is ``TargetGroupLoadBalancingAlgorithmType.WEIGHTED_RANDOM`` Default: false
         :param load_balancing_algorithm_type: The load balancing algorithm to select targets for routing requests. Default: TargetGroupLoadBalancingAlgorithmType.ROUND_ROBIN
         :param port: The port on which the target receives traffic. This is not applicable for Lambda targets. Default: - Determined from protocol if known
         :param protocol: The protocol used for communication with the target. This is not applicable for Lambda targets. Default: - Determined from port if known
@@ -19697,15 +19764,11 @@ class ApplicationTargetGroupProps(BaseTargetGroupProps):
             # vpc: ec2.Vpc
             
             
+            # Target group with slow start mode enabled
             tg = elbv2.ApplicationTargetGroup(self, "TG",
-                target_type=elbv2.TargetType.IP,
-                port=50051,
-                protocol=elbv2.ApplicationProtocol.HTTP,
-                protocol_version=elbv2.ApplicationProtocolVersion.GRPC,
-                health_check=elbv2.HealthCheck(
-                    enabled=True,
-                    healthy_grpc_codes="0-99"
-                ),
+                target_type=elbv2.TargetType.INSTANCE,
+                slow_start=Duration.seconds(60),
+                port=80,
                 vpc=vpc
             )
         '''
@@ -19718,6 +19781,7 @@ class ApplicationTargetGroupProps(BaseTargetGroupProps):
             check_type(argname="argument target_group_name", value=target_group_name, expected_type=type_hints["target_group_name"])
             check_type(argname="argument target_type", value=target_type, expected_type=type_hints["target_type"])
             check_type(argname="argument vpc", value=vpc, expected_type=type_hints["vpc"])
+            check_type(argname="argument enable_anomaly_mitigation", value=enable_anomaly_mitigation, expected_type=type_hints["enable_anomaly_mitigation"])
             check_type(argname="argument load_balancing_algorithm_type", value=load_balancing_algorithm_type, expected_type=type_hints["load_balancing_algorithm_type"])
             check_type(argname="argument port", value=port, expected_type=type_hints["port"])
             check_type(argname="argument protocol", value=protocol, expected_type=type_hints["protocol"])
@@ -19737,6 +19801,8 @@ class ApplicationTargetGroupProps(BaseTargetGroupProps):
             self._values["target_type"] = target_type
         if vpc is not None:
             self._values["vpc"] = vpc
+        if enable_anomaly_mitigation is not None:
+            self._values["enable_anomaly_mitigation"] = enable_anomaly_mitigation
         if load_balancing_algorithm_type is not None:
             self._values["load_balancing_algorithm_type"] = load_balancing_algorithm_type
         if port is not None:
@@ -19813,6 +19879,19 @@ class ApplicationTargetGroupProps(BaseTargetGroupProps):
         result = self._values.get("vpc")
         return typing.cast(typing.Optional[_IVpc_f30d5663], result)
 
+    @builtins.property
+    def enable_anomaly_mitigation(self) -> typing.Optional[builtins.bool]:
+        '''Indicates whether anomaly mitigation is enabled.
+
+        Only available when ``loadBalancingAlgorithmType`` is ``TargetGroupLoadBalancingAlgorithmType.WEIGHTED_RANDOM``
+
+        :default: false
+
+        :see: https://docs.aws.amazon.com/elasticloadbalancing/latest/application/load-balancer-target-groups.html#automatic-target-weights
+        '''
+        result = self._values.get("enable_anomaly_mitigation")
+        return typing.cast(typing.Optional[builtins.bool], result)
+
     @builtins.property
     def load_balancing_algorithm_type(
         self,
@@ -20053,6 +20132,7 @@ class IApplicationListener(
         id: builtins.str,
         *,
         deregistration_delay: typing.Optional[_Duration_4839e8c3] = None,
+        enable_anomaly_mitigation: typing.Optional[builtins.bool] = None,
         health_check: typing.Optional[typing.Union[HealthCheck, typing.Dict[builtins.str, typing.Any]]] = None,
         load_balancing_algorithm_type: typing.Optional[TargetGroupLoadBalancingAlgorithmType] = None,
         port: typing.Optional[jsii.Number] = None,
@@ -20076,6 +20156,7 @@ class IApplicationListener(
 
         :param id: -
         :param deregistration_delay: The amount of time for Elastic Load Balancing to wait before deregistering a target. The range is 0-3600 seconds. Default: Duration.minutes(5)
+        :param enable_anomaly_mitigation: Indicates whether anomaly mitigation is enabled. Only available when ``loadBalancingAlgorithmType`` is ``TargetGroupLoadBalancingAlgorithmType.WEIGHTED_RANDOM`` Default: false
         :param health_check: Health check configuration. Default: - The default value for each property in this configuration varies depending on the target.
         :param load_balancing_algorithm_type: The load balancing algorithm to select targets for routing requests. Default: round_robin.
         :param port: The port on which the listener listens for requests. Default: Determined from protocol if known
@@ -20208,6 +20289,7 @@ class _IApplicationListenerProxy(
         id: builtins.str,
         *,
         deregistration_delay: typing.Optional[_Duration_4839e8c3] = None,
+        enable_anomaly_mitigation: typing.Optional[builtins.bool] = None,
         health_check: typing.Optional[typing.Union[HealthCheck, typing.Dict[builtins.str, typing.Any]]] = None,
         load_balancing_algorithm_type: typing.Optional[TargetGroupLoadBalancingAlgorithmType] = None,
         port: typing.Optional[jsii.Number] = None,
@@ -20231,6 +20313,7 @@ class _IApplicationListenerProxy(
 
         :param id: -
         :param deregistration_delay: The amount of time for Elastic Load Balancing to wait before deregistering a target. The range is 0-3600 seconds. Default: Duration.minutes(5)
+        :param enable_anomaly_mitigation: Indicates whether anomaly mitigation is enabled. Only available when ``loadBalancingAlgorithmType`` is ``TargetGroupLoadBalancingAlgorithmType.WEIGHTED_RANDOM`` Default: false
         :param health_check: Health check configuration. Default: - The default value for each property in this configuration varies depending on the target.
         :param load_balancing_algorithm_type: The load balancing algorithm to select targets for routing requests. Default: round_robin.
         :param port: The port on which the listener listens for requests. Default: Determined from protocol if known
@@ -20251,6 +20334,7 @@ class _IApplicationListenerProxy(
             check_type(argname="argument id", value=id, expected_type=type_hints["id"])
         props = AddApplicationTargetsProps(
             deregistration_delay=deregistration_delay,
+            enable_anomaly_mitigation=enable_anomaly_mitigation,
             health_check=health_check,
             load_balancing_algorithm_type=load_balancing_algorithm_type,
             port=port,
@@ -21395,6 +21479,7 @@ class ApplicationListener(
         id: builtins.str,
         *,
         deregistration_delay: typing.Optional[_Duration_4839e8c3] = None,
+        enable_anomaly_mitigation: typing.Optional[builtins.bool] = None,
         health_check: typing.Optional[typing.Union[HealthCheck, typing.Dict[builtins.str, typing.Any]]] = None,
         load_balancing_algorithm_type: typing.Optional[TargetGroupLoadBalancingAlgorithmType] = None,
         port: typing.Optional[jsii.Number] = None,
@@ -21421,6 +21506,7 @@ class ApplicationListener(
 
         :param id: -
         :param deregistration_delay: The amount of time for Elastic Load Balancing to wait before deregistering a target. The range is 0-3600 seconds. Default: Duration.minutes(5)
+        :param enable_anomaly_mitigation: Indicates whether anomaly mitigation is enabled. Only available when ``loadBalancingAlgorithmType`` is ``TargetGroupLoadBalancingAlgorithmType.WEIGHTED_RANDOM`` Default: false
         :param health_check: Health check configuration. Default: - The default value for each property in this configuration varies depending on the target.
         :param load_balancing_algorithm_type: The load balancing algorithm to select targets for routing requests. Default: round_robin.
         :param port: The port on which the listener listens for requests. Default: Determined from protocol if known
@@ -21441,6 +21527,7 @@ class ApplicationListener(
             check_type(argname="argument id", value=id, expected_type=type_hints["id"])
         props = AddApplicationTargetsProps(
             deregistration_delay=deregistration_delay,
+            enable_anomaly_mitigation=enable_anomaly_mitigation,
             health_check=health_check,
             load_balancing_algorithm_type=load_balancing_algorithm_type,
             port=port,
@@ -22858,6 +22945,7 @@ class ApplicationTargetGroup(
         scope: _constructs_77d1e7e8.Construct,
         id: builtins.str,
         *,
+        enable_anomaly_mitigation: typing.Optional[builtins.bool] = None,
         load_balancing_algorithm_type: typing.Optional[TargetGroupLoadBalancingAlgorithmType] = None,
         port: typing.Optional[jsii.Number] = None,
         protocol: typing.Optional[ApplicationProtocol] = None,
@@ -22875,6 +22963,7 @@ class ApplicationTargetGroup(
         '''
         :param scope: -
         :param id: -
+        :param enable_anomaly_mitigation: Indicates whether anomaly mitigation is enabled. Only available when ``loadBalancingAlgorithmType`` is ``TargetGroupLoadBalancingAlgorithmType.WEIGHTED_RANDOM`` Default: false
         :param load_balancing_algorithm_type: The load balancing algorithm to select targets for routing requests. Default: TargetGroupLoadBalancingAlgorithmType.ROUND_ROBIN
         :param port: The port on which the target receives traffic. This is not applicable for Lambda targets. Default: - Determined from protocol if known
         :param protocol: The protocol used for communication with the target. This is not applicable for Lambda targets. Default: - Determined from port if known
@@ -22894,6 +22983,7 @@ class ApplicationTargetGroup(
             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 = ApplicationTargetGroupProps(
+            enable_anomaly_mitigation=enable_anomaly_mitigation,
             load_balancing_algorithm_type=load_balancing_algorithm_type,
             port=port,
             protocol=protocol,
@@ -25288,6 +25378,7 @@ def _typecheckingstub__b26d56d500bb67c9d6ae66f1cb40dc7e2f3a670459278ff6a96edc676
     conditions: typing.Optional[typing.Sequence[ListenerCondition]] = None,
     priority: typing.Optional[jsii.Number] = None,
     deregistration_delay: typing.Optional[_Duration_4839e8c3] = None,
+    enable_anomaly_mitigation: typing.Optional[builtins.bool] = None,
     health_check: typing.Optional[typing.Union[HealthCheck, typing.Dict[builtins.str, typing.Any]]] = None,
     load_balancing_algorithm_type: typing.Optional[TargetGroupLoadBalancingAlgorithmType] = None,
     port: typing.Optional[jsii.Number] = None,
@@ -25378,6 +25469,7 @@ def _typecheckingstub__0fbf37aa0a91cb985ce7a336a6188364cc38400538c1653e53453287c
     target_group_name: typing.Optional[builtins.str] = None,
     target_type: typing.Optional[TargetType] = None,
     vpc: typing.Optional[_IVpc_f30d5663] = None,
+    enable_anomaly_mitigation: typing.Optional[builtins.bool] = None,
     load_balancing_algorithm_type: typing.Optional[TargetGroupLoadBalancingAlgorithmType] = None,
     port: typing.Optional[jsii.Number] = None,
     protocol: typing.Optional[ApplicationProtocol] = None,
@@ -25430,6 +25522,7 @@ def _typecheckingstub__84e790e0e8140f8df376ccc9404001adf95dc62c6408367a7fb37a7ac
     id: builtins.str,
     *,
     deregistration_delay: typing.Optional[_Duration_4839e8c3] = None,
+    enable_anomaly_mitigation: typing.Optional[builtins.bool] = None,
     health_check: typing.Optional[typing.Union[HealthCheck, typing.Dict[builtins.str, typing.Any]]] = None,
     load_balancing_algorithm_type: typing.Optional[TargetGroupLoadBalancingAlgorithmType] = None,
     port: typing.Optional[jsii.Number] = None,
@@ -25685,6 +25778,7 @@ def _typecheckingstub__024551e53e2a61ea5cc079e4909fa79f39b1b922c5d0ab7d4adfe8153
     id: builtins.str,
     *,
     deregistration_delay: typing.Optional[_Duration_4839e8c3] = None,
+    enable_anomaly_mitigation: typing.Optional[builtins.bool] = None,
     health_check: typing.Optional[typing.Union[HealthCheck, typing.Dict[builtins.str, typing.Any]]] = None,
     load_balancing_algorithm_type: typing.Optional[TargetGroupLoadBalancingAlgorithmType] = None,
     port: typing.Optional[jsii.Number] = None,
@@ -25835,6 +25929,7 @@ def _typecheckingstub__e179515c9d6138007cc1b74835b75f10a179c1f5ef977cbe4188c778c
     scope: _constructs_77d1e7e8.Construct,
     id: builtins.str,
     *,
+    enable_anomaly_mitigation: typing.Optional[builtins.bool] = None,
     load_balancing_algorithm_type: typing.Optional[TargetGroupLoadBalancingAlgorithmType] = None,
     port: typing.Optional[jsii.Number] = None,
     protocol: typing.Optional[ApplicationProtocol] = None,

aws_cdk/aws_emr/__init__.py

@@ -612,7 +612,7 @@ class CfnCluster(
         :param additional_info: A JSON string for selecting additional features.
         :param applications: The applications to install on this cluster, for example, Spark, Flink, Oozie, Zeppelin, and so on.
         :param auto_scaling_role: An IAM role for automatic scaling policies. The default role is ``EMR_AutoScaling_DefaultRole`` . The IAM role provides permissions that the automatic scaling feature requires to launch and terminate Amazon EC2 instances in an instance group.
-        :param auto_termination_policy: An auto-termination policy defines the amount of idle time in seconds after which a cluster automatically terminates. For alternative cluster termination options, see `Control cluster termination <https://docs.aws.amazon.com/emr/latest/ManagementGuide/emr-plan-termination.html>`_
+        :param auto_termination_policy: An auto-termination policy for an Amazon EMR cluster. An auto-termination policy defines the amount of idle time in seconds after which a cluster automatically terminates. For alternative cluster termination options, see `Control cluster termination <https://docs.aws.amazon.com/emr/latest/ManagementGuide/emr-plan-termination.html>`_ .
         :param bootstrap_actions: A list of bootstrap actions to run before Hadoop starts on the cluster nodes.
         :param configurations: Applies only to Amazon EMR releases 4.x and later. The list of configurations that are supplied to the Amazon EMR cluster.
         :param custom_ami_id: Available only in Amazon EMR releases 5.7.0 and later. The ID of a custom Amazon EBS-backed Linux AMI if the cluster uses a custom AMI.
@@ -834,7 +834,7 @@ class CfnCluster(
     def auto_termination_policy(
         self,
     ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnCluster.AutoTerminationPolicyProperty"]]:
-        '''An auto-termination policy defines the amount of idle time in seconds after which a cluster automatically terminates.'''
+        '''An auto-termination policy for an Amazon EMR cluster.'''
         return typing.cast(typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnCluster.AutoTerminationPolicyProperty"]], jsii.get(self, "autoTerminationPolicy"))
 
     @auto_termination_policy.setter
@@ -5277,7 +5277,7 @@ class CfnClusterProps:
         :param additional_info: A JSON string for selecting additional features.
         :param applications: The applications to install on this cluster, for example, Spark, Flink, Oozie, Zeppelin, and so on.
         :param auto_scaling_role: An IAM role for automatic scaling policies. The default role is ``EMR_AutoScaling_DefaultRole`` . The IAM role provides permissions that the automatic scaling feature requires to launch and terminate Amazon EC2 instances in an instance group.
-        :param auto_termination_policy: An auto-termination policy defines the amount of idle time in seconds after which a cluster automatically terminates. For alternative cluster termination options, see `Control cluster termination <https://docs.aws.amazon.com/emr/latest/ManagementGuide/emr-plan-termination.html>`_
+        :param auto_termination_policy: An auto-termination policy for an Amazon EMR cluster. An auto-termination policy defines the amount of idle time in seconds after which a cluster automatically terminates. For alternative cluster termination options, see `Control cluster termination <https://docs.aws.amazon.com/emr/latest/ManagementGuide/emr-plan-termination.html>`_ .
         :param bootstrap_actions: A list of bootstrap actions to run before Hadoop starts on the cluster nodes.
         :param configurations: Applies only to Amazon EMR releases 4.x and later. The list of configurations that are supplied to the Amazon EMR cluster.
         :param custom_ami_id: Available only in Amazon EMR releases 5.7.0 and later. The ID of a custom Amazon EBS-backed Linux AMI if the cluster uses a custom AMI.
@@ -5961,9 +5961,9 @@ class CfnClusterProps:
     def auto_termination_policy(
         self,
     ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, CfnCluster.AutoTerminationPolicyProperty]]:
-        '''An auto-termination policy defines the amount of idle time in seconds after which a cluster automatically terminates.
+        '''An auto-termination policy for an Amazon EMR cluster.
 
-        For alternative cluster termination options, see `Control cluster termination <https://docs.aws.amazon.com/emr/latest/ManagementGuide/emr-plan-termination.html>`_
+        An auto-termination policy defines the amount of idle time in seconds after which a cluster automatically terminates. For alternative cluster termination options, see `Control cluster termination <https://docs.aws.amazon.com/emr/latest/ManagementGuide/emr-plan-termination.html>`_ .
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-emr-cluster.html#cfn-emr-cluster-autoterminationpolicy
         '''
@@ -9571,7 +9571,7 @@ class CfnSecurityConfiguration(
         '''
         :param scope: Scope in which this resource is defined.
         :param id: Construct identifier for this resource (unique in its scope).
-        :param security_configuration: The security configuration details in JSON format.
+        :param security_configuration: The security configuration details in JSON format. For JSON parameters and examples, see `Use Security Configurations to Set Up Cluster Security <https://docs.aws.amazon.com/emr/latest/ManagementGuide/emr-security-configurations.html>`_ in the *Amazon EMR Management Guide* .
         :param name: The name of the security configuration.
         '''
         if __debug__:
@@ -9660,7 +9660,7 @@ class CfnSecurityConfigurationProps:
     ) -> None:
         '''Properties for defining a ``CfnSecurityConfiguration``.
 
-        :param security_configuration: The security configuration details in JSON format.
+        :param security_configuration: The security configuration details in JSON format. For JSON parameters and examples, see `Use Security Configurations to Set Up Cluster Security <https://docs.aws.amazon.com/emr/latest/ManagementGuide/emr-security-configurations.html>`_ in the *Amazon EMR Management Guide* .
         :param name: The name of the security configuration.
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-emr-securityconfiguration.html
@@ -9743,6 +9743,8 @@ class CfnSecurityConfigurationProps:
     def security_configuration(self) -> typing.Any:
         '''The security configuration details in JSON format.
 
+        For JSON parameters and examples, see `Use Security Configurations to Set Up Cluster Security <https://docs.aws.amazon.com/emr/latest/ManagementGuide/emr-security-configurations.html>`_ in the *Amazon EMR Management Guide* .
+
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-emr-securityconfiguration.html#cfn-emr-securityconfiguration-securityconfiguration
         '''
         result = self._values.get("security_configuration")
@@ -11277,9 +11279,7 @@ class CfnWALWorkspace(
     metaclass=jsii.JSIIMeta,
     jsii_type="aws-cdk-lib.aws_emr.CfnWALWorkspace",
 ):
-    '''A WAL workspace is a logical container of write-ahead logs (WALs).
-
-    All WALs in Amazon EMR WAL are encapsulated by a WAL workspace.
+    '''http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-emr-walworkspace.html.
 
     :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-emr-walworkspace.html
     :cloudformationResource: AWS::EMR::WALWorkspace
@@ -11311,8 +11311,8 @@ class CfnWALWorkspace(
         '''
         :param scope: Scope in which this resource is defined.
         :param id: Construct identifier for this resource (unique in its scope).
-        :param tags: You can add tags when you create a new workspace. You can add, remove, or list tags from an active workspace, but you can't update tags. Instead, remove the tag and add a new one. For more information, see see `Tag your Amazon EMR WAL workspaces <https://docs.aws.amazon.com/emr/latest/ReleaseGuide/emr-hbase-wal.html#emr-hbase-wal-tagging>`_ .
-        :param wal_workspace_name: The name of the WAL workspace.
+        :param tags: An array of key-value pairs to apply to this resource.
+        :param wal_workspace_name: The name of the emrwal container.
         '''
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__1985a11480d9771f4adca96d86b169aa02281678db75bca99cae188da64db2af)
@@ -11366,7 +11366,7 @@ class CfnWALWorkspace(
     @builtins.property
     @jsii.member(jsii_name="tags")
     def tags(self) -> typing.Optional[typing.List[_CfnTag_f6864754]]:
-        '''You can add tags when you create a new workspace.'''
+        '''An array of key-value pairs to apply to this resource.'''
         return typing.cast(typing.Optional[typing.List[_CfnTag_f6864754]], jsii.get(self, "tags"))
 
     @tags.setter
@@ -11379,7 +11379,7 @@ class CfnWALWorkspace(
     @builtins.property
     @jsii.member(jsii_name="walWorkspaceName")
     def wal_workspace_name(self) -> typing.Optional[builtins.str]:
-        '''The name of the WAL workspace.'''
+        '''The name of the emrwal container.'''
         return typing.cast(typing.Optional[builtins.str], jsii.get(self, "walWorkspaceName"))
 
     @wal_workspace_name.setter
@@ -11404,8 +11404,8 @@ class CfnWALWorkspaceProps:
     ) -> None:
         '''Properties for defining a ``CfnWALWorkspace``.
 
-        :param tags: You can add tags when you create a new workspace. You can add, remove, or list tags from an active workspace, but you can't update tags. Instead, remove the tag and add a new one. For more information, see see `Tag your Amazon EMR WAL workspaces <https://docs.aws.amazon.com/emr/latest/ReleaseGuide/emr-hbase-wal.html#emr-hbase-wal-tagging>`_ .
-        :param wal_workspace_name: The name of the WAL workspace.
+        :param tags: An array of key-value pairs to apply to this resource.
+        :param wal_workspace_name: The name of the emrwal container.
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-emr-walworkspace.html
         :exampleMetadata: fixture=_generated
@@ -11436,9 +11436,7 @@ class CfnWALWorkspaceProps:
 
     @builtins.property
     def tags(self) -> typing.Optional[typing.List[_CfnTag_f6864754]]:
-        '''You can add tags when you create a new workspace.
-
-        You can add, remove, or list tags from an active workspace, but you can't update tags. Instead, remove the tag and add a new one. For more information, see see `Tag your Amazon EMR WAL workspaces <https://docs.aws.amazon.com/emr/latest/ReleaseGuide/emr-hbase-wal.html#emr-hbase-wal-tagging>`_ .
+        '''An array of key-value pairs to apply to this resource.
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-emr-walworkspace.html#cfn-emr-walworkspace-tags
         '''
@@ -11447,7 +11445,7 @@ class CfnWALWorkspaceProps:
 
     @builtins.property
     def wal_workspace_name(self) -> typing.Optional[builtins.str]:
-        '''The name of the WAL workspace.
+        '''The name of the emrwal container.
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-emr-walworkspace.html#cfn-emr-walworkspace-walworkspacename
         '''