aws-cdk-lib 2.143.1__py3-none-any.whl → 2.145.0__py3-none-any.whl

aws_cdk/aws_logs/__init__.py

@@ -130,6 +130,26 @@ logs.SubscriptionFilter(self, "Subscription",
 )
 ```
 
+When you use `KinesisDestination`, you can choose the method used to
+distribute log data to the destination by setting the `distribution` property.
+
+```python
+import aws_cdk.aws_logs_destinations as destinations
+import aws_cdk.aws_kinesis as kinesis
+
+# stream: kinesis.Stream
+# log_group: logs.LogGroup
+
+
+logs.SubscriptionFilter(self, "Subscription",
+    log_group=log_group,
+    destination=destinations.KinesisDestination(stream),
+    filter_pattern=logs.FilterPattern.all_terms("ERROR", "MainThread"),
+    filter_name="ErrorInMainThread",
+    distribution=logs.Distribution.RANDOM
+)
+```
+
 ## Metric Filters
 
 CloudWatch Logs can extract and emit metrics based on a textual log stream.
@@ -5233,6 +5253,36 @@ class DataProtectionPolicyProps:
         )
 
 
+@jsii.enum(jsii_type="aws-cdk-lib.aws_logs.Distribution")
+class Distribution(enum.Enum):
+    '''The method used to distribute log data to the destination.
+
+    :exampleMetadata: infused
+
+    Example::
+
+        import aws_cdk.aws_logs_destinations as destinations
+        import aws_cdk.aws_kinesis as kinesis
+        
+        # stream: kinesis.Stream
+        # log_group: logs.LogGroup
+        
+        
+        logs.SubscriptionFilter(self, "Subscription",
+            log_group=log_group,
+            destination=destinations.KinesisDestination(stream),
+            filter_pattern=logs.FilterPattern.all_terms("ERROR", "MainThread"),
+            filter_name="ErrorInMainThread",
+            distribution=logs.Distribution.RANDOM
+        )
+    '''
+
+    BY_LOG_STREAM = "BY_LOG_STREAM"
+    '''Log events from the same log stream are kept together and sent to the same destination.'''
+    RANDOM = "RANDOM"
+    '''Log events are distributed across the log destinations randomly.'''
+
+
 class FilterPattern(
     metaclass=jsii.JSIIMeta,
     jsii_type="aws-cdk-lib.aws_logs.FilterPattern",
@@ -5243,14 +5293,18 @@ class FilterPattern(
 
     Example::
 
-        # Search for all events where the component field is equal to
-        # "HttpServer" and either error is true or the latency is higher
-        # than 1000.
-        pattern = logs.FilterPattern.all(
-            logs.FilterPattern.string_value("$.component", "=", "HttpServer"),
-            logs.FilterPattern.any(
-                logs.FilterPattern.boolean_value("$.error", True),
-                logs.FilterPattern.number_value("$.latency", ">", 1000)))
+        import aws_cdk.aws_logs_destinations as destinations
+        
+        # fn: lambda.Function
+        # log_group: logs.LogGroup
+        
+        
+        logs.SubscriptionFilter(self, "Subscription",
+            log_group=log_group,
+            destination=destinations.LambdaDestination(fn),
+            filter_pattern=logs.FilterPattern.all_terms("ERROR", "MainThread"),
+            filter_name="ErrorInMainThread"
+        )
     '''
 
     def __init__(self) -> None:
@@ -5576,6 +5630,7 @@ class ILogGroup(_IResourceWithPolicy_720d64fc, typing_extensions.Protocol):
         *,
         destination: "ILogSubscriptionDestination",
         filter_pattern: IFilterPattern,
+        distribution: typing.Optional[Distribution] = None,
         filter_name: typing.Optional[builtins.str] = None,
     ) -> "SubscriptionFilter":
         '''Create a new Subscription Filter on this Log Group.
@@ -5583,6 +5638,7 @@ class ILogGroup(_IResourceWithPolicy_720d64fc, typing_extensions.Protocol):
         :param id: Unique identifier for the construct in its parent.
         :param destination: The destination to send the filtered events to. For example, a Kinesis stream or a Lambda function.
         :param filter_pattern: Log events matching this pattern will be sent to the destination.
+        :param distribution: The method used to distribute log data to the destination. This property can only be used with KinesisDestination. Default: Distribution.BY_LOG_STREAM
         :param filter_name: The name of the subscription filter. Default: Automatically generated
         '''
         ...
@@ -5736,6 +5792,7 @@ class _ILogGroupProxy(
         *,
         destination: "ILogSubscriptionDestination",
         filter_pattern: IFilterPattern,
+        distribution: typing.Optional[Distribution] = None,
         filter_name: typing.Optional[builtins.str] = None,
     ) -> "SubscriptionFilter":
         '''Create a new Subscription Filter on this Log Group.
@@ -5743,6 +5800,7 @@ class _ILogGroupProxy(
         :param id: Unique identifier for the construct in its parent.
         :param destination: The destination to send the filtered events to. For example, a Kinesis stream or a Lambda function.
         :param filter_pattern: Log events matching this pattern will be sent to the destination.
+        :param distribution: The method used to distribute log data to the destination. This property can only be used with KinesisDestination. Default: Distribution.BY_LOG_STREAM
         :param filter_name: The name of the subscription filter. Default: Automatically generated
         '''
         if __debug__:
@@ -5751,6 +5809,7 @@ class _ILogGroupProxy(
         props = SubscriptionFilterOptions(
             destination=destination,
             filter_pattern=filter_pattern,
+            distribution=distribution,
             filter_name=filter_name,
         )
 
@@ -6149,6 +6208,7 @@ class LogGroup(
         *,
         destination: ILogSubscriptionDestination,
         filter_pattern: IFilterPattern,
+        distribution: typing.Optional[Distribution] = None,
         filter_name: typing.Optional[builtins.str] = None,
     ) -> "SubscriptionFilter":
         '''Create a new Subscription Filter on this Log Group.
@@ -6156,6 +6216,7 @@ class LogGroup(
         :param id: Unique identifier for the construct in its parent.
         :param destination: The destination to send the filtered events to. For example, a Kinesis stream or a Lambda function.
         :param filter_pattern: Log events matching this pattern will be sent to the destination.
+        :param distribution: The method used to distribute log data to the destination. This property can only be used with KinesisDestination. Default: Distribution.BY_LOG_STREAM
         :param filter_name: The name of the subscription filter. Default: Automatically generated
         '''
         if __debug__:
@@ -6164,6 +6225,7 @@ class LogGroup(
         props = SubscriptionFilterOptions(
             destination=destination,
             filter_pattern=filter_pattern,
+            distribution=distribution,
             filter_name=filter_name,
         )
 
@@ -8311,6 +8373,7 @@ class SubscriptionFilter(
         log_group: ILogGroup,
         destination: ILogSubscriptionDestination,
         filter_pattern: IFilterPattern,
+        distribution: typing.Optional[Distribution] = None,
         filter_name: typing.Optional[builtins.str] = None,
     ) -> None:
         '''
@@ -8319,6 +8382,7 @@ class SubscriptionFilter(
         :param log_group: The log group to create the subscription on.
         :param destination: The destination to send the filtered events to. For example, a Kinesis stream or a Lambda function.
         :param filter_pattern: Log events matching this pattern will be sent to the destination.
+        :param distribution: The method used to distribute log data to the destination. This property can only be used with KinesisDestination. Default: Distribution.BY_LOG_STREAM
         :param filter_name: The name of the subscription filter. Default: Automatically generated
         '''
         if __debug__:
@@ -8329,6 +8393,7 @@ class SubscriptionFilter(
             log_group=log_group,
             destination=destination,
             filter_pattern=filter_pattern,
+            distribution=distribution,
             filter_name=filter_name,
         )
 
@@ -8341,6 +8406,7 @@ class SubscriptionFilter(
     name_mapping={
         "destination": "destination",
         "filter_pattern": "filterPattern",
+        "distribution": "distribution",
         "filter_name": "filterName",
     },
 )
@@ -8350,12 +8416,14 @@ class SubscriptionFilterOptions:
         *,
         destination: ILogSubscriptionDestination,
         filter_pattern: IFilterPattern,
+        distribution: typing.Optional[Distribution] = None,
         filter_name: typing.Optional[builtins.str] = None,
     ) -> None:
         '''Properties for a new SubscriptionFilter created from a LogGroup.
 
         :param destination: The destination to send the filtered events to. For example, a Kinesis stream or a Lambda function.
         :param filter_pattern: Log events matching this pattern will be sent to the destination.
+        :param distribution: The method used to distribute log data to the destination. This property can only be used with KinesisDestination. Default: Distribution.BY_LOG_STREAM
         :param filter_name: The name of the subscription filter. Default: Automatically generated
 
         :exampleMetadata: fixture=_generated
@@ -8374,6 +8442,7 @@ class SubscriptionFilterOptions:
                 filter_pattern=filter_pattern,
             
                 # the properties below are optional
+                distribution=logs.Distribution.BY_LOG_STREAM,
                 filter_name="filterName"
             )
         '''
@@ -8381,11 +8450,14 @@ class SubscriptionFilterOptions:
             type_hints = typing.get_type_hints(_typecheckingstub__177a84e94bfd826b20adc1107770c972772c540b0a1ac8475f63476502450a73)
             check_type(argname="argument destination", value=destination, expected_type=type_hints["destination"])
             check_type(argname="argument filter_pattern", value=filter_pattern, expected_type=type_hints["filter_pattern"])
+            check_type(argname="argument distribution", value=distribution, expected_type=type_hints["distribution"])
             check_type(argname="argument filter_name", value=filter_name, expected_type=type_hints["filter_name"])
         self._values: typing.Dict[builtins.str, typing.Any] = {
             "destination": destination,
             "filter_pattern": filter_pattern,
         }
+        if distribution is not None:
+            self._values["distribution"] = distribution
         if filter_name is not None:
             self._values["filter_name"] = filter_name
 
@@ -8406,6 +8478,17 @@ class SubscriptionFilterOptions:
         assert result is not None, "Required property 'filter_pattern' is missing"
         return typing.cast(IFilterPattern, result)
 
+    @builtins.property
+    def distribution(self) -> typing.Optional[Distribution]:
+        '''The method used to distribute log data to the destination.
+
+        This property can only be used with KinesisDestination.
+
+        :default: Distribution.BY_LOG_STREAM
+        '''
+        result = self._values.get("distribution")
+        return typing.cast(typing.Optional[Distribution], result)
+
     @builtins.property
     def filter_name(self) -> typing.Optional[builtins.str]:
         '''The name of the subscription filter.
@@ -8433,6 +8516,7 @@ class SubscriptionFilterOptions:
     name_mapping={
         "destination": "destination",
         "filter_pattern": "filterPattern",
+        "distribution": "distribution",
         "filter_name": "filterName",
         "log_group": "logGroup",
     },
@@ -8443,6 +8527,7 @@ class SubscriptionFilterProps(SubscriptionFilterOptions):
         *,
         destination: ILogSubscriptionDestination,
         filter_pattern: IFilterPattern,
+        distribution: typing.Optional[Distribution] = None,
         filter_name: typing.Optional[builtins.str] = None,
         log_group: ILogGroup,
     ) -> None:
@@ -8450,6 +8535,7 @@ class SubscriptionFilterProps(SubscriptionFilterOptions):
 
         :param destination: The destination to send the filtered events to. For example, a Kinesis stream or a Lambda function.
         :param filter_pattern: Log events matching this pattern will be sent to the destination.
+        :param distribution: The method used to distribute log data to the destination. This property can only be used with KinesisDestination. Default: Distribution.BY_LOG_STREAM
         :param filter_name: The name of the subscription filter. Default: Automatically generated
         :param log_group: The log group to create the subscription on.
 
@@ -8474,6 +8560,7 @@ class SubscriptionFilterProps(SubscriptionFilterOptions):
             type_hints = typing.get_type_hints(_typecheckingstub__eb936c8dd6a8ee03c9e8f4ffbe991c19b4b98648bbdd91f03367a058de3e8268)
             check_type(argname="argument destination", value=destination, expected_type=type_hints["destination"])
             check_type(argname="argument filter_pattern", value=filter_pattern, expected_type=type_hints["filter_pattern"])
+            check_type(argname="argument distribution", value=distribution, expected_type=type_hints["distribution"])
             check_type(argname="argument filter_name", value=filter_name, expected_type=type_hints["filter_name"])
             check_type(argname="argument log_group", value=log_group, expected_type=type_hints["log_group"])
         self._values: typing.Dict[builtins.str, typing.Any] = {
@@ -8481,6 +8568,8 @@ class SubscriptionFilterProps(SubscriptionFilterOptions):
             "filter_pattern": filter_pattern,
             "log_group": log_group,
         }
+        if distribution is not None:
+            self._values["distribution"] = distribution
         if filter_name is not None:
             self._values["filter_name"] = filter_name
 
@@ -8501,6 +8590,17 @@ class SubscriptionFilterProps(SubscriptionFilterOptions):
         assert result is not None, "Required property 'filter_pattern' is missing"
         return typing.cast(IFilterPattern, result)
 
+    @builtins.property
+    def distribution(self) -> typing.Optional[Distribution]:
+        '''The method used to distribute log data to the destination.
+
+        This property can only be used with KinesisDestination.
+
+        :default: Distribution.BY_LOG_STREAM
+        '''
+        result = self._values.get("distribution")
+        return typing.cast(typing.Optional[Distribution], result)
+
     @builtins.property
     def filter_name(self) -> typing.Optional[builtins.str]:
         '''The name of the subscription filter.
@@ -8765,6 +8865,7 @@ __all__ = [
     "DataIdentifier",
     "DataProtectionPolicy",
     "DataProtectionPolicyProps",
+    "Distribution",
     "FilterPattern",
     "IFilterPattern",
     "ILogGroup",
@@ -9678,6 +9779,7 @@ def _typecheckingstub__3445e5a6f896ca9cd9e8a527d7229440b3a517fd59dc21bc08b64ef68
     *,
     destination: ILogSubscriptionDestination,
     filter_pattern: IFilterPattern,
+    distribution: typing.Optional[Distribution] = None,
     filter_name: typing.Optional[builtins.str] = None,
 ) -> None:
     """Type checking stubs"""
@@ -9781,6 +9883,7 @@ def _typecheckingstub__a53e1c08918ff12981b248135756d8f20c9acc571a2cab87ee6a35043
     *,
     destination: ILogSubscriptionDestination,
     filter_pattern: IFilterPattern,
+    distribution: typing.Optional[Distribution] = None,
     filter_name: typing.Optional[builtins.str] = None,
 ) -> None:
     """Type checking stubs"""
@@ -10043,6 +10146,7 @@ def _typecheckingstub__e3c78d3f905ddfb9bb1ff8466a0b030e7b262b0793c43d2667b561e42
     log_group: ILogGroup,
     destination: ILogSubscriptionDestination,
     filter_pattern: IFilterPattern,
+    distribution: typing.Optional[Distribution] = None,
     filter_name: typing.Optional[builtins.str] = None,
 ) -> None:
     """Type checking stubs"""
@@ -10052,6 +10156,7 @@ def _typecheckingstub__177a84e94bfd826b20adc1107770c972772c540b0a1ac8475f6347650
     *,
     destination: ILogSubscriptionDestination,
     filter_pattern: IFilterPattern,
+    distribution: typing.Optional[Distribution] = None,
     filter_name: typing.Optional[builtins.str] = None,
 ) -> None:
     """Type checking stubs"""
@@ -10061,6 +10166,7 @@ def _typecheckingstub__eb936c8dd6a8ee03c9e8f4ffbe991c19b4b98648bbdd91f03367a058d
     *,
     destination: ILogSubscriptionDestination,
     filter_pattern: IFilterPattern,
+    distribution: typing.Optional[Distribution] = None,
     filter_name: typing.Optional[builtins.str] = None,
     log_group: ILogGroup,
 ) -> None:

aws_cdk/aws_logs_destinations/__init__.py

@@ -41,21 +41,23 @@ class KinesisDestination(
 ):
     '''Use a Kinesis stream as the destination for a log subscription.
 
-    :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_iam as iam
-        from aws_cdk import aws_kinesis as kinesis
-        from aws_cdk import aws_logs_destinations as logs_destinations
+        import aws_cdk.aws_logs_destinations as destinations
+        import aws_cdk.aws_kinesis as kinesis
         
-        # role: iam.Role
         # stream: kinesis.Stream
+        # log_group: logs.LogGroup
+        
         
-        kinesis_destination = logs_destinations.KinesisDestination(stream,
-            role=role
+        logs.SubscriptionFilter(self, "Subscription",
+            log_group=log_group,
+            destination=destinations.KinesisDestination(stream),
+            filter_pattern=logs.FilterPattern.all_terms("ERROR", "MainThread"),
+            filter_name="ErrorInMainThread",
+            distribution=logs.Distribution.RANDOM
         )
     '''
 

aws_cdk/aws_mediaconnect/__init__.py

@@ -3954,10 +3954,10 @@ class CfnFlow(
             :param ingest_ip: The IP address that the flow listens on for incoming content.
             :param ingest_port: The port that the flow listens on for incoming content. If the protocol of the source is Zixi, the port must be set to 2088.
             :param max_bitrate: The maximum bitrate for RIST, RTP, and RTP-FEC streams.
-            :param max_latency: The maximum latency in milliseconds for a RIST or Zixi-based source. Default: - 2000
+            :param max_latency: The maximum latency in milliseconds for a RIST or Zixi-based source.
             :param max_sync_buffer: The size of the buffer (in milliseconds) to use to sync incoming source data.
             :param media_stream_source_configurations: The media stream that is associated with the source, and the parameters for that association.
-            :param min_latency: The minimum latency in milliseconds for SRT-based streams. In streams that use the SRT protocol, this value that you set on your MediaConnect source or output represents the minimal potential latency of that connection. The latency of the stream is set to the highest number between the sender’s minimum latency and the receiver’s minimum latency. Default: - 2000
+            :param min_latency: The minimum latency in milliseconds for SRT-based streams. In streams that use the SRT protocol, this value that you set on your MediaConnect source or output represents the minimal potential latency of that connection. The latency of the stream is set to the highest number between the sender’s minimum latency and the receiver’s minimum latency.
             :param name: The name of the source.
             :param protocol: The protocol that is used by the source. AWS CloudFormation does not currently support CDI or ST 2110 JPEG XS source protocols.
             :param sender_control_port: The port that the flow uses to send outbound requests to initiate connection with the sender.
@@ -4181,8 +4181,6 @@ class CfnFlow(
         def max_latency(self) -> typing.Optional[jsii.Number]:
             '''The maximum latency in milliseconds for a RIST or Zixi-based source.
 
-            :default: - 2000
-
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-mediaconnect-flow-source.html#cfn-mediaconnect-flow-source-maxlatency
             '''
             result = self._values.get("max_latency")
@@ -4214,8 +4212,6 @@ class CfnFlow(
 
             In streams that use the SRT protocol, this value that you set on your MediaConnect source or output represents the minimal potential latency of that connection. The latency of the stream is set to the highest number between the sender’s minimum latency and the receiver’s minimum latency.
 
-            :default: - 2000
-
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-mediaconnect-flow-source.html#cfn-mediaconnect-flow-source-minlatency
             '''
             result = self._values.get("min_latency")

aws_cdk/aws_medialive/__init__.py

@@ -3259,19 +3259,24 @@ class CfnChannel(
     @jsii.data_type(
         jsii_type="aws-cdk-lib.aws_medialive.CfnChannel.AvailConfigurationProperty",
         jsii_struct_bases=[],
-        name_mapping={"avail_settings": "availSettings"},
+        name_mapping={
+            "avail_settings": "availSettings",
+            "scte35_segmentation_scope": "scte35SegmentationScope",
+        },
     )
     class AvailConfigurationProperty:
         def __init__(
             self,
             *,
             avail_settings: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union["CfnChannel.AvailSettingsProperty", typing.Dict[builtins.str, typing.Any]]]] = None,
+            scte35_segmentation_scope: typing.Optional[builtins.str] = None,
         ) -> None:
             '''The setup of ad avail handling in the output.
 
             The parent of this entity is EncoderSettings.
 
             :param avail_settings: The setup of ad avail handling in the output.
+            :param scte35_segmentation_scope: 
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-medialive-channel-availconfiguration.html
             :exampleMetadata: fixture=_generated
@@ -3302,15 +3307,19 @@ class CfnChannel(
                             no_regional_blackout_flag="noRegionalBlackoutFlag",
                             web_delivery_allowed_flag="webDeliveryAllowedFlag"
                         )
-                    )
+                    ),
+                    scte35_segmentation_scope="scte35SegmentationScope"
                 )
             '''
             if __debug__:
                 type_hints = typing.get_type_hints(_typecheckingstub__64a141b4b3b5b23b51297f468895864a0795ec8b925d0233a715f29550246998)
                 check_type(argname="argument avail_settings", value=avail_settings, expected_type=type_hints["avail_settings"])
+                check_type(argname="argument scte35_segmentation_scope", value=scte35_segmentation_scope, expected_type=type_hints["scte35_segmentation_scope"])
             self._values: typing.Dict[builtins.str, typing.Any] = {}
             if avail_settings is not None:
                 self._values["avail_settings"] = avail_settings
+            if scte35_segmentation_scope is not None:
+                self._values["scte35_segmentation_scope"] = scte35_segmentation_scope
 
         @builtins.property
         def avail_settings(
@@ -3323,6 +3332,14 @@ class CfnChannel(
             result = self._values.get("avail_settings")
             return typing.cast(typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnChannel.AvailSettingsProperty"]], result)
 
+        @builtins.property
+        def scte35_segmentation_scope(self) -> typing.Optional[builtins.str]:
+            '''
+            :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-medialive-channel-availconfiguration.html#cfn-medialive-channel-availconfiguration-scte35segmentationscope
+            '''
+            result = self._values.get("scte35_segmentation_scope")
+            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
 
@@ -25638,6 +25655,7 @@ def _typecheckingstub__eca0526dd47d2b5efa5857a5e7d3c0d846ea42078c494f626e4d9e9f6
 def _typecheckingstub__64a141b4b3b5b23b51297f468895864a0795ec8b925d0233a715f29550246998(
     *,
     avail_settings: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union[CfnChannel.AvailSettingsProperty, typing.Dict[builtins.str, typing.Any]]]] = None,
+    scte35_segmentation_scope: typing.Optional[builtins.str] = None,
 ) -> None:
     """Type checking stubs"""
     pass