aws-sdk-cloudwatch 1.86.0 → 1.88.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3ed4f3f747a399a51957477f954557e1b52b3cadd4aa40aa706abc4948e578ad
-  data.tar.gz: 5b36773dd5694e320e180a15e15a5abe114bf4777e25d3f38d4b34256a2f1fc0
+  metadata.gz: 503ae029db1cabd915c02f93be1ff57273b3cb65ad17c5e3d1040a6997665df1
+  data.tar.gz: 9b2bd2a6620f559a2fa0cb080eb9c8e3314a486537ce11d745eb777ff9c6d03c
 SHA512:
-  metadata.gz: 7d8718048608bbff61c9d4c261bd8a2a46ce7ade0b758639ee2eb842e12eabbffb872691b00d482b646147e45cf69126bc4f0881c8e402342a7eff7d81b92ff1
-  data.tar.gz: 707dbc8c55983852a88db1d6feffbe5dc1d9b49a594d01375b4debe903056a2dce94f7105e01b4b7f5aeee8a237fcb6e4c4855c55b57bf671b05468ebc513791
+  metadata.gz: 962c4b2c2e9a794dab9a05ce56ef0beca5279a5d31ce8dc1eecf67bcdf0c5746f444e4a23bde2ad27ba3b30a67c8818935bf20a7c53e3214a6c93e0ac5f16352
+  data.tar.gz: de41f911c570f190206b25f61a24c25feb2c9caf5891d7dc10e0cf8c7dfd1460f75acb79b0e0d9f8dc90ed5c0a8c8323e670123356b0de843893a50337904f9d

data/CHANGELOG.md

@@ -1,6 +1,16 @@
 Unreleased Changes
 ------------------
 
+1.88.0 (2024-04-11)
+------------------
+
+* Feature - This release adds support for Metric Characteristics for CloudWatch Anomaly Detection. Anomaly Detector now takes Metric Characteristics object with Periodic Spikes boolean field that tells Anomaly Detection that spikes that repeat at the same time every week are part of the expected pattern.
+
+1.87.0 (2024-04-01)
+------------------
+
+* Feature - This release adds support for CloudWatch Anomaly Detection on cross-account metrics. SingleMetricAnomalyDetector and MetricDataQuery inputs to Anomaly Detection APIs now take an optional AccountId field.
+
 1.86.0 (2024-02-12)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.86.0
+1.88.0

data/lib/aws-sdk-cloudwatch/client.rb

@@ -519,6 +519,7 @@ module Aws::CloudWatch
     #     ],
     #     stat: "AnomalyDetectorMetricStat",
     #     single_metric_anomaly_detector: {
+    #       account_id: "AccountId",
     #       namespace: "Namespace",
     #       metric_name: "MetricName",
     #       dimensions: [
@@ -1133,6 +1134,8 @@ module Aws::CloudWatch
     #   resp.anomaly_detectors[0].configuration.excluded_time_ranges[0].end_time #=> Time
     #   resp.anomaly_detectors[0].configuration.metric_timezone #=> String
     #   resp.anomaly_detectors[0].state_value #=> String, one of "PENDING_TRAINING", "TRAINED_INSUFFICIENT_DATA", "TRAINED"
+    #   resp.anomaly_detectors[0].metric_characteristics.periodic_spikes #=> Boolean
+    #   resp.anomaly_detectors[0].single_metric_anomaly_detector.account_id #=> String
     #   resp.anomaly_detectors[0].single_metric_anomaly_detector.namespace #=> String
     #   resp.anomaly_detectors[0].single_metric_anomaly_detector.metric_name #=> String
     #   resp.anomaly_detectors[0].single_metric_anomaly_detector.dimensions #=> Array
@@ -1656,6 +1659,9 @@ module Aws::CloudWatch
     #   oldest data first and paginates when the `MaxDatapoints` limit is
     #   reached.
     #
+    #   If you omit this parameter, the default of `TimestampDescending` is
+    #   used.
+    #
     # @option params [Integer] :max_datapoints
     #   The maximum number of data points the request should return before
     #   paginating. If you omit this, the default of 100,800 is used.
@@ -2407,6 +2413,11 @@ module Aws::CloudWatch
     # use the model to display a band of expected normal values when the
     # metric is graphed.
     #
+    # 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. You can specify the account ID in the object you
+    # specify in the `SingleMetricAnomalyDetector` parameter.
+    #
     # For more information, see [CloudWatch Anomaly Detection][1].
     #
     #
@@ -2433,6 +2444,12 @@ module Aws::CloudWatch
     #   The configuration can also include the time zone to use for the
     #   metric.
     #
+    # @option params [Types::MetricCharacteristics] :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.
+    #
     # @option params [Types::SingleMetricAnomalyDetector] :single_metric_anomaly_detector
     #   A single metric anomaly detector to be created.
     #
@@ -2447,7 +2464,7 @@ module Aws::CloudWatch
     #
     #   * `Stat`
     #
-    #   * the `MetricMatchAnomalyDetector` parameters of
+    #   * the `MetricMathAnomalyDetector` parameters of
     #     `PutAnomalyDetectorInput`
     #
     #   Instead, specify the single metric anomaly detector attributes as part
@@ -2496,7 +2513,11 @@ module Aws::CloudWatch
     #       ],
     #       metric_timezone: "AnomalyDetectorMetricTimezone",
     #     },
+    #     metric_characteristics: {
+    #       periodic_spikes: false,
+    #     },
     #     single_metric_anomaly_detector: {
+    #       account_id: "AccountId",
     #       namespace: "Namespace",
     #       metric_name: "MetricName",
     #       dimensions: [
@@ -2563,8 +2584,15 @@ module Aws::CloudWatch
     # 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.
+    # Composite alarms can take the following actions:
+    #
+    # * Notify Amazon SNS topics.
+    #
+    # * Invoke Lambda functions.
+    #
+    # * Create OpsItems in Systems Manager Ops Center.
+    #
+    # * Create incidents in Systems Manager Incident Manager.
     #
     # <note markdown="1"> It is possible to create a loop or cycle of composite alarms, where
     # composite alarm A depends on composite alarm B, and composite alarm B
@@ -2611,7 +2639,27 @@ module Aws::CloudWatch
     #   state from any other state. Each action is specified as an Amazon
     #   Resource Name (ARN).
     #
-    #   Valid Values: `arn:aws:sns:region:account-id:sns-topic-name ` \|
+    #   Valid Values: \]
+    #
+    #   **Amazon SNS actions:**
+    #
+    #   `arn:aws:sns:region:account-id:sns-topic-name `
+    #
+    #   **Lambda actions:**
+    #
+    #   * Invoke the latest version of a Lambda function:
+    #     `arn:aws:lambda:region:account-id:function:function-name `
+    #
+    #   * Invoke a specific version of a Lambda function:
+    #     `arn:aws:lambda:region:account-id:function:function-name:version-number
+    #     `
+    #
+    #   * Invoke a function by using an alias Lambda function:
+    #     `arn:aws:lambda:region:account-id:function:function-name:alias-name
+    #     `
+    #
+    #   **Systems Manager actions:**
+    #
     #   `arn:aws:ssm:region:account-id:opsitem:severity `
     #
     # @option params [String] :alarm_description
@@ -2684,23 +2732,68 @@ module Aws::CloudWatch
     #   `INSUFFICIENT_DATA` state from any other state. Each action is
     #   specified as an Amazon Resource Name (ARN).
     #
-    #   Valid Values: `arn:aws:sns:region:account-id:sns-topic-name `
+    #   Valid Values: \]
+    #
+    #   **Amazon SNS actions:**
+    #
+    #   `arn:aws:sns:region:account-id:sns-topic-name `
+    #
+    #   **Lambda actions:**
+    #
+    #   * Invoke the latest version of a Lambda function:
+    #     `arn:aws:lambda:region:account-id:function:function-name `
+    #
+    #   * Invoke a specific version of a Lambda function:
+    #     `arn:aws:lambda:region:account-id:function:function-name:version-number
+    #     `
+    #
+    #   * Invoke a function by using an alias Lambda function:
+    #     `arn:aws:lambda:region:account-id:function:function-name:alias-name
+    #     `
     #
     # @option params [Array<String>] :ok_actions
     #   The actions to execute when this alarm transitions to an `OK` state
     #   from any other state. Each action is specified as an Amazon Resource
     #   Name (ARN).
     #
-    #   Valid Values: `arn:aws:sns:region:account-id:sns-topic-name `
+    #   Valid Values: \]
+    #
+    #   **Amazon SNS actions:**
+    #
+    #   `arn:aws:sns:region:account-id:sns-topic-name `
+    #
+    #   **Lambda actions:**
+    #
+    #   * Invoke the latest version of a Lambda function:
+    #     `arn:aws:lambda:region:account-id:function:function-name `
+    #
+    #   * Invoke a specific version of a Lambda function:
+    #     `arn:aws:lambda:region:account-id:function:function-name:version-number
+    #     `
+    #
+    #   * Invoke a function by using an alias Lambda function:
+    #     `arn:aws:lambda:region:account-id:function:function-name:alias-name
+    #     `
     #
     # @option params [Array<Types::Tag>] :tags
-    #   A list of key-value pairs to associate with the composite alarm. You
-    #   can associate as many as 50 tags with an alarm.
+    #   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
+    #   use them to scope user permissions by granting a user permission to
     #   access or change only resources with certain tag values.
     #
+    #   If you are using this operation to update an existing alarm, any tags
+    #   you specify in this parameter are ignored. To change the tags of an
+    #   existing alarm, use [TagResource][1] or [UntagResource][2].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_TagResource.html
+    #   [2]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_UntagResource.html
+    #
     # @option params [String] :actions_suppressor
     #   Actions will be suppressed if the suppressor alarm is in the `ALARM`
     #   state. `ActionsSuppressor` can be an AlarmName or an Amazon Resource
@@ -3050,11 +3143,23 @@ module Aws::CloudWatch
     #
     #   ^
     #
-    #   **SNS notification action:**
+    #   **Lambda actions:**
+    #
+    #   * Invoke the latest version of a Lambda function:
+    #     `arn:aws:lambda:region:account-id:function:function-name `
+    #
+    #   * Invoke a specific version of a Lambda function:
+    #     `arn:aws:lambda:region:account-id:function:function-name:version-number
+    #     `
     #
-    #   * `arn:aws:sns:region:account-id:sns-topic-name:autoScalingGroupName/group-friendly-name:policyName/policy-friendly-name
+    #   * Invoke a function by using an alias Lambda function:
+    #     `arn:aws:lambda:region:account-id:function:function-name:alias-name
     #     `
     #
+    #   **SNS notification action:**
+    #
+    #   * `arn:aws:sns:region:account-id:sns-topic-name `
+    #
     #   ^
     #
     #   **SSM integration actions:**
@@ -3094,11 +3199,23 @@ module Aws::CloudWatch
     #
     #   ^
     #
-    #   **SNS notification action:**
+    #   **Lambda actions:**
+    #
+    #   * Invoke the latest version of a Lambda function:
+    #     `arn:aws:lambda:region:account-id:function:function-name `
     #
-    #   * `arn:aws:sns:region:account-id:sns-topic-name:autoScalingGroupName/group-friendly-name:policyName/policy-friendly-name
+    #   * Invoke a specific version of a Lambda function:
+    #     `arn:aws:lambda:region:account-id:function:function-name:version-number
     #     `
     #
+    #   * Invoke a function by using an alias Lambda function:
+    #     `arn:aws:lambda:region:account-id:function:function-name:alias-name
+    #     `
+    #
+    #   **SNS notification action:**
+    #
+    #   * `arn:aws:sns:region:account-id:sns-topic-name `
+    #
     #   ^
     #
     #   **SSM integration actions:**
@@ -3138,11 +3255,23 @@ module Aws::CloudWatch
     #
     #   ^
     #
-    #   **SNS notification action:**
+    #   **Lambda actions:**
+    #
+    #   * Invoke the latest version of a Lambda function:
+    #     `arn:aws:lambda:region:account-id:function:function-name `
+    #
+    #   * Invoke a specific version of a Lambda function:
+    #     `arn:aws:lambda:region:account-id:function:function-name:version-number
+    #     `
     #
-    #   * `arn:aws:sns:region:account-id:sns-topic-name:autoScalingGroupName/group-friendly-name:policyName/policy-friendly-name
+    #   * Invoke a function by using an alias Lambda function:
+    #     `arn:aws:lambda:region:account-id:function:function-name:alias-name
     #     `
     #
+    #   **SNS notification action:**
+    #
+    #   * `arn:aws:sns:region:account-id:sns-topic-name `
+    #
     #   ^
     #
     #   **SSM integration actions:**
@@ -3466,10 +3595,9 @@ module Aws::CloudWatch
     # You can publish either individual data points in the `Value` field, or
     # arrays of values and the number of times each value occurred during
     # the period by using the `Values` and `Counts` fields in the
-    # `MetricDatum` structure. Using the `Values` and `Counts` method
-    # enables you to publish up to 150 values per metric with one
-    # `PutMetricData` request, and supports retrieving percentile statistics
-    # on this data.
+    # `MetricData` structure. Using the `Values` and `Counts` method enables
+    # you to publish up to 150 values per metric with one `PutMetricData`
+    # request, and supports retrieving percentile statistics on this data.
     #
     # Each `PutMetricData` request is limited to 1 MB in size for HTTP POST
     # requests. You can send a payload compressed by gzip. Each request is
@@ -3986,7 +4114,7 @@ module Aws::CloudWatch
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-cloudwatch'
-      context[:gem_version] = '1.86.0'
+      context[:gem_version] = '1.88.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

data/lib/aws-sdk-cloudwatch/client_api.rb

@@ -185,6 +185,7 @@ module Aws::CloudWatch
     Metric = Shapes::StructureShape.new(name: 'Metric')
     MetricAlarm = Shapes::StructureShape.new(name: 'MetricAlarm')
     MetricAlarms = Shapes::ListShape.new(name: 'MetricAlarms')
+    MetricCharacteristics = Shapes::StructureShape.new(name: 'MetricCharacteristics')
     MetricData = Shapes::ListShape.new(name: 'MetricData')
     MetricDataQueries = Shapes::ListShape.new(name: 'MetricDataQueries')
     MetricDataQuery = Shapes::StructureShape.new(name: 'MetricDataQuery')
@@ -223,6 +224,7 @@ module Aws::CloudWatch
     OwningAccounts = Shapes::ListShape.new(name: 'OwningAccounts')
     PartialFailure = Shapes::StructureShape.new(name: 'PartialFailure')
     Period = Shapes::IntegerShape.new(name: 'Period')
+    PeriodicSpikes = Shapes::BooleanShape.new(name: 'PeriodicSpikes')
     PutAnomalyDetectorInput = Shapes::StructureShape.new(name: 'PutAnomalyDetectorInput')
     PutAnomalyDetectorOutput = Shapes::StructureShape.new(name: 'PutAnomalyDetectorOutput')
     PutCompositeAlarmInput = Shapes::StructureShape.new(name: 'PutCompositeAlarmInput')
@@ -300,6 +302,7 @@ module Aws::CloudWatch
     AnomalyDetector.add_member(:stat, Shapes::ShapeRef.new(shape: AnomalyDetectorMetricStat, deprecated: true, location_name: "Stat", metadata: {"deprecatedMessage"=>"Use SingleMetricAnomalyDetector.Stat property."}))
     AnomalyDetector.add_member(:configuration, Shapes::ShapeRef.new(shape: AnomalyDetectorConfiguration, location_name: "Configuration"))
     AnomalyDetector.add_member(:state_value, Shapes::ShapeRef.new(shape: AnomalyDetectorStateValue, location_name: "StateValue"))
+    AnomalyDetector.add_member(:metric_characteristics, Shapes::ShapeRef.new(shape: MetricCharacteristics, location_name: "MetricCharacteristics"))
     AnomalyDetector.add_member(:single_metric_anomaly_detector, Shapes::ShapeRef.new(shape: SingleMetricAnomalyDetector, location_name: "SingleMetricAnomalyDetector"))
     AnomalyDetector.add_member(:metric_math_anomaly_detector, Shapes::ShapeRef.new(shape: MetricMathAnomalyDetector, location_name: "MetricMathAnomalyDetector"))
     AnomalyDetector.struct_class = Types::AnomalyDetector
@@ -754,6 +757,9 @@ module Aws::CloudWatch
 
     MetricAlarms.member = Shapes::ShapeRef.new(shape: MetricAlarm)
 
+    MetricCharacteristics.add_member(:periodic_spikes, Shapes::ShapeRef.new(shape: PeriodicSpikes, location_name: "PeriodicSpikes"))
+    MetricCharacteristics.struct_class = Types::MetricCharacteristics
+
     MetricData.member = Shapes::ShapeRef.new(shape: MetricDatum)
 
     MetricDataQueries.member = Shapes::ShapeRef.new(shape: MetricDataQuery)
@@ -852,6 +858,7 @@ module Aws::CloudWatch
     PutAnomalyDetectorInput.add_member(:dimensions, Shapes::ShapeRef.new(shape: Dimensions, deprecated: true, location_name: "Dimensions", metadata: {"deprecatedMessage"=>"Use SingleMetricAnomalyDetector."}))
     PutAnomalyDetectorInput.add_member(:stat, Shapes::ShapeRef.new(shape: AnomalyDetectorMetricStat, deprecated: true, location_name: "Stat", metadata: {"deprecatedMessage"=>"Use SingleMetricAnomalyDetector."}))
     PutAnomalyDetectorInput.add_member(:configuration, Shapes::ShapeRef.new(shape: AnomalyDetectorConfiguration, location_name: "Configuration"))
+    PutAnomalyDetectorInput.add_member(:metric_characteristics, Shapes::ShapeRef.new(shape: MetricCharacteristics, location_name: "MetricCharacteristics"))
     PutAnomalyDetectorInput.add_member(:single_metric_anomaly_detector, Shapes::ShapeRef.new(shape: SingleMetricAnomalyDetector, location_name: "SingleMetricAnomalyDetector"))
     PutAnomalyDetectorInput.add_member(:metric_math_anomaly_detector, Shapes::ShapeRef.new(shape: MetricMathAnomalyDetector, location_name: "MetricMathAnomalyDetector"))
     PutAnomalyDetectorInput.struct_class = Types::PutAnomalyDetectorInput
@@ -953,6 +960,7 @@ module Aws::CloudWatch
     SetAlarmStateInput.add_member(:state_reason_data, Shapes::ShapeRef.new(shape: StateReasonData, location_name: "StateReasonData"))
     SetAlarmStateInput.struct_class = Types::SetAlarmStateInput
 
+    SingleMetricAnomalyDetector.add_member(:account_id, Shapes::ShapeRef.new(shape: AccountId, location_name: "AccountId"))
     SingleMetricAnomalyDetector.add_member(:namespace, Shapes::ShapeRef.new(shape: Namespace, location_name: "Namespace"))
     SingleMetricAnomalyDetector.add_member(:metric_name, Shapes::ShapeRef.new(shape: MetricName, location_name: "MetricName"))
     SingleMetricAnomalyDetector.add_member(:dimensions, Shapes::ShapeRef.new(shape: Dimensions, location_name: "Dimensions"))

data/lib/aws-sdk-cloudwatch/metric.rb

@@ -409,11 +409,23 @@ module Aws::CloudWatch
     #
     #   ^
     #
-    #   **SNS notification action:**
+    #   **Lambda actions:**
+    #
+    #   * Invoke the latest version of a Lambda function:
+    #     `arn:aws:lambda:region:account-id:function:function-name `
+    #
+    #   * Invoke a specific version of a Lambda function:
+    #     `arn:aws:lambda:region:account-id:function:function-name:version-number
+    #     `
     #
-    #   * `arn:aws:sns:region:account-id:sns-topic-name:autoScalingGroupName/group-friendly-name:policyName/policy-friendly-name
+    #   * Invoke a function by using an alias Lambda function:
+    #     `arn:aws:lambda:region:account-id:function:function-name:alias-name
     #     `
     #
+    #   **SNS notification action:**
+    #
+    #   * `arn:aws:sns:region:account-id:sns-topic-name `
+    #
     #   ^
     #
     #   **SSM integration actions:**
@@ -452,11 +464,23 @@ module Aws::CloudWatch
     #
     #   ^
     #
-    #   **SNS notification action:**
+    #   **Lambda actions:**
+    #
+    #   * Invoke the latest version of a Lambda function:
+    #     `arn:aws:lambda:region:account-id:function:function-name `
+    #
+    #   * Invoke a specific version of a Lambda function:
+    #     `arn:aws:lambda:region:account-id:function:function-name:version-number
+    #     `
     #
-    #   * `arn:aws:sns:region:account-id:sns-topic-name:autoScalingGroupName/group-friendly-name:policyName/policy-friendly-name
+    #   * Invoke a function by using an alias Lambda function:
+    #     `arn:aws:lambda:region:account-id:function:function-name:alias-name
     #     `
     #
+    #   **SNS notification action:**
+    #
+    #   * `arn:aws:sns:region:account-id:sns-topic-name `
+    #
     #   ^
     #
     #   **SSM integration actions:**
@@ -495,11 +519,23 @@ module Aws::CloudWatch
     #
     #   ^
     #
-    #   **SNS notification action:**
+    #   **Lambda actions:**
+    #
+    #   * Invoke the latest version of a Lambda function:
+    #     `arn:aws:lambda:region:account-id:function:function-name `
     #
-    #   * `arn:aws:sns:region:account-id:sns-topic-name:autoScalingGroupName/group-friendly-name:policyName/policy-friendly-name
+    #   * Invoke a specific version of a Lambda function:
+    #     `arn:aws:lambda:region:account-id:function:function-name:version-number
     #     `
     #
+    #   * Invoke a function by using an alias Lambda function:
+    #     `arn:aws:lambda:region:account-id:function:function-name:alias-name
+    #     `
+    #
+    #   **SNS notification action:**
+    #
+    #   * `arn:aws:sns:region:account-id:sns-topic-name `
+    #
     #   ^
     #
     #   **SSM integration actions:**

data/lib/aws-sdk-cloudwatch/types.rb

@@ -53,6 +53,10 @@ module Aws::CloudWatch
     # metric, statistic, or metric math expression. You can use the model to
     # display a band of expected, normal values when the metric is graphed.
     #
+    # 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.
+    #
     # @!attribute [rw] namespace
     #   The namespace of the metric associated with the anomaly detection
     #   model.
@@ -77,10 +81,16 @@ module Aws::CloudWatch
     #   @return [Types::AnomalyDetectorConfiguration]
     #
     # @!attribute [rw] state_value
-    #   The current status of the anomaly detector's training. The possible
-    #   values are `TRAINED | PENDING_TRAINING | TRAINED_INSUFFICIENT_DATA`
+    #   The current status of the anomaly detector's training.
     #   @return [String]
     #
+    # @!attribute [rw] metric_characteristics
+    #   This object includes parameters that you can use to provide
+    #   information about your metric to CloudWatch to help it build more
+    #   accurate anomaly detection models. Currently, it includes the
+    #   `PeriodicSpikes` parameter.
+    #   @return [Types::MetricCharacteristics]
+    #
     # @!attribute [rw] single_metric_anomaly_detector
     #   The CloudWatch metric and statistic for this anomaly detector.
     #   @return [Types::SingleMetricAnomalyDetector]
@@ -98,6 +108,7 @@ module Aws::CloudWatch
       :stat,
       :configuration,
       :state_value,
+      :metric_characteristics,
       :single_metric_anomaly_detector,
       :metric_math_anomaly_detector)
       SENSITIVE = []
@@ -1295,6 +1306,9 @@ module Aws::CloudWatch
     #   when the `MaxDatapoints` limit is reached. `TimestampAscending`
     #   returns the oldest data first and paginates when the `MaxDatapoints`
     #   limit is reached.
+    #
+    #   If you omit this parameter, the default of `TimestampDescending` is
+    #   used.
     #   @return [String]
     #
     # @!attribute [rw] max_datapoints
@@ -2575,6 +2589,26 @@ module Aws::CloudWatch
       include Aws::Structure
     end
 
+    # This object includes parameters that you can use to provide
+    # information to CloudWatch to help it build more accurate anomaly
+    # detection models.
+    #
+    # @!attribute [rw] 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.
+    #   @return [Boolean]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/MetricCharacteristics AWS API Documentation
+    #
+    class MetricCharacteristics < Struct.new(
+      :periodic_spikes)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # This structure is used in both `GetMetricData` and `PutMetricAlarm`.
     # The supported use of this structure is different for those two
     # operations.
@@ -3176,6 +3210,13 @@ module Aws::CloudWatch
     #   metric.
     #   @return [Types::AnomalyDetectorConfiguration]
     #
+    # @!attribute [rw] 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.
+    #   @return [Types::MetricCharacteristics]
+    #
     # @!attribute [rw] single_metric_anomaly_detector
     #   A single metric anomaly detector to be created.
     #
@@ -3190,7 +3231,7 @@ module Aws::CloudWatch
     #
     #   * `Stat`
     #
-    #   * the `MetricMatchAnomalyDetector` parameters of
+    #   * the `MetricMathAnomalyDetector` parameters of
     #     `PutAnomalyDetectorInput`
     #
     #   Instead, specify the single metric anomaly detector attributes as
@@ -3226,6 +3267,7 @@ module Aws::CloudWatch
       :dimensions,
       :stat,
       :configuration,
+      :metric_characteristics,
       :single_metric_anomaly_detector,
       :metric_math_anomaly_detector)
       SENSITIVE = []
@@ -3246,7 +3288,27 @@ module Aws::CloudWatch
     #   state from any other state. Each action is specified as an Amazon
     #   Resource Name (ARN).
     #
-    #   Valid Values: `arn:aws:sns:region:account-id:sns-topic-name ` \|
+    #   Valid Values: \]
+    #
+    #   **Amazon SNS actions:**
+    #
+    #   `arn:aws:sns:region:account-id:sns-topic-name `
+    #
+    #   **Lambda actions:**
+    #
+    #   * Invoke the latest version of a Lambda function:
+    #     `arn:aws:lambda:region:account-id:function:function-name `
+    #
+    #   * Invoke a specific version of a Lambda function:
+    #     `arn:aws:lambda:region:account-id:function:function-name:version-number
+    #     `
+    #
+    #   * Invoke a function by using an alias Lambda function:
+    #     `arn:aws:lambda:region:account-id:function:function-name:alias-name
+    #     `
+    #
+    #   **Systems Manager actions:**
+    #
     #   `arn:aws:ssm:region:account-id:opsitem:severity `
     #   @return [Array<String>]
     #
@@ -3323,7 +3385,24 @@ module Aws::CloudWatch
     #   `INSUFFICIENT_DATA` state from any other state. Each action is
     #   specified as an Amazon Resource Name (ARN).
     #
-    #   Valid Values: `arn:aws:sns:region:account-id:sns-topic-name `
+    #   Valid Values: \]
+    #
+    #   **Amazon SNS actions:**
+    #
+    #   `arn:aws:sns:region:account-id:sns-topic-name `
+    #
+    #   **Lambda actions:**
+    #
+    #   * Invoke the latest version of a Lambda function:
+    #     `arn:aws:lambda:region:account-id:function:function-name `
+    #
+    #   * Invoke a specific version of a Lambda function:
+    #     `arn:aws:lambda:region:account-id:function:function-name:version-number
+    #     `
+    #
+    #   * Invoke a function by using an alias Lambda function:
+    #     `arn:aws:lambda:region:account-id:function:function-name:alias-name
+    #     `
     #   @return [Array<String>]
     #
     # @!attribute [rw] ok_actions
@@ -3331,17 +3410,45 @@ module Aws::CloudWatch
     #   from any other state. Each action is specified as an Amazon Resource
     #   Name (ARN).
     #
-    #   Valid Values: `arn:aws:sns:region:account-id:sns-topic-name `
+    #   Valid Values: \]
+    #
+    #   **Amazon SNS actions:**
+    #
+    #   `arn:aws:sns:region:account-id:sns-topic-name `
+    #
+    #   **Lambda actions:**
+    #
+    #   * Invoke the latest version of a Lambda function:
+    #     `arn:aws:lambda:region:account-id:function:function-name `
+    #
+    #   * Invoke a specific version of a Lambda function:
+    #     `arn:aws:lambda:region:account-id:function:function-name:version-number
+    #     `
+    #
+    #   * Invoke a function by using an alias Lambda function:
+    #     `arn:aws:lambda:region:account-id:function:function-name:alias-name
+    #     `
     #   @return [Array<String>]
     #
     # @!attribute [rw] tags
-    #   A list of key-value pairs to associate with the composite alarm. You
-    #   can associate as many as 50 tags with an alarm.
+    #   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
+    #   also use them to scope user permissions by granting a user
     #   permission to access or change only resources with certain tag
     #   values.
+    #
+    #   If you are using this operation to update an existing alarm, any
+    #   tags you specify in this parameter are ignored. To change the tags
+    #   of an existing alarm, use [TagResource][1] or [UntagResource][2].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_TagResource.html
+    #   [2]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_UntagResource.html
     #   @return [Array<Types::Tag>]
     #
     # @!attribute [rw] actions_suppressor
@@ -3559,11 +3666,23 @@ module Aws::CloudWatch
     #
     #   ^
     #
-    #   **SNS notification action:**
+    #   **Lambda actions:**
     #
-    #   * `arn:aws:sns:region:account-id:sns-topic-name:autoScalingGroupName/group-friendly-name:policyName/policy-friendly-name
+    #   * Invoke the latest version of a Lambda function:
+    #     `arn:aws:lambda:region:account-id:function:function-name `
+    #
+    #   * Invoke a specific version of a Lambda function:
+    #     `arn:aws:lambda:region:account-id:function:function-name:version-number
+    #     `
+    #
+    #   * Invoke a function by using an alias Lambda function:
+    #     `arn:aws:lambda:region:account-id:function:function-name:alias-name
     #     `
     #
+    #   **SNS notification action:**
+    #
+    #   * `arn:aws:sns:region:account-id:sns-topic-name `
+    #
     #   ^
     #
     #   **SSM integration actions:**
@@ -3605,11 +3724,23 @@ module Aws::CloudWatch
     #
     #   ^
     #
-    #   **SNS notification action:**
+    #   **Lambda actions:**
+    #
+    #   * Invoke the latest version of a Lambda function:
+    #     `arn:aws:lambda:region:account-id:function:function-name `
+    #
+    #   * Invoke a specific version of a Lambda function:
+    #     `arn:aws:lambda:region:account-id:function:function-name:version-number
+    #     `
     #
-    #   * `arn:aws:sns:region:account-id:sns-topic-name:autoScalingGroupName/group-friendly-name:policyName/policy-friendly-name
+    #   * Invoke a function by using an alias Lambda function:
+    #     `arn:aws:lambda:region:account-id:function:function-name:alias-name
     #     `
     #
+    #   **SNS notification action:**
+    #
+    #   * `arn:aws:sns:region:account-id:sns-topic-name `
+    #
     #   ^
     #
     #   **SSM integration actions:**
@@ -3651,11 +3782,23 @@ module Aws::CloudWatch
     #
     #   ^
     #
-    #   **SNS notification action:**
+    #   **Lambda actions:**
+    #
+    #   * Invoke the latest version of a Lambda function:
+    #     `arn:aws:lambda:region:account-id:function:function-name `
     #
-    #   * `arn:aws:sns:region:account-id:sns-topic-name:autoScalingGroupName/group-friendly-name:policyName/policy-friendly-name
+    #   * Invoke a specific version of a Lambda function:
+    #     `arn:aws:lambda:region:account-id:function:function-name:version-number
     #     `
     #
+    #   * Invoke a function by using an alias Lambda function:
+    #     `arn:aws:lambda:region:account-id:function:function-name:alias-name
+    #     `
+    #
+    #   **SNS notification action:**
+    #
+    #   * `arn:aws:sns:region:account-id:sns-topic-name `
+    #
     #   ^
     #
     #   **SSM integration actions:**
@@ -4189,7 +4332,16 @@ module Aws::CloudWatch
     end
 
     # Designates the CloudWatch metric and statistic that provides the time
-    # series the anomaly detector uses as input.
+    # series the anomaly detector uses as input. 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.
+    #
+    # @!attribute [rw] 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.
+    #   @return [String]
     #
     # @!attribute [rw] namespace
     #   The namespace of the metric to create the anomaly detection model
@@ -4211,6 +4363,7 @@ module Aws::CloudWatch
     # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/SingleMetricAnomalyDetector AWS API Documentation
     #
     class SingleMetricAnomalyDetector < Struct.new(
+      :account_id,
       :namespace,
       :metric_name,
       :dimensions,

data/lib/aws-sdk-cloudwatch.rb

@@ -56,6 +56,6 @@ require_relative 'aws-sdk-cloudwatch/customizations'
 # @!group service
 module Aws::CloudWatch
 
-  GEM_VERSION = '1.86.0'
+  GEM_VERSION = '1.88.0'
 
 end

data/sig/client.rbs

@@ -93,6 +93,7 @@ module Aws
                                      ],
                                      ?stat: ::String,
                                      ?single_metric_anomaly_detector: {
+                                       account_id: ::String?,
                                        namespace: ::String?,
                                        metric_name: ::String?,
                                        dimensions: Array[
@@ -511,7 +512,11 @@ module Aws
                                     ]?,
                                     metric_timezone: ::String?
                                   },
+                                  ?metric_characteristics: {
+                                    periodic_spikes: bool?
+                                  },
                                   ?single_metric_anomaly_detector: {
+                                    account_id: ::String?,
                                     namespace: ::String?,
                                     metric_name: ::String?,
                                     dimensions: Array[

data/sig/types.rbs

@@ -25,6 +25,7 @@ module Aws::CloudWatch
       attr_accessor stat: ::String
       attr_accessor configuration: Types::AnomalyDetectorConfiguration
       attr_accessor state_value: ("PENDING_TRAINING" | "TRAINED_INSUFFICIENT_DATA" | "TRAINED")
+      attr_accessor metric_characteristics: Types::MetricCharacteristics
       attr_accessor single_metric_anomaly_detector: Types::SingleMetricAnomalyDetector
       attr_accessor metric_math_anomaly_detector: Types::MetricMathAnomalyDetector
       SENSITIVE: []
@@ -572,6 +573,11 @@ module Aws::CloudWatch
       SENSITIVE: []
     end
 
+    class MetricCharacteristics
+      attr_accessor periodic_spikes: bool
+      SENSITIVE: []
+    end
+
     class MetricDataQuery
       attr_accessor id: ::String
       attr_accessor metric_stat: Types::MetricStat
@@ -667,6 +673,7 @@ module Aws::CloudWatch
       attr_accessor dimensions: ::Array[Types::Dimension]
       attr_accessor stat: ::String
       attr_accessor configuration: Types::AnomalyDetectorConfiguration
+      attr_accessor metric_characteristics: Types::MetricCharacteristics
       attr_accessor single_metric_anomaly_detector: Types::SingleMetricAnomalyDetector
       attr_accessor metric_math_anomaly_detector: Types::MetricMathAnomalyDetector
       SENSITIVE: []
@@ -798,6 +805,7 @@ module Aws::CloudWatch
     end
 
     class SingleMetricAnomalyDetector
+      attr_accessor account_id: ::String
       attr_accessor namespace: ::String
       attr_accessor metric_name: ::String
       attr_accessor dimensions: ::Array[Types::Dimension]

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-cloudwatch
 version: !ruby/object:Gem::Version
-  version: 1.86.0
+  version: 1.88.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-02-12 00:00:00.000000000 Z
+date: 2024-04-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core