aws-cdk-lib 2.175.1__py3-none-any.whl → 2.177.0__py3-none-any.whl

aws_cdk/__init__.py

@@ -6252,7 +6252,7 @@ class CfnMacroProps:
         :param function_name: The Amazon Resource Name (ARN) of the underlying Lambda function that you want CloudFormation to invoke when the macro is run.
         :param name: The name of the macro. The name of the macro must be unique across all macros in the account.
         :param description: A description of the macro.
-        :param log_group_name: The CloudWatch Logs group to which CloudFormation sends error logging information when invoking the macro's underlying Lambda function.
+        :param log_group_name: The CloudWatch Logs group to which CloudFormation sends error logging information when invoking the macro's underlying Lambda function. This will be an existing CloudWatch Logs LogGroup. Neither CloudFormation or Lambda will create the group.
         :param log_role_arn: The ARN of the role CloudFormation should assume when sending log entries to CloudWatch Logs .
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-cloudformation-macro.html
@@ -6327,6 +6327,8 @@ class CfnMacroProps:
     def log_group_name(self) -> typing.Optional[builtins.str]:
         '''The CloudWatch Logs group to which CloudFormation sends error logging information when invoking the macro's underlying Lambda function.
 
+        This will be an existing CloudWatch Logs LogGroup. Neither CloudFormation or Lambda will create the group.
+
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-cloudformation-macro.html#cfn-cloudformation-macro-loggroupname
         '''
         result = self._values.get("log_group_name")
@@ -13282,6 +13284,7 @@ class Environment:
         Example::
 
             import aws_cdk as cdk
+            import aws_cdk.aws_cloudwatch as cloudwatch
             
             
             app = cdk.App()
@@ -13289,10 +13292,18 @@ class Environment:
             
             global_table = dynamodb.TableV2(stack, "GlobalTable",
                 partition_key=dynamodb.Attribute(name="pk", type=dynamodb.AttributeType.STRING),
-                replicas=[dynamodb.ReplicaTableProps(region="us-east-1")]
+                replicas=[dynamodb.ReplicaTableProps(region="us-east-1"), dynamodb.ReplicaTableProps(region="us-east-2")
+                ]
             )
             
-            global_table.add_replica(region="us-east-2", deletion_protection=True)
+            # metric is only for the table in us-west-2
+            metric = global_table.metric_consumed_read_capacity_units()
+            
+            cloudwatch.Alarm(self, "Alarm",
+                metric=metric,
+                evaluation_periods=1,
+                threshold=1
+            )
         '''
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__779551ef0a4b144070fd2c3e88ff076e32ad12d30facdc65a940b7a8791f27c6)
@@ -13349,7 +13360,7 @@ class Environment:
 
 
 class Errors(metaclass=jsii.JSIIMeta, jsii_type="aws-cdk-lib.Errors"):
-    '''Helper to check if an error is a SynthesisErrors.
+    '''Helper to check if an error is of a certain type.
 
     :exampleMetadata: fixture=_generated
 
@@ -13370,6 +13381,9 @@ class Errors(metaclass=jsii.JSIIMeta, jsii_type="aws-cdk-lib.Errors"):
     def is_construct_error(cls, x: typing.Any) -> builtins.bool:
         '''Test whether the given errors is a ConstructionError.
 
+        A ConstructionError is a generic error that will be thrown during the App construction or synthesis.
+        To check for more specific errors, use the respective methods.
+
         :param x: -
         '''
         if __debug__:
@@ -13382,6 +13396,9 @@ class Errors(metaclass=jsii.JSIIMeta, jsii_type="aws-cdk-lib.Errors"):
     def is_validation_error(cls, x: typing.Any) -> builtins.bool:
         '''Test whether the given error is a ValidationError.
 
+        A ValidationError is thrown when input props are failing to pass the rules of the construct.
+        It usually means the underlying CloudFormation resource(s) would not deploy with a given configuration.
+
         :param x: -
         '''
         if __debug__:
@@ -30317,7 +30334,7 @@ class CfnMacro(CfnResource, metaclass=jsii.JSIIMeta, jsii_type="aws-cdk-lib.CfnM
         :param function_name: The Amazon Resource Name (ARN) of the underlying Lambda function that you want CloudFormation to invoke when the macro is run.
         :param name: The name of the macro. The name of the macro must be unique across all macros in the account.
         :param description: A description of the macro.
-        :param log_group_name: The CloudWatch Logs group to which CloudFormation sends error logging information when invoking the macro's underlying Lambda function.
+        :param log_group_name: The CloudWatch Logs group to which CloudFormation sends error logging information when invoking the macro's underlying Lambda function. This will be an existing CloudWatch Logs LogGroup. Neither CloudFormation or Lambda will create the group.
         :param log_role_arn: The ARN of the role CloudFormation should assume when sending log entries to CloudWatch Logs .
         '''
         if __debug__:
@@ -36347,7 +36364,6 @@ __all__ = [
     "aws_internetmonitor",
     "aws_invoicing",
     "aws_iot",
-    "aws_iot1click",
     "aws_iotanalytics",
     "aws_iotcoredeviceadvisor",
     "aws_iotevents",
@@ -36401,6 +36417,8 @@ __all__ = [
     "aws_networkfirewall",
     "aws_networkmanager",
     "aws_nimblestudio",
+    "aws_notifications",
+    "aws_notificationscontacts",
     "aws_oam",
     "aws_omics",
     "aws_opensearchserverless",
@@ -36640,7 +36658,6 @@ from . import aws_inspectorv2
 from . import aws_internetmonitor
 from . import aws_invoicing
 from . import aws_iot
-from . import aws_iot1click
 from . import aws_iotanalytics
 from . import aws_iotcoredeviceadvisor
 from . import aws_iotevents
@@ -36694,6 +36711,8 @@ from . import aws_neptunegraph
 from . import aws_networkfirewall
 from . import aws_networkmanager
 from . import aws_nimblestudio
+from . import aws_notifications
+from . import aws_notificationscontacts
 from . import aws_oam
 from . import aws_omics
 from . import aws_opensearchserverless

aws_cdk/_jsii/__init__.py

@@ -35,7 +35,7 @@ import aws_cdk.cloud_assembly_schema._jsii
 import constructs._jsii
 
 __jsii_assembly__ = jsii.JSIIAssembly.load(
-    "aws-cdk-lib", "2.175.1", __name__[0:-6], "aws-cdk-lib@2.175.1.jsii.tgz"
+    "aws-cdk-lib", "2.177.0", __name__[0:-6], "aws-cdk-lib@2.177.0.jsii.tgz"
 )
 
 __all__ = [

aws_cdk/aws_apigatewayv2_integrations/__init__.py

@@ -14,6 +14,7 @@ r'''
 
   * [Lambda WebSocket Integration](#lambda-websocket-integration)
   * [AWS WebSocket Integration](#aws-websocket-integration)
+  * [Mock WebSocket Integration](#mock-websocket-integration)
 * [Import Issues](#import-issues)
 
   * [DotNet Namespace](#dotnet-namespace)
@@ -322,6 +323,30 @@ web_socket_api.add_route("$connect",
 You can also set additional properties to change the behavior of your integration, such as `contentHandling`.
 See [Working with binary media types for WebSocket APIs](https://docs.aws.amazon.com/apigateway/latest/developerguide/websocket-api-develop-binary-media-types.html).
 
+### Mock WebSocket Integration
+
+API Gateway also allows the creation of mock integrations, allowing you to generate API responses without the need for an integration backend. These responses can range in complexity from a static message to a templated response with parameters extracted from the input request or the integration's context. See [Set up data mapping for WebSocket APIs in API Gateway](https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-websocket-api-mapping-template-reference.html) and [WebSocket API mapping template reference for API Gateway](https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-websocket-api-mapping-template-reference.html) for more information.
+
+```python
+from aws_cdk.aws_apigatewayv2_integrations import WebSocketMockIntegration
+
+
+web_socket_api = apigwv2.WebSocketApi(self, "mywsapi")
+apigwv2.WebSocketStage(self, "mystage",
+    web_socket_api=web_socket_api,
+    stage_name="dev",
+    auto_deploy=True
+)
+
+web_socket_api.add_route("sendMessage",
+    integration=WebSocketMockIntegration("DefaultIntegration",
+        request_templates={"application/json": JSON.stringify({"status_code": 200})},
+        template_selection_expression="\\$default"
+    ),
+    return_response=True
+)
+```
+
 ## Import Issues
 
 `jsiirc.json` file is missing during the stablization process of this module, which caused import issues for DotNet and Java users who attempt to use this module. Unfortunately, to guarantee backward compatibility, we cannot simply correct the namespace for DotNet or package for Java. The following outlines the workaround.
@@ -1060,9 +1085,9 @@ class HttpServiceDiscoveryIntegration(
         :param route: The route to which this is being bound.
         :param scope: The current scope in which the bind is occurring. If the ``HttpRouteIntegration`` being bound creates additional constructs, this will be used as their parent scope.
         '''
-        _options = _HttpRouteIntegrationBindOptions_f870a39e(route=route, scope=scope)
+        options = _HttpRouteIntegrationBindOptions_f870a39e(route=route, scope=scope)
 
-        return typing.cast(_HttpRouteIntegrationConfig_aafc4b76, jsii.invoke(self, "bind", [_options]))
+        return typing.cast(_HttpRouteIntegrationConfig_aafc4b76, jsii.invoke(self, "bind", [options]))
 
     @builtins.property
     @jsii.member(jsii_name="connectionType")
@@ -2103,25 +2128,50 @@ class WebSocketMockIntegration(
 ):
     '''Mock WebSocket Integration.
 
-    :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_apigatewayv2_integrations as apigatewayv2_integrations
+        from aws_cdk.aws_apigatewayv2_integrations import WebSocketMockIntegration
+        
+        
+        web_socket_api = apigwv2.WebSocketApi(self, "mywsapi")
+        apigwv2.WebSocketStage(self, "mystage",
+            web_socket_api=web_socket_api,
+            stage_name="dev",
+            auto_deploy=True
+        )
         
-        web_socket_mock_integration = apigatewayv2_integrations.WebSocketMockIntegration("id")
+        web_socket_api.add_route("sendMessage",
+            integration=WebSocketMockIntegration("DefaultIntegration",
+                request_templates={"application/json": JSON.stringify({"status_code": 200})},
+                template_selection_expression="\\$default"
+            ),
+            return_response=True
+        )
     '''
 
-    def __init__(self, id: builtins.str) -> None:
+    def __init__(
+        self,
+        id: builtins.str,
+        *,
+        request_templates: typing.Optional[typing.Mapping[builtins.str, builtins.str]] = None,
+        template_selection_expression: typing.Optional[builtins.str] = None,
+    ) -> None:
         '''
         :param id: id of the underlying integration construct.
+        :param request_templates: A map of Apache Velocity templates that are applied on the request payload. Example:: { "application/json": "{ \\"statusCode\\": 200 }" } Default: - No request template provided to the integration.
+        :param template_selection_expression: The template selection expression for the integration. Default: - No template selection expression provided.
         '''
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__0919a4fac21867e16e13ed094546c03cf261043724396e00ccd357f077081bad)
             check_type(argname="argument id", value=id, expected_type=type_hints["id"])
-        jsii.create(self.__class__, self, [id])
+        props = WebSocketMockIntegrationProps(
+            request_templates=request_templates,
+            template_selection_expression=template_selection_expression,
+        )
+
+        jsii.create(self.__class__, self, [id, props])
 
     @jsii.member(jsii_name="bind")
     def bind(
@@ -2142,6 +2192,96 @@ class WebSocketMockIntegration(
         return typing.cast(_WebSocketRouteIntegrationConfig_7402c18a, jsii.invoke(self, "bind", [options]))
 
 
+@jsii.data_type(
+    jsii_type="aws-cdk-lib.aws_apigatewayv2_integrations.WebSocketMockIntegrationProps",
+    jsii_struct_bases=[],
+    name_mapping={
+        "request_templates": "requestTemplates",
+        "template_selection_expression": "templateSelectionExpression",
+    },
+)
+class WebSocketMockIntegrationProps:
+    def __init__(
+        self,
+        *,
+        request_templates: typing.Optional[typing.Mapping[builtins.str, builtins.str]] = None,
+        template_selection_expression: typing.Optional[builtins.str] = None,
+    ) -> None:
+        '''Props for Mock type integration for a WebSocket Api.
+
+        :param request_templates: A map of Apache Velocity templates that are applied on the request payload. Example:: { "application/json": "{ \\"statusCode\\": 200 }" } Default: - No request template provided to the integration.
+        :param template_selection_expression: The template selection expression for the integration. Default: - No template selection expression provided.
+
+        :exampleMetadata: infused
+
+        Example::
+
+            from aws_cdk.aws_apigatewayv2_integrations import WebSocketMockIntegration
+            
+            
+            web_socket_api = apigwv2.WebSocketApi(self, "mywsapi")
+            apigwv2.WebSocketStage(self, "mystage",
+                web_socket_api=web_socket_api,
+                stage_name="dev",
+                auto_deploy=True
+            )
+            
+            web_socket_api.add_route("sendMessage",
+                integration=WebSocketMockIntegration("DefaultIntegration",
+                    request_templates={"application/json": JSON.stringify({"status_code": 200})},
+                    template_selection_expression="\\$default"
+                ),
+                return_response=True
+            )
+        '''
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__d6654c6762caad4ba2ce48d0dd2c9946c37d0961c47d7df1f0618055fb20fbf2)
+            check_type(argname="argument request_templates", value=request_templates, expected_type=type_hints["request_templates"])
+            check_type(argname="argument template_selection_expression", value=template_selection_expression, expected_type=type_hints["template_selection_expression"])
+        self._values: typing.Dict[builtins.str, typing.Any] = {}
+        if request_templates is not None:
+            self._values["request_templates"] = request_templates
+        if template_selection_expression is not None:
+            self._values["template_selection_expression"] = template_selection_expression
+
+    @builtins.property
+    def request_templates(
+        self,
+    ) -> typing.Optional[typing.Mapping[builtins.str, builtins.str]]:
+        '''A map of Apache Velocity templates that are applied on the request payload.
+
+        Example::
+
+             { "application/json": "{ \\"statusCode\\": 200 }" }
+
+        :default: - No request template provided to the integration.
+
+        :see: https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-websocket-api-mapping-template-reference.html
+        '''
+        result = self._values.get("request_templates")
+        return typing.cast(typing.Optional[typing.Mapping[builtins.str, builtins.str]], result)
+
+    @builtins.property
+    def template_selection_expression(self) -> typing.Optional[builtins.str]:
+        '''The template selection expression for the integration.
+
+        :default: - No template selection expression provided.
+        '''
+        result = self._values.get("template_selection_expression")
+        return typing.cast(typing.Optional[builtins.str], result)
+
+    def __eq__(self, rhs: typing.Any) -> builtins.bool:
+        return isinstance(rhs, self.__class__) and rhs._values == self._values
+
+    def __ne__(self, rhs: typing.Any) -> builtins.bool:
+        return not (rhs == self)
+
+    def __repr__(self) -> str:
+        return "WebSocketMockIntegrationProps(%s)" % ", ".join(
+            k + "=" + repr(v) for k, v in self._values.items()
+        )
+
+
 @jsii.data_type(
     jsii_type="aws-cdk-lib.aws_apigatewayv2_integrations.HttpAlbIntegrationProps",
     jsii_struct_bases=[HttpPrivateIntegrationOptions],
@@ -2423,6 +2563,7 @@ __all__ = [
     "WebSocketLambdaIntegration",
     "WebSocketLambdaIntegrationProps",
     "WebSocketMockIntegration",
+    "WebSocketMockIntegrationProps",
 ]
 
 publication.publish()
@@ -2670,6 +2811,17 @@ def _typecheckingstub__b3043b7d6bcd4be959d4924c0dbbe6ad490dc788f95ab7a014933e7e1
 
 def _typecheckingstub__0919a4fac21867e16e13ed094546c03cf261043724396e00ccd357f077081bad(
     id: builtins.str,
+    *,
+    request_templates: typing.Optional[typing.Mapping[builtins.str, builtins.str]] = None,
+    template_selection_expression: typing.Optional[builtins.str] = None,
+) -> None:
+    """Type checking stubs"""
+    pass
+
+def _typecheckingstub__d6654c6762caad4ba2ce48d0dd2c9946c37d0961c47d7df1f0618055fb20fbf2(
+    *,
+    request_templates: typing.Optional[typing.Mapping[builtins.str, builtins.str]] = None,
+    template_selection_expression: typing.Optional[builtins.str] = None,
 ) -> None:
     """Type checking stubs"""
     pass