aws-cdk-lib 2.155.0__py3-none-any.whl → 2.157.0__py3-none-any.whl

aws_cdk/aws_ecs_patterns/__init__.py

@@ -1124,7 +1124,46 @@ queue_processing_fargate_service = ecs_patterns.NetworkLoadBalancedFargateServic
 )
 ```
 
-### Use dualstack NLB
+### Use dualstack Load Balancer
+
+You can use dualstack IP address type for Application Load Balancer and Network Load Balancer.
+
+To use dualstack IP address type, you must have associated IPv6 CIDR blocks with the VPC and subnets and set the `ipAddressType` to `IpAddressType.DUAL_STACK` when creating the load balancer.
+
+### Application Load Balancer
+
+You can use dualstack Application Load Balancer for Fargate and EC2 services.
+
+```python
+import aws_cdk.aws_elasticloadbalancingv2 as elbv2
+
+
+# The VPC and subnet must have associated IPv6 CIDR blocks.
+vpc = ec2.Vpc(self, "Vpc",
+    ip_protocol=ec2.IpProtocol.DUAL_STACK
+)
+cluster = ecs.Cluster(self, "EcsCluster", vpc=vpc)
+
+service = ecs_patterns.ApplicationLoadBalancedFargateService(self, "myService",
+    cluster=cluster,
+    task_image_options=ecsPatterns.ApplicationLoadBalancedTaskImageOptions(
+        image=ecs.ContainerImage.from_registry("amazon/amazon-ecs-sample")
+    ),
+    ip_address_type=elbv2.IpAddressType.DUAL_STACK
+)
+
+application_load_balanced_ec2_service = ecs_patterns.ApplicationLoadBalancedEc2Service(self, "myService",
+    cluster=cluster,
+    task_image_options=ecsPatterns.ApplicationLoadBalancedTaskImageOptions(
+        image=ecs.ContainerImage.from_registry("amazon/amazon-ecs-sample")
+    ),
+    ip_address_type=elbv2.IpAddressType.DUAL_STACK
+)
+```
+
+### Network Load Balancer
+
+You can use dualstack Network Load Balancer for Fargate and EC2 services.
 
 ```python
 import aws_cdk.aws_elasticloadbalancingv2 as elbv2
@@ -1391,6 +1430,7 @@ class ApplicationLoadBalancedServiceBase(
         enable_execute_command: typing.Optional[builtins.bool] = None,
         health_check_grace_period: typing.Optional[_Duration_4839e8c3] = None,
         idle_timeout: typing.Optional[_Duration_4839e8c3] = None,
+        ip_address_type: typing.Optional[_IpAddressType_c43b240e] = None,
         listener_port: typing.Optional[jsii.Number] = None,
         load_balancer: typing.Optional[_IApplicationLoadBalancer_4cbd50ab] = None,
         load_balancer_name: typing.Optional[builtins.str] = None,
@@ -1426,6 +1466,7 @@ class ApplicationLoadBalancedServiceBase(
         :param enable_execute_command: Whether ECS Exec should be enabled. Default: - false
         :param health_check_grace_period: The period of time, in seconds, that the Amazon ECS service scheduler ignores unhealthy Elastic Load Balancing target health checks after a task has first started. Default: - defaults to 60 seconds if at least one load balancer is in-use and it is not already set
         :param idle_timeout: The load balancer idle timeout, in seconds. Can be between 1 and 4000 seconds Default: - CloudFormation sets idle timeout to 60 seconds
+        :param ip_address_type: The type of IP address to use. Default: - IpAddressType.IPV4
         :param listener_port: Listener port of the application load balancer that will serve traffic to the service. Default: - The default listener port is determined from the protocol (port 80 for HTTP, port 443 for HTTPS). A domain name and zone must be also be specified if using HTTPS.
         :param load_balancer: The application load balancer that will serve traffic to the service. The VPC attribute of a load balancer must be specified for it to be used to create a new service with this pattern. [disable-awslint:ref-via-interface] Default: - a new load balancer will be created.
         :param load_balancer_name: Name of the load balancer. Default: - Automatically generated name.
@@ -1462,6 +1503,7 @@ class ApplicationLoadBalancedServiceBase(
             enable_execute_command=enable_execute_command,
             health_check_grace_period=health_check_grace_period,
             idle_timeout=idle_timeout,
+            ip_address_type=ip_address_type,
             listener_port=listener_port,
             load_balancer=load_balancer,
             load_balancer_name=load_balancer_name,
@@ -1592,6 +1634,7 @@ typing.cast(typing.Any, ApplicationLoadBalancedServiceBase).__jsii_proxy_class__
         "enable_execute_command": "enableExecuteCommand",
         "health_check_grace_period": "healthCheckGracePeriod",
         "idle_timeout": "idleTimeout",
+        "ip_address_type": "ipAddressType",
         "listener_port": "listenerPort",
         "load_balancer": "loadBalancer",
         "load_balancer_name": "loadBalancerName",
@@ -1628,6 +1671,7 @@ class ApplicationLoadBalancedServiceBaseProps:
         enable_execute_command: typing.Optional[builtins.bool] = None,
         health_check_grace_period: typing.Optional[_Duration_4839e8c3] = None,
         idle_timeout: typing.Optional[_Duration_4839e8c3] = None,
+        ip_address_type: typing.Optional[_IpAddressType_c43b240e] = None,
         listener_port: typing.Optional[jsii.Number] = None,
         load_balancer: typing.Optional[_IApplicationLoadBalancer_4cbd50ab] = None,
         load_balancer_name: typing.Optional[builtins.str] = None,
@@ -1661,6 +1705,7 @@ class ApplicationLoadBalancedServiceBaseProps:
         :param enable_execute_command: Whether ECS Exec should be enabled. Default: - false
         :param health_check_grace_period: The period of time, in seconds, that the Amazon ECS service scheduler ignores unhealthy Elastic Load Balancing target health checks after a task has first started. Default: - defaults to 60 seconds if at least one load balancer is in-use and it is not already set
         :param idle_timeout: The load balancer idle timeout, in seconds. Can be between 1 and 4000 seconds Default: - CloudFormation sets idle timeout to 60 seconds
+        :param ip_address_type: The type of IP address to use. Default: - IpAddressType.IPV4
         :param listener_port: Listener port of the application load balancer that will serve traffic to the service. Default: - The default listener port is determined from the protocol (port 80 for HTTP, port 443 for HTTPS). A domain name and zone must be also be specified if using HTTPS.
         :param load_balancer: The application load balancer that will serve traffic to the service. The VPC attribute of a load balancer must be specified for it to be used to create a new service with this pattern. [disable-awslint:ref-via-interface] Default: - a new load balancer will be created.
         :param load_balancer_name: Name of the load balancer. Default: - Automatically generated name.
@@ -1740,6 +1785,7 @@ class ApplicationLoadBalancedServiceBaseProps:
                 enable_execute_command=False,
                 health_check_grace_period=cdk.Duration.minutes(30),
                 idle_timeout=cdk.Duration.minutes(30),
+                ip_address_type=elbv2.IpAddressType.IPV4,
                 listener_port=123,
                 load_balancer=application_load_balancer,
                 load_balancer_name="loadBalancerName",
@@ -1804,6 +1850,7 @@ class ApplicationLoadBalancedServiceBaseProps:
             check_type(argname="argument enable_execute_command", value=enable_execute_command, expected_type=type_hints["enable_execute_command"])
             check_type(argname="argument health_check_grace_period", value=health_check_grace_period, expected_type=type_hints["health_check_grace_period"])
             check_type(argname="argument idle_timeout", value=idle_timeout, expected_type=type_hints["idle_timeout"])
+            check_type(argname="argument ip_address_type", value=ip_address_type, expected_type=type_hints["ip_address_type"])
             check_type(argname="argument listener_port", value=listener_port, expected_type=type_hints["listener_port"])
             check_type(argname="argument load_balancer", value=load_balancer, expected_type=type_hints["load_balancer"])
             check_type(argname="argument load_balancer_name", value=load_balancer_name, expected_type=type_hints["load_balancer_name"])
@@ -1848,6 +1895,8 @@ class ApplicationLoadBalancedServiceBaseProps:
             self._values["health_check_grace_period"] = health_check_grace_period
         if idle_timeout is not None:
             self._values["idle_timeout"] = idle_timeout
+        if ip_address_type is not None:
+            self._values["ip_address_type"] = ip_address_type
         if listener_port is not None:
             self._values["listener_port"] = listener_port
         if load_balancer is not None:
@@ -2027,6 +2076,15 @@ class ApplicationLoadBalancedServiceBaseProps:
         result = self._values.get("idle_timeout")
         return typing.cast(typing.Optional[_Duration_4839e8c3], result)
 
+    @builtins.property
+    def ip_address_type(self) -> typing.Optional[_IpAddressType_c43b240e]:
+        '''The type of IP address to use.
+
+        :default: - IpAddressType.IPV4
+        '''
+        result = self._values.get("ip_address_type")
+        return typing.cast(typing.Optional[_IpAddressType_c43b240e], result)
+
     @builtins.property
     def listener_port(self) -> typing.Optional[jsii.Number]:
         '''Listener port of the application load balancer that will serve traffic to the service.
@@ -7346,6 +7404,7 @@ class ApplicationLoadBalancedEc2Service(
         enable_execute_command: typing.Optional[builtins.bool] = None,
         health_check_grace_period: typing.Optional[_Duration_4839e8c3] = None,
         idle_timeout: typing.Optional[_Duration_4839e8c3] = None,
+        ip_address_type: typing.Optional[_IpAddressType_c43b240e] = None,
         listener_port: typing.Optional[jsii.Number] = None,
         load_balancer: typing.Optional[_IApplicationLoadBalancer_4cbd50ab] = None,
         load_balancer_name: typing.Optional[builtins.str] = None,
@@ -7387,6 +7446,7 @@ class ApplicationLoadBalancedEc2Service(
         :param enable_execute_command: Whether ECS Exec should be enabled. Default: - false
         :param health_check_grace_period: The period of time, in seconds, that the Amazon ECS service scheduler ignores unhealthy Elastic Load Balancing target health checks after a task has first started. Default: - defaults to 60 seconds if at least one load balancer is in-use and it is not already set
         :param idle_timeout: The load balancer idle timeout, in seconds. Can be between 1 and 4000 seconds Default: - CloudFormation sets idle timeout to 60 seconds
+        :param ip_address_type: The type of IP address to use. Default: - IpAddressType.IPV4
         :param listener_port: Listener port of the application load balancer that will serve traffic to the service. Default: - The default listener port is determined from the protocol (port 80 for HTTP, port 443 for HTTPS). A domain name and zone must be also be specified if using HTTPS.
         :param load_balancer: The application load balancer that will serve traffic to the service. The VPC attribute of a load balancer must be specified for it to be used to create a new service with this pattern. [disable-awslint:ref-via-interface] Default: - a new load balancer will be created.
         :param load_balancer_name: Name of the load balancer. Default: - Automatically generated name.
@@ -7429,6 +7489,7 @@ class ApplicationLoadBalancedEc2Service(
             enable_execute_command=enable_execute_command,
             health_check_grace_period=health_check_grace_period,
             idle_timeout=idle_timeout,
+            ip_address_type=ip_address_type,
             listener_port=listener_port,
             load_balancer=load_balancer,
             load_balancer_name=load_balancer_name,
@@ -7480,6 +7541,7 @@ class ApplicationLoadBalancedEc2Service(
         "enable_execute_command": "enableExecuteCommand",
         "health_check_grace_period": "healthCheckGracePeriod",
         "idle_timeout": "idleTimeout",
+        "ip_address_type": "ipAddressType",
         "listener_port": "listenerPort",
         "load_balancer": "loadBalancer",
         "load_balancer_name": "loadBalancerName",
@@ -7522,6 +7584,7 @@ class ApplicationLoadBalancedEc2ServiceProps(ApplicationLoadBalancedServiceBaseP
         enable_execute_command: typing.Optional[builtins.bool] = None,
         health_check_grace_period: typing.Optional[_Duration_4839e8c3] = None,
         idle_timeout: typing.Optional[_Duration_4839e8c3] = None,
+        ip_address_type: typing.Optional[_IpAddressType_c43b240e] = None,
         listener_port: typing.Optional[jsii.Number] = None,
         load_balancer: typing.Optional[_IApplicationLoadBalancer_4cbd50ab] = None,
         load_balancer_name: typing.Optional[builtins.str] = None,
@@ -7561,6 +7624,7 @@ class ApplicationLoadBalancedEc2ServiceProps(ApplicationLoadBalancedServiceBaseP
         :param enable_execute_command: Whether ECS Exec should be enabled. Default: - false
         :param health_check_grace_period: The period of time, in seconds, that the Amazon ECS service scheduler ignores unhealthy Elastic Load Balancing target health checks after a task has first started. Default: - defaults to 60 seconds if at least one load balancer is in-use and it is not already set
         :param idle_timeout: The load balancer idle timeout, in seconds. Can be between 1 and 4000 seconds Default: - CloudFormation sets idle timeout to 60 seconds
+        :param ip_address_type: The type of IP address to use. Default: - IpAddressType.IPV4
         :param listener_port: Listener port of the application load balancer that will serve traffic to the service. Default: - The default listener port is determined from the protocol (port 80 for HTTP, port 443 for HTTPS). A domain name and zone must be also be specified if using HTTPS.
         :param load_balancer: The application load balancer that will serve traffic to the service. The VPC attribute of a load balancer must be specified for it to be used to create a new service with this pattern. [disable-awslint:ref-via-interface] Default: - a new load balancer will be created.
         :param load_balancer_name: Name of the load balancer. Default: - Automatically generated name.
@@ -7629,6 +7693,7 @@ class ApplicationLoadBalancedEc2ServiceProps(ApplicationLoadBalancedServiceBaseP
             check_type(argname="argument enable_execute_command", value=enable_execute_command, expected_type=type_hints["enable_execute_command"])
             check_type(argname="argument health_check_grace_period", value=health_check_grace_period, expected_type=type_hints["health_check_grace_period"])
             check_type(argname="argument idle_timeout", value=idle_timeout, expected_type=type_hints["idle_timeout"])
+            check_type(argname="argument ip_address_type", value=ip_address_type, expected_type=type_hints["ip_address_type"])
             check_type(argname="argument listener_port", value=listener_port, expected_type=type_hints["listener_port"])
             check_type(argname="argument load_balancer", value=load_balancer, expected_type=type_hints["load_balancer"])
             check_type(argname="argument load_balancer_name", value=load_balancer_name, expected_type=type_hints["load_balancer_name"])
@@ -7679,6 +7744,8 @@ class ApplicationLoadBalancedEc2ServiceProps(ApplicationLoadBalancedServiceBaseP
             self._values["health_check_grace_period"] = health_check_grace_period
         if idle_timeout is not None:
             self._values["idle_timeout"] = idle_timeout
+        if ip_address_type is not None:
+            self._values["ip_address_type"] = ip_address_type
         if listener_port is not None:
             self._values["listener_port"] = listener_port
         if load_balancer is not None:
@@ -7870,6 +7937,15 @@ class ApplicationLoadBalancedEc2ServiceProps(ApplicationLoadBalancedServiceBaseP
         result = self._values.get("idle_timeout")
         return typing.cast(typing.Optional[_Duration_4839e8c3], result)
 
+    @builtins.property
+    def ip_address_type(self) -> typing.Optional[_IpAddressType_c43b240e]:
+        '''The type of IP address to use.
+
+        :default: - IpAddressType.IPV4
+        '''
+        result = self._values.get("ip_address_type")
+        return typing.cast(typing.Optional[_IpAddressType_c43b240e], result)
+
     @builtins.property
     def listener_port(self) -> typing.Optional[jsii.Number]:
         '''Listener port of the application load balancer that will serve traffic to the service.
@@ -8175,11 +8251,20 @@ class ApplicationLoadBalancedFargateService(
             cpu=512,
             task_image_options=ecsPatterns.ApplicationLoadBalancedTaskImageOptions(
                 image=ecs.ContainerImage.from_registry("amazon/amazon-ecs-sample")
-            ),
-            task_subnets=ec2.SubnetSelection(
-                subnets=[ec2.Subnet.from_subnet_id(self, "subnet", "VpcISOLATEDSubnet1Subnet80F07FA0")]
-            ),
-            load_balancer_name="application-lb-name"
+            )
+        )
+        
+        scalable_target = load_balanced_fargate_service.service.auto_scale_task_count(
+            min_capacity=1,
+            max_capacity=20
+        )
+        
+        scalable_target.scale_on_cpu_utilization("CpuScaling",
+            target_utilization_percent=50
+        )
+        
+        scalable_target.scale_on_memory_utilization("MemoryScaling",
+            target_utilization_percent=50
         )
     '''
 
@@ -8205,6 +8290,7 @@ class ApplicationLoadBalancedFargateService(
         enable_execute_command: typing.Optional[builtins.bool] = None,
         health_check_grace_period: typing.Optional[_Duration_4839e8c3] = None,
         idle_timeout: typing.Optional[_Duration_4839e8c3] = None,
+        ip_address_type: typing.Optional[_IpAddressType_c43b240e] = None,
         listener_port: typing.Optional[jsii.Number] = None,
         load_balancer: typing.Optional[_IApplicationLoadBalancer_4cbd50ab] = None,
         load_balancer_name: typing.Optional[builtins.str] = None,
@@ -8250,6 +8336,7 @@ class ApplicationLoadBalancedFargateService(
         :param enable_execute_command: Whether ECS Exec should be enabled. Default: - false
         :param health_check_grace_period: The period of time, in seconds, that the Amazon ECS service scheduler ignores unhealthy Elastic Load Balancing target health checks after a task has first started. Default: - defaults to 60 seconds if at least one load balancer is in-use and it is not already set
         :param idle_timeout: The load balancer idle timeout, in seconds. Can be between 1 and 4000 seconds Default: - CloudFormation sets idle timeout to 60 seconds
+        :param ip_address_type: The type of IP address to use. Default: - IpAddressType.IPV4
         :param listener_port: Listener port of the application load balancer that will serve traffic to the service. Default: - The default listener port is determined from the protocol (port 80 for HTTP, port 443 for HTTPS). A domain name and zone must be also be specified if using HTTPS.
         :param load_balancer: The application load balancer that will serve traffic to the service. The VPC attribute of a load balancer must be specified for it to be used to create a new service with this pattern. [disable-awslint:ref-via-interface] Default: - a new load balancer will be created.
         :param load_balancer_name: Name of the load balancer. Default: - Automatically generated name.
@@ -8296,6 +8383,7 @@ class ApplicationLoadBalancedFargateService(
             enable_execute_command=enable_execute_command,
             health_check_grace_period=health_check_grace_period,
             idle_timeout=idle_timeout,
+            ip_address_type=ip_address_type,
             listener_port=listener_port,
             load_balancer=load_balancer,
             load_balancer_name=load_balancer_name,
@@ -8361,6 +8449,7 @@ class ApplicationLoadBalancedFargateService(
         "enable_execute_command": "enableExecuteCommand",
         "health_check_grace_period": "healthCheckGracePeriod",
         "idle_timeout": "idleTimeout",
+        "ip_address_type": "ipAddressType",
         "listener_port": "listenerPort",
         "load_balancer": "loadBalancer",
         "load_balancer_name": "loadBalancerName",
@@ -8410,6 +8499,7 @@ class ApplicationLoadBalancedFargateServiceProps(
         enable_execute_command: typing.Optional[builtins.bool] = None,
         health_check_grace_period: typing.Optional[_Duration_4839e8c3] = None,
         idle_timeout: typing.Optional[_Duration_4839e8c3] = None,
+        ip_address_type: typing.Optional[_IpAddressType_c43b240e] = None,
         listener_port: typing.Optional[jsii.Number] = None,
         load_balancer: typing.Optional[_IApplicationLoadBalancer_4cbd50ab] = None,
         load_balancer_name: typing.Optional[builtins.str] = None,
@@ -8453,6 +8543,7 @@ class ApplicationLoadBalancedFargateServiceProps(
         :param enable_execute_command: Whether ECS Exec should be enabled. Default: - false
         :param health_check_grace_period: The period of time, in seconds, that the Amazon ECS service scheduler ignores unhealthy Elastic Load Balancing target health checks after a task has first started. Default: - defaults to 60 seconds if at least one load balancer is in-use and it is not already set
         :param idle_timeout: The load balancer idle timeout, in seconds. Can be between 1 and 4000 seconds Default: - CloudFormation sets idle timeout to 60 seconds
+        :param ip_address_type: The type of IP address to use. Default: - IpAddressType.IPV4
         :param listener_port: Listener port of the application load balancer that will serve traffic to the service. Default: - The default listener port is determined from the protocol (port 80 for HTTP, port 443 for HTTPS). A domain name and zone must be also be specified if using HTTPS.
         :param load_balancer: The application load balancer that will serve traffic to the service. The VPC attribute of a load balancer must be specified for it to be used to create a new service with this pattern. [disable-awslint:ref-via-interface] Default: - a new load balancer will be created.
         :param load_balancer_name: Name of the load balancer. Default: - Automatically generated name.
@@ -8494,11 +8585,20 @@ class ApplicationLoadBalancedFargateServiceProps(
                 cpu=512,
                 task_image_options=ecsPatterns.ApplicationLoadBalancedTaskImageOptions(
                     image=ecs.ContainerImage.from_registry("amazon/amazon-ecs-sample")
-                ),
-                task_subnets=ec2.SubnetSelection(
-                    subnets=[ec2.Subnet.from_subnet_id(self, "subnet", "VpcISOLATEDSubnet1Subnet80F07FA0")]
-                ),
-                load_balancer_name="application-lb-name"
+                )
+            )
+            
+            scalable_target = load_balanced_fargate_service.service.auto_scale_task_count(
+                min_capacity=1,
+                max_capacity=20
+            )
+            
+            scalable_target.scale_on_cpu_utilization("CpuScaling",
+                target_utilization_percent=50
+            )
+            
+            scalable_target.scale_on_memory_utilization("MemoryScaling",
+                target_utilization_percent=50
             )
         '''
         if isinstance(circuit_breaker, dict):
@@ -8530,6 +8630,7 @@ class ApplicationLoadBalancedFargateServiceProps(
             check_type(argname="argument enable_execute_command", value=enable_execute_command, expected_type=type_hints["enable_execute_command"])
             check_type(argname="argument health_check_grace_period", value=health_check_grace_period, expected_type=type_hints["health_check_grace_period"])
             check_type(argname="argument idle_timeout", value=idle_timeout, expected_type=type_hints["idle_timeout"])
+            check_type(argname="argument ip_address_type", value=ip_address_type, expected_type=type_hints["ip_address_type"])
             check_type(argname="argument listener_port", value=listener_port, expected_type=type_hints["listener_port"])
             check_type(argname="argument load_balancer", value=load_balancer, expected_type=type_hints["load_balancer"])
             check_type(argname="argument load_balancer_name", value=load_balancer_name, expected_type=type_hints["load_balancer_name"])
@@ -8584,6 +8685,8 @@ class ApplicationLoadBalancedFargateServiceProps(
             self._values["health_check_grace_period"] = health_check_grace_period
         if idle_timeout is not None:
             self._values["idle_timeout"] = idle_timeout
+        if ip_address_type is not None:
+            self._values["ip_address_type"] = ip_address_type
         if listener_port is not None:
             self._values["listener_port"] = listener_port
         if load_balancer is not None:
@@ -8783,6 +8886,15 @@ class ApplicationLoadBalancedFargateServiceProps(
         result = self._values.get("idle_timeout")
         return typing.cast(typing.Optional[_Duration_4839e8c3], result)
 
+    @builtins.property
+    def ip_address_type(self) -> typing.Optional[_IpAddressType_c43b240e]:
+        '''The type of IP address to use.
+
+        :default: - IpAddressType.IPV4
+        '''
+        result = self._values.get("ip_address_type")
+        return typing.cast(typing.Optional[_IpAddressType_c43b240e], result)
+
     @builtins.property
     def listener_port(self) -> typing.Optional[jsii.Number]:
         '''Listener port of the application load balancer that will serve traffic to the service.
@@ -16055,6 +16167,7 @@ def _typecheckingstub__8c3ede040de35ed817f7c39537976690e81673c7be443b152e959f7f9
     enable_execute_command: typing.Optional[builtins.bool] = None,
     health_check_grace_period: typing.Optional[_Duration_4839e8c3] = None,
     idle_timeout: typing.Optional[_Duration_4839e8c3] = None,
+    ip_address_type: typing.Optional[_IpAddressType_c43b240e] = None,
     listener_port: typing.Optional[jsii.Number] = None,
     load_balancer: typing.Optional[_IApplicationLoadBalancer_4cbd50ab] = None,
     load_balancer_name: typing.Optional[builtins.str] = None,
@@ -16110,6 +16223,7 @@ def _typecheckingstub__a68b3d7133b7b22b27e8c904e21f15f3a38d6a44c16a16cdf89d4051b
     enable_execute_command: typing.Optional[builtins.bool] = None,
     health_check_grace_period: typing.Optional[_Duration_4839e8c3] = None,
     idle_timeout: typing.Optional[_Duration_4839e8c3] = None,
+    ip_address_type: typing.Optional[_IpAddressType_c43b240e] = None,
     listener_port: typing.Optional[jsii.Number] = None,
     load_balancer: typing.Optional[_IApplicationLoadBalancer_4cbd50ab] = None,
     load_balancer_name: typing.Optional[builtins.str] = None,
@@ -16694,6 +16808,7 @@ def _typecheckingstub__c7c2728dc66395799b8f32553505628c230427b49bbbc6fd682aa7208
     enable_execute_command: typing.Optional[builtins.bool] = None,
     health_check_grace_period: typing.Optional[_Duration_4839e8c3] = None,
     idle_timeout: typing.Optional[_Duration_4839e8c3] = None,
+    ip_address_type: typing.Optional[_IpAddressType_c43b240e] = None,
     listener_port: typing.Optional[jsii.Number] = None,
     load_balancer: typing.Optional[_IApplicationLoadBalancer_4cbd50ab] = None,
     load_balancer_name: typing.Optional[builtins.str] = None,
@@ -16730,6 +16845,7 @@ def _typecheckingstub__b3f33e583b66138930e8047d22ea9454885645ecc97e1b8505d5c0a26
     enable_execute_command: typing.Optional[builtins.bool] = None,
     health_check_grace_period: typing.Optional[_Duration_4839e8c3] = None,
     idle_timeout: typing.Optional[_Duration_4839e8c3] = None,
+    ip_address_type: typing.Optional[_IpAddressType_c43b240e] = None,
     listener_port: typing.Optional[jsii.Number] = None,
     load_balancer: typing.Optional[_IApplicationLoadBalancer_4cbd50ab] = None,
     load_balancer_name: typing.Optional[builtins.str] = None,
@@ -16778,6 +16894,7 @@ def _typecheckingstub__52e4707f036e6b5ab8a12a1dd88ad78656d9ef102eb7d04caef957d69
     enable_execute_command: typing.Optional[builtins.bool] = None,
     health_check_grace_period: typing.Optional[_Duration_4839e8c3] = None,
     idle_timeout: typing.Optional[_Duration_4839e8c3] = None,
+    ip_address_type: typing.Optional[_IpAddressType_c43b240e] = None,
     listener_port: typing.Optional[jsii.Number] = None,
     load_balancer: typing.Optional[_IApplicationLoadBalancer_4cbd50ab] = None,
     load_balancer_name: typing.Optional[builtins.str] = None,
@@ -16820,6 +16937,7 @@ def _typecheckingstub__cdcb8bd483faaddad588ad37d4527fa1a0028fc2307a21fc3690044a0
     enable_execute_command: typing.Optional[builtins.bool] = None,
     health_check_grace_period: typing.Optional[_Duration_4839e8c3] = None,
     idle_timeout: typing.Optional[_Duration_4839e8c3] = None,
+    ip_address_type: typing.Optional[_IpAddressType_c43b240e] = None,
     listener_port: typing.Optional[jsii.Number] = None,
     load_balancer: typing.Optional[_IApplicationLoadBalancer_4cbd50ab] = None,
     load_balancer_name: typing.Optional[builtins.str] = None,

aws_cdk/aws_eks/__init__.py

@@ -660,7 +660,7 @@ The default value is `eks.EndpointAccess.PUBLIC_AND_PRIVATE`. Which means the cl
 
 ### Alb Controller
 
-Some Kubernetes resources are commonly implemented on AWS with the help of the [ALB Controller](https://kubernetes-sigs.github.io/aws-load-balancer-controller/v2.5/).
+Some Kubernetes resources are commonly implemented on AWS with the help of the [ALB Controller](https://kubernetes-sigs.github.io/aws-load-balancer-controller/latest/).
 
 From the docs:
 
@@ -675,7 +675,7 @@ To deploy the controller on your EKS cluster, configure the `albController` prop
 eks.Cluster(self, "HelloEKS",
     version=eks.KubernetesVersion.V1_30,
     alb_controller=eks.AlbControllerOptions(
-        version=eks.AlbControllerVersion.V2_6_2
+        version=eks.AlbControllerVersion.V2_8_2
     )
 )
 ```
@@ -2879,7 +2879,7 @@ class AlbControllerOptions:
             eks.Cluster(self, "HelloEKS",
                 version=eks.KubernetesVersion.V1_30,
                 alb_controller=eks.AlbControllerOptions(
-                    version=eks.AlbControllerVersion.V2_6_2
+                    version=eks.AlbControllerVersion.V2_8_2
                 )
             )
         '''
@@ -3072,7 +3072,7 @@ class AlbControllerVersion(
         eks.Cluster(self, "HelloEKS",
             version=eks.KubernetesVersion.V1_30,
             alb_controller=eks.AlbControllerOptions(
-                version=eks.AlbControllerVersion.V2_6_2
+                version=eks.AlbControllerVersion.V2_8_2
             )
         )
     '''
@@ -3269,6 +3269,42 @@ class AlbControllerVersion(
         '''v2.6.2.'''
         return typing.cast("AlbControllerVersion", jsii.sget(cls, "V2_6_2"))
 
+    @jsii.python.classproperty
+    @jsii.member(jsii_name="V2_7_0")
+    def V2_7_0(cls) -> "AlbControllerVersion":
+        '''v2.7.0.'''
+        return typing.cast("AlbControllerVersion", jsii.sget(cls, "V2_7_0"))
+
+    @jsii.python.classproperty
+    @jsii.member(jsii_name="V2_7_1")
+    def V2_7_1(cls) -> "AlbControllerVersion":
+        '''v2.7.1.'''
+        return typing.cast("AlbControllerVersion", jsii.sget(cls, "V2_7_1"))
+
+    @jsii.python.classproperty
+    @jsii.member(jsii_name="V2_7_2")
+    def V2_7_2(cls) -> "AlbControllerVersion":
+        '''v2.7.2.'''
+        return typing.cast("AlbControllerVersion", jsii.sget(cls, "V2_7_2"))
+
+    @jsii.python.classproperty
+    @jsii.member(jsii_name="V2_8_0")
+    def V2_8_0(cls) -> "AlbControllerVersion":
+        '''v2.8.0.'''
+        return typing.cast("AlbControllerVersion", jsii.sget(cls, "V2_8_0"))
+
+    @jsii.python.classproperty
+    @jsii.member(jsii_name="V2_8_1")
+    def V2_8_1(cls) -> "AlbControllerVersion":
+        '''v2.8.1.'''
+        return typing.cast("AlbControllerVersion", jsii.sget(cls, "V2_8_1"))
+
+    @jsii.python.classproperty
+    @jsii.member(jsii_name="V2_8_2")
+    def V2_8_2(cls) -> "AlbControllerVersion":
+        '''v2.8.2.'''
+        return typing.cast("AlbControllerVersion", jsii.sget(cls, "V2_8_2"))
+
     @builtins.property
     @jsii.member(jsii_name="custom")
     def custom(self) -> builtins.bool:

aws_cdk/aws_elasticloadbalancingv2/__init__.py

@@ -1021,7 +1021,7 @@ class AddNetworkTargetsProps:
     ) -> None:
         '''Properties for adding new network targets to a listener.
 
-        :param port: The port on which the listener listens for requests. Default: Determined from protocol if known
+        :param port: The port on which the target receives traffic. Default: Determined from protocol if known
         :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 health_check: Health check configuration. Default: - The default value for each property in this configuration varies depending on the target.
         :param preserve_client_ip: Indicates whether client IP preservation is enabled. Default: false if the target group type is IP address and the target group protocol is TCP or TLS. Otherwise, true.
@@ -1092,7 +1092,7 @@ class AddNetworkTargetsProps:
 
     @builtins.property
     def port(self) -> jsii.Number:
-        '''The port on which the listener listens for requests.
+        '''The port on which the target receives traffic.
 
         :default: Determined from protocol if known
         '''
@@ -8812,7 +8812,7 @@ class CfnTargetGroup(
         :param protocol: The protocol to use for routing traffic to the targets. For Application Load Balancers, the supported protocols are HTTP and HTTPS. For Network Load Balancers, the supported protocols are TCP, TLS, UDP, or TCP_UDP. For Gateway Load Balancers, the supported protocol is GENEVE. A TCP_UDP listener must be associated with a TCP_UDP target group. If the target is a Lambda function, this parameter does not apply.
         :param protocol_version: [HTTP/HTTPS protocol] The protocol version. The possible values are ``GRPC`` , ``HTTP1`` , and ``HTTP2`` .
         :param tags: The tags.
-        :param target_group_attributes: The attributes.
+        :param target_group_attributes: The target group attributes.
         :param targets: The targets.
         :param target_type: The type of target that you must specify when registering targets with this target group. You can't specify targets for a target group using more than one target type. - ``instance`` - Register targets by instance ID. This is the default value. - ``ip`` - Register targets by IP address. You can specify IP addresses from the subnets of the virtual private cloud (VPC) for the target group, the RFC 1918 range (10.0.0.0/8, 172.16.0.0/12, and 192.168.0.0/16), and the RFC 6598 range (100.64.0.0/10). You can't specify publicly routable IP addresses. - ``lambda`` - Register a single Lambda function as a target. - ``alb`` - Register a single Application Load Balancer as a target.
         :param unhealthy_threshold_count: The number of consecutive health check failures required before considering a target unhealthy. The range is 2-10. If the target group protocol is TCP, TCP_UDP, UDP, TLS, HTTP or HTTPS, the default is 2. For target groups with a protocol of GENEVE, the default is 2. If the target type is ``lambda`` , the default is 5.
@@ -9127,7 +9127,7 @@ class CfnTargetGroup(
     def target_group_attributes(
         self,
     ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, typing.List[typing.Union[_IResolvable_da3f097b, "CfnTargetGroup.TargetGroupAttributeProperty"]]]]:
-        '''The attributes.'''
+        '''The target group attributes.'''
         return typing.cast(typing.Optional[typing.Union[_IResolvable_da3f097b, typing.List[typing.Union[_IResolvable_da3f097b, "CfnTargetGroup.TargetGroupAttributeProperty"]]]], jsii.get(self, "targetGroupAttributes"))
 
     @target_group_attributes.setter
@@ -9566,7 +9566,7 @@ class CfnTargetGroupProps:
         :param protocol: The protocol to use for routing traffic to the targets. For Application Load Balancers, the supported protocols are HTTP and HTTPS. For Network Load Balancers, the supported protocols are TCP, TLS, UDP, or TCP_UDP. For Gateway Load Balancers, the supported protocol is GENEVE. A TCP_UDP listener must be associated with a TCP_UDP target group. If the target is a Lambda function, this parameter does not apply.
         :param protocol_version: [HTTP/HTTPS protocol] The protocol version. The possible values are ``GRPC`` , ``HTTP1`` , and ``HTTP2`` .
         :param tags: The tags.
-        :param target_group_attributes: The attributes.
+        :param target_group_attributes: The target group attributes.
         :param targets: The targets.
         :param target_type: The type of target that you must specify when registering targets with this target group. You can't specify targets for a target group using more than one target type. - ``instance`` - Register targets by instance ID. This is the default value. - ``ip`` - Register targets by IP address. You can specify IP addresses from the subnets of the virtual private cloud (VPC) for the target group, the RFC 1918 range (10.0.0.0/8, 172.16.0.0/12, and 192.168.0.0/16), and the RFC 6598 range (100.64.0.0/10). You can't specify publicly routable IP addresses. - ``lambda`` - Register a single Lambda function as a target. - ``alb`` - Register a single Application Load Balancer as a target.
         :param unhealthy_threshold_count: The number of consecutive health check failures required before considering a target unhealthy. The range is 2-10. If the target group protocol is TCP, TCP_UDP, UDP, TLS, HTTP or HTTPS, the default is 2. For target groups with a protocol of GENEVE, the default is 2. If the target type is ``lambda`` , the default is 5.
@@ -9841,7 +9841,7 @@ class CfnTargetGroupProps:
     def target_group_attributes(
         self,
     ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, typing.List[typing.Union[_IResolvable_da3f097b, CfnTargetGroup.TargetGroupAttributeProperty]]]]:
-        '''The attributes.
+        '''The target group attributes.
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-elasticloadbalancingv2-targetgroup.html#cfn-elasticloadbalancingv2-targetgroup-targetgroupattributes
         '''
@@ -14942,53 +14942,29 @@ class IpAddressType(enum.Enum):
 
     Example::
 
-        # vpc: ec2.Vpc
-        
-        
-        lb = elbv2.ApplicationLoadBalancer(self, "LB",
-            vpc=vpc,
-            internet_facing=True,
+        import aws_cdk.aws_elasticloadbalancingv2 as elbv2
         
-            # Whether HTTP/2 is enabled
-            http2_enabled=False,
-        
-            # The idle timeout value, in seconds
-            idle_timeout=Duration.seconds(1000),
         
-            # Whether HTTP headers with header fields thatare not valid
-            # are removed by the load balancer (true), or routed to targets
-            drop_invalid_header_fields=True,
-        
-            # How the load balancer handles requests that might
-            # pose a security risk to your application
-            desync_mitigation_mode=elbv2.DesyncMitigationMode.DEFENSIVE,
-        
-            # The type of IP addresses to use.
-            ip_address_type=elbv2.IpAddressType.IPV4,
-        
-            # The duration of client keep-alive connections
-            client_keep_alive=Duration.seconds(500),
-        
-            # Whether cross-zone load balancing is enabled.
-            cross_zone_enabled=True,
-        
-            # Whether the load balancer blocks traffic through the Internet Gateway (IGW).
-            deny_all_igw_traffic=False,
-        
-            # Whether to preserve host header in the request to the target
-            preserve_host_header=True,
-        
-            # Whether to add the TLS information header to the request
-            x_amzn_tls_version_and_cipher_suite_headers=True,
-        
-            # Whether the X-Forwarded-For header should preserve the source port
-            preserve_xff_client_port=True,
+        # The VPC and subnet must have associated IPv6 CIDR blocks.
+        vpc = ec2.Vpc(self, "Vpc",
+            ip_protocol=ec2.IpProtocol.DUAL_STACK
+        )
+        cluster = ecs.Cluster(self, "EcsCluster", vpc=vpc)
         
-            # The processing mode for X-Forwarded-For headers
-            xff_header_processing_mode=elbv2.XffHeaderProcessingMode.APPEND,
+        service = ecs_patterns.ApplicationLoadBalancedFargateService(self, "myService",
+            cluster=cluster,
+            task_image_options=ecsPatterns.ApplicationLoadBalancedTaskImageOptions(
+                image=ecs.ContainerImage.from_registry("amazon/amazon-ecs-sample")
+            ),
+            ip_address_type=elbv2.IpAddressType.DUAL_STACK
+        )
         
-            # Whether to allow a load balancer to route requests to targets if it is unable to forward the request to AWS WAF.
-            waf_fail_open=True
+        application_load_balanced_ec2_service = ecs_patterns.ApplicationLoadBalancedEc2Service(self, "myService",
+            cluster=cluster,
+            task_image_options=ecsPatterns.ApplicationLoadBalancedTaskImageOptions(
+                image=ecs.ContainerImage.from_registry("amazon/amazon-ecs-sample")
+            ),
+            ip_address_type=elbv2.IpAddressType.DUAL_STACK
         )
     '''
 
@@ -21794,7 +21770,7 @@ class NetworkListener(
         one set of targets must be added without conditions.
 
         :param id: -
-        :param port: The port on which the listener listens for requests. Default: Determined from protocol if known
+        :param port: The port on which the target receives traffic. Default: Determined from protocol if known
         :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 health_check: Health check configuration. Default: - The default value for each property in this configuration varies depending on the target.
         :param preserve_client_ip: Indicates whether client IP preservation is enabled. Default: false if the target group type is IP address and the target group protocol is TCP or TLS. Otherwise, true.