aws-cdk-lib 2.137.0__py3-none-any.whl → 2.138.0__py3-none-any.whl

aws_cdk/aws_elasticloadbalancingv2/__init__.py

@@ -785,6 +785,19 @@ target_group = elbv2.ApplicationTargetGroup.from_target_group_attributes(self, "
 
 target_group_metrics = target_group.metrics
 ```
+
+## logicalIds on ExternalApplicationListener.addTargetGroups() and .addAction()
+
+By default, the `addTargetGroups()` method does not follow the standard behavior
+of adding a `Rule` suffix to the logicalId of the `ListenerRule` it creates.
+If you are deploying new `ListenerRule`s using `addTargetGroups()` the recommendation
+is to set the `removeRuleSuffixFromLogicalId: false` property.
+If you have `ListenerRule`s deployed using the legacy behavior of `addTargetGroups()`,
+which you need to switch over to being managed by the `addAction()` method,
+then you will need to enable the `removeRuleSuffixFromLogicalId: true` property in the `addAction()` method.
+
+`ListenerRule`s have a unique `priority` for a given `Listener`.
+Because the `priority` must be unique, CloudFormation will always fail when creating a new `ListenerRule` to replace the existing one, unless you change the `priority` as well as the logicalId.
 '''
 from pkgutil import extend_path
 __path__ = extend_path(__path__, __name__)
@@ -18213,6 +18226,7 @@ class XffHeaderProcessingMode(enum.Enum):
         "conditions": "conditions",
         "priority": "priority",
         "action": "action",
+        "remove_suffix": "removeSuffix",
     },
 )
 class AddApplicationActionProps(AddRuleProps):
@@ -18222,12 +18236,14 @@ class AddApplicationActionProps(AddRuleProps):
         conditions: typing.Optional[typing.Sequence[ListenerCondition]] = None,
         priority: typing.Optional[jsii.Number] = None,
         action: ListenerAction,
+        remove_suffix: typing.Optional[builtins.bool] = None,
     ) -> None:
         '''Properties for adding a new action to a listener.
 
         :param conditions: Rule applies if matches the conditions. Default: - No conditions.
         :param priority: Priority of this target group. The rule with the lowest priority will be used for every request. If priority is not given, these target groups will be added as defaults, and must not have conditions. Priorities must be unique. Default: Target groups are used as defaults
         :param action: Action to perform.
+        :param remove_suffix: ``ListenerRule``s have a ``Rule`` suffix on their logicalId by default. This allows you to remove that suffix. Legacy behavior of the ``addTargetGroups()`` convenience method did not include the ``Rule`` suffix on the logicalId of the generated ``ListenerRule``. At some point, increasing complexity of requirements can require users to switch from the ``addTargetGroups()`` method to the ``addAction()`` method. When migrating ``ListenerRule``s deployed by a legacy version of ``addTargetGroups()``, you will need to enable this flag to avoid changing the logicalId of your resource. Otherwise Cfn will attempt to replace the ``ListenerRule`` and fail. Default: - use standard logicalId with the ``Rule`` suffix
 
         :exampleMetadata: infused
 
@@ -18252,6 +18268,7 @@ class AddApplicationActionProps(AddRuleProps):
             check_type(argname="argument conditions", value=conditions, expected_type=type_hints["conditions"])
             check_type(argname="argument priority", value=priority, expected_type=type_hints["priority"])
             check_type(argname="argument action", value=action, expected_type=type_hints["action"])
+            check_type(argname="argument remove_suffix", value=remove_suffix, expected_type=type_hints["remove_suffix"])
         self._values: typing.Dict[builtins.str, typing.Any] = {
             "action": action,
         }
@@ -18259,6 +18276,8 @@ class AddApplicationActionProps(AddRuleProps):
             self._values["conditions"] = conditions
         if priority is not None:
             self._values["priority"] = priority
+        if remove_suffix is not None:
+            self._values["remove_suffix"] = remove_suffix
 
     @builtins.property
     def conditions(self) -> typing.Optional[typing.List[ListenerCondition]]:
@@ -18293,6 +18312,22 @@ class AddApplicationActionProps(AddRuleProps):
         assert result is not None, "Required property 'action' is missing"
         return typing.cast(ListenerAction, result)
 
+    @builtins.property
+    def remove_suffix(self) -> typing.Optional[builtins.bool]:
+        '''``ListenerRule``s have a ``Rule`` suffix on their logicalId by default. This allows you to remove that suffix.
+
+        Legacy behavior of the ``addTargetGroups()`` convenience method did not include the ``Rule`` suffix on the logicalId of the generated ``ListenerRule``.
+        At some point, increasing complexity of requirements can require users to switch from the ``addTargetGroups()`` method
+        to the ``addAction()`` method.
+        When migrating ``ListenerRule``s deployed by a legacy version of ``addTargetGroups()``,
+        you will need to enable this flag to avoid changing the logicalId of your resource.
+        Otherwise Cfn will attempt to replace the ``ListenerRule`` and fail.
+
+        :default: - use standard logicalId with the ``Rule`` suffix
+        '''
+        result = self._values.get("remove_suffix")
+        return typing.cast(typing.Optional[builtins.bool], result)
+
     def __eq__(self, rhs: typing.Any) -> builtins.bool:
         return isinstance(rhs, self.__class__) and rhs._values == self._values
 
@@ -19933,6 +19968,7 @@ class IApplicationListener(
         id: builtins.str,
         *,
         action: ListenerAction,
+        remove_suffix: typing.Optional[builtins.bool] = None,
         conditions: typing.Optional[typing.Sequence[ListenerCondition]] = None,
         priority: typing.Optional[jsii.Number] = None,
     ) -> None:
@@ -19950,6 +19986,7 @@ class IApplicationListener(
 
         :param id: -
         :param action: Action to perform.
+        :param remove_suffix: ``ListenerRule``s have a ``Rule`` suffix on their logicalId by default. This allows you to remove that suffix. Legacy behavior of the ``addTargetGroups()`` convenience method did not include the ``Rule`` suffix on the logicalId of the generated ``ListenerRule``. At some point, increasing complexity of requirements can require users to switch from the ``addTargetGroups()`` method to the ``addAction()`` method. When migrating ``ListenerRule``s deployed by a legacy version of ``addTargetGroups()``, you will need to enable this flag to avoid changing the logicalId of your resource. Otherwise Cfn will attempt to replace the ``ListenerRule`` and fail. Default: - use standard logicalId with the ``Rule`` suffix
         :param conditions: Rule applies if matches the conditions. Default: - No conditions.
         :param priority: Priority of this target group. The rule with the lowest priority will be used for every request. If priority is not given, these target groups will be added as defaults, and must not have conditions. Priorities must be unique. Default: Target groups are used as defaults
         '''
@@ -20065,6 +20102,7 @@ class _IApplicationListenerProxy(
         id: builtins.str,
         *,
         action: ListenerAction,
+        remove_suffix: typing.Optional[builtins.bool] = None,
         conditions: typing.Optional[typing.Sequence[ListenerCondition]] = None,
         priority: typing.Optional[jsii.Number] = None,
     ) -> None:
@@ -20082,6 +20120,7 @@ class _IApplicationListenerProxy(
 
         :param id: -
         :param action: Action to perform.
+        :param remove_suffix: ``ListenerRule``s have a ``Rule`` suffix on their logicalId by default. This allows you to remove that suffix. Legacy behavior of the ``addTargetGroups()`` convenience method did not include the ``Rule`` suffix on the logicalId of the generated ``ListenerRule``. At some point, increasing complexity of requirements can require users to switch from the ``addTargetGroups()`` method to the ``addAction()`` method. When migrating ``ListenerRule``s deployed by a legacy version of ``addTargetGroups()``, you will need to enable this flag to avoid changing the logicalId of your resource. Otherwise Cfn will attempt to replace the ``ListenerRule`` and fail. Default: - use standard logicalId with the ``Rule`` suffix
         :param conditions: Rule applies if matches the conditions. Default: - No conditions.
         :param priority: Priority of this target group. The rule with the lowest priority will be used for every request. If priority is not given, these target groups will be added as defaults, and must not have conditions. Priorities must be unique. Default: Target groups are used as defaults
         '''
@@ -20089,7 +20128,10 @@ class _IApplicationListenerProxy(
             type_hints = typing.get_type_hints(_typecheckingstub__078c8c060ef52d807e9a62da847c7c1f9a2fb0a3f7bf8900246c80b1d9ff0a2e)
             check_type(argname="argument id", value=id, expected_type=type_hints["id"])
         props = AddApplicationActionProps(
-            action=action, conditions=conditions, priority=priority
+            action=action,
+            remove_suffix=remove_suffix,
+            conditions=conditions,
+            priority=priority,
         )
 
         return typing.cast(None, jsii.invoke(self, "addAction", [id, props]))
@@ -21241,6 +21283,7 @@ class ApplicationListener(
         id: builtins.str,
         *,
         action: ListenerAction,
+        remove_suffix: typing.Optional[builtins.bool] = None,
         conditions: typing.Optional[typing.Sequence[ListenerCondition]] = None,
         priority: typing.Optional[jsii.Number] = None,
     ) -> None:
@@ -21256,6 +21299,7 @@ class ApplicationListener(
 
         :param id: -
         :param action: Action to perform.
+        :param remove_suffix: ``ListenerRule``s have a ``Rule`` suffix on their logicalId by default. This allows you to remove that suffix. Legacy behavior of the ``addTargetGroups()`` convenience method did not include the ``Rule`` suffix on the logicalId of the generated ``ListenerRule``. At some point, increasing complexity of requirements can require users to switch from the ``addTargetGroups()`` method to the ``addAction()`` method. When migrating ``ListenerRule``s deployed by a legacy version of ``addTargetGroups()``, you will need to enable this flag to avoid changing the logicalId of your resource. Otherwise Cfn will attempt to replace the ``ListenerRule`` and fail. Default: - use standard logicalId with the ``Rule`` suffix
         :param conditions: Rule applies if matches the conditions. Default: - No conditions.
         :param priority: Priority of this target group. The rule with the lowest priority will be used for every request. If priority is not given, these target groups will be added as defaults, and must not have conditions. Priorities must be unique. Default: Target groups are used as defaults
         '''
@@ -21263,7 +21307,10 @@ class ApplicationListener(
             type_hints = typing.get_type_hints(_typecheckingstub__646bd302ed3a63a28a30ea3b62d2e003bf976ae981493560776ad112cacb8001)
             check_type(argname="argument id", value=id, expected_type=type_hints["id"])
         props = AddApplicationActionProps(
-            action=action, conditions=conditions, priority=priority
+            action=action,
+            remove_suffix=remove_suffix,
+            conditions=conditions,
+            priority=priority,
         )
 
         return typing.cast(None, jsii.invoke(self, "addAction", [id, props]))
@@ -25201,6 +25248,7 @@ def _typecheckingstub__4107bd237140ac5f517872385fdbe42c3d9200e34f993d6b71eb7a020
     conditions: typing.Optional[typing.Sequence[ListenerCondition]] = None,
     priority: typing.Optional[jsii.Number] = None,
     action: ListenerAction,
+    remove_suffix: typing.Optional[builtins.bool] = None,
 ) -> None:
     """Type checking stubs"""
     pass
@@ -25333,6 +25381,7 @@ def _typecheckingstub__078c8c060ef52d807e9a62da847c7c1f9a2fb0a3f7bf8900246c80b1d
     id: builtins.str,
     *,
     action: ListenerAction,
+    remove_suffix: typing.Optional[builtins.bool] = None,
     conditions: typing.Optional[typing.Sequence[ListenerCondition]] = None,
     priority: typing.Optional[jsii.Number] = None,
 ) -> None:
@@ -25587,6 +25636,7 @@ def _typecheckingstub__646bd302ed3a63a28a30ea3b62d2e003bf976ae981493560776ad112c
     id: builtins.str,
     *,
     action: ListenerAction,
+    remove_suffix: typing.Optional[builtins.bool] = None,
     conditions: typing.Optional[typing.Sequence[ListenerCondition]] = None,
     priority: typing.Optional[jsii.Number] = None,
 ) -> None:

aws_cdk/aws_emr/__init__.py

@@ -3047,7 +3047,7 @@ class CfnCluster(
             :param emr_managed_master_security_group: The identifier of the Amazon EC2 security group for the master node. If you specify ``EmrManagedMasterSecurityGroup`` , you must also specify ``EmrManagedSlaveSecurityGroup`` .
             :param emr_managed_slave_security_group: The identifier of the Amazon EC2 security group for the core and task nodes. If you specify ``EmrManagedSlaveSecurityGroup`` , you must also specify ``EmrManagedMasterSecurityGroup`` .
             :param hadoop_version: Applies only to Amazon EMR release versions earlier than 4.0. The Hadoop version for the cluster. Valid inputs are "0.18" (no longer maintained), "0.20" (no longer maintained), "0.20.205" (no longer maintained), "1.0.3", "2.2.0", or "2.4.0". If you do not set this value, the default of 0.18 is used, unless the ``AmiVersion`` parameter is set in the RunJobFlow call, in which case the default version of Hadoop for that AMI version is used.
-            :param keep_job_flow_alive_when_no_steps: Specifies whether the cluster should remain available after completing all steps. Defaults to ``true`` . For more information about configuring cluster termination, see `Control Cluster Termination <https://docs.aws.amazon.com/emr/latest/ManagementGuide/emr-plan-termination.html>`_ in the *EMR Management Guide* .
+            :param keep_job_flow_alive_when_no_steps: Specifies whether the cluster should remain available after completing all steps. Defaults to ``false`` . For more information about configuring cluster termination, see `Control Cluster Termination <https://docs.aws.amazon.com/emr/latest/ManagementGuide/emr-plan-termination.html>`_ in the *EMR Management Guide* .
             :param master_instance_fleet: Describes the EC2 instances and instance configurations for the master instance fleet when using clusters with the instance fleet configuration.
             :param master_instance_group: Describes the EC2 instances and instance configurations for the master instance group when using clusters with the uniform instance group configuration.
             :param placement: The Availability Zone in which the cluster runs.
@@ -3637,7 +3637,7 @@ class CfnCluster(
         ) -> typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]]:
             '''Specifies whether the cluster should remain available after completing all steps.
 
-            Defaults to ``true`` . For more information about configuring cluster termination, see `Control Cluster Termination <https://docs.aws.amazon.com/emr/latest/ManagementGuide/emr-plan-termination.html>`_ in the *EMR Management Guide* .
+            Defaults to ``false`` . For more information about configuring cluster termination, see `Control Cluster Termination <https://docs.aws.amazon.com/emr/latest/ManagementGuide/emr-plan-termination.html>`_ in the *EMR Management Guide* .
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-emr-cluster-jobflowinstancesconfig.html#cfn-emr-cluster-jobflowinstancesconfig-keepjobflowalivewhennosteps
             '''