aws-cdk-lib 2.186.0__py3-none-any.whl → 2.187.0__py3-none-any.whl

aws_cdk/aws_cloudwatch/__init__.py

@@ -10847,23 +10847,19 @@ class Statistic(enum.Enum):
 
     Example::
 
-        import aws_cdk.aws_cloudwatch as cloudwatch
-        
-        # delivery_stream: firehose.DeliveryStream
-        
+        # matchmaking_rule_set: gamelift.MatchmakingRuleSet
         
-        # Alarm that triggers when the per-second average of incoming bytes exceeds 90% of the current service limit
-        incoming_bytes_percent_of_limit = cloudwatch.MathExpression(
-            expression="incomingBytes / 300 / bytePerSecLimit",
+        # Alarm that triggers when the per-second average of not placed matches exceed 10%
+        rule_evaluation_ratio = cloudwatch.MathExpression(
+            expression="1 - (ruleEvaluationsPassed / ruleEvaluationsFailed)",
             using_metrics={
-                "incoming_bytes": delivery_stream.metric_incoming_bytes(statistic=cloudwatch.Statistic.SUM),
-                "byte_per_sec_limit": delivery_stream.metric("BytesPerSecondLimit")
+                "rule_evaluations_passed": matchmaking_rule_set.metric_rule_evaluations_passed(statistic=cloudwatch.Statistic.SUM),
+                "rule_evaluations_failed": matchmaking_rule_set.metric("ruleEvaluationsFailed")
             }
         )
-        
         cloudwatch.Alarm(self, "Alarm",
-            metric=incoming_bytes_percent_of_limit,
-            threshold=0.9,
+            metric=rule_evaluation_ratio,
+            threshold=0.1,
             evaluation_periods=3
         )
     '''
@@ -12594,29 +12590,31 @@ class AlarmProps(CreateAlarmOptions):
 
         Example::
 
-            # log_group: logs.LogGroup
+            import aws_cdk.aws_cloudwatch as cloudwatch
             
-            mf = logs.MetricFilter(self, "MetricFilter",
-                log_group=log_group,
-                metric_namespace="MyApp",
-                metric_name="Latency",
-                filter_pattern=logs.FilterPattern.exists("$.latency"),
-                metric_value="$.latency",
-                dimensions={
-                    "ErrorCode": "$.errorCode"
-                },
-                unit=cloudwatch.Unit.MILLISECONDS
-            )
+            # alias: lambda.Alias
             
-            # expose a metric from the metric filter
-            metric = mf.metric()
+            # or add alarms to an existing group
+            # blue_green_alias: lambda.Alias
             
-            # you can use the metric to create a new alarm
-            cloudwatch.Alarm(self, "alarm from metric filter",
-                metric=metric,
-                threshold=100,
-                evaluation_periods=2
+            alarm = cloudwatch.Alarm(self, "Errors",
+                comparison_operator=cloudwatch.ComparisonOperator.GREATER_THAN_THRESHOLD,
+                threshold=1,
+                evaluation_periods=1,
+                metric=alias.metric_errors()
             )
+            deployment_group = codedeploy.LambdaDeploymentGroup(self, "BlueGreenDeployment",
+                alias=alias,
+                deployment_config=codedeploy.LambdaDeploymentConfig.LINEAR_10PERCENT_EVERY_1MINUTE,
+                alarms=[alarm
+                ]
+            )
+            deployment_group.add_alarm(cloudwatch.Alarm(self, "BlueGreenErrors",
+                comparison_operator=cloudwatch.ComparisonOperator.GREATER_THAN_THRESHOLD,
+                threshold=1,
+                evaluation_periods=1,
+                metric=blue_green_alias.metric_errors()
+            ))
         '''
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__b2e7c873c118fbc1f6cf26e1bb5bd3d8549040c626a6450f2d686bb07b87266b)
@@ -14861,29 +14859,31 @@ class Alarm(
 
     Example::
 
-        # log_group: logs.LogGroup
+        import aws_cdk.aws_cloudwatch as cloudwatch
         
-        mf = logs.MetricFilter(self, "MetricFilter",
-            log_group=log_group,
-            metric_namespace="MyApp",
-            metric_name="Latency",
-            filter_pattern=logs.FilterPattern.exists("$.latency"),
-            metric_value="$.latency",
-            dimensions={
-                "ErrorCode": "$.errorCode"
-            },
-            unit=cloudwatch.Unit.MILLISECONDS
-        )
+        # alias: lambda.Alias
         
-        # expose a metric from the metric filter
-        metric = mf.metric()
+        # or add alarms to an existing group
+        # blue_green_alias: lambda.Alias
         
-        # you can use the metric to create a new alarm
-        cloudwatch.Alarm(self, "alarm from metric filter",
-            metric=metric,
-            threshold=100,
-            evaluation_periods=2
+        alarm = cloudwatch.Alarm(self, "Errors",
+            comparison_operator=cloudwatch.ComparisonOperator.GREATER_THAN_THRESHOLD,
+            threshold=1,
+            evaluation_periods=1,
+            metric=alias.metric_errors()
+        )
+        deployment_group = codedeploy.LambdaDeploymentGroup(self, "BlueGreenDeployment",
+            alias=alias,
+            deployment_config=codedeploy.LambdaDeploymentConfig.LINEAR_10PERCENT_EVERY_1MINUTE,
+            alarms=[alarm
+            ]
         )
+        deployment_group.add_alarm(cloudwatch.Alarm(self, "BlueGreenErrors",
+            comparison_operator=cloudwatch.ComparisonOperator.GREATER_THAN_THRESHOLD,
+            threshold=1,
+            evaluation_periods=1,
+            metric=blue_green_alias.metric_errors()
+        ))
     '''
 
     def __init__(

aws_cdk/aws_codebuild/__init__.py

@@ -12108,6 +12108,7 @@ class LinuxBuildImage(
         cache_disabled: typing.Optional[builtins.bool] = None,
         cache_from: typing.Optional[typing.Sequence[typing.Union[_DockerCacheOption_58ef18ca, typing.Dict[builtins.str, typing.Any]]]] = None,
         cache_to: typing.Optional[typing.Union[_DockerCacheOption_58ef18ca, typing.Dict[builtins.str, typing.Any]]] = None,
+        display_name: typing.Optional[builtins.str] = None,
         file: typing.Optional[builtins.str] = None,
         invalidation: typing.Optional[typing.Union[_DockerImageAssetInvalidationOptions_4deb8d45, typing.Dict[builtins.str, typing.Any]]] = None,
         network_mode: typing.Optional[_NetworkMode_897e5081] = None,
@@ -12131,6 +12132,7 @@ class LinuxBuildImage(
         :param cache_disabled: Disable the cache and pass ``--no-cache`` to the ``docker build`` command. Default: - cache is used
         :param cache_from: Cache from options to pass to the ``docker build`` command. Default: - no cache from options are passed to the build command
         :param cache_to: Cache to options to pass to the ``docker build`` command. Default: - no cache to options are passed to the build command
+        :param display_name: A display name for this asset. If supplied, the display name will be used in locations where the asset identifier is printed, like in the CLI progress information. If the same asset is added multiple times, the display name of the first occurrence is used. If ``assetName`` is given, it will also be used as the default ``displayName``. Otherwise, the default is the construct path of the ImageAsset construct, with respect to the enclosing stack. If the asset is produced by a construct helper function (such as ``lambda.Code.fromAssetImage()``), this will look like ``MyFunction/AssetImage``. We use the stack-relative construct path so that in the common case where you have multiple stacks with the same asset, we won't show something like ``/MyBetaStack/MyFunction/Code`` when you are actually deploying to production. Default: - Stack-relative construct path
         :param file: Path to the Dockerfile (relative to the directory). Default: 'Dockerfile'
         :param invalidation: Options to control which parameters are used to invalidate the asset hash. Default: - hash all parameters
         :param network_mode: Networking mode for the RUN commands during build. Support docker API 1.25+. Default: - no networking mode specified (the default networking mode ``NetworkMode.DEFAULT`` will be used)
@@ -12155,6 +12157,7 @@ class LinuxBuildImage(
             cache_disabled=cache_disabled,
             cache_from=cache_from,
             cache_to=cache_to,
+            display_name=display_name,
             file=file,
             invalidation=invalidation,
             network_mode=network_mode,
@@ -12807,6 +12810,7 @@ class MacBuildImage(
                     "params_key": "params"
                 }
             ),
+            display_name="displayName",
             exclude=["exclude"],
             extra_hash="extraHash",
             file="file",
@@ -12846,6 +12850,7 @@ class MacBuildImage(
         cache_disabled: typing.Optional[builtins.bool] = None,
         cache_from: typing.Optional[typing.Sequence[typing.Union[_DockerCacheOption_58ef18ca, typing.Dict[builtins.str, typing.Any]]]] = None,
         cache_to: typing.Optional[typing.Union[_DockerCacheOption_58ef18ca, typing.Dict[builtins.str, typing.Any]]] = None,
+        display_name: typing.Optional[builtins.str] = None,
         file: typing.Optional[builtins.str] = None,
         invalidation: typing.Optional[typing.Union[_DockerImageAssetInvalidationOptions_4deb8d45, typing.Dict[builtins.str, typing.Any]]] = None,
         network_mode: typing.Optional[_NetworkMode_897e5081] = None,
@@ -12869,6 +12874,7 @@ class MacBuildImage(
         :param cache_disabled: Disable the cache and pass ``--no-cache`` to the ``docker build`` command. Default: - cache is used
         :param cache_from: Cache from options to pass to the ``docker build`` command. Default: - no cache from options are passed to the build command
         :param cache_to: Cache to options to pass to the ``docker build`` command. Default: - no cache to options are passed to the build command
+        :param display_name: A display name for this asset. If supplied, the display name will be used in locations where the asset identifier is printed, like in the CLI progress information. If the same asset is added multiple times, the display name of the first occurrence is used. If ``assetName`` is given, it will also be used as the default ``displayName``. Otherwise, the default is the construct path of the ImageAsset construct, with respect to the enclosing stack. If the asset is produced by a construct helper function (such as ``lambda.Code.fromAssetImage()``), this will look like ``MyFunction/AssetImage``. We use the stack-relative construct path so that in the common case where you have multiple stacks with the same asset, we won't show something like ``/MyBetaStack/MyFunction/Code`` when you are actually deploying to production. Default: - Stack-relative construct path
         :param file: Path to the Dockerfile (relative to the directory). Default: 'Dockerfile'
         :param invalidation: Options to control which parameters are used to invalidate the asset hash. Default: - hash all parameters
         :param network_mode: Networking mode for the RUN commands during build. Support docker API 1.25+. Default: - no networking mode specified (the default networking mode ``NetworkMode.DEFAULT`` will be used)
@@ -12893,6 +12899,7 @@ class MacBuildImage(
             cache_disabled=cache_disabled,
             cache_from=cache_from,
             cache_to=cache_to,
+            display_name=display_name,
             file=file,
             invalidation=invalidation,
             network_mode=network_mode,
@@ -19797,6 +19804,7 @@ def _typecheckingstub__c4ce5766deb0a7d190b79fe8c16f4eb758ab6db30a15dc2ea68692833
     cache_disabled: typing.Optional[builtins.bool] = None,
     cache_from: typing.Optional[typing.Sequence[typing.Union[_DockerCacheOption_58ef18ca, typing.Dict[builtins.str, typing.Any]]]] = None,
     cache_to: typing.Optional[typing.Union[_DockerCacheOption_58ef18ca, typing.Dict[builtins.str, typing.Any]]] = None,
+    display_name: typing.Optional[builtins.str] = None,
     file: typing.Optional[builtins.str] = None,
     invalidation: typing.Optional[typing.Union[_DockerImageAssetInvalidationOptions_4deb8d45, typing.Dict[builtins.str, typing.Any]]] = None,
     network_mode: typing.Optional[_NetworkMode_897e5081] = None,
@@ -19864,6 +19872,7 @@ def _typecheckingstub__aa924aa0600b9706b95a62c612f337f8dde0f0df7d5d3b8c5b48b7279
     cache_disabled: typing.Optional[builtins.bool] = None,
     cache_from: typing.Optional[typing.Sequence[typing.Union[_DockerCacheOption_58ef18ca, typing.Dict[builtins.str, typing.Any]]]] = None,
     cache_to: typing.Optional[typing.Union[_DockerCacheOption_58ef18ca, typing.Dict[builtins.str, typing.Any]]] = None,
+    display_name: typing.Optional[builtins.str] = None,
     file: typing.Optional[builtins.str] = None,
     invalidation: typing.Optional[typing.Union[_DockerImageAssetInvalidationOptions_4deb8d45, typing.Dict[builtins.str, typing.Any]]] = None,
     network_mode: typing.Optional[_NetworkMode_897e5081] = None,

aws_cdk/aws_config/__init__.py

@@ -698,7 +698,7 @@ class CfnConfigRule(
         :param evaluation_modes: The modes the AWS Config rule can be evaluated in. The valid values are distinct objects. By default, the value is Detective evaluation mode only.
         :param input_parameters: A string, in JSON format, that is passed to the AWS Config rule Lambda function.
         :param maximum_execution_frequency: The maximum frequency with which AWS Config runs evaluations for a rule. You can specify a value for ``MaximumExecutionFrequency`` when: - You are using an AWS managed rule that is triggered at a periodic frequency. - Your custom rule is triggered when AWS Config delivers the configuration snapshot. For more information, see `ConfigSnapshotDeliveryProperties <https://docs.aws.amazon.com/config/latest/APIReference/API_ConfigSnapshotDeliveryProperties.html>`_ . .. epigraph:: By default, rules with a periodic trigger are evaluated every 24 hours. To change the frequency, specify a valid value for the ``MaximumExecutionFrequency`` parameter.
-        :param scope: Defines which resources can trigger an evaluation for the rule. The scope can include one or more resource types, a combination of one resource type and one resource ID, or a combination of a tag key and value. Specify a scope to constrain the resources that can trigger an evaluation for the rule. If you do not specify a scope, evaluations are triggered when any resource in the recording group changes. .. epigraph:: Scope is only supported for change-triggered rules. Scope is not supported for periodic or hybrid rules.
+        :param scope: Defines which resources can trigger an evaluation for the rule. The scope can include one or more resource types, a combination of one resource type and one resource ID, or a combination of a tag key and value. Specify a scope to constrain the resources that can trigger an evaluation for the rule. If you do not specify a scope, evaluations are triggered when any resource in the recording group changes.
         '''
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__deecc74e0a0f7e54fde16a159ece5d8f96f56f6b8aca025003adcc1d931d5d00)
@@ -1512,7 +1512,7 @@ class CfnConfigRuleProps:
         :param evaluation_modes: The modes the AWS Config rule can be evaluated in. The valid values are distinct objects. By default, the value is Detective evaluation mode only.
         :param input_parameters: A string, in JSON format, that is passed to the AWS Config rule Lambda function.
         :param maximum_execution_frequency: The maximum frequency with which AWS Config runs evaluations for a rule. You can specify a value for ``MaximumExecutionFrequency`` when: - You are using an AWS managed rule that is triggered at a periodic frequency. - Your custom rule is triggered when AWS Config delivers the configuration snapshot. For more information, see `ConfigSnapshotDeliveryProperties <https://docs.aws.amazon.com/config/latest/APIReference/API_ConfigSnapshotDeliveryProperties.html>`_ . .. epigraph:: By default, rules with a periodic trigger are evaluated every 24 hours. To change the frequency, specify a valid value for the ``MaximumExecutionFrequency`` parameter.
-        :param scope: Defines which resources can trigger an evaluation for the rule. The scope can include one or more resource types, a combination of one resource type and one resource ID, or a combination of a tag key and value. Specify a scope to constrain the resources that can trigger an evaluation for the rule. If you do not specify a scope, evaluations are triggered when any resource in the recording group changes. .. epigraph:: Scope is only supported for change-triggered rules. Scope is not supported for periodic or hybrid rules.
+        :param scope: Defines which resources can trigger an evaluation for the rule. The scope can include one or more resource types, a combination of one resource type and one resource ID, or a combination of a tag key and value. Specify a scope to constrain the resources that can trigger an evaluation for the rule. If you do not specify a scope, evaluations are triggered when any resource in the recording group changes.
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-config-configrule.html
         :exampleMetadata: fixture=_generated
@@ -1682,9 +1682,6 @@ class CfnConfigRuleProps:
         '''Defines which resources can trigger an evaluation for the rule.
 
         The scope can include one or more resource types, a combination of one resource type and one resource ID, or a combination of a tag key and value. Specify a scope to constrain the resources that can trigger an evaluation for the rule. If you do not specify a scope, evaluations are triggered when any resource in the recording group changes.
-        .. epigraph::
-
-           Scope is only supported for change-triggered rules. Scope is not supported for periodic or hybrid rules.
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-config-configrule.html#cfn-config-configrule-scope
         '''