aws-sdk-cloudwatch 1.39.1 → 1.44.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4470e54d65ae67a415058601a72dc202d4a4f0e6fe7e0d47adb791d75a01d7eb
-  data.tar.gz: e2741fc2be09560b90cb3399b9e8b5698ed750a551ae546e987dbb2eba7284e6
+  metadata.gz: 0be685b2a4beb76797422f844a0748eb8b529b3dc7184fc78feae952bedb7485
+  data.tar.gz: 80b39e955a3cdc7bbc9444a56aeacf298ba7858713287d9236a43931e2c087b8
 SHA512:
-  metadata.gz: fccdd3a27926bf5e6c37069a430a1a5c176a8bef62ba5fd8fb40acb3835769be62ba1e600ec44d58246c5fe851b4810a265dba9c11ffb0f7c79a13e693ada2e8
-  data.tar.gz: ea69e9777a0ab468260a23a82197f28a068b56cc02e0e58b060cb2d918c436c59294559768ca7369ff7a6b92c9d64991f1ab0fddc0a532a7bfff244ec6ee286e
+  metadata.gz: 9d625a238d5f72f14f2bcfec278a463d1fa51e5878c5f4bef5ca452ff00be125de121fe84d3c309ea81990f8ed43dcdbfca320e9b8365e8250187a47c01fd1ac
+  data.tar.gz: af43403695d5a69d67d0338c88b43889359d7d50964b7c6a6c59d2a8daea9444f38ec74817102df885479fc04fb2061593dbbfddfa7263b36da41889a2e39e19

data/lib/aws-sdk-cloudwatch.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 # WARNING ABOUT GENERATED CODE
 #
 # This file is generated. See the contributing guide for more information:
@@ -5,6 +7,7 @@
 #
 # WARNING ABOUT GENERATED CODE
 
+
 require 'aws-sdk-core'
 require 'aws-sigv4'
 
@@ -46,9 +49,9 @@ require_relative 'aws-sdk-cloudwatch/customizations'
 #
 # See {Errors} for more information.
 #
-# @service
+# @!group service
 module Aws::CloudWatch
 
-  GEM_VERSION = '1.39.1'
+  GEM_VERSION = '1.44.0'
 
 end

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

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 # WARNING ABOUT GENERATED CODE
 #
 # This file is generated. See the contributing guide for more information:

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

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 # WARNING ABOUT GENERATED CODE
 #
 # This file is generated. See the contributing guide for more information:
@@ -83,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:
@@ -99,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
@@ -396,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.
     #
@@ -423,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
@@ -568,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
@@ -589,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,
@@ -918,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:
     #
@@ -1121,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.
@@ -1173,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.
@@ -1295,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.
     #
     #
     #
@@ -1604,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:
     #
@@ -1806,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].
     #
     #
     #
@@ -1828,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;
@@ -1847,6 +1878,7 @@ module Aws::CloudWatch
     #       },
     #     ],
     #     next_token: "NextToken",
+    #     recently_active: "PT3H", # accepts PT3H
     #   })
     #
     # @example Response structure
@@ -1880,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*.
     #
     #
@@ -2039,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
@@ -2223,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.
     #
     #
     #
@@ -2343,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.
@@ -2456,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].
     #
@@ -2479,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
@@ -2582,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
@@ -2781,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
@@ -2795,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.
@@ -2839,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
@@ -2862,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*.
     #
     #
@@ -2906,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*.
     #
     #
@@ -2947,7 +2977,7 @@ module Aws::CloudWatch
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-cloudwatch'
-      context[:gem_version] = '1.39.1'
+      context[:gem_version] = '1.44.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 # WARNING ABOUT GENERATED CODE
 #
 # This file is generated. See the contributing guide for more information:
@@ -189,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')
@@ -565,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/composite_alarm.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 # WARNING ABOUT GENERATED CODE
 #
 # This file is generated. See the contributing guide for more information:

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

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # WARNING ABOUT GENERATED CODE
 #
 # This file is generated. See the contributing for info on making contributions:

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

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 # WARNING ABOUT GENERATED CODE
 #
 # This file is generated. See the contributing guide for more information:

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

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 # WARNING ABOUT GENERATED CODE
 #
 # This file is generated. See the contributing guide for more information:
@@ -288,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(
@@ -361,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
@@ -452,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].
     #
@@ -474,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
@@ -569,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