aws-sdk-cloudwatch 1.41.0 → 1.46.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 555cc3f54befa566ff23f4e717bfdcfebfadcef73c3f7fdc621dff94a9865ab0
-  data.tar.gz: c4b914f004862803b2a2c73e49f1ce0e39d57966a0c0a6394396ad3399f4f9cd
+  metadata.gz: 1347762bcffca8868d6ad9213c7cfd1d938f9bd0ff3d625fa1150b5748b79258
+  data.tar.gz: 004300b9fb06235b2e748fd7a948479bbb4a432f6e0f3b28a254356f62f9bf16
 SHA512:
-  metadata.gz: 4f64c22479fad53948338202d23a69cf070fd3294ce4e1ae2cdc891862cada042ac66e47b0156675512ca285f676af12fac1db767ba9255c88a29dfea7558de5
-  data.tar.gz: 2216519d2d4a582fff7d651dfc60896f7ec3c2c331acbe7028dad96e49b493a85cb9f02e9fefb49703657a2643604c450129a66cec86193a820a438d66b303d2
+  metadata.gz: 3dd159ec62cf5bd822acde7677769e944236e22504d2cb03946063627ec1201e1be35e588aedf10a7c05f42667cfdcc90e807e3042b3561790026746d1f49418
+  data.tar.gz: 7535b020ff585ca226f974cf0505f4d2d9b950beace1f7b61fc4af3d67b5ac3da89cf29db57b5c916d5138837b20d0998ede397cae04df03e7df9742d95a7ac6

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.41.0'
+  GEM_VERSION = '1.46.0'
 
 end

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

@@ -201,7 +201,7 @@ module Aws::CloudWatch
     # metric math expression. Each structure either retrieves a metric or
     # performs a math expression. One item in the Metrics array is the math
     # expression that the alarm watches. This expression by designated by
-    # having `ReturnValue` set to true.
+    # having `ReturnData` set to true.
     # @return [Array<Types::MetricDataQuery>]
     def metrics
       data[:metrics]

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,
@@ -724,6 +739,11 @@ module Aws::CloudWatch
     # Retrieves the alarms for the specified metric. To filter the results,
     # specify a statistic, period, or unit.
     #
+    # This operation retrieves only standard alarms that are based on the
+    # specified metric. It does not return alarms based on math expressions
+    # that use the specified metric, or composite alarms that use the
+    # specified metric.
+    #
     # @option params [required, String] :metric_name
     #   The name of the metric.
     #
@@ -906,7 +926,6 @@ module Aws::CloudWatch
     end
 
     # Returns a list of all the Contributor Insights rules in your account.
-    # All rules in your account are returned with a single operation.
     #
     # For more information about Contributor Insights, see [Using
     # Contributor Insights to Analyze High-Cardinality Data][1].
@@ -916,11 +935,12 @@ module Aws::CloudWatch
     # [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/ContributorInsights.html
     #
     # @option params [String] :next_token
-    #   Reserved for future use.
+    #   Include this value, if it was returned by the previous operation, to
+    #   get the next set of rules.
     #
     # @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.
+    #   The maximum number of results to return in one operation. If you omit
+    #   this parameter, the default of 500 is used.
     #
     # @return [Types::DescribeInsightRulesOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -1123,8 +1143,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 +1195,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 +1317,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.
     #
     #
     #
@@ -1361,8 +1381,8 @@ module Aws::CloudWatch
     #   response from CloudWatch than setting 12:07 or 12:29 as the `EndTime`.
     #
     # @option params [String] :next_token
-    #   Include this value, if it was returned by the previous call, to get
-    #   the next set of data points.
+    #   Include this value, if it was returned by the previous `GetMetricData`
+    #   operation, to get the next set of data points.
     #
     # @option params [String] :scan_by
     #   The order in which data points should be returned.
@@ -1606,10 +1626,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 +1828,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].
     #
     #
     #
@@ -1818,18 +1842,31 @@ module Aws::CloudWatch
     # [2]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_GetMetricStatistics.html
     #
     # @option params [String] :namespace
-    #   The namespace to filter against.
+    #   The metric namespace to filter against. Only the namespace that
+    #   matches exactly will be returned.
     #
     # @option params [String] :metric_name
-    #   The name of the metric to filter against.
+    #   The name of the metric to filter against. Only the metrics with names
+    #   that match exactly will be returned.
     #
     # @option params [Array<Types::DimensionFilter>] :dimensions
-    #   The dimensions to filter against.
+    #   The dimensions to filter against. Only the dimensions that match
+    #   exactly will be returned.
     #
     # @option params [String] :next_token
     #   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 +1886,7 @@ module Aws::CloudWatch
     #       },
     #     ],
     #     next_token: "NextToken",
+    #     recently_active: "PT3H", # accepts PT3H
     #   })
     #
     # @example Response structure
@@ -1882,7 +1920,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*.
     #
     #
@@ -1944,8 +1982,6 @@ module Aws::CloudWatch
     #   The configuration can also include the time zone to use for the
     #   metric.
     #
-    #   You can in
-    #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
     # @example Request syntax with placeholder values
@@ -2041,8 +2077,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 +2261,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 +2381,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 +2493,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 +2516,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
@@ -2565,8 +2600,8 @@ module Aws::CloudWatch
     #   a math expression.
     #
     #   One item in the `Metrics` array is the expression that the alarm
-    #   watches. You designate this expression by setting `ReturnValue` to
-    #   true for this object in the array. For more information, see
+    #   watches. You designate this expression by setting `ReturnData` to true
+    #   for this object in the array. For more information, see
     #   [MetricDataQuery][1].
     #
     #   If you use the `Metrics` parameter, you cannot include the
@@ -2584,7 +2619,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
@@ -2696,6 +2731,10 @@ module Aws::CloudWatch
     # pair. For more information about specifying dimensions, see
     # [Publishing Metrics][2] in the *Amazon CloudWatch User Guide*.
     #
+    # You specify the time stamp to be associated with each data point. You
+    # can specify time stamps that are as much as two weeks before the
+    # current date, and as much as 2 hours after the current day and time.
+    #
     # Data points with time stamps from 24 hours ago or longer can take at
     # least 48 hours to become available for [GetMetricData][3] or
     # [GetMetricStatistics][4] from the time they are submitted. Data points
@@ -2783,9 +2822,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 +2836,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 +2879,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 +2902,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 +2946,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 +2987,7 @@ module Aws::CloudWatch
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-cloudwatch'
-      context[:gem_version] = '1.41.0'
+      context[:gem_version] = '1.46.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
@@ -553,8 +552,8 @@ module Aws::CloudWatch
     #   a math expression.
     #
     #   One item in the `Metrics` array is the expression that the alarm
-    #   watches. You designate this expression by setting `ReturnValue` to
-    #   true for this object in the array. For more information, see
+    #   watches. You designate this expression by setting `ReturnData` to true
+    #   for this object in the array. For more information, see
     #   [MetricDataQuery][1].
     #
     #   If you use the `Metrics` parameter, you cannot include the
@@ -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,14 +253,27 @@ module Aws::CloudWatch
     #         value: "DimensionValue",
     #       },
     #     ],
+    #     recently_active: "PT3H", # accepts PT3H
     #   })
     # @param [Hash] options ({})
     # @option options [String] :namespace
-    #   The namespace to filter against.
+    #   The metric namespace to filter against. Only the namespace that
+    #   matches exactly will be returned.
     # @option options [String] :metric_name
-    #   The name of the metric to filter against.
+    #   The name of the metric to filter against. Only the metrics with names
+    #   that match exactly will be returned.
     # @option options [Array<Types::DimensionFilter>] :dimensions
-    #   The dimensions to filter against.
+    #   The dimensions to filter against. Only the dimensions that match
+    #   exactly will be returned.
+    # @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,
@@ -871,12 +871,13 @@ module Aws::CloudWatch
     #       }
     #
     # @!attribute [rw] next_token
-    #   Reserved for future use.
+    #   Include this value, if it was returned by the previous operation, to
+    #   get the next set of rules.
     #   @return [String]
     #
     # @!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.
+    #   The maximum number of results to return in one operation. If you
+    #   omit this parameter, the default of 500 is used.
     #   @return [Integer]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/DescribeInsightRulesInput AWS API Documentation
@@ -889,7 +890,8 @@ module Aws::CloudWatch
     end
 
     # @!attribute [rw] next_token
-    #   Reserved for future use.
+    #   If this parameter is present, it is a token that marks the start of
+    #   the next batch of returned results.
     #   @return [String]
     #
     # @!attribute [rw] insight_rules
@@ -905,7 +907,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 +922,13 @@ 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. Dimension values cannot contain blank
+    #   spaces or non-ASCII characters.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/Dimension AWS API Documentation
@@ -1167,7 +1175,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
@@ -1349,8 +1357,8 @@ module Aws::CloudWatch
     #   @return [Time]
     #
     # @!attribute [rw] next_token
-    #   Include this value, if it was returned by the previous call, to get
-    #   the next set of data points.
+    #   Include this value, if it was returned by the previous
+    #   `GetMetricData` operation, to get the next set of data points.
     #   @return [String]
     #
     # @!attribute [rw] scan_by
@@ -1391,8 +1399,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 +1547,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 +1656,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,18 +2005,22 @@ module Aws::CloudWatch
     #           },
     #         ],
     #         next_token: "NextToken",
+    #         recently_active: "PT3H", # accepts PT3H
     #       }
     #
     # @!attribute [rw] namespace
-    #   The namespace to filter against.
+    #   The metric namespace to filter against. Only the namespace that
+    #   matches exactly will be returned.
     #   @return [String]
     #
     # @!attribute [rw] metric_name
-    #   The name of the metric to filter against.
+    #   The name of the metric to filter against. Only the metrics with
+    #   names that match exactly will be returned.
     #   @return [String]
     #
     # @!attribute [rw] dimensions
-    #   The dimensions to filter against.
+    #   The dimensions to filter against. Only the dimensions that match
+    #   exactly will be returned.
     #   @return [Array<Types::DimensionFilter>]
     #
     # @!attribute [rw] next_token
@@ -2015,19 +2028,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 +2086,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*.
     #
     #
@@ -2275,7 +2300,7 @@ module Aws::CloudWatch
     #   metric math expression. Each structure either retrieves a metric or
     #   performs a math expression. One item in the Metrics array is the
     #   math expression that the alarm watches. This expression by
-    #   designated by having `ReturnValue` set to true.
+    #   designated by having `ReturnData` set to true.
     #   @return [Array<Types::MetricDataQuery>]
     #
     # @!attribute [rw] threshold_metric_id
@@ -2694,7 +2719,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.
@@ -2804,8 +2829,6 @@ module Aws::CloudWatch
     #
     #   The configuration can also include the time zone to use for the
     #   metric.
-    #
-    #   You can in
     #   @return [Types::AnomalyDetectorConfiguration]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/PutAnomalyDetectorInput AWS API Documentation
@@ -2862,7 +2885,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 +3032,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 +3177,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 +3301,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 +3326,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.
@@ -3396,7 +3418,7 @@ module Aws::CloudWatch
     #   performs a math expression.
     #
     #   One item in the `Metrics` array is the expression that the alarm
-    #   watches. You designate this expression by setting `ReturnValue` to
+    #   watches. You designate this expression by setting `ReturnData` to
     #   true for this object in the array. For more information, see
     #   [MetricDataQuery][1].
     #
@@ -3416,7 +3438,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 +3605,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 +3728,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 +3772,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.46.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-07-02 00:00:00.000000000 Z
+date: 2020-11-04 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