aws-sdk-cloudwatch 1.40.0 → 1.45.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b097ed4e861c19358794f164d86a74f8f55defc27eae827a9b65eac79ba7c945
-  data.tar.gz: 84b43a8b49143a7182baafd00404596916e992f51a0e67f1050d100492fc01d4
+  metadata.gz: a4970b3a61258b6678d3ff236f556dc853f88713468c4df4c237459fbb0e9e58
+  data.tar.gz: b35bc1caef1e7e611979c9c76859fe9f8aba93807eca74fb0fc35e165b7fcd6b
 SHA512:
-  metadata.gz: 97fae1bd5ca20687e6ddff79e39b94b8cb91b072adc4e4e8c0bfac35f8dbd7809d96664172579900c7472a7c7293755c470b68fb1e4722b143486e080de7b773
-  data.tar.gz: 8a625d1e85f8a54410c4cef16ed7cfc18eed48a44913be977a1dcd926787a965ef35395e8ce58eb8b1cd3f1cde21c9f819acec3287ff110035921d3259860c50
+  metadata.gz: e284b6a709d107f3e305336f0edcd6bf638e2d70a53bc72741a7522367e9d6e5ef9fa72699f1a973e4f6acb13c53684ae918fa2702890b1d3665f2f2b274ae59
+  data.tar.gz: 2856c0d2ec2ff7e9a729e4d37e577fb808c977a8e2060f6dd3e50251fea0ec12b26184b2c508695c0a73532222296e09f93604f979df3dc684936cdef4c4643f

data/lib/aws-sdk-cloudwatch.rb

@@ -7,6 +7,7 @@
 #
 # WARNING ABOUT GENERATED CODE
 
+
 require 'aws-sdk-core'
 require 'aws-sigv4'
 
@@ -48,9 +49,9 @@ require_relative 'aws-sdk-cloudwatch/customizations'
 #
 # See {Errors} for more information.
 #
-# @service
+# @!group service
 module Aws::CloudWatch
 
-  GEM_VERSION = '1.40.0'
+  GEM_VERSION = '1.45.0'
 
 end

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

@@ -85,13 +85,28 @@ module Aws::CloudWatch
     #     * `Aws::Credentials` - Used for configuring static, non-refreshing
     #       credentials.
     #
+    #     * `Aws::SharedCredentials` - Used for loading static credentials from a
+    #       shared file, such as `~/.aws/config`.
+    #
+    #     * `Aws::AssumeRoleCredentials` - Used when you need to assume a role.
+    #
+    #     * `Aws::AssumeRoleWebIdentityCredentials` - Used when you need to
+    #       assume a role after providing credentials via the web.
+    #
+    #     * `Aws::SSOCredentials` - Used for loading credentials from AWS SSO using an
+    #       access token generated from `aws login`.
+    #
+    #     * `Aws::ProcessCredentials` - Used for loading credentials from a
+    #       process that outputs to stdout.
+    #
     #     * `Aws::InstanceProfileCredentials` - Used for loading credentials
     #       from an EC2 IMDS on an EC2 instance.
     #
-    #     * `Aws::SharedCredentials` - Used for loading credentials from a
-    #       shared file, such as `~/.aws/config`.
+    #     * `Aws::ECSCredentials` - Used for loading credentials from
+    #       instances running in ECS.
     #
-    #     * `Aws::AssumeRoleCredentials` - Used when you need to assume a role.
+    #     * `Aws::CognitoIdentityCredentials` - Used for loading credentials
+    #       from the Cognito Identity service.
     #
     #     When `:credentials` are not configured directly, the following
     #     locations will be searched for credentials:
@@ -101,10 +116,10 @@ module Aws::CloudWatch
     #     * ENV['AWS_ACCESS_KEY_ID'], ENV['AWS_SECRET_ACCESS_KEY']
     #     * `~/.aws/credentials`
     #     * `~/.aws/config`
-    #     * EC2 IMDS instance profile - When used by default, the timeouts are
-    #       very aggressive. Construct and pass an instance of
-    #       `Aws::InstanceProfileCredentails` to enable retries and extended
-    #       timeouts.
+    #     * EC2/ECS IMDS instance profile - When used by default, the timeouts
+    #       are very aggressive. Construct and pass an instance of
+    #       `Aws::InstanceProfileCredentails` or `Aws::ECSCredentials` to
+    #       enable retries and extended timeouts.
     #
     #   @option options [required, String] :region
     #     The AWS region to connect to.  The configured `:region` is
@@ -398,7 +413,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 +440,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 +585,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 +606,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 +935,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 +1138,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 +1190,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 +1312,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 +1621,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 +1823,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 +1849,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 +1878,7 @@ module Aws::CloudWatch
     #       },
     #     ],
     #     next_token: "NextToken",
+    #     recently_active: "PT3H", # accepts PT3H
     #   })
     #
     # @example Response structure
@@ -1882,7 +1912,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 +2071,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 +2255,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 +2375,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 +2487,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 +2510,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 +2613,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 +2812,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 +2826,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 +2869,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 +2892,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 +2936,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 +2977,7 @@ module Aws::CloudWatch
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-cloudwatch'
-      context[:gem_version] = '1.40.0'
+      context[:gem_version] = '1.45.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.40.0
+  version: 1.45.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-06-23 00:00:00.000000000 Z
+date: 2020-09-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core
@@ -19,7 +19,7 @@ dependencies:
         version: '3'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.99.0
+        version: 3.109.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -29,7 +29,7 @@ dependencies:
         version: '3'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.99.0
+        version: 3.109.0
 - !ruby/object:Gem::Dependency
   name: aws-sigv4
   requirement: !ruby/object:Gem::Requirement