aws-cdk-lib 2.125.0__py3-none-any.whl → 2.127.0__py3-none-any.whl

aws_cdk/aws_lambda_event_sources/__init__.py

@@ -96,6 +96,25 @@ fn.add_event_source(S3EventSource(bucket,
 ))
 ```
 
+In the example above, `S3EventSource` is accepting `Bucket` type as parameter.
+However, Functions like `from_bucket_name` and `from_bucket_arn` will return `IBucket`
+and is not compliant with `S3EventSource`. If this is the case, please consider using
+`S3EventSourceV2` instead, this class accepts `IBucket`.
+
+```python
+import aws_cdk.aws_s3 as s3
+from aws_cdk.aws_lambda_event_sources import S3EventSourceV2
+# fn: lambda.Function
+
+
+bucket = s3.Bucket.from_bucket_name(self, "Bucket", "bucket-name")
+
+fn.add_event_source(S3EventSourceV2(bucket,
+    events=[s3.EventType.OBJECT_CREATED, s3.EventType.OBJECT_REMOVED],
+    filters=[s3.NotificationKeyFilter(prefix="subdir/")]
+))
+```
+
 ## SNS
 
 You can write Lambda functions to process Amazon Simple Notification Service
@@ -1164,13 +1183,14 @@ class S3EventSourceProps:
 
         Example::
 
-            import aws_cdk.aws_lambda_event_sources as eventsources
             import aws_cdk.aws_s3 as s3
-            
+            from aws_cdk.aws_lambda_event_sources import S3EventSource
             # fn: lambda.Function
             
-            bucket = s3.Bucket(self, "Bucket")
-            fn.add_event_source(eventsources.S3EventSource(bucket,
+            
+            bucket = s3.Bucket(self, "mybucket")
+            
+            fn.add_event_source(S3EventSource(bucket,
                 events=[s3.EventType.OBJECT_CREATED, s3.EventType.OBJECT_REMOVED],
                 filters=[s3.NotificationKeyFilter(prefix="subdir/")]
             ))
@@ -1215,6 +1235,61 @@ class S3EventSourceProps:
         )
 
 
+@jsii.implements(_IEventSource_3686b3f8)
+class S3EventSourceV2(
+    metaclass=jsii.JSIIMeta,
+    jsii_type="aws-cdk-lib.aws_lambda_event_sources.S3EventSourceV2",
+):
+    '''S3EventSourceV2 Use S3 bucket notifications as an event source for AWS Lambda.
+
+    :exampleMetadata: infused
+
+    Example::
+
+        import aws_cdk.aws_s3 as s3
+        from aws_cdk.aws_lambda_event_sources import S3EventSourceV2
+        # fn: lambda.Function
+        
+        
+        bucket = s3.Bucket.from_bucket_name(self, "Bucket", "bucket-name")
+        
+        fn.add_event_source(S3EventSourceV2(bucket,
+            events=[s3.EventType.OBJECT_CREATED, s3.EventType.OBJECT_REMOVED],
+            filters=[s3.NotificationKeyFilter(prefix="subdir/")]
+        ))
+    '''
+
+    def __init__(
+        self,
+        bucket: _IBucket_42e086fd,
+        *,
+        events: typing.Sequence[_EventType_ef204dc6],
+        filters: typing.Optional[typing.Sequence[typing.Union[_NotificationKeyFilter_eba42084, typing.Dict[builtins.str, typing.Any]]]] = None,
+    ) -> None:
+        '''
+        :param bucket: -
+        :param events: The s3 event types that will trigger the notification.
+        :param filters: S3 object key filter rules to determine which objects trigger this event. Each filter must include a ``prefix`` and/or ``suffix`` that will be matched against the s3 object key. Refer to the S3 Developer Guide for details about allowed filter rules.
+        '''
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__3b524b9f9e27e80410f1523d51bf79704d46cf77b7a59d204a7810cc4c27a14c)
+            check_type(argname="argument bucket", value=bucket, expected_type=type_hints["bucket"])
+        props = S3EventSourceProps(events=events, filters=filters)
+
+        jsii.create(self.__class__, self, [bucket, props])
+
+    @jsii.member(jsii_name="bind")
+    def bind(self, target: _IFunction_6adb0ab8) -> None:
+        '''Called by ``lambda.addEventSource`` to allow the event source to bind to this function.
+
+        :param target: -
+        '''
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__eba09585dbf41064eb893342d38abe2dd66fbda8d2b8c07ad2b32d7cd7015de9)
+            check_type(argname="argument target", value=target, expected_type=type_hints["target"])
+        return typing.cast(None, jsii.invoke(self, "bind", [target]))
+
+
 @jsii.implements(_IEventSourceDlq_5e2c6ad9)
 class S3OnFailureDestination(
     metaclass=jsii.JSIIMeta,
@@ -3479,6 +3554,7 @@ __all__ = [
     "ManagedKafkaEventSourceProps",
     "S3EventSource",
     "S3EventSourceProps",
+    "S3EventSourceV2",
     "S3OnFailureDestination",
     "SelfManagedKafkaEventSource",
     "SelfManagedKafkaEventSourceProps",
@@ -3582,6 +3658,21 @@ def _typecheckingstub__b46031fffc8f7bfa84384e954e6ee022bcc41e41187a45226ab35681d
     """Type checking stubs"""
     pass
 
+def _typecheckingstub__3b524b9f9e27e80410f1523d51bf79704d46cf77b7a59d204a7810cc4c27a14c(
+    bucket: _IBucket_42e086fd,
+    *,
+    events: typing.Sequence[_EventType_ef204dc6],
+    filters: typing.Optional[typing.Sequence[typing.Union[_NotificationKeyFilter_eba42084, typing.Dict[builtins.str, typing.Any]]]] = None,
+) -> None:
+    """Type checking stubs"""
+    pass
+
+def _typecheckingstub__eba09585dbf41064eb893342d38abe2dd66fbda8d2b8c07ad2b32d7cd7015de9(
+    target: _IFunction_6adb0ab8,
+) -> None:
+    """Type checking stubs"""
+    pass
+
 def _typecheckingstub__f05f3a68a05800664f2bd5a5604691c83a38238799acf8fe643171f61cb9a364(
     bucket: _IBucket_42e086fd,
 ) -> None:

aws_cdk/aws_lambda_nodejs/__init__.py

@@ -417,6 +417,7 @@ from ..aws_lambda import (
     ILayerVersion as _ILayerVersion_5ac127c8,
     LambdaInsightsVersion as _LambdaInsightsVersion_9dfbfef9,
     LogRetentionRetryOptions as _LogRetentionRetryOptions_ad797a7a,
+    LoggingFormat as _LoggingFormat_30be8e01,
     ParamsAndSecretsLayerVersion as _ParamsAndSecretsLayerVersion_dce97f06,
     Runtime as _Runtime_b4eaa844,
     RuntimeManagementMode as _RuntimeManagementMode_688c173b,
@@ -1473,6 +1474,7 @@ class NodejsFunction(
         insights_version: typing.Optional[_LambdaInsightsVersion_9dfbfef9] = None,
         layers: typing.Optional[typing.Sequence[_ILayerVersion_5ac127c8]] = None,
         log_format: typing.Optional[builtins.str] = None,
+        logging_format: typing.Optional[_LoggingFormat_30be8e01] = None,
         log_group: typing.Optional[_ILogGroup_3c4fa718] = None,
         log_retention: typing.Optional[_RetentionDays_070f99f0] = None,
         log_retention_retry_options: typing.Optional[typing.Union[_LogRetentionRetryOptions_ad797a7a, typing.Dict[builtins.str, typing.Any]]] = None,
@@ -1527,6 +1529,7 @@ class NodejsFunction(
         :param insights_version: Specify the version of CloudWatch Lambda insights to use for monitoring. Default: - No Lambda Insights
         :param layers: A list of layers to add to the function's execution environment. You can configure your Lambda function to pull in additional code during initialization in the form of layers. Layers are packages of libraries or other dependencies that can be used by multiple functions. Default: - No layers.
         :param log_format: Sets the logFormat for the function. Default: "Text"
+        :param logging_format: Sets the loggingFormat for the function. Default: LoggingFormat.TEXT
         :param log_group: The log group the function sends logs to. By default, Lambda functions send logs to an automatically created default log group named /aws/lambda/<function name>. However you cannot change the properties of this auto-created log group using the AWS CDK, e.g. you cannot set a different log retention. Use the ``logGroup`` property to create a fully customizable LogGroup ahead of time, and instruct the Lambda function to send logs to it. Providing a user-controlled log group was rolled out to commercial regions on 2023-11-16. If you are deploying to another type of region, please check regional availability first. Default: ``/aws/lambda/${this.functionName}`` - default log group created by Lambda
         :param log_retention: The number of days log events are kept in CloudWatch Logs. When updating this property, unsetting it doesn't remove the log retention policy. To remove the retention policy, set the value to ``INFINITE``. This is a legacy API and we strongly recommend you move away from it if you can. Instead create a fully customizable log group with ``logs.LogGroup`` and use the ``logGroup`` property to instruct the Lambda function to send logs to it. Migrating from ``logRetention`` to ``logGroup`` will cause the name of the log group to change. Users and code and referencing the name verbatim will have to adjust. In AWS CDK code, you can access the log group name directly from the LogGroup construct:: import * as logs from 'aws-cdk-lib/aws-logs'; declare const myLogGroup: logs.LogGroup; myLogGroup.logGroupName; Default: logs.RetentionDays.INFINITE
         :param log_retention_retry_options: When log retention is specified, a custom resource attempts to create the CloudWatch log group. These options control the retry policy when interacting with CloudWatch APIs. This is a legacy API and we strongly recommend you migrate to ``logGroup`` if you can. ``logGroup`` allows you to create a fully customizable log group and instruct the Lambda function to send logs to it. Default: - Default AWS SDK retry options.
@@ -1583,6 +1586,7 @@ class NodejsFunction(
             insights_version=insights_version,
             layers=layers,
             log_format=log_format,
+            logging_format=logging_format,
             log_group=log_group,
             log_retention=log_retention,
             log_retention_retry_options=log_retention_retry_options,
@@ -1639,6 +1643,7 @@ class NodejsFunction(
         "insights_version": "insightsVersion",
         "layers": "layers",
         "log_format": "logFormat",
+        "logging_format": "loggingFormat",
         "log_group": "logGroup",
         "log_retention": "logRetention",
         "log_retention_retry_options": "logRetentionRetryOptions",
@@ -1695,6 +1700,7 @@ class NodejsFunctionProps(_FunctionOptions_328f4d39):
         insights_version: typing.Optional[_LambdaInsightsVersion_9dfbfef9] = None,
         layers: typing.Optional[typing.Sequence[_ILayerVersion_5ac127c8]] = None,
         log_format: typing.Optional[builtins.str] = None,
+        logging_format: typing.Optional[_LoggingFormat_30be8e01] = None,
         log_group: typing.Optional[_ILogGroup_3c4fa718] = None,
         log_retention: typing.Optional[_RetentionDays_070f99f0] = None,
         log_retention_retry_options: typing.Optional[typing.Union[_LogRetentionRetryOptions_ad797a7a, typing.Dict[builtins.str, typing.Any]]] = None,
@@ -1748,6 +1754,7 @@ class NodejsFunctionProps(_FunctionOptions_328f4d39):
         :param insights_version: Specify the version of CloudWatch Lambda insights to use for monitoring. Default: - No Lambda Insights
         :param layers: A list of layers to add to the function's execution environment. You can configure your Lambda function to pull in additional code during initialization in the form of layers. Layers are packages of libraries or other dependencies that can be used by multiple functions. Default: - No layers.
         :param log_format: Sets the logFormat for the function. Default: "Text"
+        :param logging_format: Sets the loggingFormat for the function. Default: LoggingFormat.TEXT
         :param log_group: The log group the function sends logs to. By default, Lambda functions send logs to an automatically created default log group named /aws/lambda/<function name>. However you cannot change the properties of this auto-created log group using the AWS CDK, e.g. you cannot set a different log retention. Use the ``logGroup`` property to create a fully customizable LogGroup ahead of time, and instruct the Lambda function to send logs to it. Providing a user-controlled log group was rolled out to commercial regions on 2023-11-16. If you are deploying to another type of region, please check regional availability first. Default: ``/aws/lambda/${this.functionName}`` - default log group created by Lambda
         :param log_retention: The number of days log events are kept in CloudWatch Logs. When updating this property, unsetting it doesn't remove the log retention policy. To remove the retention policy, set the value to ``INFINITE``. This is a legacy API and we strongly recommend you move away from it if you can. Instead create a fully customizable log group with ``logs.LogGroup`` and use the ``logGroup`` property to instruct the Lambda function to send logs to it. Migrating from ``logRetention`` to ``logGroup`` will cause the name of the log group to change. Users and code and referencing the name verbatim will have to adjust. In AWS CDK code, you can access the log group name directly from the LogGroup construct:: import * as logs from 'aws-cdk-lib/aws-logs'; declare const myLogGroup: logs.LogGroup; myLogGroup.logGroupName; Default: logs.RetentionDays.INFINITE
         :param log_retention_retry_options: When log retention is specified, a custom resource attempts to create the CloudWatch log group. These options control the retry policy when interacting with CloudWatch APIs. This is a legacy API and we strongly recommend you migrate to ``logGroup`` if you can. ``logGroup`` allows you to create a fully customizable log group and instruct the Lambda function to send logs to it. Default: - Default AWS SDK retry options.
@@ -1825,6 +1832,7 @@ class NodejsFunctionProps(_FunctionOptions_328f4d39):
             check_type(argname="argument insights_version", value=insights_version, expected_type=type_hints["insights_version"])
             check_type(argname="argument layers", value=layers, expected_type=type_hints["layers"])
             check_type(argname="argument log_format", value=log_format, expected_type=type_hints["log_format"])
+            check_type(argname="argument logging_format", value=logging_format, expected_type=type_hints["logging_format"])
             check_type(argname="argument log_group", value=log_group, expected_type=type_hints["log_group"])
             check_type(argname="argument log_retention", value=log_retention, expected_type=type_hints["log_retention"])
             check_type(argname="argument log_retention_retry_options", value=log_retention_retry_options, expected_type=type_hints["log_retention_retry_options"])
@@ -1901,6 +1909,8 @@ class NodejsFunctionProps(_FunctionOptions_328f4d39):
             self._values["layers"] = layers
         if log_format is not None:
             self._values["log_format"] = log_format
+        if logging_format is not None:
+            self._values["logging_format"] = logging_format
         if log_group is not None:
             self._values["log_group"] = log_group
         if log_retention is not None:
@@ -2224,6 +2234,15 @@ class NodejsFunctionProps(_FunctionOptions_328f4d39):
         result = self._values.get("log_format")
         return typing.cast(typing.Optional[builtins.str], result)
 
+    @builtins.property
+    def logging_format(self) -> typing.Optional[_LoggingFormat_30be8e01]:
+        '''Sets the loggingFormat for the function.
+
+        :default: LoggingFormat.TEXT
+        '''
+        result = self._values.get("logging_format")
+        return typing.cast(typing.Optional[_LoggingFormat_30be8e01], result)
+
     @builtins.property
     def log_group(self) -> typing.Optional[_ILogGroup_3c4fa718]:
         '''The log group the function sends logs to.
@@ -2780,6 +2799,7 @@ def _typecheckingstub__ece177829b26ef102d4080d730f168e29d7d310d1518738839cd3fc82
     insights_version: typing.Optional[_LambdaInsightsVersion_9dfbfef9] = None,
     layers: typing.Optional[typing.Sequence[_ILayerVersion_5ac127c8]] = None,
     log_format: typing.Optional[builtins.str] = None,
+    logging_format: typing.Optional[_LoggingFormat_30be8e01] = None,
     log_group: typing.Optional[_ILogGroup_3c4fa718] = None,
     log_retention: typing.Optional[_RetentionDays_070f99f0] = None,
     log_retention_retry_options: typing.Optional[typing.Union[_LogRetentionRetryOptions_ad797a7a, typing.Dict[builtins.str, typing.Any]]] = None,
@@ -2833,6 +2853,7 @@ def _typecheckingstub__2da45b394f0332be0f6d6b7468d9fb54961953d56265da69955d36ffa
     insights_version: typing.Optional[_LambdaInsightsVersion_9dfbfef9] = None,
     layers: typing.Optional[typing.Sequence[_ILayerVersion_5ac127c8]] = None,
     log_format: typing.Optional[builtins.str] = None,
+    logging_format: typing.Optional[_LoggingFormat_30be8e01] = None,
     log_group: typing.Optional[_ILogGroup_3c4fa718] = None,
     log_retention: typing.Optional[_RetentionDays_070f99f0] = None,
     log_retention_retry_options: typing.Optional[typing.Union[_LogRetentionRetryOptions_ad797a7a, typing.Dict[builtins.str, typing.Any]]] = None,

aws_cdk/aws_location/__init__.py

@@ -1336,7 +1336,7 @@ class CfnMap(
             '''Specifies the map tile style selected from an available provider.
 
             :param style: Specifies the map style selected from an available data provider. Valid `Esri map styles <https://docs.aws.amazon.com/location/latest/developerguide/esri.html>`_ : - ``VectorEsriNavigation`` – The Esri Navigation map style, which provides a detailed basemap for the world symbolized with a custom navigation map style that's designed for use during the day in mobile devices. It also includes a richer set of places, such as shops, services, restaurants, attractions, and other points of interest. Enable the ``POI`` layer by setting it in CustomLayers to leverage the additional places data. - ``RasterEsriImagery`` – The Esri Imagery map style. A raster basemap that provides one meter or better satellite and aerial imagery in many parts of the world and lower resolution satellite imagery worldwide. - ``VectorEsriLightGrayCanvas`` – The Esri Light Gray Canvas map style, which provides a detailed vector basemap with a light gray, neutral background style with minimal colors, labels, and features that's designed to draw attention to your thematic content. - ``VectorEsriTopographic`` – The Esri Light map style, which provides a detailed vector basemap with a classic Esri map style. - ``VectorEsriStreets`` – The Esri Street Map style, which provides a detailed vector basemap for the world symbolized with a classic Esri street map style. The vector tile layer is similar in content and style to the World Street Map raster map. - ``VectorEsriDarkGrayCanvas`` – The Esri Dark Gray Canvas map style. A vector basemap with a dark gray, neutral background with minimal colors, labels, and features that's designed to draw attention to your thematic content. Valid `HERE Technologies map styles <https://docs.aws.amazon.com/location/latest/developerguide/HERE.html>`_ : - ``VectorHereExplore`` – A default HERE map style containing a neutral, global map and its features including roads, buildings, landmarks, and water features. It also now includes a fully designed map of Japan. - ``RasterHereExploreSatellite`` – A global map containing high resolution satellite imagery. - ``HybridHereExploreSatellite`` – A global map displaying the road network, street names, and city labels over satellite imagery. This style will automatically retrieve both raster and vector tiles, and your charges will be based on total tiles retrieved. .. epigraph:: Hybrid styles use both vector and raster tiles when rendering the map that you see. This means that more tiles are retrieved than when using either vector or raster tiles alone. Your charges will include all tiles retrieved. - ``VectorHereContrast`` – The HERE Contrast (Berlin) map style is a high contrast detailed base map of the world that blends 3D and 2D rendering. .. epigraph:: The ``VectorHereContrast`` style has been renamed from ``VectorHereBerlin`` . ``VectorHereBerlin`` has been deprecated, but will continue to work in applications that use it. - ``VectorHereExploreTruck`` – A global map containing truck restrictions and attributes (e.g. width / height / HAZMAT) symbolized with highlighted segments and icons on top of HERE Explore to support use cases within transport and logistics. Valid `GrabMaps map styles <https://docs.aws.amazon.com/location/latest/developerguide/grab.html>`_ : - ``VectorGrabStandardLight`` – The Grab Standard Light map style provides a basemap with detailed land use coloring, area names, roads, landmarks, and points of interest covering Southeast Asia. - ``VectorGrabStandardDark`` – The Grab Standard Dark map style provides a dark variation of the standard basemap covering Southeast Asia. .. epigraph:: Grab provides maps only for countries in Southeast Asia, and is only available in the Asia Pacific (Singapore) Region ( ``ap-southeast-1`` ). For more information, see `GrabMaps countries and area covered <https://docs.aws.amazon.com/location/latest/developerguide/grab.html#grab-coverage-area>`_ . Valid `Open Data map styles <https://docs.aws.amazon.com/location/latest/developerguide/open-data.html>`_ : - ``VectorOpenDataStandardLight`` – The Open Data Standard Light map style provides a detailed basemap for the world suitable for website and mobile application use. The map includes highways major roads, minor roads, railways, water features, cities, parks, landmarks, building footprints, and administrative boundaries. - ``VectorOpenDataStandardDark`` – Open Data Standard Dark is a dark-themed map style that provides a detailed basemap for the world suitable for website and mobile application use. The map includes highways major roads, minor roads, railways, water features, cities, parks, landmarks, building footprints, and administrative boundaries. - ``VectorOpenDataVisualizationLight`` – The Open Data Visualization Light map style is a light-themed style with muted colors and fewer features that aids in understanding overlaid data. - ``VectorOpenDataVisualizationDark`` – The Open Data Visualization Dark map style is a dark-themed style with muted colors and fewer features that aids in understanding overlaid data.
-            :param custom_layers: 
+            :param custom_layers: Specifies the custom layers for the style. Leave unset to not enable any custom layer, or, for styles that support custom layers, you can enable layer(s), such as the ``POI`` layer for the VectorEsriNavigation style. .. epigraph:: Currenlty only ``VectorEsriNavigation`` supports CustomLayers. For more information, see `Custom Layers <https://docs.aws.amazon.com//location/latest/developerguide/map-concepts.html#map-custom-layers>`_ .
             :param political_view: Specifies the map political view selected from an available data provider.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-location-map-mapconfiguration.html
@@ -1424,7 +1424,13 @@ class CfnMap(
 
         @builtins.property
         def custom_layers(self) -> typing.Optional[typing.List[builtins.str]]:
-            '''
+            '''Specifies the custom layers for the style.
+
+            Leave unset to not enable any custom layer, or, for styles that support custom layers, you can enable layer(s), such as the ``POI`` layer for the VectorEsriNavigation style.
+            .. epigraph::
+
+               Currenlty only ``VectorEsriNavigation`` supports CustomLayers. For more information, see `Custom Layers <https://docs.aws.amazon.com//location/latest/developerguide/map-concepts.html#map-custom-layers>`_ .
+
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-location-map-mapconfiguration.html#cfn-location-map-mapconfiguration-customlayers
             '''
             result = self._values.get("custom_layers")

aws_cdk/aws_logs/__init__.py

@@ -454,7 +454,7 @@ class CfnAccountPolicy(
     metaclass=jsii.JSIIMeta,
     jsii_type="aws-cdk-lib.aws_logs.CfnAccountPolicy",
 ):
-    '''Creates or updates an aaccount-level data protection policy or subscription filter policy that applies to all log groups or a subset of log groups in the account.
+    '''Creates or updates an account-level data protection policy or subscription filter policy that applies to all log groups or a subset of log groups in the account.
 
     *Data protection policy*
 
@@ -3513,7 +3513,7 @@ class CfnQueryDefinition(
         '''
         :param scope: Scope in which this resource is defined.
         :param id: Construct identifier for this resource (unique in its scope).
-        :param name: A name for the query definition.
+        :param name: A name for the query definition. .. epigraph:: You can use the name to create a folder structure for your queries. To create a folder, use a forward slash (/) to prefix your desired query name with your desired folder name. For example, ``/ *folder-name* / *query-name*`` .
         :param query_string: The query string to use for this query definition. For more information, see `CloudWatch Logs Insights Query Syntax <https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CWL_QuerySyntax.html>`_ .
         :param log_group_names: Use this parameter if you want the query to query only certain log groups.
         '''
@@ -3633,7 +3633,7 @@ class CfnQueryDefinitionProps:
     ) -> None:
         '''Properties for defining a ``CfnQueryDefinition``.
 
-        :param name: A name for the query definition.
+        :param name: A name for the query definition. .. epigraph:: You can use the name to create a folder structure for your queries. To create a folder, use a forward slash (/) to prefix your desired query name with your desired folder name. For example, ``/ *folder-name* / *query-name*`` .
         :param query_string: The query string to use for this query definition. For more information, see `CloudWatch Logs Insights Query Syntax <https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CWL_QuerySyntax.html>`_ .
         :param log_group_names: Use this parameter if you want the query to query only certain log groups.
 
@@ -3670,6 +3670,10 @@ class CfnQueryDefinitionProps:
     def name(self) -> builtins.str:
         '''A name for the query definition.
 
+        .. epigraph::
+
+           You can use the name to create a folder structure for your queries. To create a folder, use a forward slash (/) to prefix your desired query name with your desired folder name. For example, ``/ *folder-name* / *query-name*`` .
+
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-logs-querydefinition.html#cfn-logs-querydefinition-name
         '''
         result = self._values.get("name")

aws_cdk/aws_networkmanager/__init__.py

@@ -2330,7 +2330,7 @@ class CfnDevice(
     @builtins.property
     @jsii.member(jsii_name="attrCreatedAt")
     def attr_created_at(self) -> builtins.str:
-        '''The time that the device was created.
+        '''The date and time that the device was created.
 
         :cloudformationAttribute: CreatedAt
         '''

aws_cdk/aws_opensearchserverless/__init__.py

@@ -361,7 +361,7 @@ class CfnCollection(
         :param id: Construct identifier for this resource (unique in its scope).
         :param name: The name of the collection. Collection names must meet the following criteria: - Starts with a lowercase letter - Unique to your account and AWS Region - Contains between 3 and 28 characters - Contains only lowercase letters a-z, the numbers 0-9, and the hyphen (-)
         :param description: A description of the collection.
-        :param standby_replicas: Details about an OpenSearch Serverless collection.
+        :param standby_replicas: Indicates whether standby replicas should be used for a collection.
         :param tags: An arbitrary set of tags (key–value pairs) to associate with the collection. For more information, see `Tag <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-resource-tags.html>`_ .
         :param type: The type of collection. Possible values are ``SEARCH`` , ``TIMESERIES`` , and ``VECTORSEARCH`` . For more information, see `Choosing a collection type <https://docs.aws.amazon.com/opensearch-service/latest/developerguide/serverless-overview.html#serverless-usecase>`_ .
         '''
@@ -493,7 +493,7 @@ class CfnCollection(
     @builtins.property
     @jsii.member(jsii_name="standbyReplicas")
     def standby_replicas(self) -> typing.Optional[builtins.str]:
-        '''Details about an OpenSearch Serverless collection.'''
+        '''Indicates whether standby replicas should be used for a collection.'''
         return typing.cast(typing.Optional[builtins.str], jsii.get(self, "standbyReplicas"))
 
     @standby_replicas.setter
@@ -555,7 +555,7 @@ class CfnCollectionProps:
 
         :param name: The name of the collection. Collection names must meet the following criteria: - Starts with a lowercase letter - Unique to your account and AWS Region - Contains between 3 and 28 characters - Contains only lowercase letters a-z, the numbers 0-9, and the hyphen (-)
         :param description: A description of the collection.
-        :param standby_replicas: Details about an OpenSearch Serverless collection.
+        :param standby_replicas: Indicates whether standby replicas should be used for a collection.
         :param tags: An arbitrary set of tags (key–value pairs) to associate with the collection. For more information, see `Tag <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-resource-tags.html>`_ .
         :param type: The type of collection. Possible values are ``SEARCH`` , ``TIMESERIES`` , and ``VECTORSEARCH`` . For more information, see `Choosing a collection type <https://docs.aws.amazon.com/opensearch-service/latest/developerguide/serverless-overview.html#serverless-usecase>`_ .
 
@@ -628,7 +628,7 @@ class CfnCollectionProps:
 
     @builtins.property
     def standby_replicas(self) -> typing.Optional[builtins.str]:
-        '''Details about an OpenSearch Serverless collection.
+        '''Indicates whether standby replicas should be used for a collection.
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-opensearchserverless-collection.html#cfn-opensearchserverless-collection-standbyreplicas
         '''

aws_cdk/aws_osis/__init__.py

@@ -133,8 +133,8 @@ class CfnPipeline(
         :param min_units: The minimum pipeline capacity, in Ingestion Compute Units (ICUs).
         :param pipeline_configuration_body: The Data Prepper pipeline configuration in YAML format.
         :param pipeline_name: The name of the pipeline.
-        :param buffer_options: Options that specify the configuration of a persistent buffer. To configure how OpenSearch Ingestion encrypts this data, set the EncryptionAtRestOptions.
-        :param encryption_at_rest_options: Options to control how OpenSearch encrypts all data-at-rest.
+        :param buffer_options: Options that specify the configuration of a persistent buffer. To configure how OpenSearch Ingestion encrypts this data, set the ``EncryptionAtRestOptions`` . For more information, see `Persistent buffering <https://docs.aws.amazon.com/opensearch-service/latest/developerguide/osis-features-overview.html#persistent-buffering>`_ .
+        :param encryption_at_rest_options: Options to control how OpenSearch encrypts buffer data.
         :param log_publishing_options: Key-value pairs that represent log publishing settings.
         :param tags: List of tags to add to the pipeline upon creation.
         :param vpc_options: Options that specify the subnets and security groups for an OpenSearch Ingestion VPC endpoint.
@@ -302,7 +302,7 @@ class CfnPipeline(
     def encryption_at_rest_options(
         self,
     ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnPipeline.EncryptionAtRestOptionsProperty"]]:
-        '''Options to control how OpenSearch encrypts all data-at-rest.'''
+        '''Options to control how OpenSearch encrypts buffer data.'''
         return typing.cast(typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnPipeline.EncryptionAtRestOptionsProperty"]], jsii.get(self, "encryptionAtRestOptions"))
 
     @encryption_at_rest_options.setter
@@ -377,7 +377,7 @@ class CfnPipeline(
         ) -> None:
             '''Options that specify the configuration of a persistent buffer.
 
-            To configure how OpenSearch Ingestion encrypts this data, set the EncryptionAtRestOptions.
+            To configure how OpenSearch Ingestion encrypts this data, set the ``EncryptionAtRestOptions`` . For more information, see `Persistent buffering <https://docs.aws.amazon.com/opensearch-service/latest/developerguide/osis-features-overview.html#persistent-buffering>`_ .
 
             :param persistent_buffer_enabled: Whether persistent buffering should be enabled.
 
@@ -433,7 +433,7 @@ class CfnPipeline(
         def __init__(self, *, log_group: builtins.str) -> None:
             '''The destination for OpenSearch Ingestion logs sent to Amazon CloudWatch.
 
-            :param log_group: The name of the CloudWatch Logs group to send pipeline logs to. You can specify an existing log group or create a new one. For example, ``/aws/OpenSearchService/IngestionService/my-pipeline`` .
+            :param log_group: The name of the CloudWatch Logs group to send pipeline logs to. You can specify an existing log group or create a new one. For example, ``/aws/vendedlogs/OpenSearchService/pipelines`` .
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-osis-pipeline-cloudwatchlogdestination.html
             :exampleMetadata: fixture=_generated
@@ -459,7 +459,7 @@ class CfnPipeline(
         def log_group(self) -> builtins.str:
             '''The name of the CloudWatch Logs group to send pipeline logs to.
 
-            You can specify an existing log group or create a new one. For example, ``/aws/OpenSearchService/IngestionService/my-pipeline`` .
+            You can specify an existing log group or create a new one. For example, ``/aws/vendedlogs/OpenSearchService/pipelines`` .
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-osis-pipeline-cloudwatchlogdestination.html#cfn-osis-pipeline-cloudwatchlogdestination-loggroup
             '''
@@ -485,9 +485,9 @@ class CfnPipeline(
     )
     class EncryptionAtRestOptionsProperty:
         def __init__(self, *, kms_key_arn: builtins.str) -> None:
-            '''Options to control how OpenSearch encrypts all data-at-rest.
+            '''Options to control how OpenSearch encrypts buffer data.
 
-            :param kms_key_arn: The ARN of the KMS key used to encrypt data-at-rest in OpenSearch Ingestion. By default, data is encrypted using an AWS owned key.
+            :param kms_key_arn: The ARN of the KMS key used to encrypt buffer data. By default, data is encrypted using an AWS owned key.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-osis-pipeline-encryptionatrestoptions.html
             :exampleMetadata: fixture=_generated
@@ -511,7 +511,7 @@ class CfnPipeline(
 
         @builtins.property
         def kms_key_arn(self) -> builtins.str:
-            '''The ARN of the KMS key used to encrypt data-at-rest in OpenSearch Ingestion.
+            '''The ARN of the KMS key used to encrypt buffer data.
 
             By default, data is encrypted using an AWS owned key.
 
@@ -825,8 +825,8 @@ class CfnPipelineProps:
         :param min_units: The minimum pipeline capacity, in Ingestion Compute Units (ICUs).
         :param pipeline_configuration_body: The Data Prepper pipeline configuration in YAML format.
         :param pipeline_name: The name of the pipeline.
-        :param buffer_options: Options that specify the configuration of a persistent buffer. To configure how OpenSearch Ingestion encrypts this data, set the EncryptionAtRestOptions.
-        :param encryption_at_rest_options: Options to control how OpenSearch encrypts all data-at-rest.
+        :param buffer_options: Options that specify the configuration of a persistent buffer. To configure how OpenSearch Ingestion encrypts this data, set the ``EncryptionAtRestOptions`` . For more information, see `Persistent buffering <https://docs.aws.amazon.com/opensearch-service/latest/developerguide/osis-features-overview.html#persistent-buffering>`_ .
+        :param encryption_at_rest_options: Options to control how OpenSearch encrypts buffer data.
         :param log_publishing_options: Key-value pairs that represent log publishing settings.
         :param tags: List of tags to add to the pipeline upon creation.
         :param vpc_options: Options that specify the subnets and security groups for an OpenSearch Ingestion VPC endpoint.
@@ -945,7 +945,7 @@ class CfnPipelineProps:
     ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, CfnPipeline.BufferOptionsProperty]]:
         '''Options that specify the configuration of a persistent buffer.
 
-        To configure how OpenSearch Ingestion encrypts this data, set the EncryptionAtRestOptions.
+        To configure how OpenSearch Ingestion encrypts this data, set the ``EncryptionAtRestOptions`` . For more information, see `Persistent buffering <https://docs.aws.amazon.com/opensearch-service/latest/developerguide/osis-features-overview.html#persistent-buffering>`_ .
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-osis-pipeline.html#cfn-osis-pipeline-bufferoptions
         '''
@@ -956,7 +956,7 @@ class CfnPipelineProps:
     def encryption_at_rest_options(
         self,
     ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, CfnPipeline.EncryptionAtRestOptionsProperty]]:
-        '''Options to control how OpenSearch encrypts all data-at-rest.
+        '''Options to control how OpenSearch encrypts buffer data.
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-osis-pipeline.html#cfn-osis-pipeline-encryptionatrestoptions
         '''

aws_cdk/aws_personalize/__init__.py

@@ -1101,7 +1101,7 @@ class CfnSolution(
 ):
     '''An object that provides information about a solution.
 
-    A solution is a trained model that can be deployed as a campaign.
+    A solution includes the custom recipe, customized parameters, and trained models (Solution Versions) that Amazon Personalize uses to generate recommendations.
 
     :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-personalize-solution.html
     :cloudformationResource: AWS::Personalize::Solution

aws_cdk/aws_pinpoint/__init__.py

@@ -8990,7 +8990,7 @@ class CfnEventStream(
         :param scope: Scope in which this resource is defined.
         :param id: Construct identifier for this resource (unique in its scope).
         :param application_id: The unique identifier for the Amazon Pinpoint application that you want to export data from.
-        :param destination_stream_arn: The Amazon Resource Name (ARN) of the Amazon Kinesis data stream or Amazon Kinesis Data Firehose delivery stream that you want to publish event data to. For a Kinesis data stream, the ARN format is: ``arn:aws:kinesis: region : account-id :stream/ stream_name`` For a Kinesis Data Firehose delivery stream, the ARN format is: ``arn:aws:firehose: region : account-id :deliverystream/ stream_name``
+        :param destination_stream_arn: The Amazon Resource Name (ARN) of the Amazon Kinesis Data Stream or Amazon Kinesis Data Firehose delivery stream that you want to publish event data to. For a Kinesis Data Stream, the ARN format is: ``arn:aws:kinesis: region : account-id :stream/ stream_name`` For a Kinesis Data Firehose delivery stream, the ARN format is: ``arn:aws:firehose: region : account-id :deliverystream/ stream_name``
         :param role_arn: The AWS Identity and Access Management (IAM) role that authorizes Amazon Pinpoint to publish event data to the stream in your AWS account.
         '''
         if __debug__:
@@ -9064,7 +9064,7 @@ class CfnEventStream(
     @builtins.property
     @jsii.member(jsii_name="destinationStreamArn")
     def destination_stream_arn(self) -> builtins.str:
-        '''The Amazon Resource Name (ARN) of the Amazon Kinesis data stream or Amazon Kinesis Data Firehose delivery stream that you want to publish event data to.'''
+        '''The Amazon Resource Name (ARN) of the Amazon Kinesis Data Stream or Amazon Kinesis Data Firehose delivery stream that you want to publish event data to.'''
         return typing.cast(builtins.str, jsii.get(self, "destinationStreamArn"))
 
     @destination_stream_arn.setter
@@ -9108,7 +9108,7 @@ class CfnEventStreamProps:
         '''Properties for defining a ``CfnEventStream``.
 
         :param application_id: The unique identifier for the Amazon Pinpoint application that you want to export data from.
-        :param destination_stream_arn: The Amazon Resource Name (ARN) of the Amazon Kinesis data stream or Amazon Kinesis Data Firehose delivery stream that you want to publish event data to. For a Kinesis data stream, the ARN format is: ``arn:aws:kinesis: region : account-id :stream/ stream_name`` For a Kinesis Data Firehose delivery stream, the ARN format is: ``arn:aws:firehose: region : account-id :deliverystream/ stream_name``
+        :param destination_stream_arn: The Amazon Resource Name (ARN) of the Amazon Kinesis Data Stream or Amazon Kinesis Data Firehose delivery stream that you want to publish event data to. For a Kinesis Data Stream, the ARN format is: ``arn:aws:kinesis: region : account-id :stream/ stream_name`` For a Kinesis Data Firehose delivery stream, the ARN format is: ``arn:aws:firehose: region : account-id :deliverystream/ stream_name``
         :param role_arn: The AWS Identity and Access Management (IAM) role that authorizes Amazon Pinpoint to publish event data to the stream in your AWS account.
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-pinpoint-eventstream.html
@@ -9149,9 +9149,9 @@ class CfnEventStreamProps:
 
     @builtins.property
     def destination_stream_arn(self) -> builtins.str:
-        '''The Amazon Resource Name (ARN) of the Amazon Kinesis data stream or Amazon Kinesis Data Firehose delivery stream that you want to publish event data to.
+        '''The Amazon Resource Name (ARN) of the Amazon Kinesis Data Stream or Amazon Kinesis Data Firehose delivery stream that you want to publish event data to.
 
-        For a Kinesis data stream, the ARN format is: ``arn:aws:kinesis: region : account-id :stream/ stream_name``
+        For a Kinesis Data Stream, the ARN format is: ``arn:aws:kinesis: region : account-id :stream/ stream_name``
 
         For a Kinesis Data Firehose delivery stream, the ARN format is: ``arn:aws:firehose: region : account-id :deliverystream/ stream_name``
 

aws_cdk/aws_pipes/__init__.py

@@ -5324,19 +5324,16 @@ class CfnPipe(
 
                 # source_queue: sqs.Queue
                 # target_queue: sqs.Queue
-                # loggroup: logs.LogGroup
-                
                 
-                pipe = pipes.Pipe(self, "Pipe",
-                    source=SqsSource(source_queue),
-                    target=SqsTarget(target_queue),
                 
-                    log_level=pipes.LogLevel.TRACE,
-                    log_include_execution_data=[pipes.IncludeExecutionData.ALL],
+                pipe_source = sources.SqsSource(source_queue,
+                    batch_size=10,
+                    maximum_batching_window=cdk.Duration.seconds(10)
+                )
                 
-                    log_destinations=[
-                        CloudwatchDestination(loggroup)
-                    ]
+                pipe = pipes.Pipe(self, "Pipe",
+                    source=pipe_source,
+                    target=SomeTarget(target_queue)
                 )
             '''
             if __debug__: