aws-sdk-cloudwatch 1.62.0 → 1.63.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: aa99c1cc7e908a774e6363a61d5f084eba01f18269abfe6340fcf6951823be5f
-  data.tar.gz: 19e9f0f56b820e461897d3da75b1054ccb0dd40c786ac0f09a1ce47d4103abaa
+  metadata.gz: 8700346d69df22798982a45c12299f596cb8b9d20e0a6bd5c877182748f3295a
+  data.tar.gz: fdc16e10869b1f84c67dd3f0f4d270487547b7afdb47847ed3571b46842a8e19
 SHA512:
-  metadata.gz: ab62c320a5d033615cba83d38b515e31d34e936f9cc2feaa5f5a4eaf7351a151aac775f86e91c1167a8c68b6fed4574294b5944406645d5b106cabb1dc59c68d
-  data.tar.gz: 8db916b883dd838ffe61d0fe8789a8f9901972c1ee8aca4d9c7078a97e39267ab204f9b71770e5a62daaff9d8201a3ec80847db25241cd4a625423b925252676
+  metadata.gz: 80c6f183c2fdbab2f176c2d6eb3d862c7943ceafbad4e2b84c0af71009fbf47f6f6ae379c0d700248f57f22a81e9016e4a13cc310f1b1c66020be8af1a765386
+  data.tar.gz: edfd3e9952ed03e71c8db8d099a79fed3bb8dd32e554bdabc53337a76e8660312b9c444065a67f38a854a0a224667a78aff7d2df4ddb239cf303683dc4c178b1

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+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.63.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

@@ -1444,19 +1444,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 +1501,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 +1896,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 +1918,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 +2401,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
@@ -3207,6 +3241,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 extended statistics in the stream. Streaming extended
+    # 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 +3255,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 +3324,24 @@ 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 extended 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 extended statistics to stream for those metrics. The extended
+    #   statistics that you can stream depend on the stream's `OutputFormat`.
+    #   If the `OutputFormat` is `json`, you can stream any extended statistic
+    #   that is supported by CloudWatch, listed in [ CloudWatch statistics
+    #   definitions][1]. If the `OutputFormat` is `opentelemetry0.7`, you can
+    #   stream percentile statistics (p*??*).
+    #
+    #
+    #
+    #   [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 +3369,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 +3625,7 @@ module Aws::CloudWatch
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-cloudwatch'
-      context[:gem_version] = '1.62.0'
+      context[:gem_version] = '1.63.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -193,6 +193,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')
@@ -542,6 +548,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 +758,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"))
@@ -833,6 +854,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/types.rb

@@ -1031,10 +1031,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 +1049,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 +1433,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 +1788,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 extended statistics in the metric stream. For
+    #   more information about extended 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 +1820,8 @@ module Aws::CloudWatch
       :state,
       :creation_date,
       :last_update_date,
-      :output_format)
+      :output_format,
+      :statistics_configurations)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -2592,8 +2615,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 +2690,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 +2765,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 +3225,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 extended
+    # statistics in the stream. For more information about extended
+    # 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 extended
+    #   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 extended statistics, no matter their
+    #   dimensions.
+    #   @return [Array<Types::MetricStreamStatisticsMetric>]
+    #
+    # @!attribute [rw] additional_statistics
+    #   The list of extended 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 are
+    #   include the abbreviations for all of the extended 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
+    # streamed with extended 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 metric namespace for 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
@@ -4109,6 +4236,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 +4325,25 @@ 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 extended
+    #   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 extended statistics to stream for those metrics. The
+    #   extended statistics that you can stream depend on the stream's
+    #   `OutputFormat`. If the `OutputFormat` is `json`, you can stream any
+    #   extended statistic that is supported by CloudWatch, listed in [
+    #   CloudWatch statistics definitions][1]. If the `OutputFormat` is
+    #   `opentelemetry0.7`, you can stream percentile statistics (p*??*).
+    #
+    #
+    #
+    #   [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 +4353,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.63.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.63.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-02-24 00:00:00.000000000 Z
+date: 2022-04-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core