aws-sdk-cloudwatch 1.41.0 → 1.42.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 555cc3f54befa566ff23f4e717bfdcfebfadcef73c3f7fdc621dff94a9865ab0
-  data.tar.gz: c4b914f004862803b2a2c73e49f1ce0e39d57966a0c0a6394396ad3399f4f9cd
+  metadata.gz: b2e13bb14c0f93943bf34ddb2339a3b5849c93e4d15da5ab298158fd587e2a07
+  data.tar.gz: 102fd2ca487d29f9bb0f54fb24182a0f6ac8617e0f17ae9d8e3b00695a465bce
 SHA512:
-  metadata.gz: 4f64c22479fad53948338202d23a69cf070fd3294ce4e1ae2cdc891862cada042ac66e47b0156675512ca285f676af12fac1db767ba9255c88a29dfea7558de5
-  data.tar.gz: 2216519d2d4a582fff7d651dfc60896f7ec3c2c331acbe7028dad96e49b493a85cb9f02e9fefb49703657a2643604c450129a66cec86193a820a438d66b303d2
+  metadata.gz: 35ac2a9d2a1bc9102ce7ea866e48d91eee7d1cd52723619decdb9c2a97f69d9ce73b64f1f0cb01e12adee1264fd8d244c99f4ca355005ecf4b8fd680c2df3690
+  data.tar.gz: 6796036aaceca780b0675122cf729bbfed1dc9c057dde3205b15d0e0d657d36ecc2ca97da28420a7cadd2eb57495df1864da15cd8580c2457876ba65e6779fb9

data/lib/aws-sdk-cloudwatch.rb

@@ -51,6 +51,6 @@ require_relative 'aws-sdk-cloudwatch/customizations'
 # @service
 module Aws::CloudWatch
 
-  GEM_VERSION = '1.41.0'
+  GEM_VERSION = '1.42.0'
 
 end

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

@@ -398,7 +398,7 @@ module Aws::CloudWatch
       req.send_request(options)
     end
 
-    # Deletes all dashboards that you specify. You may specify up to 100
+    # Deletes all dashboards that you specify. You can specify up to 100
     # dashboards to delete. If there is an error during this call, no
     # dashboards are deleted.
     #
@@ -425,8 +425,8 @@ module Aws::CloudWatch
     # Permanently deletes the specified Contributor Insights rules.
     #
     # If you create a rule, delete it, and then re-create it with the same
-    # name, historical data from the first time the rule was created may or
-    # may not be available.
+    # name, historical data from the first time the rule was created might
+    # not be available.
     #
     # @option params [required, Array<String>] :rule_names
     #   An array of the rule names to delete. If you need to find out the
@@ -570,7 +570,7 @@ module Aws::CloudWatch
     #
     #   If you specify `ChildrenOfAlarmName`, you cannot specify any other
     #   parameters in the request except for `MaxRecords` and `NextToken`. If
-    #   you do so, you will receive a validation error.
+    #   you do so, you receive a validation error.
     #
     #   <note markdown="1"> Only the `Alarm Name`, `ARN`, `StateValue`
     #   (OK/ALARM/INSUFFICIENT\_DATA), and `StateUpdatedTimestamp` information
@@ -591,7 +591,7 @@ module Aws::CloudWatch
     #
     #   If you specify `ParentsOfAlarmName`, you cannot specify any other
     #   parameters in the request except for `MaxRecords` and `NextToken`. If
-    #   you do so, you will receive a validation error.
+    #   you do so, you receive a validation error.
     #
     #   <note markdown="1"> Only the Alarm Name and ARN are returned by this operation when you
     #   use this parameter. To get complete information about these alarms,
@@ -920,7 +920,7 @@ module Aws::CloudWatch
     #
     # @option params [Integer] :max_results
     #   This parameter is not currently used. Reserved for future use. If it
-    #   is used in the future, the maximum value may be different.
+    #   is used in the future, the maximum value might be different.
     #
     # @return [Types::DescribeInsightRulesOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -1123,8 +1123,8 @@ module Aws::CloudWatch
     #   data point.
     #
     # * `MaxContributorValue` -- the value of the top contributor for each
-    #   data point. The identity of the contributor may change for each data
-    #   point in the graph.
+    #   data point. The identity of the contributor might change for each
+    #   data point in the graph.
     #
     #   If this rule aggregates by COUNT, the top contributor for each data
     #   point is the contributor with the most occurrences in that period.
@@ -1175,8 +1175,8 @@ module Aws::CloudWatch
     #     data point.
     #
     #   * `MaxContributorValue` -- the value of the top contributor for each
-    #     data point. The identity of the contributor may change for each data
-    #     point in the graph.
+    #     data point. The identity of the contributor might change for each
+    #     data point in the graph.
     #
     #     If this rule aggregates by COUNT, the top contributor for each data
     #     point is the contributor with the most occurrences in that period.
@@ -1297,10 +1297,10 @@ module Aws::CloudWatch
     # If you omit `Unit` in your request, all data that was collected with
     # any unit is returned, along with the corresponding units that were
     # specified when the data was reported to CloudWatch. If you specify a
-    # unit, the operation returns only data data that was collected with
-    # that unit specified. If you specify a unit that does not match the
-    # data collected, the results of the operation are null. CloudWatch does
-    # not perform unit conversions.
+    # unit, the operation returns only data that was collected with that
+    # unit specified. If you specify a unit that does not match the data
+    # collected, the results of the operation are null. CloudWatch does not
+    # perform unit conversions.
     #
     #
     #
@@ -1606,10 +1606,10 @@ module Aws::CloudWatch
     #   The unit for a given metric. If you omit `Unit`, all data that was
     #   collected with any unit is returned, along with the corresponding
     #   units that were specified when the data was reported to CloudWatch. If
-    #   you specify a unit, the operation returns only data data that was
-    #   collected with that unit specified. If you specify a unit that does
-    #   not match the data collected, the results of the operation are null.
-    #   CloudWatch does not perform unit conversions.
+    #   you specify a unit, the operation returns only data that was collected
+    #   with that unit specified. If you specify a unit that does not match
+    #   the data collected, the results of the operation are null. CloudWatch
+    #   does not perform unit conversions.
     #
     # @return [Types::GetMetricStatisticsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -1808,9 +1808,13 @@ module Aws::CloudWatch
     # Up to 500 results are returned for any one call. To retrieve
     # additional results, use the returned token with subsequent calls.
     #
-    # After you create a metric, allow up to fifteen minutes before the
-    # metric appears. Statistics about the metric, however, are available
-    # sooner using [GetMetricData][1] or [GetMetricStatistics][2].
+    # After you create a metric, allow up to 15 minutes before the metric
+    # appears. You can see statistics about the metric sooner by using
+    # [GetMetricData][1] or [GetMetricStatistics][2].
+    #
+    # `ListMetrics` doesn't return information about metrics if those
+    # metrics haven't reported data in the past two weeks. To retrieve
+    # those metrics, use [GetMetricData][1] or [GetMetricStatistics][2].
     #
     #
     #
@@ -1830,6 +1834,16 @@ module Aws::CloudWatch
     #   The token returned by a previous call to indicate that there is more
     #   data available.
     #
+    # @option params [String] :recently_active
+    #   To filter the results to show only metrics that have had data points
+    #   published in the past three hours, specify this parameter with a value
+    #   of `PT3H`. This is the only valid value for this parameter.
+    #
+    #   The results that are returned are an approximation of the value you
+    #   specify. There is a low probability that the returned results include
+    #   metrics with last published data as much as 40 minutes more than the
+    #   specified time interval.
+    #
     # @return [Types::ListMetricsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::ListMetricsOutput#metrics #metrics} => Array&lt;Types::Metric&gt;
@@ -1849,6 +1863,7 @@ module Aws::CloudWatch
     #       },
     #     ],
     #     next_token: "NextToken",
+    #     recently_active: "PT3H", # accepts PT3H
     #   })
     #
     # @example Response structure
@@ -1882,7 +1897,7 @@ module Aws::CloudWatch
     #   The ARN format of a Contributor Insights rule is
     #   `arn:aws:cloudwatch:Region:account-id:insight-rule:insight-rule-name `
     #
-    #   For more information on ARN format, see [ Resource Types Defined by
+    #   For more information about ARN format, see [ Resource Types Defined by
     #   Amazon CloudWatch][1] in the *Amazon Web Services General Reference*.
     #
     #
@@ -2041,8 +2056,8 @@ module Aws::CloudWatch
     #   The description for the composite alarm.
     #
     # @option params [required, String] :alarm_name
-    #   The name for the composite alarm. This name must be unique within your
-    #   AWS account.
+    #   The name for the composite alarm. This name must be unique within the
+    #   Region.
     #
     # @option params [required, String] :alarm_rule
     #   An expression that specifies which other alarms are to be evaluated to
@@ -2225,8 +2240,8 @@ module Aws::CloudWatch
     # Contributor Insights to Analyze High-Cardinality Data][1].
     #
     # If you create a rule, delete it, and then re-create it with the same
-    # name, historical data from the first time the rule was created may or
-    # may not be available.
+    # name, historical data from the first time the rule was created might
+    # not be available.
     #
     #
     #
@@ -2345,8 +2360,7 @@ module Aws::CloudWatch
     # [1]: https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_terms-and-concepts.html#iam-term-service-linked-role
     #
     # @option params [required, String] :alarm_name
-    #   The name for the alarm. This name must be unique within your AWS
-    #   account.
+    #   The name for the alarm. This name must be unique within the Region.
     #
     # @option params [String] :alarm_description
     #   The description for the alarm.
@@ -2458,8 +2472,8 @@ module Aws::CloudWatch
     #   resolution, the alarm still attempts to gather data at the period rate
     #   that you specify. In this case, it does not receive data for the
     #   attempts that do not correspond to a one-minute data resolution, and
-    #   the alarm may often lapse into INSUFFICENT\_DATA status. Specifying 10
-    #   or 30 also sets this alarm as a high-resolution alarm, which has a
+    #   the alarm might often lapse into INSUFFICENT\_DATA status. Specifying
+    #   10 or 30 also sets this alarm as a high-resolution alarm, which has a
     #   higher charge than other alarms. For more information about pricing,
     #   see [Amazon CloudWatch Pricing][1].
     #
@@ -2481,12 +2495,12 @@ module Aws::CloudWatch
     #
     #   If you don't specify `Unit`, CloudWatch retrieves all unit types that
     #   have been published for the metric and attempts to evaluate the alarm.
-    #   Usually metrics are published with only one unit, so the alarm will
-    #   work as intended.
+    #   Usually, metrics are published with only one unit, so the alarm works
+    #   as intended.
     #
     #   However, if the metric is published with multiple types of units and
-    #   you don't specify a unit, the alarm's behavior is not defined and
-    #   will behave un-predictably.
+    #   you don't specify a unit, the alarm's behavior is not defined and it
+    #   behaves predictably.
     #
     #   We recommend omitting `Unit` so that you don't inadvertently specify
     #   an incorrect unit that is not published for this metric. Doing so
@@ -2584,7 +2598,7 @@ module Aws::CloudWatch
     #   associate as many as 50 tags with an alarm.
     #
     #   Tags can help you organize and categorize your resources. You can also
-    #   use them to scope user permissions, by granting a user permission to
+    #   use them to scope user permissions by granting a user permission to
     #   access or change only resources with certain tag values.
     #
     # @option params [String] :threshold_metric_id
@@ -2783,9 +2797,9 @@ module Aws::CloudWatch
     # CloudWatch console or through [DescribeAlarmHistory][1].
     #
     # If you use `SetAlarmState` on a composite alarm, the composite alarm
-    # is not guaranteed to return to its actual state. It will return to its
+    # is not guaranteed to return to its actual state. It returns to its
     # actual state only once any of its children alarms change state. It is
-    # also re-evaluated if you update its configuration.
+    # also reevaluated if you update its configuration.
     #
     # If an alarm triggers EC2 Auto Scaling policies or application Auto
     # Scaling policies, you must include information in the
@@ -2797,8 +2811,7 @@ module Aws::CloudWatch
     # [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_DescribeAlarmHistory.html
     #
     # @option params [required, String] :alarm_name
-    #   The name for the alarm. This name must be unique within the AWS
-    #   account. The maximum length is 255 characters.
+    #   The name of the alarm.
     #
     # @option params [required, String] :state_value
     #   The value of the state.
@@ -2841,7 +2854,7 @@ module Aws::CloudWatch
     # are alarms and Contributor Insights rules.
     #
     # Tags can help you organize and categorize your resources. You can also
-    # use them to scope user permissions, by granting a user permission to
+    # use them to scope user permissions by granting a user permission to
     # access or change only resources with certain tag values.
     #
     # Tags don't have any semantic meaning to AWS and are interpreted
@@ -2864,7 +2877,7 @@ module Aws::CloudWatch
     #   The ARN format of a Contributor Insights rule is
     #   `arn:aws:cloudwatch:Region:account-id:insight-rule:insight-rule-name `
     #
-    #   For more information on ARN format, see [ Resource Types Defined by
+    #   For more information about ARN format, see [ Resource Types Defined by
     #   Amazon CloudWatch][1] in the *Amazon Web Services General Reference*.
     #
     #
@@ -2908,7 +2921,7 @@ module Aws::CloudWatch
     #   The ARN format of a Contributor Insights rule is
     #   `arn:aws:cloudwatch:Region:account-id:insight-rule:insight-rule-name `
     #
-    #   For more information on ARN format, see [ Resource Types Defined by
+    #   For more information about ARN format, see [ Resource Types Defined by
     #   Amazon CloudWatch][1] in the *Amazon Web Services General Reference*.
     #
     #
@@ -2949,7 +2962,7 @@ module Aws::CloudWatch
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-cloudwatch'
-      context[:gem_version] = '1.41.0'
+      context[:gem_version] = '1.42.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -191,6 +191,7 @@ module Aws::CloudWatch
     PutMetricAlarmInput = Shapes::StructureShape.new(name: 'PutMetricAlarmInput')
     PutMetricDataInput = Shapes::StructureShape.new(name: 'PutMetricDataInput')
     Range = Shapes::StructureShape.new(name: 'Range')
+    RecentlyActive = Shapes::StringShape.new(name: 'RecentlyActive')
     ResourceId = Shapes::StringShape.new(name: 'ResourceId')
     ResourceList = Shapes::ListShape.new(name: 'ResourceList')
     ResourceName = Shapes::StringShape.new(name: 'ResourceName')
@@ -567,6 +568,7 @@ module Aws::CloudWatch
     ListMetricsInput.add_member(:metric_name, Shapes::ShapeRef.new(shape: MetricName, location_name: "MetricName"))
     ListMetricsInput.add_member(:dimensions, Shapes::ShapeRef.new(shape: DimensionFilters, location_name: "Dimensions"))
     ListMetricsInput.add_member(:next_token, Shapes::ShapeRef.new(shape: NextToken, location_name: "NextToken"))
+    ListMetricsInput.add_member(:recently_active, Shapes::ShapeRef.new(shape: RecentlyActive, location_name: "RecentlyActive"))
     ListMetricsInput.struct_class = Types::ListMetricsInput
 
     ListMetricsOutput.add_member(:metrics, Shapes::ShapeRef.new(shape: Metrics, location_name: "Metrics"))

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

@@ -290,10 +290,10 @@ module Aws::CloudWatch
     #   The unit for a given metric. If you omit `Unit`, all data that was
     #   collected with any unit is returned, along with the corresponding
     #   units that were specified when the data was reported to CloudWatch. If
-    #   you specify a unit, the operation returns only data data that was
-    #   collected with that unit specified. If you specify a unit that does
-    #   not match the data collected, the results of the operation are null.
-    #   CloudWatch does not perform unit conversions.
+    #   you specify a unit, the operation returns only data that was collected
+    #   with that unit specified. If you specify a unit that does not match
+    #   the data collected, the results of the operation are null. CloudWatch
+    #   does not perform unit conversions.
     # @return [Types::GetMetricStatisticsOutput]
     def get_statistics(options = {})
       options = options.merge(
@@ -363,8 +363,7 @@ module Aws::CloudWatch
     #   })
     # @param [Hash] options ({})
     # @option options [required, String] :alarm_name
-    #   The name for the alarm. This name must be unique within your AWS
-    #   account.
+    #   The name for the alarm. This name must be unique within the Region.
     # @option options [String] :alarm_description
     #   The description for the alarm.
     # @option options [Boolean] :actions_enabled
@@ -454,8 +453,8 @@ module Aws::CloudWatch
     #   resolution, the alarm still attempts to gather data at the period rate
     #   that you specify. In this case, it does not receive data for the
     #   attempts that do not correspond to a one-minute data resolution, and
-    #   the alarm may often lapse into INSUFFICENT\_DATA status. Specifying 10
-    #   or 30 also sets this alarm as a high-resolution alarm, which has a
+    #   the alarm might often lapse into INSUFFICENT\_DATA status. Specifying
+    #   10 or 30 also sets this alarm as a high-resolution alarm, which has a
     #   higher charge than other alarms. For more information about pricing,
     #   see [Amazon CloudWatch Pricing][1].
     #
@@ -476,12 +475,12 @@ module Aws::CloudWatch
     #
     #   If you don't specify `Unit`, CloudWatch retrieves all unit types that
     #   have been published for the metric and attempts to evaluate the alarm.
-    #   Usually metrics are published with only one unit, so the alarm will
-    #   work as intended.
+    #   Usually, metrics are published with only one unit, so the alarm works
+    #   as intended.
     #
     #   However, if the metric is published with multiple types of units and
-    #   you don't specify a unit, the alarm's behavior is not defined and
-    #   will behave un-predictably.
+    #   you don't specify a unit, the alarm's behavior is not defined and it
+    #   behaves predictably.
     #
     #   We recommend omitting `Unit` so that you don't inadvertently specify
     #   an incorrect unit that is not published for this metric. Doing so
@@ -571,7 +570,7 @@ module Aws::CloudWatch
     #   associate as many as 50 tags with an alarm.
     #
     #   Tags can help you organize and categorize your resources. You can also
-    #   use them to scope user permissions, by granting a user permission to
+    #   use them to scope user permissions by granting a user permission to
     #   access or change only resources with certain tag values.
     # @option options [String] :threshold_metric_id
     #   If this is an alarm based on an anomaly detection model, make this

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

@@ -78,7 +78,7 @@ module Aws::CloudWatch
     #
     #   If you specify `ChildrenOfAlarmName`, you cannot specify any other
     #   parameters in the request except for `MaxRecords` and `NextToken`. If
-    #   you do so, you will receive a validation error.
+    #   you do so, you receive a validation error.
     #
     #   <note markdown="1"> Only the `Alarm Name`, `ARN`, `StateValue`
     #   (OK/ALARM/INSUFFICIENT\_DATA), and `StateUpdatedTimestamp` information
@@ -98,7 +98,7 @@ module Aws::CloudWatch
     #
     #   If you specify `ParentsOfAlarmName`, you cannot specify any other
     #   parameters in the request except for `MaxRecords` and `NextToken`. If
-    #   you do so, you will receive a validation error.
+    #   you do so, you receive a validation error.
     #
     #   <note markdown="1"> Only the Alarm Name and ARN are returned by this operation when you
     #   use this parameter. To get complete information about these alarms,
@@ -176,7 +176,7 @@ module Aws::CloudWatch
     #
     #   If you specify `ChildrenOfAlarmName`, you cannot specify any other
     #   parameters in the request except for `MaxRecords` and `NextToken`. If
-    #   you do so, you will receive a validation error.
+    #   you do so, you receive a validation error.
     #
     #   <note markdown="1"> Only the `Alarm Name`, `ARN`, `StateValue`
     #   (OK/ALARM/INSUFFICIENT\_DATA), and `StateUpdatedTimestamp` information
@@ -196,7 +196,7 @@ module Aws::CloudWatch
     #
     #   If you specify `ParentsOfAlarmName`, you cannot specify any other
     #   parameters in the request except for `MaxRecords` and `NextToken`. If
-    #   you do so, you will receive a validation error.
+    #   you do so, you receive a validation error.
     #
     #   <note markdown="1"> Only the Alarm Name and ARN are returned by this operation when you
     #   use this parameter. To get complete information about these alarms,
@@ -253,6 +253,7 @@ module Aws::CloudWatch
     #         value: "DimensionValue",
     #       },
     #     ],
+    #     recently_active: "PT3H", # accepts PT3H
     #   })
     # @param [Hash] options ({})
     # @option options [String] :namespace
@@ -261,6 +262,15 @@ module Aws::CloudWatch
     #   The name of the metric to filter against.
     # @option options [Array<Types::DimensionFilter>] :dimensions
     #   The dimensions to filter against.
+    # @option options [String] :recently_active
+    #   To filter the results to show only metrics that have had data points
+    #   published in the past three hours, specify this parameter with a value
+    #   of `PT3H`. This is the only valid value for this parameter.
+    #
+    #   The results that are returned are an approximation of the value you
+    #   specify. There is a low probability that the returned results include
+    #   metrics with last published data as much as 40 minutes more than the
+    #   specified time interval.
     # @return [Metric::Collection]
     def metrics(options = {})
       batches = Enumerator.new do |y|

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

@@ -691,7 +691,7 @@ module Aws::CloudWatch
     #
     #   If you specify `ChildrenOfAlarmName`, you cannot specify any other
     #   parameters in the request except for `MaxRecords` and `NextToken`.
-    #   If you do so, you will receive a validation error.
+    #   If you do so, you receive a validation error.
     #
     #   <note markdown="1"> Only the `Alarm Name`, `ARN`, `StateValue`
     #   (OK/ALARM/INSUFFICIENT\_DATA), and `StateUpdatedTimestamp`
@@ -713,7 +713,7 @@ module Aws::CloudWatch
     #
     #   If you specify `ParentsOfAlarmName`, you cannot specify any other
     #   parameters in the request except for `MaxRecords` and `NextToken`.
-    #   If you do so, you will receive a validation error.
+    #   If you do so, you receive a validation error.
     #
     #   <note markdown="1"> Only the Alarm Name and ARN are returned by this operation when you
     #   use this parameter. To get complete information about these alarms,
@@ -876,7 +876,7 @@ module Aws::CloudWatch
     #
     # @!attribute [rw] max_results
     #   This parameter is not currently used. Reserved for future use. If it
-    #   is used in the future, the maximum value may be different.
+    #   is used in the future, the maximum value might be different.
     #   @return [Integer]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/DescribeInsightRulesInput AWS API Documentation
@@ -905,7 +905,11 @@ module Aws::CloudWatch
       include Aws::Structure
     end
 
-    # Expands the identity of a metric.
+    # 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.
     #
     # @note When making an API call, you may pass Dimension
     #   data as a hash:
@@ -916,11 +920,12 @@ module Aws::CloudWatch
     #       }
     #
     # @!attribute [rw] name
-    #   The name of the dimension.
+    #   The name of the dimension. Dimension names cannot contain blank
+    #   spaces or non-ASCII characters.
     #   @return [String]
     #
     # @!attribute [rw] value
-    #   The value representing the dimension measurement.
+    #   The value of the dimension.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/Dimension AWS API Documentation
@@ -1167,7 +1172,7 @@ module Aws::CloudWatch
     #     data point.
     #
     #   * `MaxContributorValue` -- the value of the top contributor for each
-    #     data point. The identity of the contributor may change for each
+    #     data point. The identity of the contributor might change for each
     #     data point in the graph.
     #
     #     If this rule aggregates by COUNT, the top contributor for each
@@ -1391,8 +1396,8 @@ module Aws::CloudWatch
     # @!attribute [rw] messages
     #   Contains a message about this `GetMetricData` operation, if the
     #   operation results in such a message. An example of a message that
-    #   may be returned is `Maximum number of allowed metrics exceeded`. If
-    #   there is a message, as much of the operation as possible is still
+    #   might be returned is `Maximum number of allowed metrics exceeded`.
+    #   If there is a message, as much of the operation as possible is still
     #   executed.
     #
     #   A message appears here only if it is related to the global
@@ -1539,7 +1544,7 @@ module Aws::CloudWatch
     #   The unit for a given metric. If you omit `Unit`, all data that was
     #   collected with any unit is returned, along with the corresponding
     #   units that were specified when the data was reported to CloudWatch.
-    #   If you specify a unit, the operation returns only data data that was
+    #   If you specify a unit, the operation returns only data that was
     #   collected with that unit specified. If you specify a unit that does
     #   not match the data collected, the results of the operation are null.
     #   CloudWatch does not perform unit conversions.
@@ -1648,7 +1653,8 @@ module Aws::CloudWatch
     end
 
     # @!attribute [rw] metric_widget_image
-    #   The image of the graph, in the output format specified.
+    #   The image of the graph, in the output format specified. The output
+    #   is base64-encoded.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/GetMetricWidgetImageOutput AWS API Documentation
@@ -1996,6 +2002,7 @@ module Aws::CloudWatch
     #           },
     #         ],
     #         next_token: "NextToken",
+    #         recently_active: "PT3H", # accepts PT3H
     #       }
     #
     # @!attribute [rw] namespace
@@ -2015,19 +2022,31 @@ module Aws::CloudWatch
     #   data available.
     #   @return [String]
     #
+    # @!attribute [rw] recently_active
+    #   To filter the results to show only metrics that have had data points
+    #   published in the past three hours, specify this parameter with a
+    #   value of `PT3H`. This is the only valid value for this parameter.
+    #
+    #   The results that are returned are an approximation of the value you
+    #   specify. There is a low probability that the returned results
+    #   include metrics with last published data as much as 40 minutes more
+    #   than the specified time interval.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/ListMetricsInput AWS API Documentation
     #
     class ListMetricsInput < Struct.new(
       :namespace,
       :metric_name,
       :dimensions,
-      :next_token)
+      :next_token,
+      :recently_active)
       SENSITIVE = []
       include Aws::Structure
     end
 
     # @!attribute [rw] metrics
-    #   The metrics.
+    #   The metrics that match your request.
     #   @return [Array<Types::Metric>]
     #
     # @!attribute [rw] next_token
@@ -2061,8 +2080,8 @@ module Aws::CloudWatch
     #   `arn:aws:cloudwatch:Region:account-id:insight-rule:insight-rule-name
     #   `
     #
-    #   For more information on ARN format, see [ Resource Types Defined by
-    #   Amazon CloudWatch][1] in the *Amazon Web Services General
+    #   For more information about ARN format, see [ Resource Types Defined
+    #   by Amazon CloudWatch][1] in the *Amazon Web Services General
     #   Reference*.
     #
     #
@@ -2694,7 +2713,7 @@ module Aws::CloudWatch
     #   In a `Get` operation, if you omit `Unit` then all data that was
     #   collected with any unit is returned, along with the corresponding
     #   units that were specified when the data was reported to CloudWatch.
-    #   If you specify a unit, the operation returns only data data that was
+    #   If you specify a unit, the operation returns only data that was
     #   collected with that unit specified. If you specify a unit that does
     #   not match the data collected, the results of the operation are null.
     #   CloudWatch does not perform unit conversions.
@@ -2862,7 +2881,7 @@ module Aws::CloudWatch
     #
     # @!attribute [rw] alarm_name
     #   The name for the composite alarm. This name must be unique within
-    #   your AWS account.
+    #   the Region.
     #   @return [String]
     #
     # @!attribute [rw] alarm_rule
@@ -3009,7 +3028,7 @@ module Aws::CloudWatch
     #
     #   If this result includes only warning messages, then the input was
     #   valid enough for the dashboard to be created or modified, but some
-    #   elements of the dashboard may not render.
+    #   elements of the dashboard might not render.
     #
     #   If this result includes error messages, the input was not valid and
     #   the operation failed.
@@ -3154,8 +3173,7 @@ module Aws::CloudWatch
     #       }
     #
     # @!attribute [rw] alarm_name
-    #   The name for the alarm. This name must be unique within your AWS
-    #   account.
+    #   The name for the alarm. This name must be unique within the Region.
     #   @return [String]
     #
     # @!attribute [rw] alarm_description
@@ -3279,7 +3297,7 @@ module Aws::CloudWatch
     #   resolution, the alarm still attempts to gather data at the period
     #   rate that you specify. In this case, it does not receive data for
     #   the attempts that do not correspond to a one-minute data resolution,
-    #   and the alarm may often lapse into INSUFFICENT\_DATA status.
+    #   and the alarm might often lapse into INSUFFICENT\_DATA status.
     #   Specifying 10 or 30 also sets this alarm as a high-resolution alarm,
     #   which has a higher charge than other alarms. For more information
     #   about pricing, see [Amazon CloudWatch Pricing][1].
@@ -3304,12 +3322,12 @@ module Aws::CloudWatch
     #
     #   If you don't specify `Unit`, CloudWatch retrieves all unit types
     #   that have been published for the metric and attempts to evaluate the
-    #   alarm. Usually metrics are published with only one unit, so the
-    #   alarm will work as intended.
+    #   alarm. Usually, metrics are published with only one unit, so the
+    #   alarm works as intended.
     #
     #   However, if the metric is published with multiple types of units and
     #   you don't specify a unit, the alarm's behavior is not defined and
-    #   will behave un-predictably.
+    #   it behaves predictably.
     #
     #   We recommend omitting `Unit` so that you don't inadvertently
     #   specify an incorrect unit that is not published for this metric.
@@ -3416,7 +3434,7 @@ module Aws::CloudWatch
     #   associate as many as 50 tags with an alarm.
     #
     #   Tags can help you organize and categorize your resources. You can
-    #   also use them to scope user permissions, by granting a user
+    #   also use them to scope user permissions by granting a user
     #   permission to access or change only resources with certain tag
     #   values.
     #   @return [Array<Types::Tag>]
@@ -3583,8 +3601,7 @@ module Aws::CloudWatch
     #       }
     #
     # @!attribute [rw] alarm_name
-    #   The name for the alarm. This name must be unique within the AWS
-    #   account. The maximum length is 255 characters.
+    #   The name of the alarm.
     #   @return [String]
     #
     # @!attribute [rw] state_value
@@ -3707,8 +3724,8 @@ module Aws::CloudWatch
     #   `arn:aws:cloudwatch:Region:account-id:insight-rule:insight-rule-name
     #   `
     #
-    #   For more information on ARN format, see [ Resource Types Defined by
-    #   Amazon CloudWatch][1] in the *Amazon Web Services General
+    #   For more information about ARN format, see [ Resource Types Defined
+    #   by Amazon CloudWatch][1] in the *Amazon Web Services General
     #   Reference*.
     #
     #
@@ -3751,8 +3768,8 @@ module Aws::CloudWatch
     #   `arn:aws:cloudwatch:Region:account-id:insight-rule:insight-rule-name
     #   `
     #
-    #   For more information on ARN format, see [ Resource Types Defined by
-    #   Amazon CloudWatch][1] in the *Amazon Web Services General
+    #   For more information about ARN format, see [ Resource Types Defined
+    #   by Amazon CloudWatch][1] in the *Amazon Web Services General
     #   Reference*.
     #
     #

metadata

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