aws-sdk-cloudwatch 1.25.0 → 1.26.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: a1ee506063533874a56e478ffd19bbddf8f87376
-  data.tar.gz: f2fae9e67b8cf4337e1d88ac8d5c40e8ae840f66
+  metadata.gz: f10b31ef02006bb4f4ec30b42ae3953aaf17f834
+  data.tar.gz: 329c243b9220db03c7af99168917bcc1d4ade397
 SHA512:
-  metadata.gz: 2c5d65bcb86dbed724da782c2ee5488c52eeefc11021472d8e8e41c09b4db3170db62cd73605d53e07cd938b017621ea41bdce59681a402ad018e49ce4bcb9e3
-  data.tar.gz: 6c6ec833d9544fc281951317548cf1f5997a005906b90828c83a955992f9b23d150e20b57811b0d88036fede200389158ea5038731e99f15191c6532846948fa
+  metadata.gz: ce533992a51ddb63d2320cb8b7e19cb5e737baafff504c8f1acf66b9dcfe5c0c93562fe9900009283db74609c499b1c623fb560acc86246cb2e61fbf0df6964c
+  data.tar.gz: cab12dcd9fdae0cf8b377c63df50635e2bd6d1adb73d58bc2485a8361893d28a42126e8627d02c4ebae74166c0214e782bfa78dd8a1811d124f39d08e7ac1f26

data/lib/aws-sdk-cloudwatch.rb

@@ -45,6 +45,6 @@ require_relative 'aws-sdk-cloudwatch/customizations'
 # @service
 module Aws::CloudWatch
 
-  GEM_VERSION = '1.25.0'
+  GEM_VERSION = '1.26.0'
 
 end

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

@@ -104,7 +104,8 @@ module Aws::CloudWatch
       data[:state_updated_timestamp]
     end
 
-    # The name of the metric associated with the alarm.
+    # The name of the metric associated with the alarm, if this is an alarm
+    # based on a single metric.
     # @return [String]
     def metric_name
       data[:metric_name]
@@ -192,12 +193,23 @@ module Aws::CloudWatch
       data[:evaluate_low_sample_count_percentile]
     end
 
-    
+    # An array of MetricDataQuery structures, used in an alarm based on a
+    # metric math expression. Each structure either retrieves a metric or
+    # performs a math expression. One item in the Metrics array is the math
+    # expression that the alarm watches. This expression by designated by
+    # having `ReturnValue` set to true.
     # @return [Array<Types::MetricDataQuery>]
     def metrics
       data[:metrics]
     end
 
+    # 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.
+    # @return [String]
+    def threshold_metric_id
+      data[:threshold_metric_id]
+    end
+
     # @!endgroup
 
     # @return [Client]

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

@@ -277,6 +277,46 @@ module Aws::CloudWatch
       req.send_request(options)
     end
 
+    # Deletes the specified anomaly detection model from your account.
+    #
+    # @option params [required, String] :namespace
+    #   The namespace associated with the anomaly detection model to delete.
+    #
+    # @option params [required, String] :metric_name
+    #   The metric name associated with the anomaly detection model to delete.
+    #
+    # @option params [Array<Types::Dimension>] :dimensions
+    #   The metric dimensions associated with the anomaly detection model to
+    #   delete.
+    #
+    # @option params [required, String] :stat
+    #   The statistic associated with the anomaly detection model to delete.
+    #
+    # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.delete_anomaly_detector({
+    #     namespace: "Namespace", # required
+    #     metric_name: "MetricName", # required
+    #     dimensions: [
+    #       {
+    #         name: "DimensionName", # required
+    #         value: "DimensionValue", # required
+    #       },
+    #     ],
+    #     stat: "Stat", # required
+    #   })
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/DeleteAnomalyDetector AWS API Documentation
+    #
+    # @overload delete_anomaly_detector(params = {})
+    # @param [Hash] params ({})
+    def delete_anomaly_detector(params = {}, options = {})
+      req = build_request(:delete_anomaly_detector, params)
+      req.send_request(options)
+    end
+
     # Deletes all dashboards that you specify. You may specify up to 100
     # dashboards to delete. If there is an error during this call, no
     # dashboards are deleted.
@@ -432,7 +472,7 @@ module Aws::CloudWatch
     #   resp.metric_alarms[0].evaluation_periods #=> Integer
     #   resp.metric_alarms[0].datapoints_to_alarm #=> Integer
     #   resp.metric_alarms[0].threshold #=> Float
-    #   resp.metric_alarms[0].comparison_operator #=> String, one of "GreaterThanOrEqualToThreshold", "GreaterThanThreshold", "LessThanThreshold", "LessThanOrEqualToThreshold"
+    #   resp.metric_alarms[0].comparison_operator #=> String, one of "GreaterThanOrEqualToThreshold", "GreaterThanThreshold", "LessThanThreshold", "LessThanOrEqualToThreshold", "LessThanLowerOrGreaterThanUpperThreshold", "LessThanLowerThreshold", "GreaterThanUpperThreshold"
     #   resp.metric_alarms[0].treat_missing_data #=> String
     #   resp.metric_alarms[0].evaluate_low_sample_count_percentile #=> String
     #   resp.metric_alarms[0].metrics #=> Array
@@ -448,6 +488,7 @@ module Aws::CloudWatch
     #   resp.metric_alarms[0].metrics[0].expression #=> String
     #   resp.metric_alarms[0].metrics[0].label #=> String
     #   resp.metric_alarms[0].metrics[0].return_data #=> Boolean
+    #   resp.metric_alarms[0].threshold_metric_id #=> String
     #   resp.next_token #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/DescribeAlarms AWS API Documentation
@@ -538,7 +579,7 @@ module Aws::CloudWatch
     #   resp.metric_alarms[0].evaluation_periods #=> Integer
     #   resp.metric_alarms[0].datapoints_to_alarm #=> Integer
     #   resp.metric_alarms[0].threshold #=> Float
-    #   resp.metric_alarms[0].comparison_operator #=> String, one of "GreaterThanOrEqualToThreshold", "GreaterThanThreshold", "LessThanThreshold", "LessThanOrEqualToThreshold"
+    #   resp.metric_alarms[0].comparison_operator #=> String, one of "GreaterThanOrEqualToThreshold", "GreaterThanThreshold", "LessThanThreshold", "LessThanOrEqualToThreshold", "LessThanLowerOrGreaterThanUpperThreshold", "LessThanLowerThreshold", "GreaterThanUpperThreshold"
     #   resp.metric_alarms[0].treat_missing_data #=> String
     #   resp.metric_alarms[0].evaluate_low_sample_count_percentile #=> String
     #   resp.metric_alarms[0].metrics #=> Array
@@ -554,6 +595,7 @@ module Aws::CloudWatch
     #   resp.metric_alarms[0].metrics[0].expression #=> String
     #   resp.metric_alarms[0].metrics[0].label #=> String
     #   resp.metric_alarms[0].metrics[0].return_data #=> Boolean
+    #   resp.metric_alarms[0].threshold_metric_id #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/DescribeAlarmsForMetric AWS API Documentation
     #
@@ -564,6 +606,82 @@ module Aws::CloudWatch
       req.send_request(options)
     end
 
+    # Lists the anomaly detection models that you have created in your
+    # account. You can list all models in your account or filter the results
+    # to only the models that are related to a certain namespace, metric
+    # name, or metric dimension.
+    #
+    # @option params [String] :next_token
+    #   Use the token returned by the previous operation to request the next
+    #   page of results.
+    #
+    # @option params [Integer] :max_results
+    #   The maximum number of results to return in one operation. The maximum
+    #   value you can specify is 10.
+    #
+    #   To retrieve the remaining results, make another call with the returned
+    #   `NextToken` value.
+    #
+    # @option params [String] :namespace
+    #   Limits the results to only the anomaly detection models that are
+    #   associated with the specified namespace.
+    #
+    # @option params [String] :metric_name
+    #   Limits the results to only the anomaly detection models that are
+    #   associated with the specified metric name. If there are multiple
+    #   metrics with this name in different namespaces that have anomaly
+    #   detection models, they're all returned.
+    #
+    # @option params [Array<Types::Dimension>] :dimensions
+    #   Limits the results to only the anomaly detection models that are
+    #   associated with the specified metric dimensions. If there are multiple
+    #   metrics that have these dimensions and have anomaly detection models
+    #   associated, they're all returned.
+    #
+    # @return [Types::DescribeAnomalyDetectorsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::DescribeAnomalyDetectorsOutput#anomaly_detectors #anomaly_detectors} => Array&lt;Types::AnomalyDetector&gt;
+    #   * {Types::DescribeAnomalyDetectorsOutput#next_token #next_token} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.describe_anomaly_detectors({
+    #     next_token: "NextToken",
+    #     max_results: 1,
+    #     namespace: "Namespace",
+    #     metric_name: "MetricName",
+    #     dimensions: [
+    #       {
+    #         name: "DimensionName", # required
+    #         value: "DimensionValue", # required
+    #       },
+    #     ],
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.anomaly_detectors #=> Array
+    #   resp.anomaly_detectors[0].namespace #=> String
+    #   resp.anomaly_detectors[0].metric_name #=> String
+    #   resp.anomaly_detectors[0].dimensions #=> Array
+    #   resp.anomaly_detectors[0].dimensions[0].name #=> String
+    #   resp.anomaly_detectors[0].dimensions[0].value #=> String
+    #   resp.anomaly_detectors[0].stat #=> String
+    #   resp.anomaly_detectors[0].configuration.excluded_time_ranges #=> Array
+    #   resp.anomaly_detectors[0].configuration.excluded_time_ranges[0].start_time #=> Time
+    #   resp.anomaly_detectors[0].configuration.excluded_time_ranges[0].end_time #=> Time
+    #   resp.anomaly_detectors[0].configuration.metric_timezone #=> String
+    #   resp.next_token #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/DescribeAnomalyDetectors AWS API Documentation
+    #
+    # @overload describe_anomaly_detectors(params = {})
+    # @param [Hash] params ({})
+    def describe_anomaly_detectors(params = {}, options = {})
+      req = build_request(:describe_anomaly_detectors, params)
+      req.send_request(options)
+    end
+
     # Disables the actions for the specified alarms. When an alarm's
     # actions are disabled, the alarm actions do not execute when the alarm
     # state changes.
@@ -1241,12 +1359,77 @@ module Aws::CloudWatch
       req.send_request(options)
     end
 
+    # Creates an anomaly detection model for a CloudWatch metric. You can
+    # use the model to display a band of expected normal values when the
+    # metric is graphed.
+    #
+    # For more information, see [CloudWatch Anomaly Detection][1].
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Anomaly_Detection.html
+    #
+    # @option params [required, String] :namespace
+    #   The namespace of the metric to create the anomaly detection model for.
+    #
+    # @option params [required, String] :metric_name
+    #   The name of the metric to create the anomaly detection model for.
+    #
+    # @option params [Array<Types::Dimension>] :dimensions
+    #   The metric dimensions to create the anomaly detection model for.
+    #
+    # @option params [required, String] :stat
+    #   The statistic to use for the metric and the anomaly detection model.
+    #
+    # @option params [Types::AnomalyDetectorConfiguration] :configuration
+    #   The configuration specifies details about how the anomaly detection
+    #   model is to be trained, including time ranges to exclude when training
+    #   and updating the model. You can specify as many as 10 time ranges.
+    #
+    #   The configuration can also include the time zone to use for the
+    #   metric.
+    #
+    #   You can in
+    #
+    # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.put_anomaly_detector({
+    #     namespace: "Namespace", # required
+    #     metric_name: "MetricName", # required
+    #     dimensions: [
+    #       {
+    #         name: "DimensionName", # required
+    #         value: "DimensionValue", # required
+    #       },
+    #     ],
+    #     stat: "Stat", # required
+    #     configuration: {
+    #       excluded_time_ranges: [
+    #         {
+    #           start_time: Time.now, # required
+    #           end_time: Time.now, # required
+    #         },
+    #       ],
+    #       metric_timezone: "AnomalyDetectorMetricTimezone",
+    #     },
+    #   })
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/PutAnomalyDetector AWS API Documentation
+    #
+    # @overload put_anomaly_detector(params = {})
+    # @param [Hash] params ({})
+    def put_anomaly_detector(params = {}, options = {})
+      req = build_request(:put_anomaly_detector, params)
+      req.send_request(options)
+    end
+
     # Creates a dashboard if it does not already exist, or updates an
     # existing dashboard. If you update a dashboard, the entire contents are
     # replaced with what you specify here.
     #
-    # There is no limit to the number of dashboards in your account. All
-    # dashboards in your account are global, not region-specific.
+    # All dashboards in your account are global, not region-specific.
     #
     # A simple way to create a dashboard using `PutDashboard` is to copy an
     # existing dashboard. To copy an existing dashboard using the console,
@@ -1305,7 +1488,10 @@ module Aws::CloudWatch
     end
 
     # Creates or updates an alarm and associates it with the specified
-    # metric or metric math expression.
+    # metric, metric math expression, or anomaly detection model.
+    #
+    # Alarms based on anomaly detection models cannot have Auto Scaling
+    # actions.
     #
     # When this operation creates an alarm, the alarm state is immediately
     # set to `INSUFFICIENT_DATA`. The alarm is then evaluated and its state
@@ -1508,7 +1694,7 @@ module Aws::CloudWatch
     #
     #   [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/AlarmThatSendsEmail.html#alarm-evaluation
     #
-    # @option params [required, Float] :threshold
+    # @option params [Float] :threshold
     #   The value against which the specified statistic is compared.
     #
     # @option params [required, String] :comparison_operator
@@ -1516,6 +1702,10 @@ module Aws::CloudWatch
     #   and threshold. The specified statistic value is used as the first
     #   operand.
     #
+    #   The values `LessThanLowerOrGreaterThanUpperThreshold`,
+    #   `LessThanLowerThreshold`, and `GreaterThanUpperThreshold` are used
+    #   only for alarms based on anomaly detection models.
+    #
     # @option params [String] :treat_missing_data
     #   Sets how this alarm is to handle missing data points. If
     #   `TreatMissingData` is omitted, the default behavior of `missing` is
@@ -1568,6 +1758,16 @@ module Aws::CloudWatch
     #   use them to scope user permissions, by granting a user permission to
     #   access or change only resources with certain tag values.
     #
+    # @option params [String] :threshold_metric_id
+    #   If this is an alarm based on an anomaly detection model, make this
+    #   value match the ID of the `ANOMALY_DETECTION_BAND` function.
+    #
+    #   For an example of how to use this parameter, see the **Anomaly
+    #   Detection Model Alarm** example on this page.
+    #
+    #   If your alarm uses this parameter, it cannot have Auto Scaling
+    #   actions.
+    #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
     # @example Request syntax with placeholder values
@@ -1593,8 +1793,8 @@ module Aws::CloudWatch
     #     unit: "Seconds", # accepts Seconds, Microseconds, Milliseconds, Bytes, Kilobytes, Megabytes, Gigabytes, Terabytes, Bits, Kilobits, Megabits, Gigabits, Terabits, Percent, Count, Bytes/Second, Kilobytes/Second, Megabytes/Second, Gigabytes/Second, Terabytes/Second, Bits/Second, Kilobits/Second, Megabits/Second, Gigabits/Second, Terabits/Second, Count/Second, None
     #     evaluation_periods: 1, # required
     #     datapoints_to_alarm: 1,
-    #     threshold: 1.0, # required
-    #     comparison_operator: "GreaterThanOrEqualToThreshold", # required, accepts GreaterThanOrEqualToThreshold, GreaterThanThreshold, LessThanThreshold, LessThanOrEqualToThreshold
+    #     threshold: 1.0,
+    #     comparison_operator: "GreaterThanOrEqualToThreshold", # required, accepts GreaterThanOrEqualToThreshold, GreaterThanThreshold, LessThanThreshold, LessThanOrEqualToThreshold, LessThanLowerOrGreaterThanUpperThreshold, LessThanLowerThreshold, GreaterThanUpperThreshold
     #     treat_missing_data: "TreatMissingData",
     #     evaluate_low_sample_count_percentile: "EvaluateLowSampleCountPercentile",
     #     metrics: [
@@ -1626,6 +1826,7 @@ module Aws::CloudWatch
     #         value: "TagValue", # required
     #       },
     #     ],
+    #     threshold_metric_id: "MetricId",
     #   })
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/PutMetricAlarm AWS API Documentation
@@ -1879,7 +2080,7 @@ module Aws::CloudWatch
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-cloudwatch'
-      context[:gem_version] = '1.25.0'
+      context[:gem_version] = '1.26.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -21,6 +21,11 @@ module Aws::CloudWatch
     AlarmNamePrefix = Shapes::StringShape.new(name: 'AlarmNamePrefix')
     AlarmNames = Shapes::ListShape.new(name: 'AlarmNames')
     AmazonResourceName = Shapes::StringShape.new(name: 'AmazonResourceName')
+    AnomalyDetector = Shapes::StructureShape.new(name: 'AnomalyDetector')
+    AnomalyDetectorConfiguration = Shapes::StructureShape.new(name: 'AnomalyDetectorConfiguration')
+    AnomalyDetectorExcludedTimeRanges = Shapes::ListShape.new(name: 'AnomalyDetectorExcludedTimeRanges')
+    AnomalyDetectorMetricTimezone = Shapes::StringShape.new(name: 'AnomalyDetectorMetricTimezone')
+    AnomalyDetectors = Shapes::ListShape.new(name: 'AnomalyDetectors')
     AwsQueryErrorMessage = Shapes::StringShape.new(name: 'AwsQueryErrorMessage')
     ComparisonOperator = Shapes::StringShape.new(name: 'ComparisonOperator')
     ConcurrentModificationException = Shapes::StructureShape.new(name: 'ConcurrentModificationException')
@@ -45,6 +50,8 @@ module Aws::CloudWatch
     Datapoints = Shapes::ListShape.new(name: 'Datapoints')
     DatapointsToAlarm = Shapes::IntegerShape.new(name: 'DatapointsToAlarm')
     DeleteAlarmsInput = Shapes::StructureShape.new(name: 'DeleteAlarmsInput')
+    DeleteAnomalyDetectorInput = Shapes::StructureShape.new(name: 'DeleteAnomalyDetectorInput')
+    DeleteAnomalyDetectorOutput = Shapes::StructureShape.new(name: 'DeleteAnomalyDetectorOutput')
     DeleteDashboardsInput = Shapes::StructureShape.new(name: 'DeleteDashboardsInput')
     DeleteDashboardsOutput = Shapes::StructureShape.new(name: 'DeleteDashboardsOutput')
     DescribeAlarmHistoryInput = Shapes::StructureShape.new(name: 'DescribeAlarmHistoryInput')
@@ -53,6 +60,8 @@ module Aws::CloudWatch
     DescribeAlarmsForMetricOutput = Shapes::StructureShape.new(name: 'DescribeAlarmsForMetricOutput')
     DescribeAlarmsInput = Shapes::StructureShape.new(name: 'DescribeAlarmsInput')
     DescribeAlarmsOutput = Shapes::StructureShape.new(name: 'DescribeAlarmsOutput')
+    DescribeAnomalyDetectorsInput = Shapes::StructureShape.new(name: 'DescribeAnomalyDetectorsInput')
+    DescribeAnomalyDetectorsOutput = Shapes::StructureShape.new(name: 'DescribeAnomalyDetectorsOutput')
     Dimension = Shapes::StructureShape.new(name: 'Dimension')
     DimensionFilter = Shapes::StructureShape.new(name: 'DimensionFilter')
     DimensionFilters = Shapes::ListShape.new(name: 'DimensionFilters')
@@ -85,6 +94,7 @@ module Aws::CloudWatch
     InvalidParameterCombinationException = Shapes::StructureShape.new(name: 'InvalidParameterCombinationException')
     InvalidParameterValueException = Shapes::StructureShape.new(name: 'InvalidParameterValueException')
     LastModified = Shapes::TimestampShape.new(name: 'LastModified')
+    LimitExceededException = Shapes::StructureShape.new(name: 'LimitExceededException')
     LimitExceededFault = Shapes::StructureShape.new(name: 'LimitExceededFault')
     ListDashboardsInput = Shapes::StructureShape.new(name: 'ListDashboardsInput')
     ListDashboardsOutput = Shapes::StructureShape.new(name: 'ListDashboardsOutput')
@@ -93,6 +103,7 @@ module Aws::CloudWatch
     ListTagsForResourceInput = Shapes::StructureShape.new(name: 'ListTagsForResourceInput')
     ListTagsForResourceOutput = Shapes::StructureShape.new(name: 'ListTagsForResourceOutput')
     MaxRecords = Shapes::IntegerShape.new(name: 'MaxRecords')
+    MaxReturnedResultsCount = Shapes::IntegerShape.new(name: 'MaxReturnedResultsCount')
     Message = Shapes::StringShape.new(name: 'Message')
     MessageData = Shapes::StructureShape.new(name: 'MessageData')
     MessageDataCode = Shapes::StringShape.new(name: 'MessageDataCode')
@@ -120,10 +131,13 @@ module Aws::CloudWatch
     NextToken = Shapes::StringShape.new(name: 'NextToken')
     OutputFormat = Shapes::StringShape.new(name: 'OutputFormat')
     Period = Shapes::IntegerShape.new(name: 'Period')
+    PutAnomalyDetectorInput = Shapes::StructureShape.new(name: 'PutAnomalyDetectorInput')
+    PutAnomalyDetectorOutput = Shapes::StructureShape.new(name: 'PutAnomalyDetectorOutput')
     PutDashboardInput = Shapes::StructureShape.new(name: 'PutDashboardInput')
     PutDashboardOutput = Shapes::StructureShape.new(name: 'PutDashboardOutput')
     PutMetricAlarmInput = Shapes::StructureShape.new(name: 'PutMetricAlarmInput')
     PutMetricDataInput = Shapes::StructureShape.new(name: 'PutMetricDataInput')
+    Range = Shapes::StructureShape.new(name: 'Range')
     ResourceId = Shapes::StringShape.new(name: 'ResourceId')
     ResourceList = Shapes::ListShape.new(name: 'ResourceList')
     ResourceName = Shapes::StringShape.new(name: 'ResourceName')
@@ -170,6 +184,21 @@ module Aws::CloudWatch
 
     AlarmNames.member = Shapes::ShapeRef.new(shape: AlarmName)
 
+    AnomalyDetector.add_member(:namespace, Shapes::ShapeRef.new(shape: Namespace, location_name: "Namespace"))
+    AnomalyDetector.add_member(:metric_name, Shapes::ShapeRef.new(shape: MetricName, location_name: "MetricName"))
+    AnomalyDetector.add_member(:dimensions, Shapes::ShapeRef.new(shape: Dimensions, location_name: "Dimensions"))
+    AnomalyDetector.add_member(:stat, Shapes::ShapeRef.new(shape: Stat, location_name: "Stat"))
+    AnomalyDetector.add_member(:configuration, Shapes::ShapeRef.new(shape: AnomalyDetectorConfiguration, location_name: "Configuration"))
+    AnomalyDetector.struct_class = Types::AnomalyDetector
+
+    AnomalyDetectorConfiguration.add_member(:excluded_time_ranges, Shapes::ShapeRef.new(shape: AnomalyDetectorExcludedTimeRanges, location_name: "ExcludedTimeRanges"))
+    AnomalyDetectorConfiguration.add_member(:metric_timezone, Shapes::ShapeRef.new(shape: AnomalyDetectorMetricTimezone, location_name: "MetricTimezone"))
+    AnomalyDetectorConfiguration.struct_class = Types::AnomalyDetectorConfiguration
+
+    AnomalyDetectorExcludedTimeRanges.member = Shapes::ShapeRef.new(shape: Range)
+
+    AnomalyDetectors.member = Shapes::ShapeRef.new(shape: AnomalyDetector)
+
     Counts.member = Shapes::ShapeRef.new(shape: DatapointValue)
 
     DashboardEntries.member = Shapes::ShapeRef.new(shape: DashboardEntry)
@@ -215,6 +244,14 @@ module Aws::CloudWatch
     DeleteAlarmsInput.add_member(:alarm_names, Shapes::ShapeRef.new(shape: AlarmNames, required: true, location_name: "AlarmNames"))
     DeleteAlarmsInput.struct_class = Types::DeleteAlarmsInput
 
+    DeleteAnomalyDetectorInput.add_member(:namespace, Shapes::ShapeRef.new(shape: Namespace, required: true, location_name: "Namespace"))
+    DeleteAnomalyDetectorInput.add_member(:metric_name, Shapes::ShapeRef.new(shape: MetricName, required: true, location_name: "MetricName"))
+    DeleteAnomalyDetectorInput.add_member(:dimensions, Shapes::ShapeRef.new(shape: Dimensions, location_name: "Dimensions"))
+    DeleteAnomalyDetectorInput.add_member(:stat, Shapes::ShapeRef.new(shape: Stat, required: true, location_name: "Stat"))
+    DeleteAnomalyDetectorInput.struct_class = Types::DeleteAnomalyDetectorInput
+
+    DeleteAnomalyDetectorOutput.struct_class = Types::DeleteAnomalyDetectorOutput
+
     DeleteDashboardsInput.add_member(:dashboard_names, Shapes::ShapeRef.new(shape: DashboardNames, required: true, location_name: "DashboardNames"))
     DeleteDashboardsInput.struct_class = Types::DeleteDashboardsInput
 
@@ -256,6 +293,17 @@ module Aws::CloudWatch
     DescribeAlarmsOutput.add_member(:next_token, Shapes::ShapeRef.new(shape: NextToken, location_name: "NextToken"))
     DescribeAlarmsOutput.struct_class = Types::DescribeAlarmsOutput
 
+    DescribeAnomalyDetectorsInput.add_member(:next_token, Shapes::ShapeRef.new(shape: NextToken, location_name: "NextToken"))
+    DescribeAnomalyDetectorsInput.add_member(:max_results, Shapes::ShapeRef.new(shape: MaxReturnedResultsCount, location_name: "MaxResults"))
+    DescribeAnomalyDetectorsInput.add_member(:namespace, Shapes::ShapeRef.new(shape: Namespace, location_name: "Namespace"))
+    DescribeAnomalyDetectorsInput.add_member(:metric_name, Shapes::ShapeRef.new(shape: MetricName, location_name: "MetricName"))
+    DescribeAnomalyDetectorsInput.add_member(:dimensions, Shapes::ShapeRef.new(shape: Dimensions, location_name: "Dimensions"))
+    DescribeAnomalyDetectorsInput.struct_class = Types::DescribeAnomalyDetectorsInput
+
+    DescribeAnomalyDetectorsOutput.add_member(:anomaly_detectors, Shapes::ShapeRef.new(shape: AnomalyDetectors, location_name: "AnomalyDetectors"))
+    DescribeAnomalyDetectorsOutput.add_member(:next_token, Shapes::ShapeRef.new(shape: NextToken, location_name: "NextToken"))
+    DescribeAnomalyDetectorsOutput.struct_class = Types::DescribeAnomalyDetectorsOutput
+
     Dimension.add_member(:name, Shapes::ShapeRef.new(shape: DimensionName, required: true, location_name: "Name"))
     Dimension.add_member(:value, Shapes::ShapeRef.new(shape: DimensionValue, required: true, location_name: "Value"))
     Dimension.struct_class = Types::Dimension
@@ -396,6 +444,7 @@ module Aws::CloudWatch
     MetricAlarm.add_member(:treat_missing_data, Shapes::ShapeRef.new(shape: TreatMissingData, location_name: "TreatMissingData"))
     MetricAlarm.add_member(:evaluate_low_sample_count_percentile, Shapes::ShapeRef.new(shape: EvaluateLowSampleCountPercentile, location_name: "EvaluateLowSampleCountPercentile"))
     MetricAlarm.add_member(:metrics, Shapes::ShapeRef.new(shape: MetricDataQueries, location_name: "Metrics"))
+    MetricAlarm.add_member(:threshold_metric_id, Shapes::ShapeRef.new(shape: MetricId, location_name: "ThresholdMetricId"))
     MetricAlarm.struct_class = Types::MetricAlarm
 
     MetricAlarms.member = Shapes::ShapeRef.new(shape: MetricAlarm)
@@ -445,6 +494,15 @@ module Aws::CloudWatch
     MissingRequiredParameterException.add_member(:message, Shapes::ShapeRef.new(shape: AwsQueryErrorMessage, location_name: "message"))
     MissingRequiredParameterException.struct_class = Types::MissingRequiredParameterException
 
+    PutAnomalyDetectorInput.add_member(:namespace, Shapes::ShapeRef.new(shape: Namespace, required: true, location_name: "Namespace"))
+    PutAnomalyDetectorInput.add_member(:metric_name, Shapes::ShapeRef.new(shape: MetricName, required: true, location_name: "MetricName"))
+    PutAnomalyDetectorInput.add_member(:dimensions, Shapes::ShapeRef.new(shape: Dimensions, location_name: "Dimensions"))
+    PutAnomalyDetectorInput.add_member(:stat, Shapes::ShapeRef.new(shape: Stat, required: true, location_name: "Stat"))
+    PutAnomalyDetectorInput.add_member(:configuration, Shapes::ShapeRef.new(shape: AnomalyDetectorConfiguration, location_name: "Configuration"))
+    PutAnomalyDetectorInput.struct_class = Types::PutAnomalyDetectorInput
+
+    PutAnomalyDetectorOutput.struct_class = Types::PutAnomalyDetectorOutput
+
     PutDashboardInput.add_member(:dashboard_name, Shapes::ShapeRef.new(shape: DashboardName, required: true, location_name: "DashboardName"))
     PutDashboardInput.add_member(:dashboard_body, Shapes::ShapeRef.new(shape: DashboardBody, required: true, location_name: "DashboardBody"))
     PutDashboardInput.struct_class = Types::PutDashboardInput
@@ -467,18 +525,23 @@ module Aws::CloudWatch
     PutMetricAlarmInput.add_member(:unit, Shapes::ShapeRef.new(shape: StandardUnit, location_name: "Unit"))
     PutMetricAlarmInput.add_member(:evaluation_periods, Shapes::ShapeRef.new(shape: EvaluationPeriods, required: true, location_name: "EvaluationPeriods"))
     PutMetricAlarmInput.add_member(:datapoints_to_alarm, Shapes::ShapeRef.new(shape: DatapointsToAlarm, location_name: "DatapointsToAlarm"))
-    PutMetricAlarmInput.add_member(:threshold, Shapes::ShapeRef.new(shape: Threshold, required: true, location_name: "Threshold"))
+    PutMetricAlarmInput.add_member(:threshold, Shapes::ShapeRef.new(shape: Threshold, location_name: "Threshold"))
     PutMetricAlarmInput.add_member(:comparison_operator, Shapes::ShapeRef.new(shape: ComparisonOperator, required: true, location_name: "ComparisonOperator"))
     PutMetricAlarmInput.add_member(:treat_missing_data, Shapes::ShapeRef.new(shape: TreatMissingData, location_name: "TreatMissingData"))
     PutMetricAlarmInput.add_member(:evaluate_low_sample_count_percentile, Shapes::ShapeRef.new(shape: EvaluateLowSampleCountPercentile, location_name: "EvaluateLowSampleCountPercentile"))
     PutMetricAlarmInput.add_member(:metrics, Shapes::ShapeRef.new(shape: MetricDataQueries, location_name: "Metrics"))
     PutMetricAlarmInput.add_member(:tags, Shapes::ShapeRef.new(shape: TagList, location_name: "Tags"))
+    PutMetricAlarmInput.add_member(:threshold_metric_id, Shapes::ShapeRef.new(shape: MetricId, location_name: "ThresholdMetricId"))
     PutMetricAlarmInput.struct_class = Types::PutMetricAlarmInput
 
     PutMetricDataInput.add_member(:namespace, Shapes::ShapeRef.new(shape: Namespace, required: true, location_name: "Namespace"))
     PutMetricDataInput.add_member(:metric_data, Shapes::ShapeRef.new(shape: MetricData, required: true, location_name: "MetricData"))
     PutMetricDataInput.struct_class = Types::PutMetricDataInput
 
+    Range.add_member(:start_time, Shapes::ShapeRef.new(shape: Timestamp, required: true, location_name: "StartTime"))
+    Range.add_member(:end_time, Shapes::ShapeRef.new(shape: Timestamp, required: true, location_name: "EndTime"))
+    Range.struct_class = Types::Range
+
     ResourceList.member = Shapes::ShapeRef.new(shape: ResourceName)
 
     ResourceNotFound.add_member(:message, Shapes::ShapeRef.new(shape: ErrorMessage, location_name: "message"))
@@ -553,6 +616,18 @@ module Aws::CloudWatch
         o.errors << Shapes::ShapeRef.new(shape: ResourceNotFound)
       end)
 
+      api.add_operation(:delete_anomaly_detector, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "DeleteAnomalyDetector"
+        o.http_method = "POST"
+        o.http_request_uri = "/"
+        o.input = Shapes::ShapeRef.new(shape: DeleteAnomalyDetectorInput)
+        o.output = Shapes::ShapeRef.new(shape: DeleteAnomalyDetectorOutput)
+        o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
+        o.errors << Shapes::ShapeRef.new(shape: InternalServiceFault)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidParameterValueException)
+        o.errors << Shapes::ShapeRef.new(shape: MissingRequiredParameterException)
+      end)
+
       api.add_operation(:delete_dashboards, Seahorse::Model::Operation.new.tap do |o|
         o.name = "DeleteDashboards"
         o.http_method = "POST"
@@ -602,6 +677,17 @@ module Aws::CloudWatch
         o.output = Shapes::ShapeRef.new(shape: DescribeAlarmsForMetricOutput)
       end)
 
+      api.add_operation(:describe_anomaly_detectors, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "DescribeAnomalyDetectors"
+        o.http_method = "POST"
+        o.http_request_uri = "/"
+        o.input = Shapes::ShapeRef.new(shape: DescribeAnomalyDetectorsInput)
+        o.output = Shapes::ShapeRef.new(shape: DescribeAnomalyDetectorsOutput)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidNextToken)
+        o.errors << Shapes::ShapeRef.new(shape: InternalServiceFault)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidParameterValueException)
+      end)
+
       api.add_operation(:disable_alarm_actions, Seahorse::Model::Operation.new.tap do |o|
         o.name = "DisableAlarmActions"
         o.http_method = "POST"
@@ -705,6 +791,18 @@ module Aws::CloudWatch
         o.errors << Shapes::ShapeRef.new(shape: InternalServiceFault)
       end)
 
+      api.add_operation(:put_anomaly_detector, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "PutAnomalyDetector"
+        o.http_method = "POST"
+        o.http_request_uri = "/"
+        o.input = Shapes::ShapeRef.new(shape: PutAnomalyDetectorInput)
+        o.output = Shapes::ShapeRef.new(shape: PutAnomalyDetectorOutput)
+        o.errors << Shapes::ShapeRef.new(shape: LimitExceededException)
+        o.errors << Shapes::ShapeRef.new(shape: InternalServiceFault)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidParameterValueException)
+        o.errors << Shapes::ShapeRef.new(shape: MissingRequiredParameterException)
+      end)
+
       api.add_operation(:put_dashboard, Seahorse::Model::Operation.new.tap do |o|
         o.name = "PutDashboard"
         o.http_method = "POST"

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

@@ -316,8 +316,8 @@ module Aws::CloudWatch
     #     unit: "Seconds", # accepts Seconds, Microseconds, Milliseconds, Bytes, Kilobytes, Megabytes, Gigabytes, Terabytes, Bits, Kilobits, Megabits, Gigabits, Terabits, Percent, Count, Bytes/Second, Kilobytes/Second, Megabytes/Second, Gigabytes/Second, Terabytes/Second, Bits/Second, Kilobits/Second, Megabits/Second, Gigabits/Second, Terabits/Second, Count/Second, None
     #     evaluation_periods: 1, # required
     #     datapoints_to_alarm: 1,
-    #     threshold: 1.0, # required
-    #     comparison_operator: "GreaterThanOrEqualToThreshold", # required, accepts GreaterThanOrEqualToThreshold, GreaterThanThreshold, LessThanThreshold, LessThanOrEqualToThreshold
+    #     threshold: 1.0,
+    #     comparison_operator: "GreaterThanOrEqualToThreshold", # required, accepts GreaterThanOrEqualToThreshold, GreaterThanThreshold, LessThanThreshold, LessThanOrEqualToThreshold, LessThanLowerOrGreaterThanUpperThreshold, LessThanLowerThreshold, GreaterThanUpperThreshold
     #     treat_missing_data: "TreatMissingData",
     #     evaluate_low_sample_count_percentile: "EvaluateLowSampleCountPercentile",
     #     metrics: [
@@ -349,6 +349,7 @@ module Aws::CloudWatch
     #         value: "TagValue", # required
     #       },
     #     ],
+    #     threshold_metric_id: "MetricId",
     #   })
     # @param [Hash] options ({})
     # @option options [required, String] :alarm_name
@@ -481,12 +482,16 @@ module Aws::CloudWatch
     #
     #
     #   [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/AlarmThatSendsEmail.html#alarm-evaluation
-    # @option options [required, Float] :threshold
+    # @option options [Float] :threshold
     #   The value against which the specified statistic is compared.
     # @option options [required, String] :comparison_operator
     #   The arithmetic operation to use when comparing the specified statistic
     #   and threshold. The specified statistic value is used as the first
     #   operand.
+    #
+    #   The values `LessThanLowerOrGreaterThanUpperThreshold`,
+    #   `LessThanLowerThreshold`, and `GreaterThanUpperThreshold` are used
+    #   only for alarms based on anomaly detection models.
     # @option options [String] :treat_missing_data
     #   Sets how this alarm is to handle missing data points. If
     #   `TreatMissingData` is omitted, the default behavior of `missing` is
@@ -535,6 +540,15 @@ module Aws::CloudWatch
     #   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.
+    # @option options [String] :threshold_metric_id
+    #   If this is an alarm based on an anomaly detection model, make this
+    #   value match the ID of the `ANOMALY_DETECTION_BAND` function.
+    #
+    #   For an example of how to use this parameter, see the **Anomaly
+    #   Detection Model Alarm** example on this page.
+    #
+    #   If your alarm uses this parameter, it cannot have Auto Scaling
+    #   actions.
     # @return [Alarm]
     def put_alarm(options = {})
       options = options.merge(

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

@@ -41,6 +41,90 @@ module Aws::CloudWatch
       include Aws::Structure
     end
 
+    # An anomaly detection model associated with a particular CloudWatch
+    # metric athresnd statistic. You can use the model to display a band of
+    # expected normal values when the metric is graphed.
+    #
+    # @!attribute [rw] namespace
+    #   The namespace of the metric associated with the anomaly detection
+    #   model.
+    #   @return [String]
+    #
+    # @!attribute [rw] metric_name
+    #   The name of the metric associated with the anomaly detection model.
+    #   @return [String]
+    #
+    # @!attribute [rw] dimensions
+    #   The metric dimensions associated with the anomaly detection model.
+    #   @return [Array<Types::Dimension>]
+    #
+    # @!attribute [rw] stat
+    #   The statistic associated with the anomaly detection model.
+    #   @return [String]
+    #
+    # @!attribute [rw] configuration
+    #   The configuration specifies details about how the anomaly detection
+    #   model is to be trained, including time ranges to exclude from use
+    #   for training the model, and the time zone to use for the metric.
+    #   @return [Types::AnomalyDetectorConfiguration]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/AnomalyDetector AWS API Documentation
+    #
+    class AnomalyDetector < Struct.new(
+      :namespace,
+      :metric_name,
+      :dimensions,
+      :stat,
+      :configuration)
+      include Aws::Structure
+    end
+
+    # The configuration specifies details about how the anomaly detection
+    # model is to be trained, including time ranges to exclude from use for
+    # training the model and the time zone to use for the metric.
+    #
+    # @note When making an API call, you may pass AnomalyDetectorConfiguration
+    #   data as a hash:
+    #
+    #       {
+    #         excluded_time_ranges: [
+    #           {
+    #             start_time: Time.now, # required
+    #             end_time: Time.now, # required
+    #           },
+    #         ],
+    #         metric_timezone: "AnomalyDetectorMetricTimezone",
+    #       }
+    #
+    # @!attribute [rw] excluded_time_ranges
+    #   An array of time ranges to exclude from use when the anomaly
+    #   detection model is trained. Use this to make sure that events that
+    #   could cause unusual values for the metric, such as deployments,
+    #   aren't used when CloudWatch creates the model.
+    #   @return [Array<Types::Range>]
+    #
+    # @!attribute [rw] metric_timezone
+    #   The time zone to use for the metric. This is useful to enable the
+    #   model to automatically account for daylight savings time changes if
+    #   the metric is sensitive to such time changes.
+    #
+    #   To specify a time zone, use the name of the time zone as specified
+    #   in the standard tz database. For more information, see [tz
+    #   database][1].
+    #
+    #
+    #
+    #   [1]: https://en.wikipedia.org/wiki/Tz_database
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/AnomalyDetectorConfiguration AWS API Documentation
+    #
+    class AnomalyDetectorConfiguration < Struct.new(
+      :excluded_time_ranges,
+      :metric_timezone)
+      include Aws::Structure
+    end
+
     # Represents a specific dashboard.
     #
     # @!attribute [rw] dashboard_name
@@ -185,6 +269,53 @@ module Aws::CloudWatch
       include Aws::Structure
     end
 
+    # @note When making an API call, you may pass DeleteAnomalyDetectorInput
+    #   data as a hash:
+    #
+    #       {
+    #         namespace: "Namespace", # required
+    #         metric_name: "MetricName", # required
+    #         dimensions: [
+    #           {
+    #             name: "DimensionName", # required
+    #             value: "DimensionValue", # required
+    #           },
+    #         ],
+    #         stat: "Stat", # required
+    #       }
+    #
+    # @!attribute [rw] namespace
+    #   The namespace associated with the anomaly detection model to delete.
+    #   @return [String]
+    #
+    # @!attribute [rw] metric_name
+    #   The metric name associated with the anomaly detection model to
+    #   delete.
+    #   @return [String]
+    #
+    # @!attribute [rw] dimensions
+    #   The metric dimensions associated with the anomaly detection model to
+    #   delete.
+    #   @return [Array<Types::Dimension>]
+    #
+    # @!attribute [rw] stat
+    #   The statistic associated with the anomaly detection model to delete.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/DeleteAnomalyDetectorInput AWS API Documentation
+    #
+    class DeleteAnomalyDetectorInput < Struct.new(
+      :namespace,
+      :metric_name,
+      :dimensions,
+      :stat)
+      include Aws::Structure
+    end
+
+    # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/DeleteAnomalyDetectorOutput AWS API Documentation
+    #
+    class DeleteAnomalyDetectorOutput < Aws::EmptyStructure; end
+
     # @note When making an API call, you may pass DeleteDashboardsInput
     #   data as a hash:
     #
@@ -414,6 +545,82 @@ module Aws::CloudWatch
       include Aws::Structure
     end
 
+    # @note When making an API call, you may pass DescribeAnomalyDetectorsInput
+    #   data as a hash:
+    #
+    #       {
+    #         next_token: "NextToken",
+    #         max_results: 1,
+    #         namespace: "Namespace",
+    #         metric_name: "MetricName",
+    #         dimensions: [
+    #           {
+    #             name: "DimensionName", # required
+    #             value: "DimensionValue", # required
+    #           },
+    #         ],
+    #       }
+    #
+    # @!attribute [rw] next_token
+    #   Use the token returned by the previous operation to request the next
+    #   page of results.
+    #   @return [String]
+    #
+    # @!attribute [rw] max_results
+    #   The maximum number of results to return in one operation. The
+    #   maximum value you can specify is 10.
+    #
+    #   To retrieve the remaining results, make another call with the
+    #   returned `NextToken` value.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] namespace
+    #   Limits the results to only the anomaly detection models that are
+    #   associated with the specified namespace.
+    #   @return [String]
+    #
+    # @!attribute [rw] metric_name
+    #   Limits the results to only the anomaly detection models that are
+    #   associated with the specified metric name. If there are multiple
+    #   metrics with this name in different namespaces that have anomaly
+    #   detection models, they're all returned.
+    #   @return [String]
+    #
+    # @!attribute [rw] dimensions
+    #   Limits the results to only the anomaly detection models that are
+    #   associated with the specified metric dimensions. If there are
+    #   multiple metrics that have these dimensions and have anomaly
+    #   detection models associated, they're all returned.
+    #   @return [Array<Types::Dimension>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/DescribeAnomalyDetectorsInput AWS API Documentation
+    #
+    class DescribeAnomalyDetectorsInput < Struct.new(
+      :next_token,
+      :max_results,
+      :namespace,
+      :metric_name,
+      :dimensions)
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] anomaly_detectors
+    #   The list of anomaly detection models returned by the operation.
+    #   @return [Array<Types::AnomalyDetector>]
+    #
+    # @!attribute [rw] next_token
+    #   A token that you can use in a subsequent operation to retrieve the
+    #   next set of results.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/DescribeAnomalyDetectorsOutput AWS API Documentation
+    #
+    class DescribeAnomalyDetectorsOutput < Struct.new(
+      :anomaly_detectors,
+      :next_token)
+      include Aws::Structure
+    end
+
     # Expands the identity of a metric.
     #
     # @note When making an API call, you may pass Dimension
@@ -1232,7 +1439,8 @@ module Aws::CloudWatch
     #   @return [Time]
     #
     # @!attribute [rw] metric_name
-    #   The name of the metric associated with the alarm.
+    #   The name of the metric associated with the alarm, if this is an
+    #   alarm based on a single metric.
     #   @return [String]
     #
     # @!attribute [rw] namespace
@@ -1295,8 +1503,19 @@ module Aws::CloudWatch
     #   @return [String]
     #
     # @!attribute [rw] metrics
+    #   An array of MetricDataQuery structures, used in an alarm based on a
+    #   metric math expression. Each structure either retrieves a metric or
+    #   performs a math expression. One item in the Metrics array is the
+    #   math expression that the alarm watches. This expression by
+    #   designated by having `ReturnValue` set to true.
     #   @return [Array<Types::MetricDataQuery>]
     #
+    # @!attribute [rw] 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.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/MetricAlarm AWS API Documentation
     #
     class MetricAlarm < Struct.new(
@@ -1325,7 +1544,8 @@ module Aws::CloudWatch
       :comparison_operator,
       :treat_missing_data,
       :evaluate_low_sample_count_percentile,
-      :metrics)
+      :metrics,
+      :threshold_metric_id)
       include Aws::Structure
     end
 
@@ -1588,7 +1808,9 @@ module Aws::CloudWatch
     #   @return [Array<Float>]
     #
     # @!attribute [rw] unit
-    #   The unit of the metric.
+    #   When you are using a `Put` operation, this defines what unit you
+    #   want to use when storing the metric. In a `Get` operation, this
+    #   displays the unit that is used for the metric.
     #   @return [String]
     #
     # @!attribute [rw] storage_resolution
@@ -1661,7 +1883,9 @@ module Aws::CloudWatch
     #   @return [String]
     #
     # @!attribute [rw] unit
-    #   The unit to use for the returned data points.
+    #   When you are using a `Put` operation, this defines what unit you
+    #   want to use when storing the metric. In a `Get` operation, this
+    #   displays the unit that is used for the metric.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/MetricStat AWS API Documentation
@@ -1686,6 +1910,74 @@ module Aws::CloudWatch
       include Aws::Structure
     end
 
+    # @note When making an API call, you may pass PutAnomalyDetectorInput
+    #   data as a hash:
+    #
+    #       {
+    #         namespace: "Namespace", # required
+    #         metric_name: "MetricName", # required
+    #         dimensions: [
+    #           {
+    #             name: "DimensionName", # required
+    #             value: "DimensionValue", # required
+    #           },
+    #         ],
+    #         stat: "Stat", # required
+    #         configuration: {
+    #           excluded_time_ranges: [
+    #             {
+    #               start_time: Time.now, # required
+    #               end_time: Time.now, # required
+    #             },
+    #           ],
+    #           metric_timezone: "AnomalyDetectorMetricTimezone",
+    #         },
+    #       }
+    #
+    # @!attribute [rw] namespace
+    #   The namespace of the metric to create the anomaly detection model
+    #   for.
+    #   @return [String]
+    #
+    # @!attribute [rw] metric_name
+    #   The name of the metric to create the anomaly detection model for.
+    #   @return [String]
+    #
+    # @!attribute [rw] dimensions
+    #   The metric dimensions to create the anomaly detection model for.
+    #   @return [Array<Types::Dimension>]
+    #
+    # @!attribute [rw] stat
+    #   The statistic to use for the metric and the anomaly detection model.
+    #   @return [String]
+    #
+    # @!attribute [rw] configuration
+    #   The configuration specifies details about how the anomaly detection
+    #   model is to be trained, including time ranges to exclude when
+    #   training and updating the model. You can specify as many as 10 time
+    #   ranges.
+    #
+    #   The configuration can also include the time zone to use for the
+    #   metric.
+    #
+    #   You can in
+    #   @return [Types::AnomalyDetectorConfiguration]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/PutAnomalyDetectorInput AWS API Documentation
+    #
+    class PutAnomalyDetectorInput < Struct.new(
+      :namespace,
+      :metric_name,
+      :dimensions,
+      :stat,
+      :configuration)
+      include Aws::Structure
+    end
+
+    # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/PutAnomalyDetectorOutput AWS API Documentation
+    #
+    class PutAnomalyDetectorOutput < Aws::EmptyStructure; end
+
     # @note When making an API call, you may pass PutDashboardInput
     #   data as a hash:
     #
@@ -1762,8 +2054,8 @@ module Aws::CloudWatch
     #         unit: "Seconds", # accepts Seconds, Microseconds, Milliseconds, Bytes, Kilobytes, Megabytes, Gigabytes, Terabytes, Bits, Kilobits, Megabits, Gigabits, Terabits, Percent, Count, Bytes/Second, Kilobytes/Second, Megabytes/Second, Gigabytes/Second, Terabytes/Second, Bits/Second, Kilobits/Second, Megabits/Second, Gigabits/Second, Terabits/Second, Count/Second, None
     #         evaluation_periods: 1, # required
     #         datapoints_to_alarm: 1,
-    #         threshold: 1.0, # required
-    #         comparison_operator: "GreaterThanOrEqualToThreshold", # required, accepts GreaterThanOrEqualToThreshold, GreaterThanThreshold, LessThanThreshold, LessThanOrEqualToThreshold
+    #         threshold: 1.0,
+    #         comparison_operator: "GreaterThanOrEqualToThreshold", # required, accepts GreaterThanOrEqualToThreshold, GreaterThanThreshold, LessThanThreshold, LessThanOrEqualToThreshold, LessThanLowerOrGreaterThanUpperThreshold, LessThanLowerThreshold, GreaterThanUpperThreshold
     #         treat_missing_data: "TreatMissingData",
     #         evaluate_low_sample_count_percentile: "EvaluateLowSampleCountPercentile",
     #         metrics: [
@@ -1795,6 +2087,7 @@ module Aws::CloudWatch
     #             value: "TagValue", # required
     #           },
     #         ],
+    #         threshold_metric_id: "MetricId",
     #       }
     #
     # @!attribute [rw] alarm_name
@@ -1975,6 +2268,10 @@ module Aws::CloudWatch
     #   The arithmetic operation to use when comparing the specified
     #   statistic and threshold. The specified statistic value is used as
     #   the first operand.
+    #
+    #   The values `LessThanLowerOrGreaterThanUpperThreshold`,
+    #   `LessThanLowerThreshold`, and `GreaterThanUpperThreshold` are used
+    #   only for alarms based on anomaly detection models.
     #   @return [String]
     #
     # @!attribute [rw] treat_missing_data
@@ -2034,6 +2331,17 @@ module Aws::CloudWatch
     #   values.
     #   @return [Array<Types::Tag>]
     #
+    # @!attribute [rw] threshold_metric_id
+    #   If this is an alarm based on an anomaly detection model, make this
+    #   value match the ID of the `ANOMALY_DETECTION_BAND` function.
+    #
+    #   For an example of how to use this parameter, see the **Anomaly
+    #   Detection Model Alarm** example on this page.
+    #
+    #   If your alarm uses this parameter, it cannot have Auto Scaling
+    #   actions.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/PutMetricAlarmInput AWS API Documentation
     #
     class PutMetricAlarmInput < Struct.new(
@@ -2057,7 +2365,8 @@ module Aws::CloudWatch
       :treat_missing_data,
       :evaluate_low_sample_count_percentile,
       :metrics,
-      :tags)
+      :tags,
+      :threshold_metric_id)
       include Aws::Structure
     end
 
@@ -2112,6 +2421,35 @@ module Aws::CloudWatch
       include Aws::Structure
     end
 
+    # Specifies one range of days or times to exclude from use for training
+    # an anomaly detection model.
+    #
+    # @note When making an API call, you may pass Range
+    #   data as a hash:
+    #
+    #       {
+    #         start_time: Time.now, # required
+    #         end_time: Time.now, # required
+    #       }
+    #
+    # @!attribute [rw] start_time
+    #   The start time of the range to exclude. The format is
+    #   `yyyy-MM-dd'T'HH:mm:ss`. For example, `2019-07-01T23:59:59`.
+    #   @return [Time]
+    #
+    # @!attribute [rw] end_time
+    #   The end time of the range to exclude. The format is
+    #   `yyyy-MM-dd'T'HH:mm:ss`. For example, `2019-07-01T23:59:59`.
+    #   @return [Time]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/Range AWS API Documentation
+    #
+    class Range < Struct.new(
+      :start_time,
+      :end_time)
+      include Aws::Structure
+    end
+
     # The named resource does not exist.
     #
     # @!attribute [rw] message

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-cloudwatch
 version: !ruby/object:Gem::Version
-  version: 1.25.0
+  version: 1.26.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-07-01 00:00:00.000000000 Z
+date: 2019-07-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core