aws-cdk-lib 2.134.0__py3-none-any.whl → 2.135.0__py3-none-any.whl

aws_cdk/aws_ecr/__init__.py

@@ -220,6 +220,9 @@ repository.add_to_resource_policy(iam.PolicyStatement(
 ))
 ```
 '''
+from pkgutil import extend_path
+__path__ = extend_path(__path__, __name__)
+
 import abc
 import builtins
 import datetime

aws_cdk/aws_ecr_assets/__init__.py

@@ -220,6 +220,9 @@ To do that, you can use `asset.repository.addToResourcePolicy(statement)` to
 grant the desired principal the following permissions: "ecr:GetDownloadUrlForLayer",
 "ecr:BatchGetImage" and "ecr:BatchCheckLayerAvailability".
 '''
+from pkgutil import extend_path
+__path__ = extend_path(__path__, __name__)
+
 import abc
 import builtins
 import datetime

aws_cdk/aws_ecs/__init__.py

@@ -1863,6 +1863,9 @@ task_definition.add_container("TheContainer",
 )
 ```
 '''
+from pkgutil import extend_path
+__path__ = extend_path(__path__, __name__)
+
 import abc
 import builtins
 import datetime
@@ -16874,6 +16877,9 @@ class CfnTaskSet(
     '''Create a task set in the specified cluster and service.
 
     This is used when a service uses the ``EXTERNAL`` deployment controller type. For more information, see `Amazon ECS deployment types <https://docs.aws.amazon.com/AmazonECS/latest/developerguide/deployment-types.html>`_ in the *Amazon Elastic Container Service Developer Guide* .
+    .. epigraph::
+
+       On March 21, 2024, a change was made to resolve the task definition revision before authorization. When a task definition revision is not specified, authorization will occur using the latest revision of a task definition.
 
     For information about the maximum number of task sets and otther quotas, see `Amazon ECS service quotas <https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-quotas.html>`_ in the *Amazon Elastic Container Service Developer Guide* .
 

aws_cdk/aws_ecs_patterns/__init__.py

@@ -1088,6 +1088,9 @@ queue_processing_fargate_service = ecs_patterns.NetworkLoadBalancedFargateServic
 )
 ```
 '''
+from pkgutil import extend_path
+__path__ = extend_path(__path__, __name__)
+
 import abc
 import builtins
 import datetime

aws_cdk/aws_efs/__init__.py

@@ -244,6 +244,9 @@ file_system = efs.FileSystem(self, "EfsFileSystem",
 )
 ```
 '''
+from pkgutil import extend_path
+__path__ = extend_path(__path__, __name__)
+
 import abc
 import builtins
 import datetime

aws_cdk/aws_eks/__init__.py

@@ -196,8 +196,7 @@ cluster = eks.Cluster(self, "HelloEKS",
 cluster.add_nodegroup_capacity("custom-node-group",
     instance_types=[ec2.InstanceType("m5.large")],
     min_size=4,
-    disk_size=100,
-    ami_type=eks.NodegroupAmiType.AL2_X86_64_GPU
+    disk_size=100
 )
 ```
 
@@ -217,6 +216,25 @@ cluster.add_nodegroup_capacity("custom-node-group",
 )
 ```
 
+To define the type of the AMI for the node group, you may explicitly define `amiType` according to your requirements, supported amiType could be found [HERE](https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.aws_eks.NodegroupAmiType.html).
+
+```python
+# cluster: eks.Cluster
+
+
+# X86_64 based AMI managed node group
+cluster.add_nodegroup_capacity("custom-node-group",
+    instance_types=[ec2.InstanceType("m5.large")],  # NOTE: if amiType is x86_64-based image, the instance types here must be x86_64-based.
+    ami_type=eks.NodegroupAmiType.AL2023_X86_64_STANDARD
+)
+
+# ARM_64 based AMI managed node group
+cluster.add_nodegroup_capacity("custom-node-group",
+    instance_types=[ec2.InstanceType("m6g.medium")],  # NOTE: if amiType is ARM-based image, the instance types here must be ARM-based.
+    ami_type=eks.NodegroupAmiType.AL2023_ARM_64_STANDARD
+)
+```
+
 To define the maximum number of instances which can be simultaneously replaced in a node group during a version update you can set `maxUnavailable` or `maxUnavailablePercentage` options.
 
 > For more details visit [Updating a managed node group](https://docs.aws.amazon.com/eks/latest/userguide/update-managed-node-group.html)
@@ -1747,6 +1765,9 @@ cluster = eks.Cluster(self, "Cluster",
 * [Service Account dependencies](https://github.com/aws/aws-cdk/issues/9910)
 * [Support isolated VPCs](https://github.com/aws/aws-cdk/issues/12171)
 '''
+from pkgutil import extend_path
+__path__ = extend_path(__path__, __name__)
+
 import abc
 import builtins
 import datetime
@@ -12723,8 +12744,7 @@ class KubernetesVersion(
         cluster.add_nodegroup_capacity("custom-node-group",
             instance_types=[ec2.InstanceType("m5.large")],
             min_size=4,
-            disk_size=100,
-            ami_type=eks.NodegroupAmiType.AL2_X86_64_GPU
+            disk_size=100
         )
     '''
 
@@ -15021,16 +15041,16 @@ class Cluster(
 
     Example::
 
-        cluster = eks.Cluster(self, "HelloEKS",
-            version=eks.KubernetesVersion.V1_29,
-            default_capacity=0
+        # or
+        # vpc: ec2.Vpc
+        eks.Cluster(self, "MyCluster",
+            kubectl_memory=Size.gibibytes(4),
+            version=eks.KubernetesVersion.V1_29
         )
-        
-        cluster.add_nodegroup_capacity("custom-node-group",
-            instance_types=[ec2.InstanceType("m5.large")],
-            min_size=4,
-            disk_size=100,
-            ami_type=eks.NodegroupAmiType.AL2_X86_64_GPU
+        eks.Cluster.from_cluster_attributes(self, "MyCluster",
+            kubectl_memory=Size.gibibytes(4),
+            vpc=vpc,
+            cluster_name="cluster-name"
         )
     '''
 
@@ -16650,16 +16670,16 @@ class ClusterProps(ClusterOptions):
 
         Example::
 
-            cluster = eks.Cluster(self, "HelloEKS",
-                version=eks.KubernetesVersion.V1_29,
-                default_capacity=0
+            # or
+            # vpc: ec2.Vpc
+            eks.Cluster(self, "MyCluster",
+                kubectl_memory=Size.gibibytes(4),
+                version=eks.KubernetesVersion.V1_29
             )
-            
-            cluster.add_nodegroup_capacity("custom-node-group",
-                instance_types=[ec2.InstanceType("m5.large")],
-                min_size=4,
-                disk_size=100,
-                ami_type=eks.NodegroupAmiType.AL2_X86_64_GPU
+            eks.Cluster.from_cluster_attributes(self, "MyCluster",
+                kubectl_memory=Size.gibibytes(4),
+                vpc=vpc,
+                cluster_name="cluster-name"
             )
         '''
         if isinstance(alb_controller, dict):

aws_cdk/aws_elasticache/__init__.py

@@ -25,6 +25,9 @@ For more information on the resources and properties available for this service,
 
 <!--END CFNONLY DISCLAIMER-->
 '''
+from pkgutil import extend_path
+__path__ = extend_path(__path__, __name__)
+
 import abc
 import builtins
 import datetime

aws_cdk/aws_elasticbeanstalk/__init__.py

@@ -25,6 +25,9 @@ For more information on the resources and properties available for this service,
 
 <!--END CFNONLY DISCLAIMER-->
 '''
+from pkgutil import extend_path
+__path__ = extend_path(__path__, __name__)
+
 import abc
 import builtins
 import datetime

aws_cdk/aws_elasticloadbalancing/__init__.py

@@ -63,6 +63,9 @@ instance = ec2.Instance(self, "targetInstance",
 lb.add_target(elb.InstanceTarget(instance))
 ```
 '''
+from pkgutil import extend_path
+__path__ = extend_path(__path__, __name__)
+
 import abc
 import builtins
 import datetime

aws_cdk/aws_elasticloadbalancingv2/__init__.py

@@ -240,6 +240,23 @@ lb = elbv2.ApplicationLoadBalancer(self, "LB",
 
 For more information, see [Load balancer attributes](https://docs.aws.amazon.com/elasticloadbalancing/latest/application/application-load-balancers.html#load-balancer-attributes)
 
+### Setting up Access Log Bucket on Application Load Balancer
+
+The only server-side encryption option that's supported is Amazon S3-managed keys (SSE-S3). For more information
+Documentation: https://docs.aws.amazon.com/elasticloadbalancing/latest/application/enable-access-logging.html
+
+```python
+# vpc: ec2.Vpc
+
+
+bucket = s3.Bucket(self, "ALBAccessLogsBucket",
+    encryption=s3.BucketEncryption.S3_MANAGED
+)
+
+lb = elbv2.ApplicationLoadBalancer(self, "LB", vpc=vpc)
+lb.log_access_logs(bucket)
+```
+
 ## Defining a Network Load Balancer
 
 Network Load Balancers are defined in a similar way to Application Load
@@ -754,6 +771,9 @@ target_group = elbv2.ApplicationTargetGroup.from_target_group_attributes(self, "
 target_group_metrics = target_group.metrics
 ```
 '''
+from pkgutil import extend_path
+__path__ = extend_path(__path__, __name__)
+
 import abc
 import builtins
 import datetime
@@ -19151,21 +19171,34 @@ class ApplicationLoadBalancerProps(BaseLoadBalancerProps):
 
         Example::
 
-            # cluster: ecs.Cluster
-            # task_definition: ecs.TaskDefinition
+            from aws_cdk.aws_autoscaling import AutoScalingGroup
+            # asg: AutoScalingGroup
             # vpc: ec2.Vpc
             
-            service = ecs.FargateService(self, "Service", cluster=cluster, task_definition=task_definition)
             
-            lb = elbv2.ApplicationLoadBalancer(self, "LB", vpc=vpc, internet_facing=True)
-            listener = lb.add_listener("Listener", port=80)
-            service.register_load_balancer_targets(
-                container_name="web",
-                container_port=80,
-                new_target_group_id="ECS",
-                listener=ecs.ListenerConfig.application_listener(listener,
-                    protocol=elbv2.ApplicationProtocol.HTTPS
-                )
+            # Create the load balancer in a VPC. 'internetFacing' is 'false'
+            # by default, which creates an internal load balancer.
+            lb = elbv2.ApplicationLoadBalancer(self, "LB",
+                vpc=vpc,
+                internet_facing=True
+            )
+            
+            # Add a listener and open up the load balancer's security group
+            # to the world.
+            listener = lb.add_listener("Listener",
+                port=80,
+            
+                # 'open: true' is the default, you can leave it out if you want. Set it
+                # to 'false' and use `listener.connections` if you want to be selective
+                # about who can access the load balancer.
+                open=True
+            )
+            
+            # Create an AutoScaling group and add it as a load balancing
+            # target to the listener.
+            listener.add_targets("ApplicationFleet",
+                port=8080,
+                targets=[asg]
             )
         '''
         if isinstance(vpc_subnets, dict):
@@ -21449,6 +21482,26 @@ class ApplicationLoadBalancer(
             check_type(argname="argument security_group", value=security_group, expected_type=type_hints["security_group"])
         return typing.cast(None, jsii.invoke(self, "addSecurityGroup", [security_group]))
 
+    @jsii.member(jsii_name="logAccessLogs")
+    def log_access_logs(
+        self,
+        bucket: _IBucket_42e086fd,
+        prefix: typing.Optional[builtins.str] = None,
+    ) -> None:
+        '''Enable access logging for this load balancer.
+
+        A region must be specified on the stack containing the load balancer; you cannot enable logging on
+        environment-agnostic stacks. See https://docs.aws.amazon.com/cdk/latest/guide/environments.html
+
+        :param bucket: -
+        :param prefix: -
+        '''
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__14e58136aa424614ad3deed70de619716d36a85a2336e0d16a5d5e3edc8431cd)
+            check_type(argname="argument bucket", value=bucket, expected_type=type_hints["bucket"])
+            check_type(argname="argument prefix", value=prefix, expected_type=type_hints["prefix"])
+        return typing.cast(None, jsii.invoke(self, "logAccessLogs", [bucket, prefix]))
+
     @jsii.member(jsii_name="metric")
     def metric(
         self,
@@ -25435,6 +25488,13 @@ def _typecheckingstub__57e7fd3d637561416b99cc18ce93e12b3ff0fd16aa199643bcfdcb4f3
     """Type checking stubs"""
     pass
 
+def _typecheckingstub__14e58136aa424614ad3deed70de619716d36a85a2336e0d16a5d5e3edc8431cd(
+    bucket: _IBucket_42e086fd,
+    prefix: typing.Optional[builtins.str] = None,
+) -> None:
+    """Type checking stubs"""
+    pass
+
 def _typecheckingstub__062c936e075fbff0552978e79ddc8d8cb01378ba1804b2546d14bd0383a824a0(
     metric_name: builtins.str,
     *,

aws_cdk/aws_elasticloadbalancingv2_actions/__init__.py

@@ -71,6 +71,9 @@ CfnOutput(self, "DNS",
 )
 ```
 '''
+from pkgutil import extend_path
+__path__ = extend_path(__path__, __name__)
+
 import abc
 import builtins
 import datetime

aws_cdk/aws_elasticloadbalancingv2_targets/__init__.py

@@ -3,6 +3,9 @@
 
 This package contains targets for ELBv2. See the README of the `aws-cdk-lib/aws-elasticloadbalancingv2` library.
 '''
+from pkgutil import extend_path
+__path__ = extend_path(__path__, __name__)
+
 import abc
 import builtins
 import datetime

aws_cdk/aws_elasticsearch/__init__.py

@@ -427,6 +427,9 @@ Follow these steps to migrate your application without data loss:
 * Synthesize and deploy your CDK application to reconfigure/recreate the modified dependent resources. The CloudFormation stacks should now contain the same resources as existed prior to migration.
 * Proceed with development as normal!
 '''
+from pkgutil import extend_path
+__path__ = extend_path(__path__, __name__)
+
 import abc
 import builtins
 import datetime

aws_cdk/aws_emr/__init__.py

@@ -25,6 +25,9 @@ For more information on the resources and properties available for this service,
 
 <!--END CFNONLY DISCLAIMER-->
 '''
+from pkgutil import extend_path
+__path__ = extend_path(__path__, __name__)
+
 import abc
 import builtins
 import datetime

aws_cdk/aws_emrcontainers/__init__.py

@@ -25,6 +25,9 @@ For more information on the resources and properties available for this service,
 
 <!--END CFNONLY DISCLAIMER-->
 '''
+from pkgutil import extend_path
+__path__ = extend_path(__path__, __name__)
+
 import abc
 import builtins
 import datetime

aws_cdk/aws_emrserverless/__init__.py

@@ -25,6 +25,9 @@ For more information on the resources and properties available for this service,
 
 <!--END CFNONLY DISCLAIMER-->
 '''
+from pkgutil import extend_path
+__path__ = extend_path(__path__, __name__)
+
 import abc
 import builtins
 import datetime

aws_cdk/aws_entityresolution/__init__.py

@@ -35,6 +35,9 @@ For more information on the resources and properties available for this service,
 
 <!--END CFNONLY DISCLAIMER-->
 '''
+from pkgutil import extend_path
+__path__ = extend_path(__path__, __name__)
+
 import abc
 import builtins
 import datetime
@@ -1705,7 +1708,7 @@ class CfnMatchingWorkflow(
             '''An object which defines the ``resolutionType`` and the ``ruleBasedProperties`` .
 
             :param provider_properties: The properties of the provider service.
-            :param resolution_type: The type of matching. There are two types of matching: ``RULE_MATCHING`` and ``ML_MATCHING`` .
+            :param resolution_type: The type of matching. There are three types of matching: ``RULE_MATCHING`` , ``ML_MATCHING`` , and ``PROVIDER`` .
             :param rule_based_properties: An object which defines the list of matching rules to run and has a field ``Rules`` , which is a list of rule objects.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-entityresolution-matchingworkflow-resolutiontechniques.html
@@ -1767,7 +1770,7 @@ class CfnMatchingWorkflow(
         def resolution_type(self) -> typing.Optional[builtins.str]:
             '''The type of matching.
 
-            There are two types of matching: ``RULE_MATCHING`` and ``ML_MATCHING`` .
+            There are three types of matching: ``RULE_MATCHING`` , ``ML_MATCHING`` , and ``PROVIDER`` .
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-entityresolution-matchingworkflow-resolutiontechniques.html#cfn-entityresolution-matchingworkflow-resolutiontechniques-resolutiontype
             '''

aws_cdk/aws_events/__init__.py

@@ -248,6 +248,9 @@ event_bus = events.EventBus.from_event_bus_arn(self, "ImportedEventBus", "arn:aw
 event_bus.grant_put_events_to(lambda_function)
 ```
 '''
+from pkgutil import extend_path
+__path__ = extend_path(__path__, __name__)
+
 import abc
 import builtins
 import datetime

aws_cdk/aws_events_targets/__init__.py

@@ -480,6 +480,9 @@ rule.add_target(targets.EcsTask(
 ))
 ```
 '''
+from pkgutil import extend_path
+__path__ = extend_path(__path__, __name__)
+
 import abc
 import builtins
 import datetime

aws_cdk/aws_eventschemas/__init__.py

@@ -25,6 +25,9 @@ For more information on the resources and properties available for this service,
 
 <!--END CFNONLY DISCLAIMER-->
 '''
+from pkgutil import extend_path
+__path__ = extend_path(__path__, __name__)
+
 import abc
 import builtins
 import datetime

aws_cdk/aws_evidently/__init__.py

@@ -25,6 +25,9 @@ For more information on the resources and properties available for this service,
 
 <!--END CFNONLY DISCLAIMER-->
 '''
+from pkgutil import extend_path
+__path__ = extend_path(__path__, __name__)
+
 import abc
 import builtins
 import datetime

aws_cdk/aws_finspace/__init__.py

@@ -25,6 +25,9 @@ For more information on the resources and properties available for this service,
 
 <!--END CFNONLY DISCLAIMER-->
 '''
+from pkgutil import extend_path
+__path__ = extend_path(__path__, __name__)
+
 import abc
 import builtins
 import datetime

aws_cdk/aws_fis/__init__.py

@@ -25,6 +25,9 @@ For more information on the resources and properties available for this service,
 
 <!--END CFNONLY DISCLAIMER-->
 '''
+from pkgutil import extend_path
+__path__ = extend_path(__path__, __name__)
+
 import abc
 import builtins
 import datetime

aws_cdk/aws_fms/__init__.py

@@ -25,6 +25,9 @@ For more information on the resources and properties available for this service,
 
 <!--END CFNONLY DISCLAIMER-->
 '''
+from pkgutil import extend_path
+__path__ = extend_path(__path__, __name__)
+
 import abc
 import builtins
 import datetime

aws_cdk/aws_forecast/__init__.py

@@ -25,6 +25,9 @@ For more information on the resources and properties available for this service,
 
 <!--END CFNONLY DISCLAIMER-->
 '''
+from pkgutil import extend_path
+__path__ = extend_path(__path__, __name__)
+
 import abc
 import builtins
 import datetime

aws_cdk/aws_frauddetector/__init__.py

@@ -25,6 +25,9 @@ For more information on the resources and properties available for this service,
 
 <!--END CFNONLY DISCLAIMER-->
 '''
+from pkgutil import extend_path
+__path__ = extend_path(__path__, __name__)
+
 import abc
 import builtins
 import datetime

aws_cdk/aws_fsx/__init__.py

@@ -193,6 +193,9 @@ When you turn data compression on for an existing file system, only newly writte
 The L2 construct for the FSx for Windows File Server has not yet been implemented. To instantiate an FSx for Windows
 file system, the L1 constructs can be used as defined by CloudFormation.
 '''
+from pkgutil import extend_path
+__path__ = extend_path(__path__, __name__)
+
 import abc
 import builtins
 import datetime

aws_cdk/aws_gamelift/__init__.py

@@ -30,6 +30,9 @@ For more information on the resources and properties available for this service,
 
 <!--END CFNONLY DISCLAIMER-->
 '''
+from pkgutil import extend_path
+__path__ = extend_path(__path__, __name__)
+
 import abc
 import builtins
 import datetime

aws_cdk/aws_globalaccelerator/__init__.py

@@ -194,6 +194,9 @@ aga_sg = endpoint_group.connections_peer("GlobalAcceleratorSG", vpc)
 alb.connections.allow_from(aga_sg, ec2.Port.tcp(443))
 ```
 '''
+from pkgutil import extend_path
+__path__ = extend_path(__path__, __name__)
+
 import abc
 import builtins
 import datetime
@@ -1143,7 +1146,7 @@ class CfnEndpointGroup(
             A resource must be valid and active when you add it as an endpoint.
 
             :param endpoint_id: An ID for the endpoint. If the endpoint is a Network Load Balancer or Application Load Balancer, this is the Amazon Resource Name (ARN) of the resource. If the endpoint is an Elastic IP address, this is the Elastic IP address allocation ID. For Amazon EC2 instances, this is the EC2 instance ID. A resource must be valid and active when you add it as an endpoint. For cross-account endpoints, this must be the ARN of the resource.
-            :param attachment_arn: The Amazon Resource Name (ARN) of the cross-account attachment that specifies the endpoints (resources) that can be added to accelerators and principals that have permission to add the endpoints to accelerators.
+            :param attachment_arn: The Amazon Resource Name (ARN) of the cross-account attachment that specifies the endpoints (resources) that can be added to accelerators and principals that have permission to add the endpoints.
             :param client_ip_preservation_enabled: Indicates whether client IP address preservation is enabled for an Application Load Balancer endpoint. The value is true or false. The default value is true for new accelerators. If the value is set to true, the client's IP address is preserved in the ``X-Forwarded-For`` request header as traffic travels to applications on the Application Load Balancer endpoint fronted by the accelerator. For more information, see `Preserve Client IP Addresses <https://docs.aws.amazon.com/global-accelerator/latest/dg/preserve-client-ip-address.html>`_ in the *AWS Global Accelerator Developer Guide* . Default: - true
             :param weight: The weight associated with the endpoint. When you add weights to endpoints, you configure Global Accelerator to route traffic based on proportions that you specify. For example, you might specify endpoint weights of 4, 5, 5, and 6 (sum=20). The result is that 4/20 of your traffic, on average, is routed to the first endpoint, 5/20 is routed both to the second and third endpoints, and 6/20 is routed to the last endpoint. For more information, see `Endpoint Weights <https://docs.aws.amazon.com/global-accelerator/latest/dg/about-endpoints-endpoint-weights.html>`_ in the *AWS Global Accelerator Developer Guide* . Default: - 100
 
@@ -1197,7 +1200,7 @@ class CfnEndpointGroup(
 
         @builtins.property
         def attachment_arn(self) -> typing.Optional[builtins.str]:
-            '''The Amazon Resource Name (ARN) of the cross-account attachment that specifies the endpoints (resources) that can be added to accelerators and principals that have permission to add the endpoints to accelerators.
+            '''The Amazon Resource Name (ARN) of the cross-account attachment that specifies the endpoints (resources) that can be added to accelerators and principals that have permission to add the endpoints.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-globalaccelerator-endpointgroup-endpointconfiguration.html#cfn-globalaccelerator-endpointgroup-endpointconfiguration-attachmentarn
             '''

aws_cdk/aws_globalaccelerator_endpoints/__init__.py

@@ -9,6 +9,9 @@ See the README of the `aws-cdk-lib/aws-globalaccelerator` library for more infor
 AWS Global Accelerator, and examples of all the integration classes available in
 this module.
 '''
+from pkgutil import extend_path
+__path__ = extend_path(__path__, __name__)
+
 import abc
 import builtins
 import datetime