aws-sdk-cloudwatch 1.38.0 → 1.43.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d8eba7875acb25028fa366e64b02a2ba6726566e8904808b6d1ce2543e820a5c
-  data.tar.gz: 62386addd91c088a25ce9f5ed0d12e05f782e57a7eee987c2b1036477aa1e3fe
+  metadata.gz: 11d06cd273b745e7031c29700ae17dfa8342f4f3de2bb558ed4c499fb7f38d0d
+  data.tar.gz: 281aa0859d4836e32eb28287be55927d6b9eb31aa0b01d866a3382b8895a5d6b
 SHA512:
-  metadata.gz: 6b8c503f9e5ba75f28e9b480442c26c7b810accc9a99ee5cf55b97521971d878c97f2b1d92f48f8001c43218e7d6e046068d12fce4537a89b53b607c7ee49db6
-  data.tar.gz: 45a3c71136ff2257399f99b5e79fb1918a591523807508d44ca50ac9ae04f64676fec73a2e37bddecfad930b1f6451d76f683eb9cbf10049dab5223e044ccc70
+  metadata.gz: 8bd441b9d0af6333dadf1f6a63ca2c56f40094151dfcd65a8e3f30c31a7e1e99aa73059e05540f5431f6e8059316abeb7245e00c26fc913c12f5b6d968d1fdb0
+  data.tar.gz: 8d5941f376c3c5adc66680d2e2239fae083820773bf7a1ca007f7b2940760c0bfa939806a43aa50825cb34fd9fc61a25799019464a0b5778d86118a06af1de81

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:
@@ -46,9 +48,9 @@ require_relative 'aws-sdk-cloudwatch/customizations'
 #
 # See {Errors} for more information.
 #
-# @service
+# @!group service
 module Aws::CloudWatch
 
-  GEM_VERSION = '1.38.0'
+  GEM_VERSION = '1.43.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:
@@ -24,6 +26,7 @@ require 'aws-sdk-core/plugins/jsonvalue_converter.rb'
 require 'aws-sdk-core/plugins/client_metrics_plugin.rb'
 require 'aws-sdk-core/plugins/client_metrics_send_plugin.rb'
 require 'aws-sdk-core/plugins/transfer_encoding.rb'
+require 'aws-sdk-core/plugins/http_checksum.rb'
 require 'aws-sdk-core/plugins/signature_v4.rb'
 require 'aws-sdk-core/plugins/protocols/query.rb'
 
@@ -69,6 +72,7 @@ module Aws::CloudWatch
     add_plugin(Aws::Plugins::ClientMetricsPlugin)
     add_plugin(Aws::Plugins::ClientMetricsSendPlugin)
     add_plugin(Aws::Plugins::TransferEncoding)
+    add_plugin(Aws::Plugins::HttpChecksum)
     add_plugin(Aws::Plugins::SignatureV4)
     add_plugin(Aws::Plugins::Protocols::Query)
 
@@ -81,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:
@@ -97,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
@@ -161,7 +180,7 @@ module Aws::CloudWatch
     #   @option options [String] :endpoint
     #     The client endpoint is normally constructed from the `:region`
     #     option. You should only configure an `:endpoint` when connecting
-    #     to test endpoints. This should be a valid HTTP(S) URI.
+    #     to test or custom endpoints. This should be a valid HTTP(S) URI.
     #
     #   @option options [Integer] :endpoint_cache_max_entries (1000)
     #     Used for the maximum size limit of the LRU cache storing endpoints data
@@ -394,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.
     #
@@ -421,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
@@ -566,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
@@ -587,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,
@@ -916,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:
     #
@@ -1119,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.
@@ -1171,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.
@@ -1293,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.
     #
     #
     #
@@ -1602,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:
     #
@@ -1804,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].
     #
     #
     #
@@ -1826,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;
@@ -1845,6 +1878,7 @@ module Aws::CloudWatch
     #       },
     #     ],
     #     next_token: "NextToken",
+    #     recently_active: "PT3H", # accepts PT3H
     #   })
     #
     # @example Response structure
@@ -1878,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*.
     #
     #
@@ -2037,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
@@ -2221,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.
     #
     #
     #
@@ -2341,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.
@@ -2454,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].
     #
@@ -2477,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
@@ -2580,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
@@ -2779,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
@@ -2793,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.
@@ -2837,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
@@ -2860,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*.
     #
     #
@@ -2904,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*.
     #
     #
@@ -2945,7 +2977,7 @@ module Aws::CloudWatch
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-cloudwatch'
-      context[:gem_version] = '1.38.0'
+      context[:gem_version] = '1.43.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