aws-cdk-lib 2.141.0__py3-none-any.whl → 2.142.0__py3-none-any.whl

aws_cdk/aws_ecs/__init__.py

@@ -384,12 +384,13 @@ fargate_task_definition = ecs.FargateTaskDefinition(self, "TaskDef",
     ),
     memory_limit_mi_b=512,
     cpu=256,
-    pid_mode=ecs.PidMode.HOST
+    pid_mode=ecs.PidMode.TASK
 )
 ```
 
 **Note:** `pidMode` is only supported for tasks that are hosted on AWS Fargate if the tasks are using platform version 1.4.0
-or later (Linux). This isn't supported for Windows containers on Fargate.
+or later (Linux). Only the `task` option is supported for Linux containers. `pidMode` isn't supported for Windows containers on Fargate.
+If `pidMode` is specified for a Fargate task, then `runtimePlatform.operatingSystemFamily` must also be specified.
 
 To add containers to a task definition, call `addContainer()`:
 
@@ -1971,6 +1972,7 @@ from ..aws_cloudwatch import (
 from ..aws_ec2 import (
     Connections as _Connections_0f31fce8,
     EbsDeviceVolumeType as _EbsDeviceVolumeType_6792555b,
+    IKeyPair as _IKeyPair_bc344eda,
     IMachineImage as _IMachineImage_0e8bd50b,
     ISecurityGroup as _ISecurityGroup_acf8a799,
     IVpc as _IVpc_f30d5663,
@@ -2174,6 +2176,7 @@ class AddAutoScalingGroupCapacityOptions:
         "ignore_unmodified_size_properties": "ignoreUnmodifiedSizeProperties",
         "instance_monitoring": "instanceMonitoring",
         "key_name": "keyName",
+        "key_pair": "keyPair",
         "max_capacity": "maxCapacity",
         "max_instance_lifetime": "maxInstanceLifetime",
         "min_capacity": "minCapacity",
@@ -2214,6 +2217,7 @@ class AddCapacityOptions(
         ignore_unmodified_size_properties: typing.Optional[builtins.bool] = None,
         instance_monitoring: typing.Optional[_Monitoring_50020f91] = None,
         key_name: typing.Optional[builtins.str] = None,
+        key_pair: typing.Optional[_IKeyPair_bc344eda] = None,
         max_capacity: typing.Optional[jsii.Number] = None,
         max_instance_lifetime: typing.Optional[_Duration_4839e8c3] = None,
         min_capacity: typing.Optional[jsii.Number] = None,
@@ -2247,7 +2251,8 @@ class AddCapacityOptions(
         :param health_check: Configuration for health checks. Default: - HealthCheck.ec2 with no grace period
         :param ignore_unmodified_size_properties: If the ASG has scheduled actions, don't reset unchanged group sizes. Only used if the ASG has scheduled actions (which may scale your ASG up or down regardless of cdk deployments). If true, the size of the group will only be reset if it has been changed in the CDK app. If false, the sizes will always be changed back to what they were in the CDK app on deployment. Default: true
         :param instance_monitoring: Controls whether instances in this group are launched with detailed or basic monitoring. When detailed monitoring is enabled, Amazon CloudWatch generates metrics every minute and your account is charged a fee. When you disable detailed monitoring, CloudWatch generates metrics every 5 minutes. ``launchTemplate`` and ``mixedInstancesPolicy`` must not be specified when this property is specified Default: - Monitoring.DETAILED
-        :param key_name: Name of SSH keypair to grant access to instances. ``launchTemplate`` and ``mixedInstancesPolicy`` must not be specified when this property is specified Default: - No SSH access will be possible.
+        :param key_name: (deprecated) Name of SSH keypair to grant access to instances. ``launchTemplate`` and ``mixedInstancesPolicy`` must not be specified when this property is specified You can either specify ``keyPair`` or ``keyName``, not both. Default: - No SSH access will be possible.
+        :param key_pair: The SSH keypair to grant access to the instance. Feature flag ``AUTOSCALING_GENERATE_LAUNCH_TEMPLATE`` must be enabled to use this property. ``launchTemplate`` and ``mixedInstancesPolicy`` must not be specified when this property is specified. You can either specify ``keyPair`` or ``keyName``, not both. Default: - No SSH access will be possible.
         :param max_capacity: Maximum number of instances in the fleet. Default: desiredCapacity
         :param max_instance_lifetime: The maximum amount of time that an instance can be in service. The maximum duration applies to all current and future instances in the group. As an instance approaches its maximum duration, it is terminated and replaced, and cannot be used again. You must specify a value of at least 604,800 seconds (7 days). To clear a previously set value, leave this property undefined. Default: none
         :param min_capacity: Minimum number of instances in the fleet. Default: 1
@@ -2297,6 +2302,7 @@ class AddCapacityOptions(
             check_type(argname="argument ignore_unmodified_size_properties", value=ignore_unmodified_size_properties, expected_type=type_hints["ignore_unmodified_size_properties"])
             check_type(argname="argument instance_monitoring", value=instance_monitoring, expected_type=type_hints["instance_monitoring"])
             check_type(argname="argument key_name", value=key_name, expected_type=type_hints["key_name"])
+            check_type(argname="argument key_pair", value=key_pair, expected_type=type_hints["key_pair"])
             check_type(argname="argument max_capacity", value=max_capacity, expected_type=type_hints["max_capacity"])
             check_type(argname="argument max_instance_lifetime", value=max_instance_lifetime, expected_type=type_hints["max_instance_lifetime"])
             check_type(argname="argument min_capacity", value=min_capacity, expected_type=type_hints["min_capacity"])
@@ -2348,6 +2354,8 @@ class AddCapacityOptions(
             self._values["instance_monitoring"] = instance_monitoring
         if key_name is not None:
             self._values["key_name"] = key_name
+        if key_pair is not None:
+            self._values["key_pair"] = key_pair
         if max_capacity is not None:
             self._values["max_capacity"] = max_capacity
         if max_instance_lifetime is not None:
@@ -2582,15 +2590,36 @@ class AddCapacityOptions(
 
     @builtins.property
     def key_name(self) -> typing.Optional[builtins.str]:
-        '''Name of SSH keypair to grant access to instances.
+        '''(deprecated) Name of SSH keypair to grant access to instances.
 
         ``launchTemplate`` and ``mixedInstancesPolicy`` must not be specified when this property is specified
 
+        You can either specify ``keyPair`` or ``keyName``, not both.
+
         :default: - No SSH access will be possible.
+
+        :deprecated: - Use ``keyPair`` instead - https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.aws_ec2-readme.html#using-an-existing-ec2-key-pair
+
+        :stability: deprecated
         '''
         result = self._values.get("key_name")
         return typing.cast(typing.Optional[builtins.str], result)
 
+    @builtins.property
+    def key_pair(self) -> typing.Optional[_IKeyPair_bc344eda]:
+        '''The SSH keypair to grant access to the instance.
+
+        Feature flag ``AUTOSCALING_GENERATE_LAUNCH_TEMPLATE`` must be enabled to use this property.
+
+        ``launchTemplate`` and ``mixedInstancesPolicy`` must not be specified when this property is specified.
+
+        You can either specify ``keyPair`` or ``keyName``, not both.
+
+        :default: - No SSH access will be possible.
+        '''
+        result = self._values.get("key_pair")
+        return typing.cast(typing.Optional[_IKeyPair_bc344eda], result)
+
     @builtins.property
     def max_capacity(self) -> typing.Optional[jsii.Number]:
         '''Maximum number of instances in the fleet.
@@ -26056,7 +26085,7 @@ class FargateTaskDefinitionProps(CommonTaskDefinitionProps):
         :param cpu: The number of cpu units used by the task. For tasks using the Fargate launch type, this field is required and you must use one of the following values, which determines your range of valid values for the memory parameter: 256 (.25 vCPU) - Available memory values: 512 (0.5 GB), 1024 (1 GB), 2048 (2 GB) 512 (.5 vCPU) - Available memory values: 1024 (1 GB), 2048 (2 GB), 3072 (3 GB), 4096 (4 GB) 1024 (1 vCPU) - Available memory values: 2048 (2 GB), 3072 (3 GB), 4096 (4 GB), 5120 (5 GB), 6144 (6 GB), 7168 (7 GB), 8192 (8 GB) 2048 (2 vCPU) - Available memory values: Between 4096 (4 GB) and 16384 (16 GB) in increments of 1024 (1 GB) 4096 (4 vCPU) - Available memory values: Between 8192 (8 GB) and 30720 (30 GB) in increments of 1024 (1 GB) 8192 (8 vCPU) - Available memory values: Between 16384 (16 GB) and 61440 (60 GB) in increments of 4096 (4 GB) 16384 (16 vCPU) - Available memory values: Between 32768 (32 GB) and 122880 (120 GB) in increments of 8192 (8 GB) Default: 256
         :param ephemeral_storage_gib: The amount (in GiB) of ephemeral storage to be allocated to the task. The maximum supported value is 200 GiB. NOTE: This parameter is only supported for tasks hosted on AWS Fargate using platform version 1.4.0 or later. Default: 20
         :param memory_limit_mib: The amount (in MiB) of memory used by the task. For tasks using the Fargate launch type, this field is required and you must use one of the following values, which determines your range of valid values for the cpu parameter: 512 (0.5 GB), 1024 (1 GB), 2048 (2 GB) - Available cpu values: 256 (.25 vCPU) 1024 (1 GB), 2048 (2 GB), 3072 (3 GB), 4096 (4 GB) - Available cpu values: 512 (.5 vCPU) 2048 (2 GB), 3072 (3 GB), 4096 (4 GB), 5120 (5 GB), 6144 (6 GB), 7168 (7 GB), 8192 (8 GB) - Available cpu values: 1024 (1 vCPU) Between 4096 (4 GB) and 16384 (16 GB) in increments of 1024 (1 GB) - Available cpu values: 2048 (2 vCPU) Between 8192 (8 GB) and 30720 (30 GB) in increments of 1024 (1 GB) - Available cpu values: 4096 (4 vCPU) Between 16384 (16 GB) and 61440 (60 GB) in increments of 4096 (4 GB) - Available cpu values: 8192 (8 vCPU) Between 32768 (32 GB) and 122880 (120 GB) in increments of 8192 (8 GB) - Available cpu values: 16384 (16 vCPU) Default: 512
-        :param pid_mode: The process namespace to use for the containers in the task. Only supported for tasks that are hosted on AWS Fargate if the tasks are using platform version 1.4.0 or later (Linux). Not supported in Windows containers. Default: - PidMode used by the task is not specified
+        :param pid_mode: The process namespace to use for the containers in the task. Only supported for tasks that are hosted on AWS Fargate if the tasks are using platform version 1.4.0 or later (Linux). Only the TASK option is supported for Linux-based Fargate containers. Not supported in Windows containers. If pidMode is specified for a Fargate task, then runtimePlatform.operatingSystemFamily must also be specified. For more information, see `Task Definition Parameters <https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task_definition_parameters.html#task_definition_pidmode>`_. Default: - PidMode used by the task is not specified
         :param runtime_platform: The operating system that your task definitions are running on. A runtimePlatform is supported only for tasks using the Fargate launch type. Default: - Undefined.
 
         :exampleMetadata: infused
@@ -26070,7 +26099,7 @@ class FargateTaskDefinitionProps(CommonTaskDefinitionProps):
                 ),
                 memory_limit_mi_b=512,
                 cpu=256,
-                pid_mode=ecs.PidMode.HOST
+                pid_mode=ecs.PidMode.TASK
             )
         '''
         if isinstance(runtime_platform, dict):
@@ -26232,8 +26261,11 @@ class FargateTaskDefinitionProps(CommonTaskDefinitionProps):
         '''The process namespace to use for the containers in the task.
 
         Only supported for tasks that are hosted on AWS Fargate if the tasks
-        are using platform version 1.4.0 or later (Linux).
-        Not supported in Windows containers.
+        are using platform version 1.4.0 or later (Linux).  Only the TASK option
+        is supported for Linux-based Fargate containers. Not supported in
+        Windows containers. If pidMode is specified for a Fargate task, then
+        runtimePlatform.operatingSystemFamily must also be specified.  For more
+        information, see `Task Definition Parameters <https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task_definition_parameters.html#task_definition_pidmode>`_.
 
         :default: - PidMode used by the task is not specified
         '''
@@ -31351,9 +31383,14 @@ class OperatingSystemFamily(
             check_type(argname="argument family", value=family, expected_type=type_hints["family"])
         return typing.cast("OperatingSystemFamily", jsii.sinvoke(cls, "of", [family]))
 
+    @jsii.member(jsii_name="isLinux")
+    def is_linux(self) -> builtins.bool:
+        '''Indicates whether the operating system family is Linux.'''
+        return typing.cast(builtins.bool, jsii.invoke(self, "isLinux", []))
+
     @jsii.member(jsii_name="isWindows")
     def is_windows(self) -> builtins.bool:
-        '''Returns true if the operating system family is Windows.'''
+        '''Indicates whether the operating system family is Windows.'''
         return typing.cast(builtins.bool, jsii.invoke(self, "isWindows", []))
 
     @jsii.python.classproperty
@@ -31420,7 +31457,7 @@ class PidMode(enum.Enum):
             ),
             memory_limit_mi_b=512,
             cpu=256,
-            pid_mode=ecs.PidMode.HOST
+            pid_mode=ecs.PidMode.TASK
         )
     '''
 
@@ -35190,7 +35227,7 @@ class TaskDefinition(
         :param ipc_mode: The IPC resource namespace to use for the containers in the task. Not supported in Fargate and Windows containers. Default: - IpcMode used by the task is not specified
         :param memory_mib: The amount (in MiB) of memory used by the task. If using the EC2 launch type, this field is optional and any value can be used. If using the Fargate launch type, this field is required and you must use one of the following values, which determines your range of valid values for the cpu parameter: 512 (0.5 GB), 1024 (1 GB), 2048 (2 GB) - Available cpu values: 256 (.25 vCPU) 1024 (1 GB), 2048 (2 GB), 3072 (3 GB), 4096 (4 GB) - Available cpu values: 512 (.5 vCPU) 2048 (2 GB), 3072 (3 GB), 4096 (4 GB), 5120 (5 GB), 6144 (6 GB), 7168 (7 GB), 8192 (8 GB) - Available cpu values: 1024 (1 vCPU) Between 4096 (4 GB) and 16384 (16 GB) in increments of 1024 (1 GB) - Available cpu values: 2048 (2 vCPU) Between 8192 (8 GB) and 30720 (30 GB) in increments of 1024 (1 GB) - Available cpu values: 4096 (4 vCPU) Between 16384 (16 GB) and 61440 (60 GB) in increments of 4096 (4 GB) - Available cpu values: 8192 (8 vCPU) Between 32768 (32 GB) and 122880 (120 GB) in increments of 8192 (8 GB) - Available cpu values: 16384 (16 vCPU) Default: - Memory used by task is not specified.
         :param network_mode: The networking mode to use for the containers in the task. On Fargate, the only supported networking mode is AwsVpc. Default: - NetworkMode.Bridge for EC2 & External tasks, AwsVpc for Fargate tasks.
-        :param pid_mode: The process namespace to use for the containers in the task. Only supported for tasks that are hosted on AWS Fargate if the tasks are using platform version 1.4.0 or later (Linux). Not supported in Windows containers. Default: - PidMode used by the task is not specified
+        :param pid_mode: The process namespace to use for the containers in the task. Only supported for tasks that are hosted on AWS Fargate if the tasks are using platform version 1.4.0 or later (Linux). Only the TASK option is supported for Linux-based Fargate containers. Not supported in Windows containers. If pidMode is specified for a Fargate task, then runtimePlatform.operatingSystemFamily must also be specified. For more information, see `Task Definition Parameters <https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task_definition_parameters.html#task_definition_pidmode>`_. Default: - PidMode used by the task is not specified
         :param placement_constraints: The placement constraints to use for tasks in the service. You can specify a maximum of 10 constraints per task (this limit includes constraints in the task definition and those specified at run time). Not supported in Fargate. Default: - No placement constraints.
         :param runtime_platform: The operating system that your task definitions are running on. A runtimePlatform is supported only for tasks using the Fargate launch type. Default: - Undefined.
         :param execution_role: The name of the IAM task execution role that grants the ECS agent permission to call AWS APIs on your behalf. The role will be used to retrieve container images from ECR and create CloudWatch log groups. Default: - An execution role will be automatically created if you use ECR images in your task definition.
@@ -35766,8 +35803,10 @@ class TaskDefinition(
         '''The process namespace to use for the containers in the task.
 
         Only supported for tasks that are hosted on AWS Fargate if the tasks
-        are using platform version 1.4.0 or later (Linux).
-        Not supported in Windows containers.
+        are using platform version 1.4.0 or later (Linux). Not supported in
+        Windows containers. If pidMode is specified for a Fargate task,
+        then runtimePlatform.operatingSystemFamily must also be specified.  For more
+        information, see `Task Definition Parameters <https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task_definition_parameters.html#task_definition_pidmode>`_.
         '''
         return typing.cast(typing.Optional[PidMode], jsii.get(self, "pidMode"))
 
@@ -35977,7 +36016,7 @@ class TaskDefinitionProps(CommonTaskDefinitionProps):
         :param ipc_mode: The IPC resource namespace to use for the containers in the task. Not supported in Fargate and Windows containers. Default: - IpcMode used by the task is not specified
         :param memory_mib: The amount (in MiB) of memory used by the task. If using the EC2 launch type, this field is optional and any value can be used. If using the Fargate launch type, this field is required and you must use one of the following values, which determines your range of valid values for the cpu parameter: 512 (0.5 GB), 1024 (1 GB), 2048 (2 GB) - Available cpu values: 256 (.25 vCPU) 1024 (1 GB), 2048 (2 GB), 3072 (3 GB), 4096 (4 GB) - Available cpu values: 512 (.5 vCPU) 2048 (2 GB), 3072 (3 GB), 4096 (4 GB), 5120 (5 GB), 6144 (6 GB), 7168 (7 GB), 8192 (8 GB) - Available cpu values: 1024 (1 vCPU) Between 4096 (4 GB) and 16384 (16 GB) in increments of 1024 (1 GB) - Available cpu values: 2048 (2 vCPU) Between 8192 (8 GB) and 30720 (30 GB) in increments of 1024 (1 GB) - Available cpu values: 4096 (4 vCPU) Between 16384 (16 GB) and 61440 (60 GB) in increments of 4096 (4 GB) - Available cpu values: 8192 (8 vCPU) Between 32768 (32 GB) and 122880 (120 GB) in increments of 8192 (8 GB) - Available cpu values: 16384 (16 vCPU) Default: - Memory used by task is not specified.
         :param network_mode: The networking mode to use for the containers in the task. On Fargate, the only supported networking mode is AwsVpc. Default: - NetworkMode.Bridge for EC2 & External tasks, AwsVpc for Fargate tasks.
-        :param pid_mode: The process namespace to use for the containers in the task. Only supported for tasks that are hosted on AWS Fargate if the tasks are using platform version 1.4.0 or later (Linux). Not supported in Windows containers. Default: - PidMode used by the task is not specified
+        :param pid_mode: The process namespace to use for the containers in the task. Only supported for tasks that are hosted on AWS Fargate if the tasks are using platform version 1.4.0 or later (Linux). Only the TASK option is supported for Linux-based Fargate containers. Not supported in Windows containers. If pidMode is specified for a Fargate task, then runtimePlatform.operatingSystemFamily must also be specified. For more information, see `Task Definition Parameters <https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task_definition_parameters.html#task_definition_pidmode>`_. Default: - PidMode used by the task is not specified
         :param placement_constraints: The placement constraints to use for tasks in the service. You can specify a maximum of 10 constraints per task (this limit includes constraints in the task definition and those specified at run time). Not supported in Fargate. Default: - No placement constraints.
         :param runtime_platform: The operating system that your task definitions are running on. A runtimePlatform is supported only for tasks using the Fargate launch type. Default: - Undefined.
 
@@ -36230,8 +36269,11 @@ class TaskDefinitionProps(CommonTaskDefinitionProps):
         '''The process namespace to use for the containers in the task.
 
         Only supported for tasks that are hosted on AWS Fargate if the tasks
-        are using platform version 1.4.0 or later (Linux).
-        Not supported in Windows containers.
+        are using platform version 1.4.0 or later (Linux). Only the TASK option
+        is supported for Linux-based Fargate containers. Not supported in Windows
+        containers. If pidMode is specified for a Fargate task, then
+        runtimePlatform.operatingSystemFamily must also be specified.  For more
+        information, see `Task Definition Parameters <https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task_definition_parameters.html#task_definition_pidmode>`_.
 
         :default: - PidMode used by the task is not specified
         '''
@@ -37649,6 +37691,7 @@ class Cluster(
         ignore_unmodified_size_properties: typing.Optional[builtins.bool] = None,
         instance_monitoring: typing.Optional[_Monitoring_50020f91] = None,
         key_name: typing.Optional[builtins.str] = None,
+        key_pair: typing.Optional[_IKeyPair_bc344eda] = None,
         max_capacity: typing.Optional[jsii.Number] = None,
         max_instance_lifetime: typing.Optional[_Duration_4839e8c3] = None,
         min_capacity: typing.Optional[jsii.Number] = None,
@@ -37687,7 +37730,8 @@ class Cluster(
         :param health_check: Configuration for health checks. Default: - HealthCheck.ec2 with no grace period
         :param ignore_unmodified_size_properties: If the ASG has scheduled actions, don't reset unchanged group sizes. Only used if the ASG has scheduled actions (which may scale your ASG up or down regardless of cdk deployments). If true, the size of the group will only be reset if it has been changed in the CDK app. If false, the sizes will always be changed back to what they were in the CDK app on deployment. Default: true
         :param instance_monitoring: Controls whether instances in this group are launched with detailed or basic monitoring. When detailed monitoring is enabled, Amazon CloudWatch generates metrics every minute and your account is charged a fee. When you disable detailed monitoring, CloudWatch generates metrics every 5 minutes. ``launchTemplate`` and ``mixedInstancesPolicy`` must not be specified when this property is specified Default: - Monitoring.DETAILED
-        :param key_name: Name of SSH keypair to grant access to instances. ``launchTemplate`` and ``mixedInstancesPolicy`` must not be specified when this property is specified Default: - No SSH access will be possible.
+        :param key_name: (deprecated) Name of SSH keypair to grant access to instances. ``launchTemplate`` and ``mixedInstancesPolicy`` must not be specified when this property is specified You can either specify ``keyPair`` or ``keyName``, not both. Default: - No SSH access will be possible.
+        :param key_pair: The SSH keypair to grant access to the instance. Feature flag ``AUTOSCALING_GENERATE_LAUNCH_TEMPLATE`` must be enabled to use this property. ``launchTemplate`` and ``mixedInstancesPolicy`` must not be specified when this property is specified. You can either specify ``keyPair`` or ``keyName``, not both. Default: - No SSH access will be possible.
         :param max_capacity: Maximum number of instances in the fleet. Default: desiredCapacity
         :param max_instance_lifetime: The maximum amount of time that an instance can be in service. The maximum duration applies to all current and future instances in the group. As an instance approaches its maximum duration, it is terminated and replaced, and cannot be used again. You must specify a value of at least 604,800 seconds (7 days). To clear a previously set value, leave this property undefined. Default: none
         :param min_capacity: Minimum number of instances in the fleet. Default: 1
@@ -37724,6 +37768,7 @@ class Cluster(
             ignore_unmodified_size_properties=ignore_unmodified_size_properties,
             instance_monitoring=instance_monitoring,
             key_name=key_name,
+            key_pair=key_pair,
             max_capacity=max_capacity,
             max_instance_lifetime=max_instance_lifetime,
             min_capacity=min_capacity,
@@ -40506,7 +40551,7 @@ class FargateTaskDefinition(
         :param cpu: The number of cpu units used by the task. For tasks using the Fargate launch type, this field is required and you must use one of the following values, which determines your range of valid values for the memory parameter: 256 (.25 vCPU) - Available memory values: 512 (0.5 GB), 1024 (1 GB), 2048 (2 GB) 512 (.5 vCPU) - Available memory values: 1024 (1 GB), 2048 (2 GB), 3072 (3 GB), 4096 (4 GB) 1024 (1 vCPU) - Available memory values: 2048 (2 GB), 3072 (3 GB), 4096 (4 GB), 5120 (5 GB), 6144 (6 GB), 7168 (7 GB), 8192 (8 GB) 2048 (2 vCPU) - Available memory values: Between 4096 (4 GB) and 16384 (16 GB) in increments of 1024 (1 GB) 4096 (4 vCPU) - Available memory values: Between 8192 (8 GB) and 30720 (30 GB) in increments of 1024 (1 GB) 8192 (8 vCPU) - Available memory values: Between 16384 (16 GB) and 61440 (60 GB) in increments of 4096 (4 GB) 16384 (16 vCPU) - Available memory values: Between 32768 (32 GB) and 122880 (120 GB) in increments of 8192 (8 GB) Default: 256
         :param ephemeral_storage_gib: The amount (in GiB) of ephemeral storage to be allocated to the task. The maximum supported value is 200 GiB. NOTE: This parameter is only supported for tasks hosted on AWS Fargate using platform version 1.4.0 or later. Default: 20
         :param memory_limit_mib: The amount (in MiB) of memory used by the task. For tasks using the Fargate launch type, this field is required and you must use one of the following values, which determines your range of valid values for the cpu parameter: 512 (0.5 GB), 1024 (1 GB), 2048 (2 GB) - Available cpu values: 256 (.25 vCPU) 1024 (1 GB), 2048 (2 GB), 3072 (3 GB), 4096 (4 GB) - Available cpu values: 512 (.5 vCPU) 2048 (2 GB), 3072 (3 GB), 4096 (4 GB), 5120 (5 GB), 6144 (6 GB), 7168 (7 GB), 8192 (8 GB) - Available cpu values: 1024 (1 vCPU) Between 4096 (4 GB) and 16384 (16 GB) in increments of 1024 (1 GB) - Available cpu values: 2048 (2 vCPU) Between 8192 (8 GB) and 30720 (30 GB) in increments of 1024 (1 GB) - Available cpu values: 4096 (4 vCPU) Between 16384 (16 GB) and 61440 (60 GB) in increments of 4096 (4 GB) - Available cpu values: 8192 (8 vCPU) Between 32768 (32 GB) and 122880 (120 GB) in increments of 8192 (8 GB) - Available cpu values: 16384 (16 vCPU) Default: 512
-        :param pid_mode: The process namespace to use for the containers in the task. Only supported for tasks that are hosted on AWS Fargate if the tasks are using platform version 1.4.0 or later (Linux). Not supported in Windows containers. Default: - PidMode used by the task is not specified
+        :param pid_mode: The process namespace to use for the containers in the task. Only supported for tasks that are hosted on AWS Fargate if the tasks are using platform version 1.4.0 or later (Linux). Only the TASK option is supported for Linux-based Fargate containers. Not supported in Windows containers. If pidMode is specified for a Fargate task, then runtimePlatform.operatingSystemFamily must also be specified. For more information, see `Task Definition Parameters <https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task_definition_parameters.html#task_definition_pidmode>`_. Default: - PidMode used by the task is not specified
         :param runtime_platform: The operating system that your task definitions are running on. A runtimePlatform is supported only for tasks using the Fargate launch type. Default: - Undefined.
         :param execution_role: The name of the IAM task execution role that grants the ECS agent permission to call AWS APIs on your behalf. The role will be used to retrieve container images from ECR and create CloudWatch log groups. Default: - An execution role will be automatically created if you use ECR images in your task definition.
         :param family: The name of a family that this task definition is registered to. A family groups multiple versions of a task definition. Default: - Automatically generated name.
@@ -40839,6 +40884,7 @@ def _typecheckingstub__64f2d9b3495e3be78346f77d5ad90928968c8ce230e670b6279dc67ad
     ignore_unmodified_size_properties: typing.Optional[builtins.bool] = None,
     instance_monitoring: typing.Optional[_Monitoring_50020f91] = None,
     key_name: typing.Optional[builtins.str] = None,
+    key_pair: typing.Optional[_IKeyPair_bc344eda] = None,
     max_capacity: typing.Optional[jsii.Number] = None,
     max_instance_lifetime: typing.Optional[_Duration_4839e8c3] = None,
     min_capacity: typing.Optional[jsii.Number] = None,
@@ -44488,6 +44534,7 @@ def _typecheckingstub__63e98e008463515927d4aee3c938d64639e34ce8a2c09fa766883be6a
     ignore_unmodified_size_properties: typing.Optional[builtins.bool] = None,
     instance_monitoring: typing.Optional[_Monitoring_50020f91] = None,
     key_name: typing.Optional[builtins.str] = None,
+    key_pair: typing.Optional[_IKeyPair_bc344eda] = None,
     max_capacity: typing.Optional[jsii.Number] = None,
     max_instance_lifetime: typing.Optional[_Duration_4839e8c3] = None,
     min_capacity: typing.Optional[jsii.Number] = None,

aws_cdk/aws_eks/__init__.py

@@ -1813,6 +1813,7 @@ from ..aws_autoscaling import (
 from ..aws_ec2 import (
     Connections as _Connections_0f31fce8,
     IConnectable as _IConnectable_10015a05,
+    IKeyPair as _IKeyPair_bc344eda,
     IMachineImage as _IMachineImage_0e8bd50b,
     ISecurityGroup as _ISecurityGroup_acf8a799,
     ISubnet as _ISubnet_d57d1229,
@@ -2401,6 +2402,7 @@ class AlbScheme(enum.Enum):
         "ignore_unmodified_size_properties": "ignoreUnmodifiedSizeProperties",
         "instance_monitoring": "instanceMonitoring",
         "key_name": "keyName",
+        "key_pair": "keyPair",
         "max_capacity": "maxCapacity",
         "max_instance_lifetime": "maxInstanceLifetime",
         "min_capacity": "minCapacity",
@@ -2438,6 +2440,7 @@ class AutoScalingGroupCapacityOptions(_CommonAutoScalingGroupProps_808bbf2d):
         ignore_unmodified_size_properties: typing.Optional[builtins.bool] = None,
         instance_monitoring: typing.Optional[_Monitoring_50020f91] = None,
         key_name: typing.Optional[builtins.str] = None,
+        key_pair: typing.Optional[_IKeyPair_bc344eda] = None,
         max_capacity: typing.Optional[jsii.Number] = None,
         max_instance_lifetime: typing.Optional[_Duration_4839e8c3] = None,
         min_capacity: typing.Optional[jsii.Number] = None,
@@ -2471,7 +2474,8 @@ class AutoScalingGroupCapacityOptions(_CommonAutoScalingGroupProps_808bbf2d):
         :param health_check: Configuration for health checks. Default: - HealthCheck.ec2 with no grace period
         :param ignore_unmodified_size_properties: If the ASG has scheduled actions, don't reset unchanged group sizes. Only used if the ASG has scheduled actions (which may scale your ASG up or down regardless of cdk deployments). If true, the size of the group will only be reset if it has been changed in the CDK app. If false, the sizes will always be changed back to what they were in the CDK app on deployment. Default: true
         :param instance_monitoring: Controls whether instances in this group are launched with detailed or basic monitoring. When detailed monitoring is enabled, Amazon CloudWatch generates metrics every minute and your account is charged a fee. When you disable detailed monitoring, CloudWatch generates metrics every 5 minutes. ``launchTemplate`` and ``mixedInstancesPolicy`` must not be specified when this property is specified Default: - Monitoring.DETAILED
-        :param key_name: Name of SSH keypair to grant access to instances. ``launchTemplate`` and ``mixedInstancesPolicy`` must not be specified when this property is specified Default: - No SSH access will be possible.
+        :param key_name: (deprecated) Name of SSH keypair to grant access to instances. ``launchTemplate`` and ``mixedInstancesPolicy`` must not be specified when this property is specified You can either specify ``keyPair`` or ``keyName``, not both. Default: - No SSH access will be possible.
+        :param key_pair: The SSH keypair to grant access to the instance. Feature flag ``AUTOSCALING_GENERATE_LAUNCH_TEMPLATE`` must be enabled to use this property. ``launchTemplate`` and ``mixedInstancesPolicy`` must not be specified when this property is specified. You can either specify ``keyPair`` or ``keyName``, not both. Default: - No SSH access will be possible.
         :param max_capacity: Maximum number of instances in the fleet. Default: desiredCapacity
         :param max_instance_lifetime: The maximum amount of time that an instance can be in service. The maximum duration applies to all current and future instances in the group. As an instance approaches its maximum duration, it is terminated and replaced, and cannot be used again. You must specify a value of at least 604,800 seconds (7 days). To clear a previously set value, leave this property undefined. Default: none
         :param min_capacity: Minimum number of instances in the fleet. Default: 1
@@ -2522,6 +2526,7 @@ class AutoScalingGroupCapacityOptions(_CommonAutoScalingGroupProps_808bbf2d):
             check_type(argname="argument ignore_unmodified_size_properties", value=ignore_unmodified_size_properties, expected_type=type_hints["ignore_unmodified_size_properties"])
             check_type(argname="argument instance_monitoring", value=instance_monitoring, expected_type=type_hints["instance_monitoring"])
             check_type(argname="argument key_name", value=key_name, expected_type=type_hints["key_name"])
+            check_type(argname="argument key_pair", value=key_pair, expected_type=type_hints["key_pair"])
             check_type(argname="argument max_capacity", value=max_capacity, expected_type=type_hints["max_capacity"])
             check_type(argname="argument max_instance_lifetime", value=max_instance_lifetime, expected_type=type_hints["max_instance_lifetime"])
             check_type(argname="argument min_capacity", value=min_capacity, expected_type=type_hints["min_capacity"])
@@ -2569,6 +2574,8 @@ class AutoScalingGroupCapacityOptions(_CommonAutoScalingGroupProps_808bbf2d):
             self._values["instance_monitoring"] = instance_monitoring
         if key_name is not None:
             self._values["key_name"] = key_name
+        if key_pair is not None:
+            self._values["key_pair"] = key_pair
         if max_capacity is not None:
             self._values["max_capacity"] = max_capacity
         if max_instance_lifetime is not None:
@@ -2765,15 +2772,36 @@ class AutoScalingGroupCapacityOptions(_CommonAutoScalingGroupProps_808bbf2d):
 
     @builtins.property
     def key_name(self) -> typing.Optional[builtins.str]:
-        '''Name of SSH keypair to grant access to instances.
+        '''(deprecated) Name of SSH keypair to grant access to instances.
 
         ``launchTemplate`` and ``mixedInstancesPolicy`` must not be specified when this property is specified
 
+        You can either specify ``keyPair`` or ``keyName``, not both.
+
         :default: - No SSH access will be possible.
+
+        :deprecated: - Use ``keyPair`` instead - https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.aws_ec2-readme.html#using-an-existing-ec2-key-pair
+
+        :stability: deprecated
         '''
         result = self._values.get("key_name")
         return typing.cast(typing.Optional[builtins.str], result)
 
+    @builtins.property
+    def key_pair(self) -> typing.Optional[_IKeyPair_bc344eda]:
+        '''The SSH keypair to grant access to the instance.
+
+        Feature flag ``AUTOSCALING_GENERATE_LAUNCH_TEMPLATE`` must be enabled to use this property.
+
+        ``launchTemplate`` and ``mixedInstancesPolicy`` must not be specified when this property is specified.
+
+        You can either specify ``keyPair`` or ``keyName``, not both.
+
+        :default: - No SSH access will be possible.
+        '''
+        result = self._values.get("key_pair")
+        return typing.cast(typing.Optional[_IKeyPair_bc344eda], result)
+
     @builtins.property
     def max_capacity(self) -> typing.Optional[jsii.Number]:
         '''Maximum number of instances in the fleet.
@@ -15325,6 +15353,7 @@ class Cluster(
         ignore_unmodified_size_properties: typing.Optional[builtins.bool] = None,
         instance_monitoring: typing.Optional[_Monitoring_50020f91] = None,
         key_name: typing.Optional[builtins.str] = None,
+        key_pair: typing.Optional[_IKeyPair_bc344eda] = None,
         max_capacity: typing.Optional[jsii.Number] = None,
         max_instance_lifetime: typing.Optional[_Duration_4839e8c3] = None,
         min_capacity: typing.Optional[jsii.Number] = None,
@@ -15371,7 +15400,8 @@ class Cluster(
         :param health_check: Configuration for health checks. Default: - HealthCheck.ec2 with no grace period
         :param ignore_unmodified_size_properties: If the ASG has scheduled actions, don't reset unchanged group sizes. Only used if the ASG has scheduled actions (which may scale your ASG up or down regardless of cdk deployments). If true, the size of the group will only be reset if it has been changed in the CDK app. If false, the sizes will always be changed back to what they were in the CDK app on deployment. Default: true
         :param instance_monitoring: Controls whether instances in this group are launched with detailed or basic monitoring. When detailed monitoring is enabled, Amazon CloudWatch generates metrics every minute and your account is charged a fee. When you disable detailed monitoring, CloudWatch generates metrics every 5 minutes. ``launchTemplate`` and ``mixedInstancesPolicy`` must not be specified when this property is specified Default: - Monitoring.DETAILED
-        :param key_name: Name of SSH keypair to grant access to instances. ``launchTemplate`` and ``mixedInstancesPolicy`` must not be specified when this property is specified Default: - No SSH access will be possible.
+        :param key_name: (deprecated) Name of SSH keypair to grant access to instances. ``launchTemplate`` and ``mixedInstancesPolicy`` must not be specified when this property is specified You can either specify ``keyPair`` or ``keyName``, not both. Default: - No SSH access will be possible.
+        :param key_pair: The SSH keypair to grant access to the instance. Feature flag ``AUTOSCALING_GENERATE_LAUNCH_TEMPLATE`` must be enabled to use this property. ``launchTemplate`` and ``mixedInstancesPolicy`` must not be specified when this property is specified. You can either specify ``keyPair`` or ``keyName``, not both. Default: - No SSH access will be possible.
         :param max_capacity: Maximum number of instances in the fleet. Default: desiredCapacity
         :param max_instance_lifetime: The maximum amount of time that an instance can be in service. The maximum duration applies to all current and future instances in the group. As an instance approaches its maximum duration, it is terminated and replaced, and cannot be used again. You must specify a value of at least 604,800 seconds (7 days). To clear a previously set value, leave this property undefined. Default: none
         :param min_capacity: Minimum number of instances in the fleet. Default: 1
@@ -15408,6 +15438,7 @@ class Cluster(
             ignore_unmodified_size_properties=ignore_unmodified_size_properties,
             instance_monitoring=instance_monitoring,
             key_name=key_name,
+            key_pair=key_pair,
             max_capacity=max_capacity,
             max_instance_lifetime=max_instance_lifetime,
             min_capacity=min_capacity,
@@ -18064,6 +18095,7 @@ def _typecheckingstub__9ac94eb5cd9569dcf4122cf20026c6f104b737f68ecd3395b237320bd
     ignore_unmodified_size_properties: typing.Optional[builtins.bool] = None,
     instance_monitoring: typing.Optional[_Monitoring_50020f91] = None,
     key_name: typing.Optional[builtins.str] = None,
+    key_pair: typing.Optional[_IKeyPair_bc344eda] = None,
     max_capacity: typing.Optional[jsii.Number] = None,
     max_instance_lifetime: typing.Optional[_Duration_4839e8c3] = None,
     min_capacity: typing.Optional[jsii.Number] = None,
@@ -19626,6 +19658,7 @@ def _typecheckingstub__e9e81d821b1c1d14225d1c9cc695af8e71b96a7489dcd36bd237c9363
     ignore_unmodified_size_properties: typing.Optional[builtins.bool] = None,
     instance_monitoring: typing.Optional[_Monitoring_50020f91] = None,
     key_name: typing.Optional[builtins.str] = None,
+    key_pair: typing.Optional[_IKeyPair_bc344eda] = None,
     max_capacity: typing.Optional[jsii.Number] = None,
     max_instance_lifetime: typing.Optional[_Duration_4839e8c3] = None,
     min_capacity: typing.Optional[jsii.Number] = None,

aws_cdk/aws_events/__init__.py

@@ -10032,6 +10032,7 @@ class RuleProps(EventCommonOptions):
     jsii_struct_bases=[],
     name_mapping={
         "arn": "arn",
+        "app_sync_parameters": "appSyncParameters",
         "batch_parameters": "batchParameters",
         "dead_letter_config": "deadLetterConfig",
         "ecs_parameters": "ecsParameters",
@@ -10050,6 +10051,7 @@ class RuleTargetConfig:
         self,
         *,
         arn: builtins.str,
+        app_sync_parameters: typing.Optional[typing.Union[CfnRule.AppSyncParametersProperty, typing.Dict[builtins.str, typing.Any]]] = None,
         batch_parameters: typing.Optional[typing.Union[CfnRule.BatchParametersProperty, typing.Dict[builtins.str, typing.Any]]] = None,
         dead_letter_config: typing.Optional[typing.Union[CfnRule.DeadLetterConfigProperty, typing.Dict[builtins.str, typing.Any]]] = None,
         ecs_parameters: typing.Optional[typing.Union[CfnRule.EcsParametersProperty, typing.Dict[builtins.str, typing.Any]]] = None,
@@ -10065,6 +10067,7 @@ class RuleTargetConfig:
         '''Properties for an event rule target.
 
         :param arn: The Amazon Resource Name (ARN) of the target.
+        :param app_sync_parameters: Contains the GraphQL operation to be parsed and executed, if the event target is an AWS AppSync API. Default: - None
         :param batch_parameters: Parameters used when the rule invokes Amazon AWS Batch Job/Queue. Default: no parameters set
         :param dead_letter_config: Contains information about a dead-letter queue configuration. Default: no dead-letter queue set
         :param ecs_parameters: The Amazon ECS task definition and task count to use, if the event target is an Amazon ECS task.
@@ -10095,6 +10098,9 @@ class RuleTargetConfig:
                 arn="arn",
             
                 # the properties below are optional
+                app_sync_parameters=events.CfnRule.AppSyncParametersProperty(
+                    graph_ql_operation="graphQlOperation"
+                ),
                 batch_parameters=events.CfnRule.BatchParametersProperty(
                     job_definition="jobDefinition",
                     job_name="jobName",
@@ -10181,6 +10187,8 @@ class RuleTargetConfig:
                 target_resource=construct
             )
         '''
+        if isinstance(app_sync_parameters, dict):
+            app_sync_parameters = CfnRule.AppSyncParametersProperty(**app_sync_parameters)
         if isinstance(batch_parameters, dict):
             batch_parameters = CfnRule.BatchParametersProperty(**batch_parameters)
         if isinstance(dead_letter_config, dict):
@@ -10200,6 +10208,7 @@ class RuleTargetConfig:
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__10b46a391417178d3d06a5360e56af2bf314e68a1662e39855324f1244482eab)
             check_type(argname="argument arn", value=arn, expected_type=type_hints["arn"])
+            check_type(argname="argument app_sync_parameters", value=app_sync_parameters, expected_type=type_hints["app_sync_parameters"])
             check_type(argname="argument batch_parameters", value=batch_parameters, expected_type=type_hints["batch_parameters"])
             check_type(argname="argument dead_letter_config", value=dead_letter_config, expected_type=type_hints["dead_letter_config"])
             check_type(argname="argument ecs_parameters", value=ecs_parameters, expected_type=type_hints["ecs_parameters"])
@@ -10214,6 +10223,8 @@ class RuleTargetConfig:
         self._values: typing.Dict[builtins.str, typing.Any] = {
             "arn": arn,
         }
+        if app_sync_parameters is not None:
+            self._values["app_sync_parameters"] = app_sync_parameters
         if batch_parameters is not None:
             self._values["batch_parameters"] = batch_parameters
         if dead_letter_config is not None:
@@ -10244,6 +10255,15 @@ class RuleTargetConfig:
         assert result is not None, "Required property 'arn' is missing"
         return typing.cast(builtins.str, result)
 
+    @builtins.property
+    def app_sync_parameters(self) -> typing.Optional[CfnRule.AppSyncParametersProperty]:
+        '''Contains the GraphQL operation to be parsed and executed, if the event target is an AWS AppSync API.
+
+        :default: - None
+        '''
+        result = self._values.get("app_sync_parameters")
+        return typing.cast(typing.Optional[CfnRule.AppSyncParametersProperty], result)
+
     @builtins.property
     def batch_parameters(self) -> typing.Optional[CfnRule.BatchParametersProperty]:
         '''Parameters used when the rule invokes Amazon AWS Batch Job/Queue.
@@ -10364,27 +10384,26 @@ class RuleTargetInput(
 
     Example::
 
-        import aws_cdk.aws_iam as iam
-        import aws_cdk.aws_stepfunctions as sfn
+        import aws_cdk.aws_appsync as appsync
         
         
-        rule = events.Rule(self, "Rule",
-            schedule=events.Schedule.rate(Duration.minutes(1))
+        api = appsync.GraphqlApi(self, "api",
+            name="api",
+            definition=appsync.Definition.from_file("schema.graphql"),
+            authorization_config=appsync.AuthorizationConfig(
+                default_authorization=appsync.AuthorizationMode(authorization_type=appsync.AuthorizationType.IAM)
+            )
         )
         
-        dlq = sqs.Queue(self, "DeadLetterQueue")
-        
-        role = iam.Role(self, "Role",
-            assumed_by=iam.ServicePrincipal("events.amazonaws.com")
-        )
-        state_machine = sfn.StateMachine(self, "SM",
-            definition=sfn.Wait(self, "Hello", time=sfn.WaitTime.duration(Duration.seconds(10)))
+        rule = events.Rule(self, "Rule",
+            schedule=events.Schedule.rate(cdk.Duration.hours(1))
         )
         
-        rule.add_target(targets.SfnStateMachine(state_machine,
-            input=events.RuleTargetInput.from_object({"SomeParam": "SomeValue"}),
-            dead_letter_queue=dlq,
-            role=role
+        rule.add_target(targets.AppSync(api,
+            graph_qLOperation="mutation Publish($message: String!){ publish(message: $message) { message } }",
+            variables=events.RuleTargetInput.from_object({
+                "message": "hello world"
+            })
         ))
     '''
 
@@ -10616,16 +10635,17 @@ class Schedule(
             schedule=events.Schedule.rate(cdk.Duration.hours(1))
         )
         
-        rule.add_target(targets.EcsTask(
-            cluster=cluster,
-            task_definition=task_definition,
-            task_count=1,
-            container_overrides=[targets.ContainerOverride(
-                container_name="TheContainer",
-                command=["echo", events.EventField.from_path("$.detail.event")]
-            )],
-            enable_execute_command=True
-        ))
+        rule.add_target(
+            targets.EcsTask(
+                cluster=cluster,
+                task_definition=task_definition,
+                propagate_tags=ecs.PropagatedTagSource.TASK_DEFINITION,
+                tags=[targets.Tag(
+                    key="my-tag",
+                    value="my-tag-value"
+                )
+                ]
+            ))
     '''
 
     def __init__(self) -> None:
@@ -12586,6 +12606,7 @@ def _typecheckingstub__26677a946da4037892c1c589c005b7536d8ffed632ca92c5c52a92586
 def _typecheckingstub__10b46a391417178d3d06a5360e56af2bf314e68a1662e39855324f1244482eab(
     *,
     arn: builtins.str,
+    app_sync_parameters: typing.Optional[typing.Union[CfnRule.AppSyncParametersProperty, typing.Dict[builtins.str, typing.Any]]] = None,
     batch_parameters: typing.Optional[typing.Union[CfnRule.BatchParametersProperty, typing.Dict[builtins.str, typing.Any]]] = None,
     dead_letter_config: typing.Optional[typing.Union[CfnRule.DeadLetterConfigProperty, typing.Dict[builtins.str, typing.Any]]] = None,
     ecs_parameters: typing.Optional[typing.Union[CfnRule.EcsParametersProperty, typing.Dict[builtins.str, typing.Any]]] = None,