aws-sdk-cloudwatch 1.62.0 → 1.65.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: aa99c1cc7e908a774e6363a61d5f084eba01f18269abfe6340fcf6951823be5f
-  data.tar.gz: 19e9f0f56b820e461897d3da75b1054ccb0dd40c786ac0f09a1ce47d4103abaa
+  metadata.gz: 9882292fa5689699f213f674aca54dfc40cd6dcc3233297a7a447993317fb386
+  data.tar.gz: d10daaa3174ea14a2667d4cf28c3758e38609fb0dc942ea5cb957da8d4fd9a7c
 SHA512:
-  metadata.gz: ab62c320a5d033615cba83d38b515e31d34e936f9cc2feaa5f5a4eaf7351a151aac775f86e91c1167a8c68b6fed4574294b5944406645d5b106cabb1dc59c68d
-  data.tar.gz: 8db916b883dd838ffe61d0fe8789a8f9901972c1ee8aca4d9c7078a97e39267ab204f9b71770e5a62daaff9d8201a3ec80847db25241cd4a625423b925252676
+  metadata.gz: 0704a30c53f1ba4a13826c8fa66c3b2a46c6268d877fe26b5f9438919f2bfb9f13e01bb7fabac24434c359fbcf798332d66be78e0cdd3156273f2a8e402245ae
+  data.tar.gz: f775047d967d586ece529236c894bf5ca0751b8de3cf29e14deeab0fe4cec346cb94d98f34aea73e9809e76e2a6ceb6aa5f61618e8af87c3087035765af581cd

data/CHANGELOG.md

@@ -1,6 +1,21 @@
 Unreleased Changes
 ------------------
 
+1.65.0 (2022-07-21)
+------------------
+
+* Feature - Adding support for the suppression of Composite Alarm actions
+
+1.64.0 (2022-04-14)
+------------------
+
+* Feature - Updates documentation for additional statistics in CloudWatch Metric Streams.
+
+1.63.0 (2022-04-13)
+------------------
+
+* Feature - Adds support for additional statistics in CloudWatch Metric Streams.
+
 1.62.0 (2022-02-24)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.62.0
+1.65.0

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

@@ -180,8 +180,17 @@ module Aws::CloudWatch
       data[:comparison_operator]
     end
 
-    # Sets how this alarm is to handle missing data points. If this
-    # parameter is omitted, the default behavior of `missing` is used.
+    # Sets how this alarm is to handle missing data points. The valid values
+    # are `breaching`, `notBreaching`, `ignore`, and `missing`. For more
+    # information, see [Configuring how CloudWatch alarms treat missing
+    # data][1].
+    #
+    # If this parameter is omitted, the default behavior of `missing` is
+    # used.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/AlarmThatSendsEmail.html#alarms-and-missing-data
     # @return [String]
     def treat_missing_data
       data[:treat_missing_data]

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

@@ -809,6 +809,12 @@ module Aws::CloudWatch
     #   resp.composite_alarms[0].state_reason_data #=> String
     #   resp.composite_alarms[0].state_updated_timestamp #=> Time
     #   resp.composite_alarms[0].state_value #=> String, one of "OK", "ALARM", "INSUFFICIENT_DATA"
+    #   resp.composite_alarms[0].state_transitioned_timestamp #=> Time
+    #   resp.composite_alarms[0].actions_suppressed_by #=> String, one of "WaitPeriod", "ExtensionPeriod", "Alarm"
+    #   resp.composite_alarms[0].actions_suppressed_reason #=> String
+    #   resp.composite_alarms[0].actions_suppressor #=> String
+    #   resp.composite_alarms[0].actions_suppressor_wait_period #=> Integer
+    #   resp.composite_alarms[0].actions_suppressor_extension_period #=> Integer
     #   resp.metric_alarms #=> Array
     #   resp.metric_alarms[0].alarm_name #=> String
     #   resp.metric_alarms[0].alarm_arn #=> String
@@ -1444,19 +1450,30 @@ module Aws::CloudWatch
       req.send_request(options)
     end
 
-    # You can use the `GetMetricData` API to retrieve as many as 500
-    # different metrics in a single request, with a total of as many as
-    # 100,800 data points. You can also optionally perform math expressions
-    # on the values of the returned statistics, to create new time series
-    # that represent new insights into your data. For example, using Lambda
-    # metrics, you could divide the Errors metric by the Invocations metric
-    # to get an error rate time series. For more information about metric
-    # math expressions, see [Metric Math Syntax and Functions][1] in the
-    # *Amazon CloudWatch User Guide*.
+    # You can use the `GetMetricData` API to retrieve CloudWatch metric
+    # values. The operation can also include a CloudWatch Metrics Insights
+    # query, and one or more metric math functions.
+    #
+    # A `GetMetricData` operation that does not include a query can retrieve
+    # as many as 500 different metrics in a single request, with a total of
+    # as many as 100,800 data points. You can also optionally perform metric
+    # math expressions on the values of the returned statistics, to create
+    # new time series that represent new insights into your data. For
+    # example, using Lambda metrics, you could divide the Errors metric by
+    # the Invocations metric to get an error rate time series. For more
+    # information about metric math expressions, see [Metric Math Syntax and
+    # Functions][1] in the *Amazon CloudWatch User Guide*.
+    #
+    # If you include a Metrics Insights query, each `GetMetricData`
+    # operation can include only one query. But the same `GetMetricData`
+    # operation can also retrieve other metrics. Metrics Insights queries
+    # can query only the most recent three hours of metric data. For more
+    # information about Metrics Insights, see [Query your metrics with
+    # CloudWatch Metrics Insights][2].
     #
     # Calls to the `GetMetricData` API have a different pricing structure
     # than calls to `GetMetricStatistics`. For more information about
-    # pricing, see [Amazon CloudWatch Pricing][2].
+    # pricing, see [Amazon CloudWatch Pricing][3].
     #
     # Amazon CloudWatch retains metric data as follows:
     #
@@ -1490,16 +1507,29 @@ module Aws::CloudWatch
     # collected, the results of the operation are null. CloudWatch does not
     # perform unit conversions.
     #
+    # **Using Metrics Insights queries with metric math**
+    #
+    # You can't mix a Metric Insights query and metric math syntax in the
+    # same expression, but you can reference results from a Metrics Insights
+    # query within other Metric math expressions. A Metrics Insights query
+    # without a **GROUP BY** clause returns a single time-series (TS), and
+    # can be used as input for a metric math expression that expects a
+    # single time series. A Metrics Insights query with a **GROUP BY**
+    # clause returns an array of time-series (TS\[\]), and can be used as
+    # input for a metric math expression that expects an array of time
+    # series.
+    #
     #
     #
     # [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/using-metric-math.html#metric-math-syntax
-    # [2]: https://aws.amazon.com/cloudwatch/pricing/
+    # [2]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/query_with_cloudwatch-metrics-insights.html
+    # [3]: https://aws.amazon.com/cloudwatch/pricing/
     #
     # @option params [required, Array<Types::MetricDataQuery>] :metric_data_queries
     #   The metric queries to be returned. A single `GetMetricData` call can
     #   include as many as 500 `MetricDataQuery` structures. Each of these
-    #   structures can specify either a metric to retrieve, or a math
-    #   expression to perform on retrieved data.
+    #   structures can specify either a metric to retrieve, a Metrics Insights
+    #   query, or a math expression to perform on retrieved data.
     #
     # @option params [required, Time,DateTime,Date,Integer,String] :start_time
     #   The time stamp indicating the earliest data to be returned.
@@ -1872,6 +1902,7 @@ module Aws::CloudWatch
     #   * {Types::GetMetricStreamOutput#creation_date #creation_date} => Time
     #   * {Types::GetMetricStreamOutput#last_update_date #last_update_date} => Time
     #   * {Types::GetMetricStreamOutput#output_format #output_format} => String
+    #   * {Types::GetMetricStreamOutput#statistics_configurations #statistics_configurations} => Array&lt;Types::MetricStreamStatisticsConfiguration&gt;
     #
     # @example Request syntax with placeholder values
     #
@@ -1893,6 +1924,12 @@ module Aws::CloudWatch
     #   resp.creation_date #=> Time
     #   resp.last_update_date #=> Time
     #   resp.output_format #=> String, one of "json", "opentelemetry0.7"
+    #   resp.statistics_configurations #=> Array
+    #   resp.statistics_configurations[0].include_metrics #=> Array
+    #   resp.statistics_configurations[0].include_metrics[0].namespace #=> String
+    #   resp.statistics_configurations[0].include_metrics[0].metric_name #=> String
+    #   resp.statistics_configurations[0].additional_statistics #=> Array
+    #   resp.statistics_configurations[0].additional_statistics[0] #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/GetMetricStream AWS API Documentation
     #
@@ -2370,7 +2407,10 @@ module Aws::CloudWatch
     # rule are met.
     #
     # The alarms specified in a composite alarm's rule expression can
-    # include metric alarms and other composite alarms.
+    # include metric alarms and other composite alarms. The rule expression
+    # of a composite alarm can include as many as 100 underlying alarms. Any
+    # single alarm can be included in the rule expressions of as many as 150
+    # composite alarms.
     #
     # Using composite alarms can reduce alarm noise. You can create multiple
     # metric alarms, and also create a composite alarm and set up alerts
@@ -2516,6 +2556,26 @@ 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] :actions_suppressor
+    #   Actions will be suppressed if the suppressor alarm is in the `ALARM`
+    #   state. `ActionsSuppressor` can be an AlarmName or an Amazon Resource
+    #   Name (ARN) from an existing alarm.
+    #
+    # @option params [Integer] :actions_suppressor_wait_period
+    #   The maximum time in seconds that the composite alarm waits for the
+    #   suppressor alarm to go into the `ALARM` state. After this time, the
+    #   composite alarm performs its actions.
+    #
+    #   `WaitPeriod` is required only when `ActionsSuppressor` is specified.
+    #
+    # @option params [Integer] :actions_suppressor_extension_period
+    #   The maximum time in seconds that the composite alarm waits after
+    #   suppressor alarm goes out of the `ALARM` state. After this time, the
+    #   composite alarm performs its actions.
+    #
+    #   `ExtensionPeriod` is required only when `ActionsSuppressor` is
+    #   specified.
+    #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
     # @example Request syntax with placeholder values
@@ -2534,6 +2594,9 @@ module Aws::CloudWatch
     #         value: "TagValue", # required
     #       },
     #     ],
+    #     actions_suppressor: "AlarmArn",
+    #     actions_suppressor_wait_period: 1,
+    #     actions_suppressor_extension_period: 1,
     #   })
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/PutCompositeAlarm AWS API Documentation
@@ -2936,6 +2999,13 @@ module Aws::CloudWatch
     #
     #   Valid Values: `breaching | notBreaching | ignore | missing`
     #
+    #   <note markdown="1"> Alarms that evaluate metrics in the `AWS/DynamoDB` namespace always
+    #   `ignore` missing data even if you choose a different option for
+    #   `TreatMissingData`. When an `AWS/DynamoDB` metric has missing data,
+    #   alarms that evaluate that metric remain in their current state.
+    #
+    #    </note>
+    #
     #
     #
     #   [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/AlarmThatSendsEmail.html#alarms-and-missing-data
@@ -3207,6 +3277,13 @@ module Aws::CloudWatch
     # * Stream metrics from only the metric namespaces that you list in
     #   `IncludeFilters`.
     #
+    # By default, a metric stream always sends the `MAX`, `MIN`, `SUM`, and
+    # `SAMPLECOUNT` statistics for each metric that is streamed. You can use
+    # the `StatisticsConfigurations` parameter to have the metric stream
+    # also send additional statistics in the stream. Streaming additional
+    # statistics incurs additional costs. For more information, see [Amazon
+    # CloudWatch Pricing][2].
+    #
     # When you use `PutMetricStream` to create a new metric stream, the
     # stream is created in the `running` state. If you use it to update an
     # existing stream, the state of the stream is not changed.
@@ -3214,6 +3291,7 @@ module Aws::CloudWatch
     #
     #
     # [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Metric-Streams.html
+    # [2]: https://aws.amazon.com/cloudwatch/pricing/
     #
     # @option params [required, String] :name
     #   If you are creating a new metric stream, this is the name for the new
@@ -3282,6 +3360,25 @@ module Aws::CloudWatch
     #   [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 [Array<Types::MetricStreamStatisticsConfiguration>] :statistics_configurations
+    #   By default, a metric stream always sends the `MAX`, `MIN`, `SUM`, and
+    #   `SAMPLECOUNT` statistics for each metric that is streamed. You can use
+    #   this parameter to have the metric stream also send additional
+    #   statistics in the stream. This array can have up to 100 members.
+    #
+    #   For each entry in this array, you specify one or more metrics and the
+    #   list of additional statistics to stream for those metrics. The
+    #   additional statistics that you can stream depend on the stream's
+    #   `OutputFormat`. If the `OutputFormat` is `json`, you can stream any
+    #   additional statistic that is supported by CloudWatch, listed in [
+    #   CloudWatch statistics definitions][1]. If the `OutputFormat` is
+    #   `opentelemetry0.7`, you can stream percentile statistics such as p95,
+    #   p99.9 and so on.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/Statistics-definitions.html.html
+    #
     # @return [Types::PutMetricStreamOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::PutMetricStreamOutput#arn #arn} => String
@@ -3309,6 +3406,17 @@ module Aws::CloudWatch
     #         value: "TagValue", # required
     #       },
     #     ],
+    #     statistics_configurations: [
+    #       {
+    #         include_metrics: [ # required
+    #           {
+    #             namespace: "Namespace", # required
+    #             metric_name: "MetricName", # required
+    #           },
+    #         ],
+    #         additional_statistics: ["MetricStreamStatistic"], # required
+    #       },
+    #     ],
     #   })
     #
     # @example Response structure
@@ -3554,7 +3662,7 @@ module Aws::CloudWatch
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-cloudwatch'
-      context[:gem_version] = '1.62.0'
+      context[:gem_version] = '1.65.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -16,6 +16,8 @@ module Aws::CloudWatch
     AccountId = Shapes::StringShape.new(name: 'AccountId')
     ActionPrefix = Shapes::StringShape.new(name: 'ActionPrefix')
     ActionsEnabled = Shapes::BooleanShape.new(name: 'ActionsEnabled')
+    ActionsSuppressedBy = Shapes::StringShape.new(name: 'ActionsSuppressedBy')
+    ActionsSuppressedReason = Shapes::StringShape.new(name: 'ActionsSuppressedReason')
     AlarmArn = Shapes::StringShape.new(name: 'AlarmArn')
     AlarmDescription = Shapes::StringShape.new(name: 'AlarmDescription')
     AlarmHistoryItem = Shapes::StructureShape.new(name: 'AlarmHistoryItem')
@@ -193,6 +195,12 @@ module Aws::CloudWatch
     MetricStreamNames = Shapes::ListShape.new(name: 'MetricStreamNames')
     MetricStreamOutputFormat = Shapes::StringShape.new(name: 'MetricStreamOutputFormat')
     MetricStreamState = Shapes::StringShape.new(name: 'MetricStreamState')
+    MetricStreamStatistic = Shapes::StringShape.new(name: 'MetricStreamStatistic')
+    MetricStreamStatisticsAdditionalStatistics = Shapes::ListShape.new(name: 'MetricStreamStatisticsAdditionalStatistics')
+    MetricStreamStatisticsConfiguration = Shapes::StructureShape.new(name: 'MetricStreamStatisticsConfiguration')
+    MetricStreamStatisticsConfigurations = Shapes::ListShape.new(name: 'MetricStreamStatisticsConfigurations')
+    MetricStreamStatisticsIncludeMetrics = Shapes::ListShape.new(name: 'MetricStreamStatisticsIncludeMetrics')
+    MetricStreamStatisticsMetric = Shapes::StructureShape.new(name: 'MetricStreamStatisticsMetric')
     MetricWidget = Shapes::StringShape.new(name: 'MetricWidget')
     MetricWidgetImage = Shapes::BlobShape.new(name: 'MetricWidgetImage')
     Metrics = Shapes::ListShape.new(name: 'Metrics')
@@ -240,6 +248,7 @@ module Aws::CloudWatch
     StopMetricStreamsInput = Shapes::StructureShape.new(name: 'StopMetricStreamsInput')
     StopMetricStreamsOutput = Shapes::StructureShape.new(name: 'StopMetricStreamsOutput')
     StorageResolution = Shapes::IntegerShape.new(name: 'StorageResolution')
+    SuppressorPeriod = Shapes::IntegerShape.new(name: 'SuppressorPeriod')
     Tag = Shapes::StructureShape.new(name: 'Tag')
     TagKey = Shapes::StringShape.new(name: 'TagKey')
     TagKeyList = Shapes::ListShape.new(name: 'TagKeyList')
@@ -304,6 +313,12 @@ module Aws::CloudWatch
     CompositeAlarm.add_member(:state_reason_data, Shapes::ShapeRef.new(shape: StateReasonData, location_name: "StateReasonData"))
     CompositeAlarm.add_member(:state_updated_timestamp, Shapes::ShapeRef.new(shape: Timestamp, location_name: "StateUpdatedTimestamp"))
     CompositeAlarm.add_member(:state_value, Shapes::ShapeRef.new(shape: StateValue, location_name: "StateValue"))
+    CompositeAlarm.add_member(:state_transitioned_timestamp, Shapes::ShapeRef.new(shape: Timestamp, location_name: "StateTransitionedTimestamp"))
+    CompositeAlarm.add_member(:actions_suppressed_by, Shapes::ShapeRef.new(shape: ActionsSuppressedBy, location_name: "ActionsSuppressedBy"))
+    CompositeAlarm.add_member(:actions_suppressed_reason, Shapes::ShapeRef.new(shape: ActionsSuppressedReason, location_name: "ActionsSuppressedReason"))
+    CompositeAlarm.add_member(:actions_suppressor, Shapes::ShapeRef.new(shape: AlarmArn, location_name: "ActionsSuppressor"))
+    CompositeAlarm.add_member(:actions_suppressor_wait_period, Shapes::ShapeRef.new(shape: SuppressorPeriod, location_name: "ActionsSuppressorWaitPeriod"))
+    CompositeAlarm.add_member(:actions_suppressor_extension_period, Shapes::ShapeRef.new(shape: SuppressorPeriod, location_name: "ActionsSuppressorExtensionPeriod"))
     CompositeAlarm.struct_class = Types::CompositeAlarm
 
     CompositeAlarms.member = Shapes::ShapeRef.new(shape: CompositeAlarm)
@@ -542,6 +557,7 @@ module Aws::CloudWatch
     GetMetricStreamOutput.add_member(:creation_date, Shapes::ShapeRef.new(shape: Timestamp, location_name: "CreationDate"))
     GetMetricStreamOutput.add_member(:last_update_date, Shapes::ShapeRef.new(shape: Timestamp, location_name: "LastUpdateDate"))
     GetMetricStreamOutput.add_member(:output_format, Shapes::ShapeRef.new(shape: MetricStreamOutputFormat, location_name: "OutputFormat"))
+    GetMetricStreamOutput.add_member(:statistics_configurations, Shapes::ShapeRef.new(shape: MetricStreamStatisticsConfigurations, location_name: "StatisticsConfigurations"))
     GetMetricStreamOutput.struct_class = Types::GetMetricStreamOutput
 
     GetMetricWidgetImageInput.add_member(:metric_widget, Shapes::ShapeRef.new(shape: MetricWidget, required: true, location_name: "MetricWidget"))
@@ -751,6 +767,20 @@ module Aws::CloudWatch
 
     MetricStreamNames.member = Shapes::ShapeRef.new(shape: MetricStreamName)
 
+    MetricStreamStatisticsAdditionalStatistics.member = Shapes::ShapeRef.new(shape: MetricStreamStatistic)
+
+    MetricStreamStatisticsConfiguration.add_member(:include_metrics, Shapes::ShapeRef.new(shape: MetricStreamStatisticsIncludeMetrics, required: true, location_name: "IncludeMetrics"))
+    MetricStreamStatisticsConfiguration.add_member(:additional_statistics, Shapes::ShapeRef.new(shape: MetricStreamStatisticsAdditionalStatistics, required: true, location_name: "AdditionalStatistics"))
+    MetricStreamStatisticsConfiguration.struct_class = Types::MetricStreamStatisticsConfiguration
+
+    MetricStreamStatisticsConfigurations.member = Shapes::ShapeRef.new(shape: MetricStreamStatisticsConfiguration)
+
+    MetricStreamStatisticsIncludeMetrics.member = Shapes::ShapeRef.new(shape: MetricStreamStatisticsMetric)
+
+    MetricStreamStatisticsMetric.add_member(:namespace, Shapes::ShapeRef.new(shape: Namespace, required: true, location_name: "Namespace"))
+    MetricStreamStatisticsMetric.add_member(:metric_name, Shapes::ShapeRef.new(shape: MetricName, required: true, location_name: "MetricName"))
+    MetricStreamStatisticsMetric.struct_class = Types::MetricStreamStatisticsMetric
+
     Metrics.member = Shapes::ShapeRef.new(shape: Metric)
 
     MissingRequiredParameterException.add_member(:message, Shapes::ShapeRef.new(shape: AwsQueryErrorMessage, location_name: "message"))
@@ -781,6 +811,9 @@ module Aws::CloudWatch
     PutCompositeAlarmInput.add_member(:insufficient_data_actions, Shapes::ShapeRef.new(shape: ResourceList, location_name: "InsufficientDataActions"))
     PutCompositeAlarmInput.add_member(:ok_actions, Shapes::ShapeRef.new(shape: ResourceList, location_name: "OKActions"))
     PutCompositeAlarmInput.add_member(:tags, Shapes::ShapeRef.new(shape: TagList, location_name: "Tags"))
+    PutCompositeAlarmInput.add_member(:actions_suppressor, Shapes::ShapeRef.new(shape: AlarmArn, location_name: "ActionsSuppressor"))
+    PutCompositeAlarmInput.add_member(:actions_suppressor_wait_period, Shapes::ShapeRef.new(shape: SuppressorPeriod, location_name: "ActionsSuppressorWaitPeriod"))
+    PutCompositeAlarmInput.add_member(:actions_suppressor_extension_period, Shapes::ShapeRef.new(shape: SuppressorPeriod, location_name: "ActionsSuppressorExtensionPeriod"))
     PutCompositeAlarmInput.struct_class = Types::PutCompositeAlarmInput
 
     PutDashboardInput.add_member(:dashboard_name, Shapes::ShapeRef.new(shape: DashboardName, required: true, location_name: "DashboardName"))
@@ -833,6 +866,7 @@ module Aws::CloudWatch
     PutMetricStreamInput.add_member(:role_arn, Shapes::ShapeRef.new(shape: AmazonResourceName, required: true, location_name: "RoleArn"))
     PutMetricStreamInput.add_member(:output_format, Shapes::ShapeRef.new(shape: MetricStreamOutputFormat, required: true, location_name: "OutputFormat"))
     PutMetricStreamInput.add_member(:tags, Shapes::ShapeRef.new(shape: TagList, location_name: "Tags"))
+    PutMetricStreamInput.add_member(:statistics_configurations, Shapes::ShapeRef.new(shape: MetricStreamStatisticsConfigurations, location_name: "StatisticsConfigurations"))
     PutMetricStreamInput.struct_class = Types::PutMetricStreamInput
 
     PutMetricStreamOutput.add_member(:arn, Shapes::ShapeRef.new(shape: AmazonResourceName, location_name: "Arn"))

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

@@ -102,7 +102,8 @@ module Aws::CloudWatch
       data[:state_reason_data]
     end
 
-    # The time stamp of the last update to the alarm state.
+    # Tracks the timestamp of any state update, even if `StateValue`
+    # doesn't change.
     # @return [Time]
     def state_updated_timestamp
       data[:state_updated_timestamp]
@@ -114,6 +115,63 @@ module Aws::CloudWatch
       data[:state_value]
     end
 
+    # The timestamp of the last change to the alarm's `StateValue`.
+    # @return [Time]
+    def state_transitioned_timestamp
+      data[:state_transitioned_timestamp]
+    end
+
+    # When the value is `ALARM`, it means that the actions are suppressed
+    # because the suppressor alarm is in `ALARM` When the value is
+    # `WaitPeriod`, it means that the actions are suppressed because the
+    # composite alarm is waiting for the suppressor alarm to go into into
+    # the `ALARM` state. The maximum waiting time is as specified in
+    # `ActionsSuppressorWaitPeriod`. After this time, the composite alarm
+    # performs its actions. When the value is `ExtensionPeriod`, it means
+    # that the actions are suppressed because the composite alarm is waiting
+    # after the suppressor alarm went out of the `ALARM` state. The maximum
+    # waiting time is as specified in `ActionsSuppressorExtensionPeriod`.
+    # After this time, the composite alarm performs its actions.
+    # @return [String]
+    def actions_suppressed_by
+      data[:actions_suppressed_by]
+    end
+
+    # Captures the reason for action suppression.
+    # @return [String]
+    def actions_suppressed_reason
+      data[:actions_suppressed_reason]
+    end
+
+    # Actions will be suppressed if the suppressor alarm is in the `ALARM`
+    # state. `ActionsSuppressor` can be an AlarmName or an Amazon Resource
+    # Name (ARN) from an existing alarm.
+    # @return [String]
+    def actions_suppressor
+      data[:actions_suppressor]
+    end
+
+    # The maximum time in seconds that the composite alarm waits for the
+    # suppressor alarm to go into the `ALARM` state. After this time, the
+    # composite alarm performs its actions.
+    #
+    # `WaitPeriod` is required only when `ActionsSuppressor` is specified.
+    # @return [Integer]
+    def actions_suppressor_wait_period
+      data[:actions_suppressor_wait_period]
+    end
+
+    # The maximum time in seconds that the composite alarm waits after
+    # suppressor alarm goes out of the `ALARM` state. After this time, the
+    # composite alarm performs its actions.
+    #
+    # `ExtensionPeriod` is required only when `ActionsSuppressor` is
+    # specified.
+    # @return [Integer]
+    def actions_suppressor_extension_period
+      data[:actions_suppressor_extension_period]
+    end
+
     # @!endgroup
 
     # @return [Client]

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

@@ -531,6 +531,13 @@ module Aws::CloudWatch
     #
     #   Valid Values: `breaching | notBreaching | ignore | missing`
     #
+    #   <note markdown="1"> Alarms that evaluate metrics in the `AWS/DynamoDB` namespace always
+    #   `ignore` missing data even if you choose a different option for
+    #   `TreatMissingData`. When an `AWS/DynamoDB` metric has missing data,
+    #   alarms that evaluate that metric remain in their current state.
+    #
+    #    </note>
+    #
     #
     #
     #   [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/AlarmThatSendsEmail.html#alarms-and-missing-data

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

@@ -205,13 +205,60 @@ module Aws::CloudWatch
     #   @return [String]
     #
     # @!attribute [rw] state_updated_timestamp
-    #   The time stamp of the last update to the alarm state.
+    #   Tracks the timestamp of any state update, even if `StateValue`
+    #   doesn't change.
     #   @return [Time]
     #
     # @!attribute [rw] state_value
     #   The state value for the alarm.
     #   @return [String]
     #
+    # @!attribute [rw] state_transitioned_timestamp
+    #   The timestamp of the last change to the alarm's `StateValue`.
+    #   @return [Time]
+    #
+    # @!attribute [rw] actions_suppressed_by
+    #   When the value is `ALARM`, it means that the actions are suppressed
+    #   because the suppressor alarm is in `ALARM` When the value is
+    #   `WaitPeriod`, it means that the actions are suppressed because the
+    #   composite alarm is waiting for the suppressor alarm to go into into
+    #   the `ALARM` state. The maximum waiting time is as specified in
+    #   `ActionsSuppressorWaitPeriod`. After this time, the composite alarm
+    #   performs its actions. When the value is `ExtensionPeriod`, it means
+    #   that the actions are suppressed because the composite alarm is
+    #   waiting after the suppressor alarm went out of the `ALARM` state.
+    #   The maximum waiting time is as specified in
+    #   `ActionsSuppressorExtensionPeriod`. After this time, the composite
+    #   alarm performs its actions.
+    #   @return [String]
+    #
+    # @!attribute [rw] actions_suppressed_reason
+    #   Captures the reason for action suppression.
+    #   @return [String]
+    #
+    # @!attribute [rw] actions_suppressor
+    #   Actions will be suppressed if the suppressor alarm is in the `ALARM`
+    #   state. `ActionsSuppressor` can be an AlarmName or an Amazon Resource
+    #   Name (ARN) from an existing alarm.
+    #   @return [String]
+    #
+    # @!attribute [rw] actions_suppressor_wait_period
+    #   The maximum time in seconds that the composite alarm waits for the
+    #   suppressor alarm to go into the `ALARM` state. After this time, the
+    #   composite alarm performs its actions.
+    #
+    #   `WaitPeriod` is required only when `ActionsSuppressor` is specified.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] actions_suppressor_extension_period
+    #   The maximum time in seconds that the composite alarm waits after
+    #   suppressor alarm goes out of the `ALARM` state. After this time, the
+    #   composite alarm performs its actions.
+    #
+    #   `ExtensionPeriod` is required only when `ActionsSuppressor` is
+    #   specified.
+    #   @return [Integer]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/CompositeAlarm AWS API Documentation
     #
     class CompositeAlarm < Struct.new(
@@ -227,7 +274,13 @@ module Aws::CloudWatch
       :state_reason,
       :state_reason_data,
       :state_updated_timestamp,
-      :state_value)
+      :state_value,
+      :state_transitioned_timestamp,
+      :actions_suppressed_by,
+      :actions_suppressed_reason,
+      :actions_suppressor,
+      :actions_suppressor_wait_period,
+      :actions_suppressor_extension_period)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -1031,10 +1084,13 @@ module Aws::CloudWatch
     end
 
     # A dimension is a name/value pair that is part of the identity of a
-    # metric. You can assign up to 10 dimensions to a metric. Because
-    # dimensions are part of the unique identifier for a metric, whenever
-    # you add a unique name/value pair to one of your metrics, you are
-    # creating a new variation of that metric.
+    # metric. Because dimensions are part of the unique identifier for a
+    # metric, whenever you add a unique name/value pair to one of your
+    # metrics, you are creating a new variation of that metric. For example,
+    # many Amazon EC2 metrics publish `InstanceId` as a dimension name, and
+    # the actual instance ID as the value for that dimension.
+    #
+    # You can assign up to 10 dimensions to a metric.
     #
     # @note When making an API call, you may pass Dimension
     #   data as a hash:
@@ -1046,7 +1102,8 @@ module Aws::CloudWatch
     #
     # @!attribute [rw] name
     #   The name of the dimension. Dimension names must contain only ASCII
-    #   characters and must include at least one non-whitespace character.
+    #   characters, must include at least one non-whitespace character, and
+    #   cannot start with a colon (`:`).
     #   @return [String]
     #
     # @!attribute [rw] value
@@ -1429,8 +1486,8 @@ module Aws::CloudWatch
     # @!attribute [rw] metric_data_queries
     #   The metric queries to be returned. A single `GetMetricData` call can
     #   include as many as 500 `MetricDataQuery` structures. Each of these
-    #   structures can specify either a metric to retrieve, or a math
-    #   expression to perform on retrieved data.
+    #   structures can specify either a metric to retrieve, a Metrics
+    #   Insights query, or a math expression to perform on retrieved data.
     #   @return [Array<Types::MetricDataQuery>]
     #
     # @!attribute [rw] start_time
@@ -1784,8 +1841,26 @@ module Aws::CloudWatch
     #   @return [Time]
     #
     # @!attribute [rw] output_format
+    #   The output format for the stream. Valid values are `json` and
+    #   `opentelemetry0.7`. For more information about metric stream output
+    #   formats, see [ Metric streams output formats][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-metric-streams-formats.html
     #   @return [String]
     #
+    # @!attribute [rw] statistics_configurations
+    #   Each entry in this array displays information about one or more
+    #   metrics that include additional statistics in the metric stream. For
+    #   more information about the additional statistics, see [ CloudWatch
+    #   statistics definitions][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/Statistics-definitions.html.html
+    #   @return [Array<Types::MetricStreamStatisticsConfiguration>]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/GetMetricStreamOutput AWS API Documentation
     #
     class GetMetricStreamOutput < Struct.new(
@@ -1798,7 +1873,8 @@ module Aws::CloudWatch
       :state,
       :creation_date,
       :last_update_date,
-      :output_format)
+      :output_format,
+      :statistics_configurations)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -2592,8 +2668,17 @@ module Aws::CloudWatch
     #   @return [String]
     #
     # @!attribute [rw] treat_missing_data
-    #   Sets how this alarm is to handle missing data points. If this
-    #   parameter is omitted, the default behavior of `missing` is used.
+    #   Sets how this alarm is to handle missing data points. The valid
+    #   values are `breaching`, `notBreaching`, `ignore`, and `missing`. For
+    #   more information, see [Configuring how CloudWatch alarms treat
+    #   missing data][1].
+    #
+    #   If this parameter is omitted, the default behavior of `missing` is
+    #   used.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/AlarmThatSendsEmail.html#alarms-and-missing-data
     #   @return [String]
     #
     # @!attribute [rw] evaluate_low_sample_count_percentile
@@ -2658,9 +2743,9 @@ module Aws::CloudWatch
     #
     # When used in `GetMetricData`, it indicates the metric data to return,
     # and whether this call is just retrieving a batch set of data for one
-    # metric, or is performing a math expression on metric data. A single
-    # `GetMetricData` call can include up to 500 `MetricDataQuery`
-    # structures.
+    # metric, or is performing a Metrics Insights query or a math
+    # expression. A single `GetMetricData` call can include up to 500
+    # `MetricDataQuery` structures.
     #
     # When used in `PutMetricAlarm`, it enables you to create an alarm based
     # on a metric math expression. Each `MetricDataQuery` in the array
@@ -2733,20 +2818,25 @@ module Aws::CloudWatch
     #   @return [Types::MetricStat]
     #
     # @!attribute [rw] expression
-    #   The math expression to be performed on the returned data, if this
-    #   object is performing a math expression. This expression can use the
-    #   `Id` of the other metrics to refer to those metrics, and can also
-    #   use the `Id` of other expressions to use the result of those
-    #   expressions. For more information about metric math expressions, see
-    #   [Metric Math Syntax and Functions][1] in the *Amazon CloudWatch User
+    #   This field can contain either a Metrics Insights query, or a metric
+    #   math expression to be performed on the returned data. For more
+    #   information about Metrics Insights queries, see [Metrics Insights
+    #   query components and syntax][1] in the *Amazon CloudWatch User
     #   Guide*.
     #
+    #   A math expression can use the `Id` of the other metrics or queries
+    #   to refer to those metrics, and can also use the `Id` of other
+    #   expressions to use the result of those expressions. For more
+    #   information about metric math expressions, see [Metric Math Syntax
+    #   and Functions][2] in the *Amazon CloudWatch User Guide*.
+    #
     #   Within each MetricDataQuery object, you must specify either
     #   `Expression` or `MetricStat` but not both.
     #
     #
     #
-    #   [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/using-metric-math.html#metric-math-syntax
+    #   [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch-metrics-insights-querylanguage
+    #   [2]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/using-metric-math.html#metric-math-syntax
     #   @return [String]
     #
     # @!attribute [rw] label
@@ -3188,6 +3278,96 @@ module Aws::CloudWatch
       include Aws::Structure
     end
 
+    # By default, a metric stream always sends the `MAX`, `MIN`, `SUM`, and
+    # `SAMPLECOUNT` statistics for each metric that is streamed. This
+    # structure contains information for one metric that includes additional
+    # statistics in the stream. For more information about statistics, see
+    # CloudWatch, listed in [ CloudWatch statistics definitions][1].
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/Statistics-definitions.html.html
+    #
+    # @note When making an API call, you may pass MetricStreamStatisticsConfiguration
+    #   data as a hash:
+    #
+    #       {
+    #         include_metrics: [ # required
+    #           {
+    #             namespace: "Namespace", # required
+    #             metric_name: "MetricName", # required
+    #           },
+    #         ],
+    #         additional_statistics: ["MetricStreamStatistic"], # required
+    #       }
+    #
+    # @!attribute [rw] include_metrics
+    #   An array of metric name and namespace pairs that stream the
+    #   additional statistics listed in the value of the
+    #   `AdditionalStatistics` parameter. There can be as many as 100 pairs
+    #   in the array.
+    #
+    #   All metrics that match the combination of metric name and namespace
+    #   will be streamed with the additional statistics, no matter their
+    #   dimensions.
+    #   @return [Array<Types::MetricStreamStatisticsMetric>]
+    #
+    # @!attribute [rw] additional_statistics
+    #   The list of additional statistics that are to be streamed for the
+    #   metrics listed in the `IncludeMetrics` array in this structure. This
+    #   list can include as many as 20 statistics.
+    #
+    #   If the `OutputFormat` for the stream is `opentelemetry0.7`, the only
+    #   valid values are `p?? ` percentile statistics such as `p90`, `p99`
+    #   and so on.
+    #
+    #   If the `OutputFormat` for the stream is `json`, the valid values
+    #   include the abbreviations for all of the statistics listed in [
+    #   CloudWatch statistics definitions][1]. For example, this includes
+    #   `tm98, ` `wm90`, `PR(:300)`, and so on.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/Statistics-definitions.html.html
+    #   @return [Array<String>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/MetricStreamStatisticsConfiguration AWS API Documentation
+    #
+    class MetricStreamStatisticsConfiguration < Struct.new(
+      :include_metrics,
+      :additional_statistics)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # This object contains the information for one metric that is to be
+    # streamed with additional statistics.
+    #
+    # @note When making an API call, you may pass MetricStreamStatisticsMetric
+    #   data as a hash:
+    #
+    #       {
+    #         namespace: "Namespace", # required
+    #         metric_name: "MetricName", # required
+    #       }
+    #
+    # @!attribute [rw] namespace
+    #   The namespace of the metric.
+    #   @return [String]
+    #
+    # @!attribute [rw] metric_name
+    #   The name of the metric.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/MetricStreamStatisticsMetric AWS API Documentation
+    #
+    class MetricStreamStatisticsMetric < Struct.new(
+      :namespace,
+      :metric_name)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # An input parameter that is required is missing.
     #
     # @!attribute [rw] message
@@ -3398,6 +3578,9 @@ module Aws::CloudWatch
     #             value: "TagValue", # required
     #           },
     #         ],
+    #         actions_suppressor: "AlarmArn",
+    #         actions_suppressor_wait_period: 1,
+    #         actions_suppressor_extension_period: 1,
     #       }
     #
     # @!attribute [rw] actions_enabled
@@ -3508,6 +3691,29 @@ module Aws::CloudWatch
     #   values.
     #   @return [Array<Types::Tag>]
     #
+    # @!attribute [rw] actions_suppressor
+    #   Actions will be suppressed if the suppressor alarm is in the `ALARM`
+    #   state. `ActionsSuppressor` can be an AlarmName or an Amazon Resource
+    #   Name (ARN) from an existing alarm.
+    #   @return [String]
+    #
+    # @!attribute [rw] actions_suppressor_wait_period
+    #   The maximum time in seconds that the composite alarm waits for the
+    #   suppressor alarm to go into the `ALARM` state. After this time, the
+    #   composite alarm performs its actions.
+    #
+    #   `WaitPeriod` is required only when `ActionsSuppressor` is specified.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] actions_suppressor_extension_period
+    #   The maximum time in seconds that the composite alarm waits after
+    #   suppressor alarm goes out of the `ALARM` state. After this time, the
+    #   composite alarm performs its actions.
+    #
+    #   `ExtensionPeriod` is required only when `ActionsSuppressor` is
+    #   specified.
+    #   @return [Integer]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/PutCompositeAlarmInput AWS API Documentation
     #
     class PutCompositeAlarmInput < Struct.new(
@@ -3518,7 +3724,10 @@ module Aws::CloudWatch
       :alarm_rule,
       :insufficient_data_actions,
       :ok_actions,
-      :tags)
+      :tags,
+      :actions_suppressor,
+      :actions_suppressor_wait_period,
+      :actions_suppressor_extension_period)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -3929,6 +4138,13 @@ module Aws::CloudWatch
     #
     #   Valid Values: `breaching | notBreaching | ignore | missing`
     #
+    #   <note markdown="1"> Alarms that evaluate metrics in the `AWS/DynamoDB` namespace always
+    #   `ignore` missing data even if you choose a different option for
+    #   `TreatMissingData`. When an `AWS/DynamoDB` metric has missing data,
+    #   alarms that evaluate that metric remain in their current state.
+    #
+    #    </note>
+    #
     #
     #
     #   [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/AlarmThatSendsEmail.html#alarms-and-missing-data
@@ -4109,6 +4325,17 @@ module Aws::CloudWatch
     #             value: "TagValue", # required
     #           },
     #         ],
+    #         statistics_configurations: [
+    #           {
+    #             include_metrics: [ # required
+    #               {
+    #                 namespace: "Namespace", # required
+    #                 metric_name: "MetricName", # required
+    #               },
+    #             ],
+    #             additional_statistics: ["MetricStreamStatistic"], # required
+    #           },
+    #         ],
     #       }
     #
     # @!attribute [rw] name
@@ -4187,6 +4414,27 @@ module Aws::CloudWatch
     #   [2]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_UntagResource.html
     #   @return [Array<Types::Tag>]
     #
+    # @!attribute [rw] statistics_configurations
+    #   By default, a metric stream always sends the `MAX`, `MIN`, `SUM`,
+    #   and `SAMPLECOUNT` statistics for each metric that is streamed. You
+    #   can use this parameter to have the metric stream also send
+    #   additional statistics in the stream. This array can have up to 100
+    #   members.
+    #
+    #   For each entry in this array, you specify one or more metrics and
+    #   the list of additional statistics to stream for those metrics. The
+    #   additional statistics that you can stream depend on the stream's
+    #   `OutputFormat`. If the `OutputFormat` is `json`, you can stream any
+    #   additional statistic that is supported by CloudWatch, listed in [
+    #   CloudWatch statistics definitions][1]. If the `OutputFormat` is
+    #   `opentelemetry0.7`, you can stream percentile statistics such as
+    #   p95, p99.9 and so on.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/Statistics-definitions.html.html
+    #   @return [Array<Types::MetricStreamStatisticsConfiguration>]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/PutMetricStreamInput AWS API Documentation
     #
     class PutMetricStreamInput < Struct.new(
@@ -4196,7 +4444,8 @@ module Aws::CloudWatch
       :firehose_arn,
       :role_arn,
       :output_format,
-      :tags)
+      :tags,
+      :statistics_configurations)
       SENSITIVE = []
       include Aws::Structure
     end

data/lib/aws-sdk-cloudwatch.rb

@@ -52,6 +52,6 @@ require_relative 'aws-sdk-cloudwatch/customizations'
 # @!group service
 module Aws::CloudWatch
 
-  GEM_VERSION = '1.62.0'
+  GEM_VERSION = '1.65.0'
 
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-cloudwatch
 version: !ruby/object:Gem::Version
-  version: 1.62.0
+  version: 1.65.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-02-24 00:00:00.000000000 Z
+date: 2022-07-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core