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

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_entityresolution/__init__.py

@@ -2912,7 +2912,7 @@ class CfnPolicyStatement(
         :param statement_id: A statement identifier that differentiates the statement from others in the same policy.
         :param action: The action that the principal can use on the resource. For example, ``entityresolution:GetIdMappingJob`` , ``entityresolution:GetMatchingJob`` .
         :param condition: A set of condition keys that you can use in key policies.
-        :param effect: Determines whether the permissions specified in the policy are to be allowed ( ``Allow`` ) or denied ( ``Deny`` ).
+        :param effect: Determines whether the permissions specified in the policy are to be allowed ( ``Allow`` ) or denied ( ``Deny`` ). .. epigraph:: If you set the value of the ``effect`` parameter to ``Deny`` for the ``AddPolicyStatement`` operation, you must also set the value of the ``effect`` parameter in the ``policy`` to ``Deny`` for the ``PutPolicy`` operation.
         :param principal: The AWS service or AWS account that can access the resource defined as ARN.
         '''
         if __debug__:
@@ -3073,7 +3073,7 @@ class CfnPolicyStatementProps:
         :param statement_id: A statement identifier that differentiates the statement from others in the same policy.
         :param action: The action that the principal can use on the resource. For example, ``entityresolution:GetIdMappingJob`` , ``entityresolution:GetMatchingJob`` .
         :param condition: A set of condition keys that you can use in key policies.
-        :param effect: Determines whether the permissions specified in the policy are to be allowed ( ``Allow`` ) or denied ( ``Deny`` ).
+        :param effect: Determines whether the permissions specified in the policy are to be allowed ( ``Allow`` ) or denied ( ``Deny`` ). .. epigraph:: If you set the value of the ``effect`` parameter to ``Deny`` for the ``AddPolicyStatement`` operation, you must also set the value of the ``effect`` parameter in the ``policy`` to ``Deny`` for the ``PutPolicy`` operation.
         :param principal: The AWS service or AWS account that can access the resource defined as ARN.
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-entityresolution-policystatement.html
@@ -3161,6 +3161,10 @@ class CfnPolicyStatementProps:
     def effect(self) -> typing.Optional[builtins.str]:
         '''Determines whether the permissions specified in the policy are to be allowed ( ``Allow`` ) or denied ( ``Deny`` ).
 
+        .. epigraph::
+
+           If you set the value of the ``effect`` parameter to ``Deny`` for the ``AddPolicyStatement`` operation, you must also set the value of the ``effect`` parameter in the ``policy`` to ``Deny`` for the ``PutPolicy`` operation.
+
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-entityresolution-policystatement.html#cfn-entityresolution-policystatement-effect
         '''
         result = self._values.get("effect")

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,