aws-cdk-lib 2.137.0__py3-none-any.whl → 2.139.0__py3-none-any.whl

aws_cdk/aws_cloudwatch/__init__.py

@@ -959,6 +959,7 @@ from .. import (
     IResolvable as _IResolvable_da3f097b,
     IResource as _IResource_c80c4260,
     ITaggable as _ITaggable_36806126,
+    ITaggableV2 as _ITaggableV2_4e6798f8,
     Resource as _Resource_45bc6135,
     ResourceProps as _ResourceProps_15a65b4e,
     TagManager as _TagManager_0a598cb3,
@@ -1320,7 +1321,7 @@ class AlarmStatusWidgetSortBy(enum.Enum):
     '''
 
 
-@jsii.implements(_IInspectable_c2943556)
+@jsii.implements(_IInspectable_c2943556, _ITaggableV2_4e6798f8)
 class CfnAlarm(
     _CfnResource_9df397a6,
     metaclass=jsii.JSIIMeta,
@@ -1389,6 +1390,10 @@ class CfnAlarm(
             ok_actions=["okActions"],
             period=123,
             statistic="statistic",
+            tags=[CfnTag(
+                key="key",
+                value="value"
+            )],
             threshold=123,
             threshold_metric_id="thresholdMetricId",
             treat_missing_data="treatMissingData",
@@ -1418,6 +1423,7 @@ class CfnAlarm(
         ok_actions: typing.Optional[typing.Sequence[builtins.str]] = None,
         period: typing.Optional[jsii.Number] = None,
         statistic: typing.Optional[builtins.str] = None,
+        tags: typing.Optional[typing.Sequence[typing.Union[_CfnTag_f6864754, typing.Dict[builtins.str, typing.Any]]]] = None,
         threshold: typing.Optional[jsii.Number] = None,
         threshold_metric_id: typing.Optional[builtins.str] = None,
         treat_missing_data: typing.Optional[builtins.str] = None,
@@ -1443,6 +1449,7 @@ class CfnAlarm(
         :param ok_actions: The actions to execute when this alarm transitions to the ``OK`` state from any other state. Each action is specified as an Amazon Resource Name (ARN).
         :param period: The period, in seconds, over which the statistic is applied. This is required for an alarm based on a metric. Valid values are 10, 30, 60, and any multiple of 60. For an alarm based on a math expression, you can't specify ``Period`` , and instead you use the ``Metrics`` parameter. *Minimum:* 10
         :param statistic: The statistic for the metric associated with the alarm, other than percentile. For percentile statistics, use ``ExtendedStatistic`` . For an alarm based on a metric, you must specify either ``Statistic`` or ``ExtendedStatistic`` but not both. For an alarm based on a math expression, you can't specify ``Statistic`` . Instead, you use ``Metrics`` .
+        :param tags: A list of key-value pairs to associate with the alarm. You can associate as many as 50 tags with an alarm. To be able to associate tags with the alarm when you create the alarm, you must have the ``cloudwatch:TagResource`` permission. Tags can help you organize and categorize your resources. You can also use them to scope user permissions by granting a user permission to access or change only resources with certain tag values.
         :param threshold: The value to compare with the specified statistic.
         :param threshold_metric_id: In an alarm based on an anomaly detection model, this is the ID of the ``ANOMALY_DETECTION_BAND`` function used as the threshold for the alarm.
         :param treat_missing_data: Sets how this alarm is to handle missing data points. Valid values are ``breaching`` , ``notBreaching`` , ``ignore`` , and ``missing`` . For more information, see `Configuring How CloudWatch Alarms Treat Missing Data <https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/AlarmThatSendsEmail.html#alarms-and-missing-data>`_ in the *Amazon CloudWatch User Guide* . If you omit this parameter, the default behavior of ``missing`` is used.
@@ -1470,6 +1477,7 @@ class CfnAlarm(
             ok_actions=ok_actions,
             period=period,
             statistic=statistic,
+            tags=tags,
             threshold=threshold,
             threshold_metric_id=threshold_metric_id,
             treat_missing_data=treat_missing_data,
@@ -1517,6 +1525,12 @@ class CfnAlarm(
         '''
         return typing.cast(builtins.str, jsii.get(self, "attrArn"))
 
+    @builtins.property
+    @jsii.member(jsii_name="cdkTagManager")
+    def cdk_tag_manager(self) -> _TagManager_0a598cb3:
+        '''Tag Manager which manages the tags for this resource.'''
+        return typing.cast(_TagManager_0a598cb3, jsii.get(self, "cdkTagManager"))
+
     @builtins.property
     @jsii.member(jsii_name="cfnProperties")
     def _cfn_properties(self) -> typing.Mapping[builtins.str, typing.Any]:
@@ -1770,6 +1784,19 @@ class CfnAlarm(
             check_type(argname="argument value", value=value, expected_type=type_hints["value"])
         jsii.set(self, "statistic", value)
 
+    @builtins.property
+    @jsii.member(jsii_name="tags")
+    def tags(self) -> typing.Optional[typing.List[_CfnTag_f6864754]]:
+        '''A list of key-value pairs to associate with the alarm.'''
+        return typing.cast(typing.Optional[typing.List[_CfnTag_f6864754]], jsii.get(self, "tags"))
+
+    @tags.setter
+    def tags(self, value: typing.Optional[typing.List[_CfnTag_f6864754]]) -> None:
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__895712e62b896ed30b8848bddfdb970fd334934c19393e2eb8ad06392ecf8af9)
+            check_type(argname="argument value", value=value, expected_type=type_hints["value"])
+        jsii.set(self, "tags", value)
+
     @builtins.property
     @jsii.member(jsii_name="threshold")
     def threshold(self) -> typing.Optional[jsii.Number]:
@@ -2337,6 +2364,7 @@ class CfnAlarm(
         "ok_actions": "okActions",
         "period": "period",
         "statistic": "statistic",
+        "tags": "tags",
         "threshold": "threshold",
         "threshold_metric_id": "thresholdMetricId",
         "treat_missing_data": "treatMissingData",
@@ -2364,6 +2392,7 @@ class CfnAlarmProps:
         ok_actions: typing.Optional[typing.Sequence[builtins.str]] = None,
         period: typing.Optional[jsii.Number] = None,
         statistic: typing.Optional[builtins.str] = None,
+        tags: typing.Optional[typing.Sequence[typing.Union[_CfnTag_f6864754, typing.Dict[builtins.str, typing.Any]]]] = None,
         threshold: typing.Optional[jsii.Number] = None,
         threshold_metric_id: typing.Optional[builtins.str] = None,
         treat_missing_data: typing.Optional[builtins.str] = None,
@@ -2388,6 +2417,7 @@ class CfnAlarmProps:
         :param ok_actions: The actions to execute when this alarm transitions to the ``OK`` state from any other state. Each action is specified as an Amazon Resource Name (ARN).
         :param period: The period, in seconds, over which the statistic is applied. This is required for an alarm based on a metric. Valid values are 10, 30, 60, and any multiple of 60. For an alarm based on a math expression, you can't specify ``Period`` , and instead you use the ``Metrics`` parameter. *Minimum:* 10
         :param statistic: The statistic for the metric associated with the alarm, other than percentile. For percentile statistics, use ``ExtendedStatistic`` . For an alarm based on a metric, you must specify either ``Statistic`` or ``ExtendedStatistic`` but not both. For an alarm based on a math expression, you can't specify ``Statistic`` . Instead, you use ``Metrics`` .
+        :param tags: A list of key-value pairs to associate with the alarm. You can associate as many as 50 tags with an alarm. To be able to associate tags with the alarm when you create the alarm, you must have the ``cloudwatch:TagResource`` permission. Tags can help you organize and categorize your resources. You can also use them to scope user permissions by granting a user permission to access or change only resources with certain tag values.
         :param threshold: The value to compare with the specified statistic.
         :param threshold_metric_id: In an alarm based on an anomaly detection model, this is the ID of the ``ANOMALY_DETECTION_BAND`` function used as the threshold for the alarm.
         :param treat_missing_data: Sets how this alarm is to handle missing data points. Valid values are ``breaching`` , ``notBreaching`` , ``ignore`` , and ``missing`` . For more information, see `Configuring How CloudWatch Alarms Treat Missing Data <https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/AlarmThatSendsEmail.html#alarms-and-missing-data>`_ in the *Amazon CloudWatch User Guide* . If you omit this parameter, the default behavior of ``missing`` is used.
@@ -2449,6 +2479,10 @@ class CfnAlarmProps:
                 ok_actions=["okActions"],
                 period=123,
                 statistic="statistic",
+                tags=[CfnTag(
+                    key="key",
+                    value="value"
+                )],
                 threshold=123,
                 threshold_metric_id="thresholdMetricId",
                 treat_missing_data="treatMissingData",
@@ -2474,6 +2508,7 @@ class CfnAlarmProps:
             check_type(argname="argument ok_actions", value=ok_actions, expected_type=type_hints["ok_actions"])
             check_type(argname="argument period", value=period, expected_type=type_hints["period"])
             check_type(argname="argument statistic", value=statistic, expected_type=type_hints["statistic"])
+            check_type(argname="argument tags", value=tags, expected_type=type_hints["tags"])
             check_type(argname="argument threshold", value=threshold, expected_type=type_hints["threshold"])
             check_type(argname="argument threshold_metric_id", value=threshold_metric_id, expected_type=type_hints["threshold_metric_id"])
             check_type(argname="argument treat_missing_data", value=treat_missing_data, expected_type=type_hints["treat_missing_data"])
@@ -2512,6 +2547,8 @@ class CfnAlarmProps:
             self._values["period"] = period
         if statistic is not None:
             self._values["statistic"] = statistic
+        if tags is not None:
+            self._values["tags"] = tags
         if threshold is not None:
             self._values["threshold"] = threshold
         if threshold_metric_id is not None:
@@ -2735,6 +2772,19 @@ class CfnAlarmProps:
         result = self._values.get("statistic")
         return typing.cast(typing.Optional[builtins.str], result)
 
+    @builtins.property
+    def tags(self) -> typing.Optional[typing.List[_CfnTag_f6864754]]:
+        '''A list of key-value pairs to associate with the alarm.
+
+        You can associate as many as 50 tags with an alarm. To be able to associate tags with the alarm when you create the alarm, you must have the ``cloudwatch:TagResource`` permission.
+
+        Tags can help you organize and categorize your resources. You can also use them to scope user permissions by granting a user permission to access or change only resources with certain tag values.
+
+        :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-cloudwatch-alarm.html#cfn-cloudwatch-alarm-tags
+        '''
+        result = self._values.get("tags")
+        return typing.cast(typing.Optional[typing.List[_CfnTag_f6864754]], result)
+
     @builtins.property
     def threshold(self) -> typing.Optional[jsii.Number]:
         '''The value to compare with the specified statistic.
@@ -2825,6 +2875,9 @@ class CfnAnomalyDetector(
                 name="name",
                 value="value"
             )],
+            metric_characteristics=cloudwatch.CfnAnomalyDetector.MetricCharacteristicsProperty(
+                periodic_spikes=False
+            ),
             metric_math_anomaly_detector=cloudwatch.CfnAnomalyDetector.MetricMathAnomalyDetectorProperty(
                 metric_data_queries=[cloudwatch.CfnAnomalyDetector.MetricDataQueryProperty(
                     id="id",
@@ -2877,6 +2930,7 @@ class CfnAnomalyDetector(
         *,
         configuration: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union["CfnAnomalyDetector.ConfigurationProperty", typing.Dict[builtins.str, typing.Any]]]] = None,
         dimensions: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Sequence[typing.Union[_IResolvable_da3f097b, typing.Union["CfnAnomalyDetector.DimensionProperty", typing.Dict[builtins.str, typing.Any]]]]]] = None,
+        metric_characteristics: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union["CfnAnomalyDetector.MetricCharacteristicsProperty", typing.Dict[builtins.str, typing.Any]]]] = None,
         metric_math_anomaly_detector: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union["CfnAnomalyDetector.MetricMathAnomalyDetectorProperty", typing.Dict[builtins.str, typing.Any]]]] = None,
         metric_name: typing.Optional[builtins.str] = None,
         namespace: typing.Optional[builtins.str] = None,
@@ -2888,6 +2942,7 @@ class CfnAnomalyDetector(
         :param id: Construct identifier for this resource (unique in its scope).
         :param configuration: Specifies details about how the anomaly detection model is to be trained, including time ranges to exclude when training and updating the model. The configuration can also include the time zone to use for the metric.
         :param dimensions: The dimensions of the metric associated with the anomaly detection band.
+        :param metric_characteristics: Use this object to include parameters to provide information about your metric to CloudWatch to help it build more accurate anomaly detection models. Currently, it includes the ``PeriodicSpikes`` parameter.
         :param metric_math_anomaly_detector: The CloudWatch metric math expression for this anomaly detector.
         :param metric_name: The name of the metric associated with the anomaly detection band.
         :param namespace: The namespace of the metric associated with the anomaly detection band.
@@ -2901,6 +2956,7 @@ class CfnAnomalyDetector(
         props = CfnAnomalyDetectorProps(
             configuration=configuration,
             dimensions=dimensions,
+            metric_characteristics=metric_characteristics,
             metric_math_anomaly_detector=metric_math_anomaly_detector,
             metric_name=metric_name,
             namespace=namespace,
@@ -2989,6 +3045,24 @@ class CfnAnomalyDetector(
             check_type(argname="argument value", value=value, expected_type=type_hints["value"])
         jsii.set(self, "dimensions", value)
 
+    @builtins.property
+    @jsii.member(jsii_name="metricCharacteristics")
+    def metric_characteristics(
+        self,
+    ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnAnomalyDetector.MetricCharacteristicsProperty"]]:
+        '''Use this object to include parameters to provide information about your metric to CloudWatch to help it build more accurate anomaly detection models.'''
+        return typing.cast(typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnAnomalyDetector.MetricCharacteristicsProperty"]], jsii.get(self, "metricCharacteristics"))
+
+    @metric_characteristics.setter
+    def metric_characteristics(
+        self,
+        value: typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnAnomalyDetector.MetricCharacteristicsProperty"]],
+    ) -> None:
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__730fad039b3befd0235c3dce81008e3d9f65ab635fe956e8ed48f3ba7060aaba)
+            check_type(argname="argument value", value=value, expected_type=type_hints["value"])
+        jsii.set(self, "metricCharacteristics", value)
+
     @builtins.property
     @jsii.member(jsii_name="metricMathAnomalyDetector")
     def metric_math_anomaly_detector(
@@ -3222,6 +3296,65 @@ class CfnAnomalyDetector(
                 k + "=" + repr(v) for k, v in self._values.items()
             )
 
+    @jsii.data_type(
+        jsii_type="aws-cdk-lib.aws_cloudwatch.CfnAnomalyDetector.MetricCharacteristicsProperty",
+        jsii_struct_bases=[],
+        name_mapping={"periodic_spikes": "periodicSpikes"},
+    )
+    class MetricCharacteristicsProperty:
+        def __init__(
+            self,
+            *,
+            periodic_spikes: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,
+        ) -> None:
+            '''This object includes parameters that you can use to provide information to CloudWatch to help it build more accurate anomaly detection models.
+
+            :param periodic_spikes: Set this parameter to true if values for this metric consistently include spikes that should not be considered to be anomalies. With this set to true, CloudWatch will expect to see spikes that occurred consistently during the model training period, and won't flag future similar spikes as anomalies.
+
+            :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-cloudwatch-anomalydetector-metriccharacteristics.html
+            :exampleMetadata: fixture=_generated
+
+            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_cloudwatch as cloudwatch
+                
+                metric_characteristics_property = cloudwatch.CfnAnomalyDetector.MetricCharacteristicsProperty(
+                    periodic_spikes=False
+                )
+            '''
+            if __debug__:
+                type_hints = typing.get_type_hints(_typecheckingstub__782bb184e35a5f89f30dd279aa12cf0d77b7069596cc47017cd113eb386bfa0b)
+                check_type(argname="argument periodic_spikes", value=periodic_spikes, expected_type=type_hints["periodic_spikes"])
+            self._values: typing.Dict[builtins.str, typing.Any] = {}
+            if periodic_spikes is not None:
+                self._values["periodic_spikes"] = periodic_spikes
+
+        @builtins.property
+        def periodic_spikes(
+            self,
+        ) -> typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]]:
+            '''Set this parameter to true if values for this metric consistently include spikes that should not be considered to be anomalies.
+
+            With this set to true, CloudWatch will expect to see spikes that occurred consistently during the model training period, and won't flag future similar spikes as anomalies.
+
+            :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-cloudwatch-anomalydetector-metriccharacteristics.html#cfn-cloudwatch-anomalydetector-metriccharacteristics-periodicspikes
+            '''
+            result = self._values.get("periodic_spikes")
+            return typing.cast(typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]], 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 "MetricCharacteristicsProperty(%s)" % ", ".join(
+                k + "=" + repr(v) for k, v in self._values.items()
+            )
+
     @jsii.data_type(
         jsii_type="aws-cdk-lib.aws_cloudwatch.CfnAnomalyDetector.MetricDataQueryProperty",
         jsii_struct_bases=[],
@@ -3846,7 +3979,7 @@ class CfnAnomalyDetector(
 
             If you have enabled unified cross-account observability, and this account is a monitoring account, the metric can be in the same account or a source account.
 
-            :param account_id: 
+            :param account_id: If the CloudWatch metric that provides the time series that the anomaly detector uses as input is in another account, specify that account ID here. If you omit this parameter, the current account is used.
             :param dimensions: The metric dimensions to create the anomaly detection model for.
             :param metric_name: The name of the metric to create the anomaly detection model for.
             :param namespace: The namespace of the metric to create the anomaly detection model for.
@@ -3893,7 +4026,10 @@ class CfnAnomalyDetector(
 
         @builtins.property
         def account_id(self) -> typing.Optional[builtins.str]:
-            '''
+            '''If the CloudWatch metric that provides the time series that the anomaly detector uses as input is in another account, specify that account ID here.
+
+            If you omit this parameter, the current account is used.
+
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-cloudwatch-anomalydetector-singlemetricanomalydetector.html#cfn-cloudwatch-anomalydetector-singlemetricanomalydetector-accountid
             '''
             result = self._values.get("account_id")
@@ -3955,6 +4091,7 @@ class CfnAnomalyDetector(
     name_mapping={
         "configuration": "configuration",
         "dimensions": "dimensions",
+        "metric_characteristics": "metricCharacteristics",
         "metric_math_anomaly_detector": "metricMathAnomalyDetector",
         "metric_name": "metricName",
         "namespace": "namespace",
@@ -3968,6 +4105,7 @@ class CfnAnomalyDetectorProps:
         *,
         configuration: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union[CfnAnomalyDetector.ConfigurationProperty, typing.Dict[builtins.str, typing.Any]]]] = None,
         dimensions: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Sequence[typing.Union[_IResolvable_da3f097b, typing.Union[CfnAnomalyDetector.DimensionProperty, typing.Dict[builtins.str, typing.Any]]]]]] = None,
+        metric_characteristics: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union[CfnAnomalyDetector.MetricCharacteristicsProperty, typing.Dict[builtins.str, typing.Any]]]] = None,
         metric_math_anomaly_detector: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union[CfnAnomalyDetector.MetricMathAnomalyDetectorProperty, typing.Dict[builtins.str, typing.Any]]]] = None,
         metric_name: typing.Optional[builtins.str] = None,
         namespace: typing.Optional[builtins.str] = None,
@@ -3978,6 +4116,7 @@ class CfnAnomalyDetectorProps:
 
         :param configuration: Specifies details about how the anomaly detection model is to be trained, including time ranges to exclude when training and updating the model. The configuration can also include the time zone to use for the metric.
         :param dimensions: The dimensions of the metric associated with the anomaly detection band.
+        :param metric_characteristics: Use this object to include parameters to provide information about your metric to CloudWatch to help it build more accurate anomaly detection models. Currently, it includes the ``PeriodicSpikes`` parameter.
         :param metric_math_anomaly_detector: The CloudWatch metric math expression for this anomaly detector.
         :param metric_name: The name of the metric associated with the anomaly detection band.
         :param namespace: The namespace of the metric associated with the anomaly detection band.
@@ -4005,6 +4144,9 @@ class CfnAnomalyDetectorProps:
                     name="name",
                     value="value"
                 )],
+                metric_characteristics=cloudwatch.CfnAnomalyDetector.MetricCharacteristicsProperty(
+                    periodic_spikes=False
+                ),
                 metric_math_anomaly_detector=cloudwatch.CfnAnomalyDetector.MetricMathAnomalyDetectorProperty(
                     metric_data_queries=[cloudwatch.CfnAnomalyDetector.MetricDataQueryProperty(
                         id="id",
@@ -4053,6 +4195,7 @@ class CfnAnomalyDetectorProps:
             type_hints = typing.get_type_hints(_typecheckingstub__929a09b64f3cc2009ffca4b74d148c42dfbbc7531a49bc66cb58443f8870fba2)
             check_type(argname="argument configuration", value=configuration, expected_type=type_hints["configuration"])
             check_type(argname="argument dimensions", value=dimensions, expected_type=type_hints["dimensions"])
+            check_type(argname="argument metric_characteristics", value=metric_characteristics, expected_type=type_hints["metric_characteristics"])
             check_type(argname="argument metric_math_anomaly_detector", value=metric_math_anomaly_detector, expected_type=type_hints["metric_math_anomaly_detector"])
             check_type(argname="argument metric_name", value=metric_name, expected_type=type_hints["metric_name"])
             check_type(argname="argument namespace", value=namespace, expected_type=type_hints["namespace"])
@@ -4063,6 +4206,8 @@ class CfnAnomalyDetectorProps:
             self._values["configuration"] = configuration
         if dimensions is not None:
             self._values["dimensions"] = dimensions
+        if metric_characteristics is not None:
+            self._values["metric_characteristics"] = metric_characteristics
         if metric_math_anomaly_detector is not None:
             self._values["metric_math_anomaly_detector"] = metric_math_anomaly_detector
         if metric_name is not None:
@@ -4098,6 +4243,19 @@ class CfnAnomalyDetectorProps:
         result = self._values.get("dimensions")
         return typing.cast(typing.Optional[typing.Union[_IResolvable_da3f097b, typing.List[typing.Union[_IResolvable_da3f097b, CfnAnomalyDetector.DimensionProperty]]]], result)
 
+    @builtins.property
+    def metric_characteristics(
+        self,
+    ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, CfnAnomalyDetector.MetricCharacteristicsProperty]]:
+        '''Use this object to include parameters to provide information about your metric to CloudWatch to help it build more accurate anomaly detection models.
+
+        Currently, it includes the ``PeriodicSpikes`` parameter.
+
+        :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-cloudwatch-anomalydetector.html#cfn-cloudwatch-anomalydetector-metriccharacteristics
+        '''
+        result = self._values.get("metric_characteristics")
+        return typing.cast(typing.Optional[typing.Union[_IResolvable_da3f097b, CfnAnomalyDetector.MetricCharacteristicsProperty]], result)
+
     @builtins.property
     def metric_math_anomaly_detector(
         self,
@@ -4159,7 +4317,7 @@ class CfnAnomalyDetectorProps:
         )
 
 
-@jsii.implements(_IInspectable_c2943556)
+@jsii.implements(_IInspectable_c2943556, _ITaggableV2_4e6798f8)
 class CfnCompositeAlarm(
     _CfnResource_9df397a6,
     metaclass=jsii.JSIIMeta,
@@ -4173,8 +4331,6 @@ class CfnCompositeAlarm(
 
     Using composite alarms can reduce alarm noise. You can create multiple metric alarms, and also create a composite alarm and set up alerts only for the composite alarm. For example, you could create a composite alarm that goes into ALARM state only when more than one of the underlying metric alarms are in ALARM state.
 
-    Currently, the only alarm actions that can be taken by composite alarms are notifying SNS topics.
-
     When this operation creates an alarm, the alarm state is immediately set to INSUFFICIENT_DATA. The alarm is then evaluated and its state is set appropriately. Any actions associated with the new state are then executed. For a composite alarm, this initial time after creation is the only time that the alarm can be in INSUFFICIENT_DATA state.
 
     When you update an existing alarm, its state is left unchanged, but the update completely overwrites the previous configuration of the alarm.
@@ -4201,7 +4357,11 @@ class CfnCompositeAlarm(
             alarm_description="alarmDescription",
             alarm_name="alarmName",
             insufficient_data_actions=["insufficientDataActions"],
-            ok_actions=["okActions"]
+            ok_actions=["okActions"],
+            tags=[CfnTag(
+                key="key",
+                value="value"
+            )]
         )
     '''
 
@@ -4220,6 +4380,7 @@ class CfnCompositeAlarm(
         alarm_name: typing.Optional[builtins.str] = None,
         insufficient_data_actions: typing.Optional[typing.Sequence[builtins.str]] = None,
         ok_actions: typing.Optional[typing.Sequence[builtins.str]] = None,
+        tags: typing.Optional[typing.Sequence[typing.Union[_CfnTag_f6864754, typing.Dict[builtins.str, typing.Any]]]] = None,
     ) -> None:
         '''
         :param scope: Scope in which this resource is defined.
@@ -4234,6 +4395,7 @@ class CfnCompositeAlarm(
         :param alarm_name: The name for the composite alarm. This name must be unique within your AWS account.
         :param insufficient_data_actions: The actions to execute when this alarm transitions to the INSUFFICIENT_DATA state from any other state. Each action is specified as an Amazon Resource Name (ARN). For more information about creating alarms and the actions that you can specify, see `PutCompositeAlarm <https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_PutCompositeAlarm.html>`_ in the *Amazon CloudWatch API Reference* .
         :param ok_actions: The actions to execute when this alarm transitions to the OK state from any other state. Each action is specified as an Amazon Resource Name (ARN). For more information about creating alarms and the actions that you can specify, see `PutCompositeAlarm <https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_PutCompositeAlarm.html>`_ in the *Amazon CloudWatch API Reference* .
+        :param tags: A list of key-value pairs to associate with the alarm. You can associate as many as 50 tags with an alarm. To be able to associate tags with the alarm when you create the alarm, you must have the ``cloudwatch:TagResource`` permission. Tags can help you organize and categorize your resources. You can also use them to scope user permissions by granting a user permission to access or change only resources with certain tag values.
         '''
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__5c24d10326e3cd470724ecbde5d50ff23fdf44dc88f809d9a181a5cd867e5cf3)
@@ -4250,6 +4412,7 @@ class CfnCompositeAlarm(
             alarm_name=alarm_name,
             insufficient_data_actions=insufficient_data_actions,
             ok_actions=ok_actions,
+            tags=tags,
         )
 
         jsii.create(self.__class__, self, [scope, id, props])
@@ -4293,6 +4456,12 @@ class CfnCompositeAlarm(
         '''
         return typing.cast(builtins.str, jsii.get(self, "attrArn"))
 
+    @builtins.property
+    @jsii.member(jsii_name="cdkTagManager")
+    def cdk_tag_manager(self) -> _TagManager_0a598cb3:
+        '''Tag Manager which manages the tags for this resource.'''
+        return typing.cast(_TagManager_0a598cb3, jsii.get(self, "cdkTagManager"))
+
     @builtins.property
     @jsii.member(jsii_name="cfnProperties")
     def _cfn_properties(self) -> typing.Mapping[builtins.str, typing.Any]:
@@ -4442,6 +4611,19 @@ class CfnCompositeAlarm(
             check_type(argname="argument value", value=value, expected_type=type_hints["value"])
         jsii.set(self, "okActions", value)
 
+    @builtins.property
+    @jsii.member(jsii_name="tags")
+    def tags(self) -> typing.Optional[typing.List[_CfnTag_f6864754]]:
+        '''A list of key-value pairs to associate with the alarm.'''
+        return typing.cast(typing.Optional[typing.List[_CfnTag_f6864754]], jsii.get(self, "tags"))
+
+    @tags.setter
+    def tags(self, value: typing.Optional[typing.List[_CfnTag_f6864754]]) -> None:
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__457680b612885bf2c4b88aebcb2510b437690fdf7d6235bf00d83846c1ee3452)
+            check_type(argname="argument value", value=value, expected_type=type_hints["value"])
+        jsii.set(self, "tags", value)
+
 
 @jsii.data_type(
     jsii_type="aws-cdk-lib.aws_cloudwatch.CfnCompositeAlarmProps",
@@ -4457,6 +4639,7 @@ class CfnCompositeAlarm(
         "alarm_name": "alarmName",
         "insufficient_data_actions": "insufficientDataActions",
         "ok_actions": "okActions",
+        "tags": "tags",
     },
 )
 class CfnCompositeAlarmProps:
@@ -4473,6 +4656,7 @@ class CfnCompositeAlarmProps:
         alarm_name: typing.Optional[builtins.str] = None,
         insufficient_data_actions: typing.Optional[typing.Sequence[builtins.str]] = None,
         ok_actions: typing.Optional[typing.Sequence[builtins.str]] = None,
+        tags: typing.Optional[typing.Sequence[typing.Union[_CfnTag_f6864754, typing.Dict[builtins.str, typing.Any]]]] = None,
     ) -> None:
         '''Properties for defining a ``CfnCompositeAlarm``.
 
@@ -4486,6 +4670,7 @@ class CfnCompositeAlarmProps:
         :param alarm_name: The name for the composite alarm. This name must be unique within your AWS account.
         :param insufficient_data_actions: The actions to execute when this alarm transitions to the INSUFFICIENT_DATA state from any other state. Each action is specified as an Amazon Resource Name (ARN). For more information about creating alarms and the actions that you can specify, see `PutCompositeAlarm <https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_PutCompositeAlarm.html>`_ in the *Amazon CloudWatch API Reference* .
         :param ok_actions: The actions to execute when this alarm transitions to the OK state from any other state. Each action is specified as an Amazon Resource Name (ARN). For more information about creating alarms and the actions that you can specify, see `PutCompositeAlarm <https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_PutCompositeAlarm.html>`_ in the *Amazon CloudWatch API Reference* .
+        :param tags: A list of key-value pairs to associate with the alarm. You can associate as many as 50 tags with an alarm. To be able to associate tags with the alarm when you create the alarm, you must have the ``cloudwatch:TagResource`` permission. Tags can help you organize and categorize your resources. You can also use them to scope user permissions by granting a user permission to access or change only resources with certain tag values.
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-cloudwatch-compositealarm.html
         :exampleMetadata: fixture=_generated
@@ -4508,7 +4693,11 @@ class CfnCompositeAlarmProps:
                 alarm_description="alarmDescription",
                 alarm_name="alarmName",
                 insufficient_data_actions=["insufficientDataActions"],
-                ok_actions=["okActions"]
+                ok_actions=["okActions"],
+                tags=[CfnTag(
+                    key="key",
+                    value="value"
+                )]
             )
         '''
         if __debug__:
@@ -4523,6 +4712,7 @@ class CfnCompositeAlarmProps:
             check_type(argname="argument alarm_name", value=alarm_name, expected_type=type_hints["alarm_name"])
             check_type(argname="argument insufficient_data_actions", value=insufficient_data_actions, expected_type=type_hints["insufficient_data_actions"])
             check_type(argname="argument ok_actions", value=ok_actions, expected_type=type_hints["ok_actions"])
+            check_type(argname="argument tags", value=tags, expected_type=type_hints["tags"])
         self._values: typing.Dict[builtins.str, typing.Any] = {
             "alarm_rule": alarm_rule,
         }
@@ -4544,6 +4734,8 @@ class CfnCompositeAlarmProps:
             self._values["insufficient_data_actions"] = insufficient_data_actions
         if ok_actions is not None:
             self._values["ok_actions"] = ok_actions
+        if tags is not None:
+            self._values["tags"] = tags
 
     @builtins.property
     def alarm_rule(self) -> builtins.str:
@@ -4676,6 +4868,19 @@ class CfnCompositeAlarmProps:
         result = self._values.get("ok_actions")
         return typing.cast(typing.Optional[typing.List[builtins.str]], result)
 
+    @builtins.property
+    def tags(self) -> typing.Optional[typing.List[_CfnTag_f6864754]]:
+        '''A list of key-value pairs to associate with the alarm.
+
+        You can associate as many as 50 tags with an alarm. To be able to associate tags with the alarm when you create the alarm, you must have the ``cloudwatch:TagResource`` permission.
+
+        Tags can help you organize and categorize your resources. You can also use them to scope user permissions by granting a user permission to access or change only resources with certain tag values.
+
+        :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-cloudwatch-compositealarm.html#cfn-cloudwatch-compositealarm-tags
+        '''
+        result = self._values.get("tags")
+        return typing.cast(typing.Optional[typing.List[_CfnTag_f6864754]], result)
+
     def __eq__(self, rhs: typing.Any) -> builtins.bool:
         return isinstance(rhs, self.__class__) and rhs._values == self._values
 
@@ -14821,6 +15026,7 @@ def _typecheckingstub__5adc477b9cef758736625389f1a51dec08eb7b348be35f42b0e37d6d4
     ok_actions: typing.Optional[typing.Sequence[builtins.str]] = None,
     period: typing.Optional[jsii.Number] = None,
     statistic: typing.Optional[builtins.str] = None,
+    tags: typing.Optional[typing.Sequence[typing.Union[_CfnTag_f6864754, typing.Dict[builtins.str, typing.Any]]]] = None,
     threshold: typing.Optional[jsii.Number] = None,
     threshold_metric_id: typing.Optional[builtins.str] = None,
     treat_missing_data: typing.Optional[builtins.str] = None,
@@ -14943,6 +15149,12 @@ def _typecheckingstub__233ab7996f3717f1bae1d0b9c6063cfa83de67875ac91777906dbd686
     """Type checking stubs"""
     pass
 
+def _typecheckingstub__895712e62b896ed30b8848bddfdb970fd334934c19393e2eb8ad06392ecf8af9(
+    value: typing.Optional[typing.List[_CfnTag_f6864754]],
+) -> None:
+    """Type checking stubs"""
+    pass
+
 def _typecheckingstub__5fbcb41a59e8a1cba566cf0b26b3129b32d1bb58de6d5fcb5045e9d2ddf908de(
     value: typing.Optional[jsii.Number],
 ) -> None:
@@ -15026,6 +15238,7 @@ def _typecheckingstub__bc643fb1b5f1f1f0e0d9896a5988171163c1f79adc28d1e921bdf85f1
     ok_actions: typing.Optional[typing.Sequence[builtins.str]] = None,
     period: typing.Optional[jsii.Number] = None,
     statistic: typing.Optional[builtins.str] = None,
+    tags: typing.Optional[typing.Sequence[typing.Union[_CfnTag_f6864754, typing.Dict[builtins.str, typing.Any]]]] = None,
     threshold: typing.Optional[jsii.Number] = None,
     threshold_metric_id: typing.Optional[builtins.str] = None,
     treat_missing_data: typing.Optional[builtins.str] = None,
@@ -15040,6 +15253,7 @@ def _typecheckingstub__09a2ebaa31c6ab1b46831db515c9eec0f049e129318fe5ad32dd73c9e
     *,
     configuration: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union[CfnAnomalyDetector.ConfigurationProperty, typing.Dict[builtins.str, typing.Any]]]] = None,
     dimensions: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Sequence[typing.Union[_IResolvable_da3f097b, typing.Union[CfnAnomalyDetector.DimensionProperty, typing.Dict[builtins.str, typing.Any]]]]]] = None,
+    metric_characteristics: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union[CfnAnomalyDetector.MetricCharacteristicsProperty, typing.Dict[builtins.str, typing.Any]]]] = None,
     metric_math_anomaly_detector: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union[CfnAnomalyDetector.MetricMathAnomalyDetectorProperty, typing.Dict[builtins.str, typing.Any]]]] = None,
     metric_name: typing.Optional[builtins.str] = None,
     namespace: typing.Optional[builtins.str] = None,
@@ -15073,6 +15287,12 @@ def _typecheckingstub__aa81b524032f55c8d3aa5c261568d608ed375b489e67451c339cda6df
     """Type checking stubs"""
     pass
 
+def _typecheckingstub__730fad039b3befd0235c3dce81008e3d9f65ab635fe956e8ed48f3ba7060aaba(
+    value: typing.Optional[typing.Union[_IResolvable_da3f097b, CfnAnomalyDetector.MetricCharacteristicsProperty]],
+) -> None:
+    """Type checking stubs"""
+    pass
+
 def _typecheckingstub__f8f418300bad7bba64cba09c0d26246445ca23587310af02c4b72408240a1db4(
     value: typing.Optional[typing.Union[_IResolvable_da3f097b, CfnAnomalyDetector.MetricMathAnomalyDetectorProperty]],
 ) -> None:
@@ -15119,6 +15339,13 @@ def _typecheckingstub__621384455c6fe008d1544e799a687e205dfd7c831d4d16758c94209b7
     """Type checking stubs"""
     pass
 
+def _typecheckingstub__782bb184e35a5f89f30dd279aa12cf0d77b7069596cc47017cd113eb386bfa0b(
+    *,
+    periodic_spikes: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,
+) -> None:
+    """Type checking stubs"""
+    pass
+
 def _typecheckingstub__d07af40dc753cdda4381651fa3711189e996a0d1ada4554c36c730242ecee721(
     *,
     id: builtins.str,
@@ -15181,6 +15408,7 @@ def _typecheckingstub__929a09b64f3cc2009ffca4b74d148c42dfbbc7531a49bc66cb58443f8
     *,
     configuration: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union[CfnAnomalyDetector.ConfigurationProperty, typing.Dict[builtins.str, typing.Any]]]] = None,
     dimensions: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Sequence[typing.Union[_IResolvable_da3f097b, typing.Union[CfnAnomalyDetector.DimensionProperty, typing.Dict[builtins.str, typing.Any]]]]]] = None,
+    metric_characteristics: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union[CfnAnomalyDetector.MetricCharacteristicsProperty, typing.Dict[builtins.str, typing.Any]]]] = None,
     metric_math_anomaly_detector: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union[CfnAnomalyDetector.MetricMathAnomalyDetectorProperty, typing.Dict[builtins.str, typing.Any]]]] = None,
     metric_name: typing.Optional[builtins.str] = None,
     namespace: typing.Optional[builtins.str] = None,
@@ -15204,6 +15432,7 @@ def _typecheckingstub__5c24d10326e3cd470724ecbde5d50ff23fdf44dc88f809d9a181a5cd8
     alarm_name: typing.Optional[builtins.str] = None,
     insufficient_data_actions: typing.Optional[typing.Sequence[builtins.str]] = None,
     ok_actions: typing.Optional[typing.Sequence[builtins.str]] = None,
+    tags: typing.Optional[typing.Sequence[typing.Union[_CfnTag_f6864754, typing.Dict[builtins.str, typing.Any]]]] = None,
 ) -> None:
     """Type checking stubs"""
     pass
@@ -15280,6 +15509,12 @@ def _typecheckingstub__f061adaf1332cbeeb6cedda66357d6a65aea2023583d23de2ed9b9c19
     """Type checking stubs"""
     pass
 
+def _typecheckingstub__457680b612885bf2c4b88aebcb2510b437690fdf7d6235bf00d83846c1ee3452(
+    value: typing.Optional[typing.List[_CfnTag_f6864754]],
+) -> None:
+    """Type checking stubs"""
+    pass
+
 def _typecheckingstub__f61e2b790710dde8e1d3a57752c99da295b632afeb42e0870113583f0277be2c(
     *,
     alarm_rule: builtins.str,
@@ -15292,6 +15527,7 @@ def _typecheckingstub__f61e2b790710dde8e1d3a57752c99da295b632afeb42e0870113583f0
     alarm_name: typing.Optional[builtins.str] = None,
     insufficient_data_actions: typing.Optional[typing.Sequence[builtins.str]] = None,
     ok_actions: typing.Optional[typing.Sequence[builtins.str]] = None,
+    tags: typing.Optional[typing.Sequence[typing.Union[_CfnTag_f6864754, typing.Dict[builtins.str, typing.Any]]]] = None,
 ) -> None:
     """Type checking stubs"""
     pass