aws-cdk-lib 2.171.1__py3-none-any.whl → 2.173.0__py3-none-any.whl

aws_cdk/aws_cloudwatch/__init__.py

@@ -8308,16 +8308,21 @@ class MathExpression(
 
     Example::
 
-        # fn: lambda.Function
-        
+        # matchmaking_rule_set: gamelift.MatchmakingRuleSet
         
-        all_problems = cloudwatch.MathExpression(
-            expression="errors + throttles",
+        # 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={
-                "errors": fn.metric_errors(),
-                "throttles": fn.metric_throttles()
+                "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=rule_evaluation_ratio,
+            threshold=0.1,
+            evaluation_periods=3
+        )
     '''
 
     def __init__(
@@ -8333,7 +8338,7 @@ class MathExpression(
     ) -> None:
         '''
         :param expression: The expression defining the metric. When an expression contains a SEARCH function, it cannot be used within an Alarm.
-        :param using_metrics: The metrics used in the expression, in a map. The key is the identifier that represents the given metric in the expression, and the value is the actual Metric object. Default: - Empty map.
+        :param using_metrics: The metrics used in the expression, in a map. The key is the identifier that represents the given metric in the expression, and the value is the actual Metric object. The ``period`` of each metric in ``usingMetrics`` is ignored and instead overridden by the ``period`` specified for the ``MathExpression`` construct. Even if no ``period`` is specified for the ``MathExpression``, it will be overridden by the default value (``Duration.minutes(5)``). Example:: declare const metrics: elbv2.IApplicationLoadBalancerMetrics; new cloudwatch.MathExpression({ expression: 'm1+m2', label: 'AlbErrors', usingMetrics: { m1: metrics.custom('HTTPCode_ELB_500_Count', { period: Duration.minutes(1), // <- This period will be ignored statistic: 'Sum', label: 'HTTPCode_ELB_500_Count', }), m2: metrics.custom('HTTPCode_ELB_502_Count', { period: Duration.minutes(1), // <- This period will be ignored statistic: 'Sum', label: 'HTTPCode_ELB_502_Count', }), }, period: Duration.minutes(3), // <- This overrides the period of each metric in `usingMetrics` // (Even if not specified, it is overridden by the default value) }); Default: - Empty map.
         :param color: Color for this metric when added to a Graph in a Dashboard. Default: - Automatic color
         :param label: Label for this expression when added to a Graph in a Dashboard. If this expression evaluates to more than one time series (for example, through the use of ``METRICS()`` or ``SEARCH()`` expressions), each time series will appear in the graph using a combination of the expression label and the individual metric label. Specify the empty string (``''``) to suppress the expression label and only keep the metric label. You can use `dynamic labels <https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/graph-dynamic-labels.html>`_ to show summary information about the displayed time series in the legend. For example, if you use:: [max: ${MAX}] MyMetric As the metric label, the maximum value in the visible range will be shown next to the time series name in the graph's legend. If the math expression produces more than one time series, the maximum will be shown for each individual time series produce by this math expression. Default: - Expression value is used as label
         :param period: The period over which the expression's statistics are applied. This period overrides all periods in the metrics used in this math expression. Default: Duration.minutes(5)
@@ -8688,22 +8693,27 @@ class MathExpressionProps(MathExpressionOptions):
         :param search_account: Account to evaluate search expressions within. Specifying a searchAccount has no effect to the account used for metrics within the expression (passed via usingMetrics). Default: - Deployment account.
         :param search_region: Region to evaluate search expressions within. Specifying a searchRegion has no effect to the region used for metrics within the expression (passed via usingMetrics). Default: - Deployment region.
         :param expression: The expression defining the metric. When an expression contains a SEARCH function, it cannot be used within an Alarm.
-        :param using_metrics: The metrics used in the expression, in a map. The key is the identifier that represents the given metric in the expression, and the value is the actual Metric object. Default: - Empty map.
+        :param using_metrics: The metrics used in the expression, in a map. The key is the identifier that represents the given metric in the expression, and the value is the actual Metric object. The ``period`` of each metric in ``usingMetrics`` is ignored and instead overridden by the ``period`` specified for the ``MathExpression`` construct. Even if no ``period`` is specified for the ``MathExpression``, it will be overridden by the default value (``Duration.minutes(5)``). Example:: declare const metrics: elbv2.IApplicationLoadBalancerMetrics; new cloudwatch.MathExpression({ expression: 'm1+m2', label: 'AlbErrors', usingMetrics: { m1: metrics.custom('HTTPCode_ELB_500_Count', { period: Duration.minutes(1), // <- This period will be ignored statistic: 'Sum', label: 'HTTPCode_ELB_500_Count', }), m2: metrics.custom('HTTPCode_ELB_502_Count', { period: Duration.minutes(1), // <- This period will be ignored statistic: 'Sum', label: 'HTTPCode_ELB_502_Count', }), }, period: Duration.minutes(3), // <- This overrides the period of each metric in `usingMetrics` // (Even if not specified, it is overridden by the default value) }); Default: - Empty map.
 
         :exampleMetadata: infused
 
         Example::
 
-            # fn: lambda.Function
-            
+            # matchmaking_rule_set: gamelift.MatchmakingRuleSet
             
-            all_problems = cloudwatch.MathExpression(
-                expression="errors + throttles",
+            # 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={
-                    "errors": fn.metric_errors(),
-                    "throttles": fn.metric_throttles()
+                    "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=rule_evaluation_ratio,
+                threshold=0.1,
+                evaluation_periods=3
+            )
         '''
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__7cfb588e44acd0977aa0e09f00c3e2435bad84385ab7b6d163b332963d844e0a)
@@ -8821,6 +8831,33 @@ class MathExpressionProps(MathExpressionOptions):
         The key is the identifier that represents the given metric in the
         expression, and the value is the actual Metric object.
 
+        The ``period`` of each metric in ``usingMetrics`` is ignored and instead overridden
+        by the ``period`` specified for the ``MathExpression`` construct. Even if no ``period``
+        is specified for the ``MathExpression``, it will be overridden by the default
+        value (``Duration.minutes(5)``).
+
+        Example::
+
+           # metrics: elbv2.IApplicationLoadBalancerMetrics
+
+           cloudwatch.MathExpression(
+               expression="m1+m2",
+               label="AlbErrors",
+               using_metrics={
+                   "m1": metrics.custom("HTTPCode_ELB_500_Count",
+                       period=Duration.minutes(1),  # <- This period will be ignored
+                       statistic="Sum",
+                       label="HTTPCode_ELB_500_Count"
+                   ),
+                   "m2": metrics.custom("HTTPCode_ELB_502_Count",
+                       period=Duration.minutes(1),  # <- This period will be ignored
+                       statistic="Sum",
+                       label="HTTPCode_ELB_502_Count"
+                   )
+               },
+               period=Duration.minutes(3)
+           )
+
         :default: - Empty map.
         '''
         result = self._values.get("using_metrics")

aws_cdk/aws_codebuild/__init__.py

@@ -3416,6 +3416,7 @@ class CfnProject(
             ),
         
             # the properties below are optional
+            auto_retry_limit=123,
             badge_enabled=False,
             build_batch_config=codebuild.CfnProject.ProjectBuildBatchConfigProperty(
                 batch_report_mode="batchReportMode",
@@ -3546,6 +3547,7 @@ class CfnProject(
         environment: typing.Union[_IResolvable_da3f097b, typing.Union["CfnProject.EnvironmentProperty", typing.Dict[builtins.str, typing.Any]]],
         service_role: builtins.str,
         source: typing.Union[_IResolvable_da3f097b, typing.Union["CfnProject.SourceProperty", typing.Dict[builtins.str, typing.Any]]],
+        auto_retry_limit: typing.Optional[jsii.Number] = None,
         badge_enabled: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,
         build_batch_config: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union["CfnProject.ProjectBuildBatchConfigProperty", typing.Dict[builtins.str, typing.Any]]]] = None,
         cache: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union["CfnProject.ProjectCacheProperty", typing.Dict[builtins.str, typing.Any]]]] = None,
@@ -3574,6 +3576,7 @@ class CfnProject(
         :param environment: The build environment settings for the project, such as the environment type or the environment variables to use for the build environment.
         :param service_role: The ARN of the IAM role that enables AWS CodeBuild to interact with dependent AWS services on behalf of the AWS account.
         :param source: The source code settings for the project, such as the source code's repository type and location.
+        :param auto_retry_limit: 
         :param badge_enabled: Indicates whether AWS CodeBuild generates a publicly accessible URL for your project's build badge. For more information, see `Build Badges Sample <https://docs.aws.amazon.com/codebuild/latest/userguide/sample-build-badges.html>`_ in the *AWS CodeBuild User Guide* . .. epigraph:: Including build badges with your project is currently not supported if the source type is CodePipeline. If you specify ``CODEPIPELINE`` for the ``Source`` property, do not specify the ``BadgeEnabled`` property.
         :param build_batch_config: A ``ProjectBuildBatchConfig`` object that defines the batch build options for the project.
         :param cache: Settings that AWS CodeBuild uses to store and reuse build dependencies.
@@ -3604,6 +3607,7 @@ class CfnProject(
             environment=environment,
             service_role=service_role,
             source=source,
+            auto_retry_limit=auto_retry_limit,
             badge_enabled=badge_enabled,
             build_batch_config=build_batch_config,
             cache=cache,
@@ -3753,6 +3757,18 @@ class CfnProject(
             check_type(argname="argument value", value=value, expected_type=type_hints["value"])
         jsii.set(self, "source", value) # pyright: ignore[reportArgumentType]
 
+    @builtins.property
+    @jsii.member(jsii_name="autoRetryLimit")
+    def auto_retry_limit(self) -> typing.Optional[jsii.Number]:
+        return typing.cast(typing.Optional[jsii.Number], jsii.get(self, "autoRetryLimit"))
+
+    @auto_retry_limit.setter
+    def auto_retry_limit(self, value: typing.Optional[jsii.Number]) -> None:
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__982f9c7096ad20ce601ce4532b3b19f5ed1ae300d09c6f58822544aaae67a03b)
+            check_type(argname="argument value", value=value, expected_type=type_hints["value"])
+        jsii.set(self, "autoRetryLimit", value) # pyright: ignore[reportArgumentType]
+
     @builtins.property
     @jsii.member(jsii_name="badgeEnabled")
     def badge_enabled(
@@ -6586,6 +6602,7 @@ class CfnProject(
         "environment": "environment",
         "service_role": "serviceRole",
         "source": "source",
+        "auto_retry_limit": "autoRetryLimit",
         "badge_enabled": "badgeEnabled",
         "build_batch_config": "buildBatchConfig",
         "cache": "cache",
@@ -6616,6 +6633,7 @@ class CfnProjectProps:
         environment: typing.Union[_IResolvable_da3f097b, typing.Union[CfnProject.EnvironmentProperty, typing.Dict[builtins.str, typing.Any]]],
         service_role: builtins.str,
         source: typing.Union[_IResolvable_da3f097b, typing.Union[CfnProject.SourceProperty, typing.Dict[builtins.str, typing.Any]]],
+        auto_retry_limit: typing.Optional[jsii.Number] = None,
         badge_enabled: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,
         build_batch_config: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union[CfnProject.ProjectBuildBatchConfigProperty, typing.Dict[builtins.str, typing.Any]]]] = None,
         cache: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union[CfnProject.ProjectCacheProperty, typing.Dict[builtins.str, typing.Any]]]] = None,
@@ -6643,6 +6661,7 @@ class CfnProjectProps:
         :param environment: The build environment settings for the project, such as the environment type or the environment variables to use for the build environment.
         :param service_role: The ARN of the IAM role that enables AWS CodeBuild to interact with dependent AWS services on behalf of the AWS account.
         :param source: The source code settings for the project, such as the source code's repository type and location.
+        :param auto_retry_limit: 
         :param badge_enabled: Indicates whether AWS CodeBuild generates a publicly accessible URL for your project's build badge. For more information, see `Build Badges Sample <https://docs.aws.amazon.com/codebuild/latest/userguide/sample-build-badges.html>`_ in the *AWS CodeBuild User Guide* . .. epigraph:: Including build badges with your project is currently not supported if the source type is CodePipeline. If you specify ``CODEPIPELINE`` for the ``Source`` property, do not specify the ``BadgeEnabled`` property.
         :param build_batch_config: A ``ProjectBuildBatchConfig`` object that defines the batch build options for the project.
         :param cache: Settings that AWS CodeBuild uses to store and reuse build dependencies.
@@ -6738,6 +6757,7 @@ class CfnProjectProps:
                 ),
             
                 # the properties below are optional
+                auto_retry_limit=123,
                 badge_enabled=False,
                 build_batch_config=codebuild.CfnProject.ProjectBuildBatchConfigProperty(
                     batch_report_mode="batchReportMode",
@@ -6864,6 +6884,7 @@ class CfnProjectProps:
             check_type(argname="argument environment", value=environment, expected_type=type_hints["environment"])
             check_type(argname="argument service_role", value=service_role, expected_type=type_hints["service_role"])
             check_type(argname="argument source", value=source, expected_type=type_hints["source"])
+            check_type(argname="argument auto_retry_limit", value=auto_retry_limit, expected_type=type_hints["auto_retry_limit"])
             check_type(argname="argument badge_enabled", value=badge_enabled, expected_type=type_hints["badge_enabled"])
             check_type(argname="argument build_batch_config", value=build_batch_config, expected_type=type_hints["build_batch_config"])
             check_type(argname="argument cache", value=cache, expected_type=type_hints["cache"])
@@ -6890,6 +6911,8 @@ class CfnProjectProps:
             "service_role": service_role,
             "source": source,
         }
+        if auto_retry_limit is not None:
+            self._values["auto_retry_limit"] = auto_retry_limit
         if badge_enabled is not None:
             self._values["badge_enabled"] = badge_enabled
         if build_batch_config is not None:
@@ -6975,6 +6998,14 @@ class CfnProjectProps:
         assert result is not None, "Required property 'source' is missing"
         return typing.cast(typing.Union[_IResolvable_da3f097b, CfnProject.SourceProperty], result)
 
+    @builtins.property
+    def auto_retry_limit(self) -> typing.Optional[jsii.Number]:
+        '''
+        :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-codebuild-project.html#cfn-codebuild-project-autoretrylimit
+        '''
+        result = self._values.get("auto_retry_limit")
+        return typing.cast(typing.Optional[jsii.Number], result)
+
     @builtins.property
     def badge_enabled(
         self,
@@ -18365,6 +18396,7 @@ def _typecheckingstub__7b09683005eb57000f0fc4ae40bb6720b934248e0cfb890644ad74d57
     environment: typing.Union[_IResolvable_da3f097b, typing.Union[CfnProject.EnvironmentProperty, typing.Dict[builtins.str, typing.Any]]],
     service_role: builtins.str,
     source: typing.Union[_IResolvable_da3f097b, typing.Union[CfnProject.SourceProperty, typing.Dict[builtins.str, typing.Any]]],
+    auto_retry_limit: typing.Optional[jsii.Number] = None,
     badge_enabled: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,
     build_batch_config: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union[CfnProject.ProjectBuildBatchConfigProperty, typing.Dict[builtins.str, typing.Any]]]] = None,
     cache: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union[CfnProject.ProjectCacheProperty, typing.Dict[builtins.str, typing.Any]]]] = None,
@@ -18425,6 +18457,12 @@ def _typecheckingstub__1c380bec8add38a9402c557e44b425d5b187bcc5edacf6ce6379ab4da
     """Type checking stubs"""
     pass
 
+def _typecheckingstub__982f9c7096ad20ce601ce4532b3b19f5ed1ae300d09c6f58822544aaae67a03b(
+    value: typing.Optional[jsii.Number],
+) -> None:
+    """Type checking stubs"""
+    pass
+
 def _typecheckingstub__b88d7a5e667269d00acc9148cb550d229e0c38feacefc2756938b6a6e77bd47b(
     value: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]],
 ) -> None:
@@ -18752,6 +18790,7 @@ def _typecheckingstub__771488c432b07e7a9597fd7e3125dfaabba88ae360a8be97bedd4b41e
     environment: typing.Union[_IResolvable_da3f097b, typing.Union[CfnProject.EnvironmentProperty, typing.Dict[builtins.str, typing.Any]]],
     service_role: builtins.str,
     source: typing.Union[_IResolvable_da3f097b, typing.Union[CfnProject.SourceProperty, typing.Dict[builtins.str, typing.Any]]],
+    auto_retry_limit: typing.Optional[jsii.Number] = None,
     badge_enabled: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,
     build_batch_config: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union[CfnProject.ProjectBuildBatchConfigProperty, typing.Dict[builtins.str, typing.Any]]]] = None,
     cache: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union[CfnProject.ProjectCacheProperty, typing.Dict[builtins.str, typing.Any]]]] = None,

aws_cdk/aws_codepipeline/__init__.py

@@ -3699,7 +3699,7 @@ class CfnPipeline(
         ) -> None:
             '''The condition for the stage.
 
-            A condition is made up of the rules and the result for the condition.
+            A condition is made up of the rules and the result for the condition. For more information about conditions, see `Stage conditions <https://docs.aws.amazon.com/codepipeline/latest/userguide/stage-conditions.html>`_ . For more information about rules, see the `AWS CodePipeline rule reference <https://docs.aws.amazon.com/codepipeline/latest/userguide/rule-reference.html>`_ .
 
             :param result: The action to be done when the condition is met. For example, rolling back an execution for a failure condition.
             :param rules: The rules that make up the condition.
@@ -4829,11 +4829,11 @@ class CfnPipeline(
         ) -> None:
             '''Represents information about the rule to be created for an associated condition.
 
-            An example would be creating a new rule for an entry condition, such as a rule that checks for a test result before allowing the run to enter the deployment stage.
+            An example would be creating a new rule for an entry condition, such as a rule that checks for a test result before allowing the run to enter the deployment stage. For more information about conditions, see `Stage conditions <https://docs.aws.amazon.com/codepipeline/latest/userguide/stage-conditions.html>`_ . For more information about rules, see the `AWS CodePipeline rule reference <https://docs.aws.amazon.com/codepipeline/latest/userguide/rule-reference.html>`_ .
 
             :param configuration: The action configuration fields for the rule.
             :param input_artifacts: The input artifacts fields for the rule, such as specifying an input file for the rule.
-            :param name: The name of the rule that is created for the condition, such as CheckAllResults.
+            :param name: The name of the rule that is created for the condition, such as ``VariableCheck`` .
             :param region: The Region for the condition associated with the rule.
             :param role_arn: The pipeline role ARN associated with the rule.
             :param rule_type_id: The ID for the rule type, which is made up of the combined values for category, owner, provider, and version.
@@ -4909,7 +4909,7 @@ class CfnPipeline(
 
         @builtins.property
         def name(self) -> typing.Optional[builtins.str]:
-            '''The name of the rule that is created for the condition, such as CheckAllResults.
+            '''The name of the rule that is created for the condition, such as ``VariableCheck`` .
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-codepipeline-pipeline-ruledeclaration.html#cfn-codepipeline-pipeline-ruledeclaration-name
             '''