aws-cdk-lib 2.73.0__py3-none-any.whl → 2.76.0__py3-none-any.whl

aws_cdk/aws_batch/__init__.py

@@ -79,12 +79,19 @@ class CfnComputeEnvironment(
        - Remove the earlier compute environment from your job queue.
        - Delete the earlier compute environment.
 
-       In April 2022, AWS Batch added enhanced support for updating compute environments. For more information, see `Updating compute environments <https://docs.aws.amazon.com/batch/latest/userguide/updating-compute-environments.html>`_ in the *AWS Batch User Guide* . To use the enhanced updating of compute environments to update AMIs, follow these rules:
+       In April 2022, AWS Batch added enhanced support for updating compute environments. For example, the ``UpdateComputeEnvironent`` API lets you use the ``ReplaceComputeEnvironment`` property to dynamically update compute environment parameters such as the launch template or instance type without replacement. For more information, see `Updating compute environments <https://docs.aws.amazon.com/batch/latest/userguide/updating-compute-environments.html>`_ in the *AWS Batch User Guide* .
+
+       To use the enhanced updating of compute environments to update AMIs, follow these rules:
 
        - Either do not set the `ServiceRole <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-batch-computeenvironment.html#cfn-batch-computeenvironment-servicerole>`_ property or set it to the *AWSServiceRoleForBatch* service-linked role.
        - Set the `AllocationStrategy <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-batch-computeenvironment-computeresources.html#cfn-batch-computeenvironment-computeresources-allocationstrategy>`_ property to ``BEST_FIT_PROGRESSIVE`` or ``SPOT_CAPACITY_OPTIMIZED`` .
        - Set the `ReplaceComputeEnvironment <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-batch-computeenvironment.html#cfn-batch-computeenvironment-replacecomputeenvironment>`_ property to ``false`` .
-       - Set the `UpdateToLatestImageVersion <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-batch-computeenvironment-computeresources.html#cfn-batch-computeenvironment-computeresources-updatetolatestimageversion>`_ property to ``true`` .
+
+       .. epigraph::
+
+          Set the ``ReplaceComputeEnvironment`` property to ``false`` if the compute environment uses the ``BEST_FIT`` allocation strategy. > If the ``ReplaceComputeEnvironment`` property is set to ``false`` , you might receive an error message when you update the CFN template for a compute environment. This issue occurs if the updated ``desiredvcpus`` value is less than the current ``desiredvcpus`` value. As a workaround, delete the ``desiredvcpus`` value from the updated template or use the ``minvcpus`` property to manage the number of vCPUs. For information, see `Error message when you update the ``DesiredvCpus`` setting <https://docs.aws.amazon.com/batch/latest/userguide/troubleshooting.html#error-desired-vcpus-update>`_ .
+
+       - Set the `UpdateToLatestImageVersion <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-batch-computeenvironment-computeresources.html#cfn-batch-computeenvironment-computeresources-updatetolatestimageversion>`_ property to ``true`` . This property is used when you update a compute environment. The `UpdateToLatestImageVersion <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-batch-computeenvironment-computeresources.html#cfn-batch-computeenvironment-computeresources-updatetolatestimageversion>`_ property is ignored when you create a compute environment.
        - Either do not specify an image ID in `ImageId <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-batch-computeenvironment-computeresources.html#cfn-batch-computeenvironment-computeresources-imageid>`_ or `ImageIdOverride <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-batch-computeenvironment-ec2configurationobject.html#cfn-batch-computeenvironment-ec2configurationobject-imageidoverride>`_ properties, or in the launch template identified by the `Launch Template <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-batch-computeenvironment-computeresources.html#cfn-batch-computeenvironment-computeresources-launchtemplate>`_ property. In that case AWS Batch will select the latest Amazon ECS optimized AMI supported by AWS Batch at the time the infrastructure update is initiated. Alternatively you can specify the AMI ID in the ``ImageId`` or ``ImageIdOverride`` properties, or the launch template identified by the ``LaunchTemplate`` properties. Changing any of these properties will trigger an infrastructure update.
 
        If these rules are followed, any update that triggers an infrastructure update will cause the AMI ID to be re-selected. If the `Version <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-batch-computeenvironment-launchtemplatespecification.html#cfn-batch-computeenvironment-launchtemplatespecification-version>`_ property of the `LaunchTemplateSpecification <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-batch-computeenvironment-launchtemplatespecification.html>`_ is set to ``$Latest`` or ``$Default`` , the latest or default version of the launch template will be evaluated up at the time of the infrastructure update, even if the ``LaunchTemplateSpecification`` was not updated.

aws_cdk/aws_billingconductor/__init__.py

@@ -1726,7 +1726,7 @@ class CfnPricingRule(
         :param billing_entity: The seller of services provided by AWS , their affiliates, or third-party providers selling services via AWS Marketplace .
         :param description: The pricing rule description.
         :param modifier_percentage: A percentage modifier applied on the public pricing rates.
-        :param operation: ``AWS::BillingConductor::PricingRule.Operation``.
+        :param operation: Operation is the specific AWS action covered by this line item. This describes the specific usage of the line item.
         :param service: If the ``Scope`` attribute is ``SERVICE`` , this attribute indicates which service the ``PricingRule`` is applicable for.
         :param tags: A map that contains tag keys and tag values that are attached to a pricing rule.
         :param tiering: The set of tiering configurations for the pricing rule.
@@ -1931,7 +1931,9 @@ class CfnPricingRule(
     @builtins.property
     @jsii.member(jsii_name="operation")
     def operation(self) -> typing.Optional[builtins.str]:
-        '''``AWS::BillingConductor::PricingRule.Operation``.
+        '''Operation is the specific AWS action covered by this line item.
+
+        This describes the specific usage of the line item.
 
         :link: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-billingconductor-pricingrule.html#cfn-billingconductor-pricingrule-operation
         '''
@@ -2008,8 +2010,9 @@ class CfnPricingRule(
             *,
             activated: typing.Union[builtins.bool, _IResolvable_da3f097b],
         ) -> None:
-            '''
-            :param activated: ``CfnPricingRule.FreeTierProperty.Activated``.
+            '''The possible AWS Free Tier configurations.
+
+            :param activated: Activate or deactivate AWS Free Tier.
 
             :link: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-billingconductor-pricingrule-freetier.html
             :exampleMetadata: fixture=_generated
@@ -2033,7 +2036,7 @@ class CfnPricingRule(
 
         @builtins.property
         def activated(self) -> typing.Union[builtins.bool, _IResolvable_da3f097b]:
-            '''``CfnPricingRule.FreeTierProperty.Activated``.
+            '''Activate or deactivate AWS Free Tier.
 
             :link: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-billingconductor-pricingrule-freetier.html#cfn-billingconductor-pricingrule-freetier-activated
             '''
@@ -2152,7 +2155,7 @@ class CfnPricingRuleProps:
         :param billing_entity: The seller of services provided by AWS , their affiliates, or third-party providers selling services via AWS Marketplace .
         :param description: The pricing rule description.
         :param modifier_percentage: A percentage modifier applied on the public pricing rates.
-        :param operation: ``AWS::BillingConductor::PricingRule.Operation``.
+        :param operation: Operation is the specific AWS action covered by this line item. This describes the specific usage of the line item.
         :param service: If the ``Scope`` attribute is ``SERVICE`` , this attribute indicates which service the ``PricingRule`` is applicable for.
         :param tags: A map that contains tag keys and tag values that are attached to a pricing rule.
         :param tiering: The set of tiering configurations for the pricing rule.
@@ -2284,7 +2287,9 @@ class CfnPricingRuleProps:
 
     @builtins.property
     def operation(self) -> typing.Optional[builtins.str]:
-        '''``AWS::BillingConductor::PricingRule.Operation``.
+        '''Operation is the specific AWS action covered by this line item.
+
+        This describes the specific usage of the line item.
 
         :link: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-billingconductor-pricingrule.html#cfn-billingconductor-pricingrule-operation
         '''

aws_cdk/aws_budgets/__init__.py

@@ -249,10 +249,9 @@ class CfnBudget(
             auto_adjust_type: builtins.str,
             historical_options: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union["CfnBudget.HistoricalOptionsProperty", typing.Dict[builtins.str, typing.Any]]]] = None,
         ) -> None:
-            '''The parameters that determine the budget amount for an auto-adjusting budget.
-
-            :param auto_adjust_type: The string that defines whether your budget auto-adjusts based on historical or forecasted data.
-            :param historical_options: The parameters that define or describe the historical data that your auto-adjusting budget is based on.
+            '''
+            :param auto_adjust_type: ``CfnBudget.AutoAdjustDataProperty.AutoAdjustType``.
+            :param historical_options: ``CfnBudget.AutoAdjustDataProperty.HistoricalOptions``.
 
             :link: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-budgets-budget-autoadjustdata.html
             :exampleMetadata: fixture=_generated
@@ -284,7 +283,7 @@ class CfnBudget(
 
         @builtins.property
         def auto_adjust_type(self) -> builtins.str:
-            '''The string that defines whether your budget auto-adjusts based on historical or forecasted data.
+            '''``CfnBudget.AutoAdjustDataProperty.AutoAdjustType``.
 
             :link: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-budgets-budget-autoadjustdata.html#cfn-budgets-budget-autoadjustdata-autoadjusttype
             '''
@@ -296,7 +295,7 @@ class CfnBudget(
         def historical_options(
             self,
         ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnBudget.HistoricalOptionsProperty"]]:
-            '''The parameters that define or describe the historical data that your auto-adjusting budget is based on.
+            '''``CfnBudget.AutoAdjustDataProperty.HistoricalOptions``.
 
             :link: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-budgets-budget-autoadjustdata.html#cfn-budgets-budget-autoadjustdata-historicaloptions
             '''
@@ -852,9 +851,8 @@ class CfnBudget(
     )
     class HistoricalOptionsProperty:
         def __init__(self, *, budget_adjustment_period: jsii.Number) -> None:
-            '''The parameters that define or describe the historical data that your auto-adjusting budget is based on.
-
-            :param budget_adjustment_period: The number of budget periods included in the moving-average calculation that determines your auto-adjusted budget amount. The maximum value depends on the ``TimeUnit`` granularity of the budget: - For the ``DAILY`` granularity, the maximum value is ``60`` . - For the ``MONTHLY`` granularity, the maximum value is ``12`` . - For the ``QUARTERLY`` granularity, the maximum value is ``4`` . - For the ``ANNUALLY`` granularity, the maximum value is ``1`` .
+            '''
+            :param budget_adjustment_period: ``CfnBudget.HistoricalOptionsProperty.BudgetAdjustmentPeriod``.
 
             :link: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-budgets-budget-historicaloptions.html
             :exampleMetadata: fixture=_generated
@@ -878,14 +876,7 @@ class CfnBudget(
 
         @builtins.property
         def budget_adjustment_period(self) -> jsii.Number:
-            '''The number of budget periods included in the moving-average calculation that determines your auto-adjusted budget amount.
-
-            The maximum value depends on the ``TimeUnit`` granularity of the budget:
-
-            - For the ``DAILY`` granularity, the maximum value is ``60`` .
-            - For the ``MONTHLY`` granularity, the maximum value is ``12`` .
-            - For the ``QUARTERLY`` granularity, the maximum value is ``4`` .
-            - For the ``ANNUALLY`` granularity, the maximum value is ``1`` .
+            '''``CfnBudget.HistoricalOptionsProperty.BudgetAdjustmentPeriod``.
 
             :link: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-budgets-budget-historicaloptions.html#cfn-budgets-budget-historicaloptions-budgetadjustmentperiod
             '''

aws_cdk/aws_certificatemanager/__init__.py

@@ -99,7 +99,10 @@ in order to access the cross stack/region certificate.
 > **This feature is currently experimental**
 
 ```python
-# Example automatically generated from non-compiling source. May contain errors.
+from aws_cdk import aws_cloudfront as cloudfront, aws_cloudfront_origins as origins
+# app: App
+
+
 stack1 = Stack(app, "Stack1",
     env=Environment(
         region="us-east-1"
@@ -119,9 +122,9 @@ stack2 = Stack(app, "Stack2",
 )
 
 cloudfront.Distribution(stack2, "Distribution",
-    default_behavior={
-        "origin": origins.HttpOrigin("example.com")
-    },
+    default_behavior=cloudfront.BehaviorOptions(
+        origin=origins.HttpOrigin("example.com")
+    ),
     domain_names=["dev.example.com"],
     certificate=cert
 )

aws_cdk/aws_cloudfront/__init__.py

@@ -128,7 +128,12 @@ enabled it is possible to do something like creating a CloudFront distribution i
 an ACM certificate in `us-east-1`.
 
 ```python
-# Example automatically generated from non-compiling source. May contain errors.
+import aws_cdk.aws_certificatemanager as acm
+import aws_cdk.aws_route53 as route53
+
+# app: App
+
+
 stack1 = Stack(app, "Stack1",
     env=Environment(
         region="us-east-1"
@@ -20959,20 +20964,18 @@ class Distribution(
 
     Example::
 
-        # Adding an existing Lambda@Edge function created in a different stack
-        # to a CloudFront distribution.
         # s3_bucket: s3.Bucket
-        
-        function_version = lambda_.Version.from_version_arn(self, "Version", "arn:aws:lambda:us-east-1:123456789012:function:functionName:1")
-        
+        # Add a cloudfront Function to a Distribution
+        cf_function = cloudfront.Function(self, "Function",
+            code=cloudfront.FunctionCode.from_inline("function handler(event) { return event.request }")
+        )
         cloudfront.Distribution(self, "distro",
             default_behavior=cloudfront.BehaviorOptions(
                 origin=origins.S3Origin(s3_bucket),
-                edge_lambdas=[cloudfront.EdgeLambda(
-                    function_version=function_version,
-                    event_type=cloudfront.LambdaEdgeEventType.VIEWER_REQUEST
-                )
-                ]
+                function_associations=[cloudfront.FunctionAssociation(
+                    function=cf_function,
+                    event_type=cloudfront.FunctionEventType.VIEWER_REQUEST
+                )]
             )
         )
     '''

aws_cdk/aws_cloudfront_origins/__init__.py

@@ -179,15 +179,25 @@ class HttpOrigin(
 
     Example::
 
-        my_bucket = s3.Bucket(self, "myBucket")
-        cloudfront.Distribution(self, "myDist",
+        # Validating signed URLs or signed cookies with Trusted Key Groups
+        
+        # public key in PEM format
+        # public_key: str
+        
+        pub_key = cloudfront.PublicKey(self, "MyPubKey",
+            encoded_key=public_key
+        )
+        
+        key_group = cloudfront.KeyGroup(self, "MyKeyGroup",
+            items=[pub_key
+            ]
+        )
+        
+        cloudfront.Distribution(self, "Dist",
             default_behavior=cloudfront.BehaviorOptions(
-                origin=origins.OriginGroup(
-                    primary_origin=origins.S3Origin(my_bucket),
-                    fallback_origin=origins.HttpOrigin("www.example.com"),
-                    # optional, defaults to: 500, 502, 503 and 504
-                    fallback_status_codes=[404]
-                )
+                origin=origins.HttpOrigin("www.example.com"),
+                trusted_key_groups=[key_group
+                ]
             )
         )
     '''

aws_cdk/aws_cloudtrail/__init__.py

@@ -196,9 +196,8 @@ Set `InsightSelector` to enable Insight.
 Insights selector values can be `ApiCallRateInsight`, `ApiErrorRateInsight`, or both.
 
 ```python
-# Example automatically generated from non-compiling source. May contain errors.
-Trail(stack, "Insights",
-    insight_types=[InsightType.API_CALL_RATE, InsightType.API_ERROR_RATE
+cloudtrail.Trail(self, "Insights",
+    insight_types=[cloudtrail.InsightType.API_CALL_RATE, cloudtrail.InsightType.API_ERROR_RATE
     ]
 )
 ```
@@ -269,7 +268,6 @@ class AddEventSelectorOptions:
 
         Example::
 
-            # Example automatically generated from non-compiling source. May contain errors.
             import aws_cdk.aws_cloudtrail as cloudtrail
             
             # source_bucket: s3.Bucket
@@ -3020,15 +3018,14 @@ class InsightType(
 ):
     '''Util element for InsightSelector.
 
-    :exampleMetadata: fixture=_generated
+    :exampleMetadata: infused
 
     Example::
 
-        # The code below shows an example of how to instantiate this type.
-        # The values are placeholders you should change.
-        from aws_cdk import aws_cloudtrail as cloudtrail
-        
-        insight_type = cloudtrail.InsightType.API_CALL_RATE
+        cloudtrail.Trail(self, "Insights",
+            insight_types=[cloudtrail.InsightType.API_CALL_RATE, cloudtrail.InsightType.API_ERROR_RATE
+            ]
+        )
     '''
 
     def __init__(self, value: builtins.str) -> None:
@@ -3190,10 +3187,6 @@ class Trail(
 
     const cloudTrail = new CloudTrail(this, 'MyTrail');
 
-    NOTE the above example creates an UNENCRYPTED bucket by default,
-    If you are required to use an Encrypted bucket you can supply a preconfigured bucket
-    via TrailProps
-
     :exampleMetadata: infused
 
     Example::

aws_cdk/aws_cloudwatch/__init__.py

@@ -182,7 +182,9 @@ The most common values are provided in the `cloudwatch.Stats` class. You can pro
 Read more at [CloudWatch statistics definitions](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/Statistics-definitions.html).
 
 ```python
-# Example automatically generated from non-compiling source. May contain errors.
+# hosted_zone: route53.HostedZone
+
+
 cloudwatch.Metric(
     namespace="AWS/Route53",
     metric_name="DNSQueries",
@@ -190,7 +192,7 @@ cloudwatch.Metric(
         "HostedZoneId": hosted_zone.hosted_zone_id
     },
     statistic=cloudwatch.Stats.SAMPLE_COUNT,
-    period=cloudwatch.Duration.minutes(5)
+    period=Duration.minutes(5)
 )
 
 cloudwatch.Metric(
@@ -200,7 +202,7 @@ cloudwatch.Metric(
         "HostedZoneId": hosted_zone.hosted_zone_id
     },
     statistic=cloudwatch.Stats.p(99),
-    period=cloudwatch.Duration.minutes(5)
+    period=Duration.minutes(5)
 )
 
 cloudwatch.Metric(
@@ -210,7 +212,7 @@ cloudwatch.Metric(
         "HostedZoneId": hosted_zone.hosted_zone_id
     },
     statistic="TS(7.5%:90%)",
-    period=cloudwatch.Duration.minutes(5)
+    period=Duration.minutes(5)
 )
 ```
 
@@ -344,9 +346,8 @@ cloudwatch.CompositeAlarm(self, "MyAwesomeCompositeAlarm",
 If you want to disable actions of a Composite Alarm based on a certain condition, you can use [Actions Suppression](https://www.amazonaws.cn/en/new/2022/amazon-cloudwatch-supports-composite-alarm-actions-suppression/).
 
 ```python
-# Example automatically generated from non-compiling source. May contain errors.
-# child_alarm1: cloudwatch.Alarm
-# child_alarm2: cloudwatch.Alarm
+# alarm1: cloudwatch.Alarm
+# alarm2: cloudwatch.Alarm
 # on_alarm_action: cloudwatch.IAlarmAction
 # on_ok_action: cloudwatch.IAlarmAction
 # actions_suppressor: cloudwatch.Alarm
@@ -358,8 +359,8 @@ my_composite_alarm = cloudwatch.CompositeAlarm(self, "MyAwesomeCompositeAlarm",
     alarm_rule=alarm_rule,
     actions_suppressor=actions_suppressor
 )
-my_composite_alarm.add_alarm_actions(on_alarm_action)
-my_composire_alarm.add_ok_action(on_ok_action)
+my_composite_alarm.add_alarm_action(on_alarm_action)
+my_composite_alarm.add_ok_action(on_ok_action)
 ```
 
 In the provided example, if `actionsSuppressor` is in `ALARM` state, `onAlarmAction` won't be triggered even if `myCompositeAlarm` goes into `ALARM` state.
@@ -572,13 +573,12 @@ dashboard.add_widgets(cloudwatch.TextWidget(
 Optionally set the TextWidget background to be transparent
 
 ```python
-# Example automatically generated from non-compiling source. May contain errors.
 # dashboard: cloudwatch.Dashboard
 
 
 dashboard.add_widgets(cloudwatch.TextWidget(
     markdown="# Key Performance Indicators",
-    background=TextWidgetBackground.TRANSPARENT
+    background=cloudwatch.TextWidgetBackground.TRANSPARENT
 ))
 ```
 
@@ -706,15 +706,14 @@ You can add a widget after object instantiation with the method
 ### Interval duration for dashboard
 
 Interval duration for metrics in dashboard. You can specify `defaultInterval` with
-the relative time(eg. 7 days) as `cdk.Duration.days(7)`.
+the relative time(eg. 7 days) as `Duration.days(7)`.
 
 ```python
-# Example automatically generated from non-compiling source. May contain errors.
 import aws_cdk.aws_cloudwatch as cw
 
 
-dashboard = cw.Dashboard(stack, "Dash",
-    default_interval=cdk.Duration.days(7)
+dashboard = cw.Dashboard(self, "Dash",
+    default_interval=Duration.days(7)
 )
 ```
 
@@ -6831,12 +6830,11 @@ class Dashboard(
 
     Example::
 
-        # Example automatically generated from non-compiling source. May contain errors.
         import aws_cdk.aws_cloudwatch as cw
         
         
-        dashboard = cw.Dashboard(stack, "Dash",
-            default_interval=cdk.Duration.days(7)
+        dashboard = cw.Dashboard(self, "Dash",
+            default_interval=Duration.days(7)
         )
     '''
 
@@ -6949,12 +6947,11 @@ class DashboardProps:
 
         Example::
 
-            # Example automatically generated from non-compiling source. May contain errors.
             import aws_cdk.aws_cloudwatch as cw
             
             
-            dashboard = cw.Dashboard(stack, "Dash",
-                default_interval=cdk.Duration.days(7)
+            dashboard = cw.Dashboard(self, "Dash",
+                default_interval=Duration.days(7)
             )
         '''
         if __debug__:
@@ -8795,19 +8792,23 @@ class MetricOptions(CommonMetricOptions):
 
         Example::
 
-            # matchmaking_rule_set: gamelift.MatchmakingRuleSet
+            import aws_cdk.aws_cloudwatch as cloudwatch
+            
+            # delivery_stream: firehose.DeliveryStream
+            
             
-            # Alarm that triggers when the per-second average of not placed matches exceed 10%
-            rule_evaluation_ratio = cloudwatch.MathExpression(
-                expression="1 - (ruleEvaluationsPassed / ruleEvaluationsFailed)",
+            # 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",
                 using_metrics={
-                    "rule_evaluations_passed": matchmaking_rule_set.metric_rule_evaluations_passed(statistic=cloudwatch.Statistic.SUM),
-                    "rule_evaluations_failed": matchmaking_rule_set.metric("ruleEvaluationsFailed")
+                    "incoming_bytes": delivery_stream.metric_incoming_bytes(statistic=cloudwatch.Statistic.SUM),
+                    "byte_per_sec_limit": delivery_stream.metric("BytesPerSecondLimit")
                 }
             )
+            
             cloudwatch.Alarm(self, "Alarm",
-                metric=rule_evaluation_ratio,
-                threshold=0.1,
+                metric=incoming_bytes_percent_of_limit,
+                threshold=0.9,
                 evaluation_periods=3
             )
         '''
@@ -10301,13 +10302,12 @@ class TextWidgetBackground(enum.Enum):
 
     Example::
 
-        # Example automatically generated from non-compiling source. May contain errors.
         # dashboard: cloudwatch.Dashboard
         
         
         dashboard.add_widgets(cloudwatch.TextWidget(
             markdown="# Key Performance Indicators",
-            background=TextWidgetBackground.TRANSPARENT
+            background=cloudwatch.TextWidgetBackground.TRANSPARENT
         ))
     '''
 
@@ -10432,7 +10432,7 @@ class TreatMissingData(enum.Enum):
             runtime=lambda_.Runtime.NODEJS_18_X,
             handler="index.handler",
             code=lambda_.Code.from_asset(path.join(__dirname, "lambda-handler")),
-            timeout=cdk.Duration.minutes(5)
+            timeout=Duration.minutes(5)
         )
         
         if fn.timeout:
@@ -10466,7 +10466,6 @@ class Unit(enum.Enum):
 
     Example::
 
-        # Example automatically generated from non-compiling source. May contain errors.
         # log_group: logs.LogGroup
         
         mf = logs.MetricFilter(self, "MetricFilter",
@@ -10478,7 +10477,7 @@ class Unit(enum.Enum):
             dimensions={
                 "ErrorCode": "$.errorCode"
             },
-            unit=Unit.MILLISECONDS
+            unit=cloudwatch.Unit.MILLISECONDS
         )
         
         # expose a metric from the metric filter
@@ -12614,7 +12613,7 @@ class CompositeAlarm(
 
         :param scope: The parent creating construct (usually ``this``).
         :param id: The construct's name.
-        :param composite_alarm_arn: Composite Alarm ARN (i.e. arn:aws:cloudwatch:::alarm/CompositeAlarmName).
+        :param composite_alarm_arn: Composite Alarm ARN (i.e. arn:aws:cloudwatch:::alarm:CompositeAlarmName).
         '''
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__dfb039403469bae811c18af1008f632188c3f4e24312b57fe3c23c7e5e1405fc)
@@ -12771,6 +12770,27 @@ class Alarm(
             check_type(argname="argument alarm_arn", value=alarm_arn, expected_type=type_hints["alarm_arn"])
         return typing.cast(IAlarm, jsii.sinvoke(cls, "fromAlarmArn", [scope, id, alarm_arn]))
 
+    @jsii.member(jsii_name="fromAlarmName")
+    @builtins.classmethod
+    def from_alarm_name(
+        cls,
+        scope: _constructs_77d1e7e8.Construct,
+        id: builtins.str,
+        alarm_name: builtins.str,
+    ) -> IAlarm:
+        '''Import an existing CloudWatch alarm provided an Name.
+
+        :param scope: The parent creating construct (usually ``this``).
+        :param id: The construct's name.
+        :param alarm_name: Alarm Name.
+        '''
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__0f69e87f80e55b26f710e5c03872b4814d854ded266dd530cb19c3aeb9cae0b2)
+            check_type(argname="argument scope", value=scope, expected_type=type_hints["scope"])
+            check_type(argname="argument id", value=id, expected_type=type_hints["id"])
+            check_type(argname="argument alarm_name", value=alarm_name, expected_type=type_hints["alarm_name"])
+        return typing.cast(IAlarm, jsii.sinvoke(cls, "fromAlarmName", [scope, id, alarm_name]))
+
     @jsii.member(jsii_name="addAlarmAction")
     def add_alarm_action(self, *actions: IAlarmAction) -> None:
         '''Trigger this action if the alarm fires.
@@ -14354,6 +14374,14 @@ def _typecheckingstub__f8a5a6150e68ee9e26c8b7ebe6f92594c12f9b3cda4195d76462b9910
     """Type checking stubs"""
     pass
 
+def _typecheckingstub__0f69e87f80e55b26f710e5c03872b4814d854ded266dd530cb19c3aeb9cae0b2(
+    scope: _constructs_77d1e7e8.Construct,
+    id: builtins.str,
+    alarm_name: builtins.str,
+) -> None:
+    """Type checking stubs"""
+    pass
+
 def _typecheckingstub__35e42b79cd71f370c96d9123c26abff1c323e3360845e3957f3fa6b0bb344dde(
     *actions: IAlarmAction,
 ) -> None:

aws_cdk/aws_codebuild/__init__.py

@@ -122,9 +122,8 @@ The build spec can be provided from a number of different sources
 You can specify a specific filename that exists within the project's source artifact to use as the buildspec.
 
 ```python
-# Example automatically generated from non-compiling source. May contain errors.
 project = codebuild.Project(self, "MyProject",
-    build_spec=codebuild.BuildSpec.from_source_file_name("my-buildspec.yml"),
+    build_spec=codebuild.BuildSpec.from_source_filename("my-buildspec.yml"),
     source=codebuild.Source.git_hub(
         owner="awslabs",
         repo="aws-cdk"
@@ -468,7 +467,7 @@ Example:
 ```python
 codebuild.Project(self, "Project",
     environment=codebuild.BuildEnvironment(
-        build_image=codebuild.LinuxBuildImage.STANDARD_6_0
+        build_image=codebuild.LinuxBuildImage.STANDARD_7_0
     ),
     ssm_session_permissions=True,
     build_spec=codebuild.BuildSpec.from_object({
@@ -1352,7 +1351,6 @@ class BuildEnvironment:
 
         Example::
 
-            # Example automatically generated from non-compiling source. May contain errors.
             # vpc: ec2.Vpc
             # my_security_group: ec2.SecurityGroup
             
@@ -1565,7 +1563,6 @@ class BuildEnvironmentVariable:
 
         Example::
 
-            # Example automatically generated from non-compiling source. May contain errors.
             # later:
             # project: codebuild.PipelineProject
             source_output = codepipeline.Artifact()
@@ -7252,7 +7249,6 @@ class ComputeType(enum.Enum):
 
     Example::
 
-        # Example automatically generated from non-compiling source. May contain errors.
         # vpc: ec2.Vpc
         # my_security_group: ec2.SecurityGroup
         
@@ -9728,7 +9724,6 @@ class LinuxBuildImage(
 
     Example::
 
-        # Example automatically generated from non-compiling source. May contain errors.
         pipeline = pipelines.CodePipeline(self, "Pipeline",
             synth=pipelines.ShellStep("Synth",
                 input=pipelines.CodePipelineSource.connection("my-org/my-app", "main",
@@ -10008,6 +10003,12 @@ class LinuxBuildImage(
         '''The ``aws/codebuild/standard:6.0`` build image.'''
         return typing.cast(IBuildImage, jsii.sget(cls, "STANDARD_6_0"))
 
+    @jsii.python.classproperty
+    @jsii.member(jsii_name="STANDARD_7_0")
+    def STANDARD_7_0(cls) -> IBuildImage:
+        '''The ``aws/codebuild/standard:7.0`` build image.'''
+        return typing.cast(IBuildImage, jsii.sget(cls, "STANDARD_7_0"))
+
     @builtins.property
     @jsii.member(jsii_name="defaultComputeType")
     def default_compute_type(self) -> ComputeType:
@@ -10287,7 +10288,6 @@ class PipelineProjectProps(CommonProjectProps):
 
         Example::
 
-            # Example automatically generated from non-compiling source. May contain errors.
             # Create a Cloudfront Web Distribution
             import aws_cdk.aws_cloudfront as cloudfront
             # distribution: cloudfront.Distribution
@@ -12757,9 +12757,8 @@ class Source(
 
     Example::
 
-        # Example automatically generated from non-compiling source. May contain errors.
         project = codebuild.Project(self, "MyProject",
-            build_spec=codebuild.BuildSpec.from_source_file_name("my-buildspec.yml"),
+            build_spec=codebuild.BuildSpec.from_source_filename("my-buildspec.yml"),
             source=codebuild.Source.git_hub(
                 owner="awslabs",
                 repo="aws-cdk"
@@ -14408,9 +14407,8 @@ class GitHubSourceProps(SourceProps):
 
         Example::
 
-            # Example automatically generated from non-compiling source. May contain errors.
             project = codebuild.Project(self, "MyProject",
-                build_spec=codebuild.BuildSpec.from_source_file_name("my-buildspec.yml"),
+                build_spec=codebuild.BuildSpec.from_source_filename("my-buildspec.yml"),
                 source=codebuild.Source.git_hub(
                     owner="awslabs",
                     repo="aws-cdk"
@@ -14920,7 +14918,6 @@ class PipelineProject(
 
     Example::
 
-        # Example automatically generated from non-compiling source. May contain errors.
         # Create a Cloudfront Web Distribution
         import aws_cdk.aws_cloudfront as cloudfront
         # distribution: cloudfront.Distribution

aws_cdk/aws_codecommit/__init__.py

@@ -2378,7 +2378,6 @@ class Repository(
 
     Example::
 
-        # Example automatically generated from non-compiling source. May contain errors.
         # project: codebuild.PipelineProject
         
         repository = codecommit.Repository(self, "MyRepository",