aws-cdk-lib 2.154.1__py3-none-any.whl → 2.156.0__py3-none-any.whl

aws_cdk/aws_ecs/__init__.py

@@ -30416,7 +30416,7 @@ class ListenerConfig(
         '''Create a config for adding target group to NLB listener.
 
         :param 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.
@@ -37605,24 +37605,28 @@ class Cluster(
 
     Example::
 
-        from aws_cdk import Tags
-        
+        vpc = ec2.Vpc.from_lookup(self, "Vpc",
+            is_default=True
+        )
+        cluster = ecs.Cluster(self, "ECSCluster", vpc=vpc)
         
-        vpc = ec2.Vpc(self, "Vpc", max_azs=1)
-        cluster = ecs.Cluster(self, "EcsCluster", vpc=vpc)
-        task_definition = ecs.FargateTaskDefinition(self, "TaskDef",
-            memory_limit_mi_b=512,
-            cpu=256
+        task_definition = ecs.TaskDefinition(self, "TD",
+            compatibility=ecs.Compatibility.FARGATE,
+            cpu="256",
+            memory_mi_b="512"
         )
-        task_definition.add_container("WebContainer",
-            image=ecs.ContainerImage.from_registry("amazon/amazon-ecs-sample")
+        
+        task_definition.add_container("TheContainer",
+            image=ecs.ContainerImage.from_registry("foo/bar")
         )
-        Tags.of(task_definition).add("my-tag", "my-tag-value")
-        scheduled_fargate_task = ecs_patterns.ScheduledFargateTask(self, "ScheduledFargateTask",
+        
+        run_task = tasks.EcsRunTask(self, "Run",
+            integration_pattern=sfn.IntegrationPattern.RUN_JOB,
             cluster=cluster,
             task_definition=task_definition,
-            schedule=appscaling.Schedule.expression("rate(1 minute)"),
-            propagate_tags=ecs.PropagatedTagSource.TASK_DEFINITION
+            launch_target=tasks.EcsFargateLaunchTarget(),
+            cpu="1024",
+            memory_mi_b="1048"
         )
     '''
 

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
     )
 )
 ```
@@ -1862,7 +1862,9 @@ load_balancer_address = cluster.get_service_load_balancer_address("my-service")
 eks.Addon(self, "Addon",
     cluster=cluster,
     addon_name="aws-guardduty-agent",
-    addon_version="v1.6.1"
+    addon_version="v1.6.1",
+    # whether to preserve the add-on software on your cluster but Amazon EKS stops managing any settings for the add-on.
+    preserve_on_delete=False
 )
 ```
 
@@ -2656,6 +2658,7 @@ class AddonAttributes:
         "addon_name": "addonName",
         "cluster": "cluster",
         "addon_version": "addonVersion",
+        "preserve_on_delete": "preserveOnDelete",
     },
 )
 class AddonProps:
@@ -2665,12 +2668,14 @@ class AddonProps:
         addon_name: builtins.str,
         cluster: "ICluster",
         addon_version: typing.Optional[builtins.str] = None,
+        preserve_on_delete: typing.Optional[builtins.bool] = None,
     ) -> None:
         '''Properties for creating an Amazon EKS Add-On.
 
         :param addon_name: Name of the Add-On.
         :param cluster: The EKS cluster the Add-On is associated with.
         :param addon_version: Version of the Add-On. You can check all available versions with describe-addon-versons. For example, this lists all available versions for the ``eks-pod-identity-agent`` addon: $ aws eks describe-addon-versions --addon-name eks-pod-identity-agent --query 'addons[*].addonVersions[*].addonVersion' Default: the latest version.
+        :param preserve_on_delete: Specifying this option preserves the add-on software on your cluster but Amazon EKS stops managing any settings for the add-on. If an IAM account is associated with the add-on, it isn't removed. Default: true
 
         :exampleMetadata: infused
 
@@ -2682,7 +2687,9 @@ class AddonProps:
             eks.Addon(self, "Addon",
                 cluster=cluster,
                 addon_name="aws-guardduty-agent",
-                addon_version="v1.6.1"
+                addon_version="v1.6.1",
+                # whether to preserve the add-on software on your cluster but Amazon EKS stops managing any settings for the add-on.
+                preserve_on_delete=False
             )
         '''
         if __debug__:
@@ -2690,12 +2697,15 @@ class AddonProps:
             check_type(argname="argument addon_name", value=addon_name, expected_type=type_hints["addon_name"])
             check_type(argname="argument cluster", value=cluster, expected_type=type_hints["cluster"])
             check_type(argname="argument addon_version", value=addon_version, expected_type=type_hints["addon_version"])
+            check_type(argname="argument preserve_on_delete", value=preserve_on_delete, expected_type=type_hints["preserve_on_delete"])
         self._values: typing.Dict[builtins.str, typing.Any] = {
             "addon_name": addon_name,
             "cluster": cluster,
         }
         if addon_version is not None:
             self._values["addon_version"] = addon_version
+        if preserve_on_delete is not None:
+            self._values["preserve_on_delete"] = preserve_on_delete
 
     @builtins.property
     def addon_name(self) -> builtins.str:
@@ -2725,6 +2735,17 @@ class AddonProps:
         result = self._values.get("addon_version")
         return typing.cast(typing.Optional[builtins.str], result)
 
+    @builtins.property
+    def preserve_on_delete(self) -> typing.Optional[builtins.bool]:
+        '''Specifying this option preserves the add-on software on your cluster but Amazon EKS stops managing any settings for the add-on.
+
+        If an IAM account is associated with the add-on, it isn't removed.
+
+        :default: true
+        '''
+        result = self._values.get("preserve_on_delete")
+        return typing.cast(typing.Optional[builtins.bool], result)
+
     def __eq__(self, rhs: typing.Any) -> builtins.bool:
         return isinstance(rhs, self.__class__) and rhs._values == self._values
 
@@ -2858,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
                 )
             )
         '''
@@ -3051,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
             )
         )
     '''
@@ -3248,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:
@@ -16806,7 +16863,9 @@ class Addon(
         eks.Addon(self, "Addon",
             cluster=cluster,
             addon_name="aws-guardduty-agent",
-            addon_version="v1.6.1"
+            addon_version="v1.6.1",
+            # whether to preserve the add-on software on your cluster but Amazon EKS stops managing any settings for the add-on.
+            preserve_on_delete=False
         )
     '''
 
@@ -16818,6 +16877,7 @@ class Addon(
         addon_name: builtins.str,
         cluster: ICluster,
         addon_version: typing.Optional[builtins.str] = None,
+        preserve_on_delete: typing.Optional[builtins.bool] = None,
     ) -> None:
         '''Creates a new Amazon EKS Add-On.
 
@@ -16826,13 +16886,17 @@ class Addon(
         :param addon_name: Name of the Add-On.
         :param cluster: The EKS cluster the Add-On is associated with.
         :param addon_version: Version of the Add-On. You can check all available versions with describe-addon-versons. For example, this lists all available versions for the ``eks-pod-identity-agent`` addon: $ aws eks describe-addon-versions --addon-name eks-pod-identity-agent --query 'addons[*].addonVersions[*].addonVersion' Default: the latest version.
+        :param preserve_on_delete: Specifying this option preserves the add-on software on your cluster but Amazon EKS stops managing any settings for the add-on. If an IAM account is associated with the add-on, it isn't removed. Default: true
         '''
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__a8342124e215d4789acf852df764143c4809251dbcaa86f6b4a11860e46f830d)
             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 = AddonProps(
-            addon_name=addon_name, cluster=cluster, addon_version=addon_version
+            addon_name=addon_name,
+            cluster=cluster,
+            addon_version=addon_version,
+            preserve_on_delete=preserve_on_delete,
         )
 
         jsii.create(self.__class__, self, [scope, id, props])
@@ -20043,6 +20107,7 @@ def _typecheckingstub__febc9f6cb4243d885b1b1838be38d633e7c5fc6534eaaf731f00a2465
     addon_name: builtins.str,
     cluster: ICluster,
     addon_version: typing.Optional[builtins.str] = None,
+    preserve_on_delete: typing.Optional[builtins.bool] = None,
 ) -> None:
     """Type checking stubs"""
     pass
@@ -21672,6 +21737,7 @@ def _typecheckingstub__a8342124e215d4789acf852df764143c4809251dbcaa86f6b4a11860e
     addon_name: builtins.str,
     cluster: ICluster,
     addon_version: typing.Optional[builtins.str] = None,
+    preserve_on_delete: typing.Optional[builtins.bool] = None,
 ) -> None:
     """Type checking stubs"""
     pass