aws-sdk-cloudwatch 1.59.0 → 1.81.0

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

@@ -63,10 +63,12 @@ module Aws::CloudWatch
     #
     # @return [self]
     def load
-      resp = @client.list_metrics(
+      resp = Aws::Plugins::UserAgent.feature('resource') do
+        @client.list_metrics(
         metric_name: @name,
         namespace: @namespace
       )
+      end
       @data = resp.metrics[0]
       self
     end
@@ -181,7 +183,9 @@ module Aws::CloudWatch
           :retry
         end
       end
-      Aws::Waiters::Waiter.new(options).wait({})
+      Aws::Plugins::UserAgent.feature('resource') do
+        Aws::Waiters::Waiter.new(options).wait({})
+      end
     end
 
     # @!group Actions
@@ -300,7 +304,9 @@ module Aws::CloudWatch
         namespace: @namespace,
         metric_name: @name
       )
-      resp = @client.get_metric_statistics(options)
+      resp = Aws::Plugins::UserAgent.feature('resource') do
+        @client.get_metric_statistics(options)
+      end
       resp.data
     end
 
@@ -365,6 +371,9 @@ module Aws::CloudWatch
     # @param [Hash] options ({})
     # @option options [required, String] :alarm_name
     #   The name for the alarm. This name must be unique within the Region.
+    #
+    #   The name must contain only UTF-8 characters, and can't contain ASCII
+    #   control characters
     # @option options [String] :alarm_description
     #   The description for the alarm.
     # @option options [Boolean] :actions_enabled
@@ -373,75 +382,172 @@ module Aws::CloudWatch
     # @option options [Array<String>] :ok_actions
     #   The actions to execute when this alarm transitions to an `OK` state
     #   from any other state. Each action is specified as an Amazon Resource
-    #   Name (ARN).
-    #
-    #   Valid Values: `arn:aws:automate:region:ec2:stop` \|
-    #   `arn:aws:automate:region:ec2:terminate` \|
-    #   `arn:aws:automate:region:ec2:recover` \|
-    #   `arn:aws:automate:region:ec2:reboot` \|
-    #   `arn:aws:sns:region:account-id:sns-topic-name ` \|
-    #   `arn:aws:autoscaling:region:account-id:scalingPolicy:policy-id:autoScalingGroupName/group-friendly-name:policyName/policy-friendly-name
-    #   `
-    #
-    #   Valid Values (for use with IAM roles):
-    #   `arn:aws:swf:region:account-id:action/actions/AWS_EC2.InstanceId.Stop/1.0`
-    #   \|
-    #   `arn:aws:swf:region:account-id:action/actions/AWS_EC2.InstanceId.Terminate/1.0`
-    #   \|
-    #   `arn:aws:swf:region:account-id:action/actions/AWS_EC2.InstanceId.Reboot/1.0`
-    #   \|
-    #   `arn:aws:swf:region:account-id:action/actions/AWS_EC2.InstanceId.Recover/1.0`
+    #   Name (ARN). Valid values:
+    #
+    #   **EC2 actions:**
+    #
+    #   * `arn:aws:automate:region:ec2:stop`
+    #
+    #   * `arn:aws:automate:region:ec2:terminate`
+    #
+    #   * `arn:aws:automate:region:ec2:reboot`
+    #
+    #   * `arn:aws:automate:region:ec2:recover`
+    #
+    #   * `arn:aws:swf:region:account-id:action/actions/AWS_EC2.InstanceId.Stop/1.0`
+    #
+    #   * `arn:aws:swf:region:account-id:action/actions/AWS_EC2.InstanceId.Terminate/1.0`
+    #
+    #   * `arn:aws:swf:region:account-id:action/actions/AWS_EC2.InstanceId.Reboot/1.0`
+    #
+    #   * `arn:aws:swf:region:account-id:action/actions/AWS_EC2.InstanceId.Recover/1.0`
+    #
+    #   **Autoscaling action:**
+    #
+    #   * `arn:aws:autoscaling:region:account-id:scalingPolicy:policy-id:autoScalingGroupName/group-friendly-name:policyName/policy-friendly-name
+    #     `
+    #
+    #   ^
+    #
+    #   **SNS notification action:**
+    #
+    #   * `arn:aws:sns:region:account-id:sns-topic-name:autoScalingGroupName/group-friendly-name:policyName/policy-friendly-name
+    #     `
+    #
+    #   ^
+    #
+    #   **SSM integration actions:**
+    #
+    #   * `arn:aws:ssm:region:account-id:opsitem:severity#CATEGORY=category-name
+    #     `
+    #
+    #   * `arn:aws:ssm-incidents::account-id:responseplan/response-plan-name `
     # @option options [Array<String>] :alarm_actions
     #   The actions to execute when this alarm transitions to the `ALARM`
     #   state from any other state. Each action is specified as an Amazon
-    #   Resource Name (ARN).
-    #
-    #   Valid Values: `arn:aws:automate:region:ec2:stop` \|
-    #   `arn:aws:automate:region:ec2:terminate` \|
-    #   `arn:aws:automate:region:ec2:recover` \|
-    #   `arn:aws:automate:region:ec2:reboot` \|
-    #   `arn:aws:sns:region:account-id:sns-topic-name ` \|
-    #   `arn:aws:autoscaling:region:account-id:scalingPolicy:policy-id:autoScalingGroupName/group-friendly-name:policyName/policy-friendly-name
-    #   ` \| `arn:aws:ssm:region:account-id:opsitem:severity ` \|
-    #   `arn:aws:ssm-incidents::account-id:response-plan:response-plan-name `
-    #
-    #   Valid Values (for use with IAM roles):
-    #   `arn:aws:swf:region:account-id:action/actions/AWS_EC2.InstanceId.Stop/1.0`
-    #   \|
-    #   `arn:aws:swf:region:account-id:action/actions/AWS_EC2.InstanceId.Terminate/1.0`
-    #   \|
-    #   `arn:aws:swf:region:account-id:action/actions/AWS_EC2.InstanceId.Reboot/1.0`
-    #   \|
-    #   `arn:aws:swf:region:account-id:action/actions/AWS_EC2.InstanceId.Recover/1.0`
+    #   Resource Name (ARN). Valid values:
+    #
+    #   **EC2 actions:**
+    #
+    #   * `arn:aws:automate:region:ec2:stop`
+    #
+    #   * `arn:aws:automate:region:ec2:terminate`
+    #
+    #   * `arn:aws:automate:region:ec2:reboot`
+    #
+    #   * `arn:aws:automate:region:ec2:recover`
+    #
+    #   * `arn:aws:swf:region:account-id:action/actions/AWS_EC2.InstanceId.Stop/1.0`
+    #
+    #   * `arn:aws:swf:region:account-id:action/actions/AWS_EC2.InstanceId.Terminate/1.0`
+    #
+    #   * `arn:aws:swf:region:account-id:action/actions/AWS_EC2.InstanceId.Reboot/1.0`
+    #
+    #   * `arn:aws:swf:region:account-id:action/actions/AWS_EC2.InstanceId.Recover/1.0`
+    #
+    #   **Autoscaling action:**
+    #
+    #   * `arn:aws:autoscaling:region:account-id:scalingPolicy:policy-id:autoScalingGroupName/group-friendly-name:policyName/policy-friendly-name
+    #     `
+    #
+    #   ^
+    #
+    #   **SNS notification action:**
+    #
+    #   * `arn:aws:sns:region:account-id:sns-topic-name:autoScalingGroupName/group-friendly-name:policyName/policy-friendly-name
+    #     `
+    #
+    #   ^
+    #
+    #   **SSM integration actions:**
+    #
+    #   * `arn:aws:ssm:region:account-id:opsitem:severity#CATEGORY=category-name
+    #     `
+    #
+    #   * `arn:aws:ssm-incidents::account-id:responseplan/response-plan-name `
     # @option options [Array<String>] :insufficient_data_actions
     #   The actions to execute when this alarm transitions to the
     #   `INSUFFICIENT_DATA` state from any other state. Each action is
-    #   specified as an Amazon Resource Name (ARN).
-    #
-    #   Valid Values: `arn:aws:automate:region:ec2:stop` \|
-    #   `arn:aws:automate:region:ec2:terminate` \|
-    #   `arn:aws:automate:region:ec2:recover` \|
-    #   `arn:aws:automate:region:ec2:reboot` \|
-    #   `arn:aws:sns:region:account-id:sns-topic-name ` \|
-    #   `arn:aws:autoscaling:region:account-id:scalingPolicy:policy-id:autoScalingGroupName/group-friendly-name:policyName/policy-friendly-name
-    #   `
-    #
-    #   Valid Values (for use with IAM roles):
-    #   `>arn:aws:swf:region:account-id:action/actions/AWS_EC2.InstanceId.Stop/1.0`
-    #   \|
-    #   `arn:aws:swf:region:account-id:action/actions/AWS_EC2.InstanceId.Terminate/1.0`
-    #   \|
-    #   `arn:aws:swf:region:account-id:action/actions/AWS_EC2.InstanceId.Reboot/1.0`
+    #   specified as an Amazon Resource Name (ARN). Valid values:
+    #
+    #   **EC2 actions:**
+    #
+    #   * `arn:aws:automate:region:ec2:stop`
+    #
+    #   * `arn:aws:automate:region:ec2:terminate`
+    #
+    #   * `arn:aws:automate:region:ec2:reboot`
+    #
+    #   * `arn:aws:automate:region:ec2:recover`
+    #
+    #   * `arn:aws:swf:region:account-id:action/actions/AWS_EC2.InstanceId.Stop/1.0`
+    #
+    #   * `arn:aws:swf:region:account-id:action/actions/AWS_EC2.InstanceId.Terminate/1.0`
+    #
+    #   * `arn:aws:swf:region:account-id:action/actions/AWS_EC2.InstanceId.Reboot/1.0`
+    #
+    #   * `arn:aws:swf:region:account-id:action/actions/AWS_EC2.InstanceId.Recover/1.0`
+    #
+    #   **Autoscaling action:**
+    #
+    #   * `arn:aws:autoscaling:region:account-id:scalingPolicy:policy-id:autoScalingGroupName/group-friendly-name:policyName/policy-friendly-name
+    #     `
+    #
+    #   ^
+    #
+    #   **SNS notification action:**
+    #
+    #   * `arn:aws:sns:region:account-id:sns-topic-name:autoScalingGroupName/group-friendly-name:policyName/policy-friendly-name
+    #     `
+    #
+    #   ^
+    #
+    #   **SSM integration actions:**
+    #
+    #   * `arn:aws:ssm:region:account-id:opsitem:severity#CATEGORY=category-name
+    #     `
+    #
+    #   * `arn:aws:ssm-incidents::account-id:responseplan/response-plan-name `
     # @option options [String] :statistic
     #   The statistic for the metric specified in `MetricName`, other than
     #   percentile. For percentile statistics, use `ExtendedStatistic`. When
     #   you call `PutMetricAlarm` and specify a `MetricName`, you must specify
     #   either `Statistic` or `ExtendedStatistic,` but not both.
     # @option options [String] :extended_statistic
-    #   The percentile statistic for the metric specified in `MetricName`.
-    #   Specify a value between p0.0 and p100. When you call `PutMetricAlarm`
-    #   and specify a `MetricName`, you must specify either `Statistic` or
-    #   `ExtendedStatistic,` but not both.
+    #   The extended statistic for the metric specified in `MetricName`. When
+    #   you call `PutMetricAlarm` and specify a `MetricName`, you must specify
+    #   either `Statistic` or `ExtendedStatistic` but not both.
+    #
+    #   If you specify `ExtendedStatistic`, the following are valid values:
+    #
+    #   * `p90`
+    #
+    #   * `tm90`
+    #
+    #   * `tc90`
+    #
+    #   * `ts90`
+    #
+    #   * `wm90`
+    #
+    #   * `IQM`
+    #
+    #   * `PR(n:m)` where n and m are values of the metric
+    #
+    #   * `TC(X%:X%)` where X is between 10 and 90 inclusive.
+    #
+    #   * `TM(X%:X%)` where X is between 10 and 90 inclusive.
+    #
+    #   * `TS(X%:X%)` where X is between 10 and 90 inclusive.
+    #
+    #   * `WM(X%:X%)` where X is between 10 and 90 inclusive.
+    #
+    #   For more information about these extended statistics, see [CloudWatch
+    #   statistics definitions][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/Statistics-definitions.html
     # @option options [Array<Types::Dimension>] :dimensions
     #   The dimensions for the metric specified in `MetricName`.
     # @option options [Integer] :period
@@ -486,7 +592,7 @@ module Aws::CloudWatch
     #
     #   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 it
-    #   behaves predictably.
+    #   behaves unpredictably.
     #
     #   We recommend omitting `Unit` so that you don't inadvertently specify
     #   an incorrect unit that is not published for this metric. Doing so
@@ -531,6 +637,13 @@ module Aws::CloudWatch
     #
     #   Valid Values: `breaching | notBreaching | ignore | missing`
     #
+    #   <note markdown="1"> Alarms that evaluate metrics in the `AWS/DynamoDB` namespace always
+    #   `ignore` missing data even if you choose a different option for
+    #   `TreatMissingData`. When an `AWS/DynamoDB` metric has missing data,
+    #   alarms that evaluate that metric remain in their current state.
+    #
+    #    </note>
+    #
     #
     #
     #   [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/AlarmThatSendsEmail.html#alarms-and-missing-data
@@ -573,7 +686,9 @@ module Aws::CloudWatch
     #   [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_MetricDataQuery.html
     # @option options [Array<Types::Tag>] :tags
     #   A list of key-value pairs to associate with the alarm. You can
-    #   associate as many as 50 tags with an alarm.
+    #   associate as many as 50 tags with an alarm. To be able to associate
+    #   tags with the alarm when you create the alarm, you must have the
+    #   `cloudwatch:TagResource` permission.
     #
     #   Tags can help you organize and categorize your resources. You can also
     #   use them to scope user permissions by granting a user permission to
@@ -602,7 +717,9 @@ module Aws::CloudWatch
         namespace: @namespace,
         metric_name: @name
       )
-      @client.put_metric_alarm(options)
+      Aws::Plugins::UserAgent.feature('resource') do
+        @client.put_metric_alarm(options)
+      end
       Alarm.new(
         name: options[:alarm_name],
         client: @client
@@ -638,15 +755,17 @@ module Aws::CloudWatch
     #   })
     # @param [Hash] options ({})
     # @option options [required, Array<Types::MetricDatum>] :metric_data
-    #   The data for the metric. The array can include no more than 20 metrics
-    #   per call.
+    #   The data for the metric. The array can include no more than 1000
+    #   metrics per call.
     # @return [EmptyStructure]
     def put_data(options = {})
       options = Aws::Util.deep_merge(options,
         namespace: @namespace,
         metric_data: [{ metric_name: @name }]
       )
-      resp = @client.put_metric_data(options)
+      resp = Aws::Plugins::UserAgent.feature('resource') do
+        @client.put_metric_data(options)
+      end
       resp.data
     end
 
@@ -689,7 +808,9 @@ module Aws::CloudWatch
           namespace: @namespace,
           metric_name: @name
         )
-        resp = @client.describe_alarms_for_metric(options)
+        resp = Aws::Plugins::UserAgent.feature('resource') do
+          @client.describe_alarms_for_metric(options)
+        end
         resp.data.metric_alarms.each do |m|
           batch << Alarm.new(
             name: m.alarm_name,

data/lib/aws-sdk-cloudwatch/plugins/endpoints.rb

@@ -0,0 +1,144 @@
+# frozen_string_literal: true
+
+# WARNING ABOUT GENERATED CODE
+#
+# This file is generated. See the contributing guide for more information:
+# https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md
+#
+# WARNING ABOUT GENERATED CODE
+
+
+module Aws::CloudWatch
+  module Plugins
+    class Endpoints < Seahorse::Client::Plugin
+      option(
+        :endpoint_provider,
+        doc_type: 'Aws::CloudWatch::EndpointProvider',
+        docstring: 'The endpoint provider used to resolve endpoints. Any '\
+                   'object that responds to `#resolve_endpoint(parameters)` '\
+                   'where `parameters` is a Struct similar to '\
+                   '`Aws::CloudWatch::EndpointParameters`'
+      ) do |cfg|
+        Aws::CloudWatch::EndpointProvider.new
+      end
+
+      # @api private
+      class Handler < Seahorse::Client::Handler
+        def call(context)
+          # If endpoint was discovered, do not resolve or apply the endpoint.
+          unless context[:discovered_endpoint]
+            params = parameters_for_operation(context)
+            endpoint = context.config.endpoint_provider.resolve_endpoint(params)
+
+            context.http_request.endpoint = endpoint.url
+            apply_endpoint_headers(context, endpoint.headers)
+          end
+
+          context[:endpoint_params] = params
+          context[:auth_scheme] =
+            Aws::Endpoints.resolve_auth_scheme(context, endpoint)
+
+          @handler.call(context)
+        end
+
+        private
+
+        def apply_endpoint_headers(context, headers)
+          headers.each do |key, values|
+            value = values
+              .compact
+              .map { |s| Seahorse::Util.escape_header_list_string(s.to_s) }
+              .join(',')
+
+            context.http_request.headers[key] = value
+          end
+        end
+
+        def parameters_for_operation(context)
+          case context.operation_name
+          when :delete_alarms
+            Aws::CloudWatch::Endpoints::DeleteAlarms.build(context)
+          when :delete_anomaly_detector
+            Aws::CloudWatch::Endpoints::DeleteAnomalyDetector.build(context)
+          when :delete_dashboards
+            Aws::CloudWatch::Endpoints::DeleteDashboards.build(context)
+          when :delete_insight_rules
+            Aws::CloudWatch::Endpoints::DeleteInsightRules.build(context)
+          when :delete_metric_stream
+            Aws::CloudWatch::Endpoints::DeleteMetricStream.build(context)
+          when :describe_alarm_history
+            Aws::CloudWatch::Endpoints::DescribeAlarmHistory.build(context)
+          when :describe_alarms
+            Aws::CloudWatch::Endpoints::DescribeAlarms.build(context)
+          when :describe_alarms_for_metric
+            Aws::CloudWatch::Endpoints::DescribeAlarmsForMetric.build(context)
+          when :describe_anomaly_detectors
+            Aws::CloudWatch::Endpoints::DescribeAnomalyDetectors.build(context)
+          when :describe_insight_rules
+            Aws::CloudWatch::Endpoints::DescribeInsightRules.build(context)
+          when :disable_alarm_actions
+            Aws::CloudWatch::Endpoints::DisableAlarmActions.build(context)
+          when :disable_insight_rules
+            Aws::CloudWatch::Endpoints::DisableInsightRules.build(context)
+          when :enable_alarm_actions
+            Aws::CloudWatch::Endpoints::EnableAlarmActions.build(context)
+          when :enable_insight_rules
+            Aws::CloudWatch::Endpoints::EnableInsightRules.build(context)
+          when :get_dashboard
+            Aws::CloudWatch::Endpoints::GetDashboard.build(context)
+          when :get_insight_rule_report
+            Aws::CloudWatch::Endpoints::GetInsightRuleReport.build(context)
+          when :get_metric_data
+            Aws::CloudWatch::Endpoints::GetMetricData.build(context)
+          when :get_metric_statistics
+            Aws::CloudWatch::Endpoints::GetMetricStatistics.build(context)
+          when :get_metric_stream
+            Aws::CloudWatch::Endpoints::GetMetricStream.build(context)
+          when :get_metric_widget_image
+            Aws::CloudWatch::Endpoints::GetMetricWidgetImage.build(context)
+          when :list_dashboards
+            Aws::CloudWatch::Endpoints::ListDashboards.build(context)
+          when :list_managed_insight_rules
+            Aws::CloudWatch::Endpoints::ListManagedInsightRules.build(context)
+          when :list_metric_streams
+            Aws::CloudWatch::Endpoints::ListMetricStreams.build(context)
+          when :list_metrics
+            Aws::CloudWatch::Endpoints::ListMetrics.build(context)
+          when :list_tags_for_resource
+            Aws::CloudWatch::Endpoints::ListTagsForResource.build(context)
+          when :put_anomaly_detector
+            Aws::CloudWatch::Endpoints::PutAnomalyDetector.build(context)
+          when :put_composite_alarm
+            Aws::CloudWatch::Endpoints::PutCompositeAlarm.build(context)
+          when :put_dashboard
+            Aws::CloudWatch::Endpoints::PutDashboard.build(context)
+          when :put_insight_rule
+            Aws::CloudWatch::Endpoints::PutInsightRule.build(context)
+          when :put_managed_insight_rules
+            Aws::CloudWatch::Endpoints::PutManagedInsightRules.build(context)
+          when :put_metric_alarm
+            Aws::CloudWatch::Endpoints::PutMetricAlarm.build(context)
+          when :put_metric_data
+            Aws::CloudWatch::Endpoints::PutMetricData.build(context)
+          when :put_metric_stream
+            Aws::CloudWatch::Endpoints::PutMetricStream.build(context)
+          when :set_alarm_state
+            Aws::CloudWatch::Endpoints::SetAlarmState.build(context)
+          when :start_metric_streams
+            Aws::CloudWatch::Endpoints::StartMetricStreams.build(context)
+          when :stop_metric_streams
+            Aws::CloudWatch::Endpoints::StopMetricStreams.build(context)
+          when :tag_resource
+            Aws::CloudWatch::Endpoints::TagResource.build(context)
+          when :untag_resource
+            Aws::CloudWatch::Endpoints::UntagResource.build(context)
+          end
+        end
+      end
+
+      def add_handlers(handlers, _config)
+        handlers.add(Handler, step: :build, priority: 75)
+      end
+    end
+  end
+end

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

@@ -67,7 +67,15 @@ module Aws::CloudWatch
     # @option options [Array<String>] :alarm_types
     #   Use this parameter to specify whether you want the operation to return
     #   metric alarms or composite alarms. If you omit this parameter, only
-    #   metric alarms are returned.
+    #   metric alarms are returned, even if composite alarms exist in the
+    #   account.
+    #
+    #   For example, if you omit this parameter or specify `MetricAlarms`, the
+    #   operation returns only a list of metric alarms. It does not return any
+    #   composite alarms, even if composite alarms exist in the account.
+    #
+    #   If you specify `CompositeAlarms`, the operation returns only a list of
+    #   composite alarms, and does not return any metric alarms.
     # @option options [String] :children_of_alarm_name
     #   If you use this parameter and specify the name of a composite alarm,
     #   the operation returns information about the "children" alarms of the
@@ -117,7 +125,9 @@ module Aws::CloudWatch
     # @return [Alarm::Collection]
     def alarms(options = {})
       batches = Enumerator.new do |y|
-        resp = @client.describe_alarms(options)
+        resp = Aws::Plugins::UserAgent.feature('resource') do
+          @client.describe_alarms(options)
+        end
         resp.each_page do |page|
           batch = []
           page.data.metric_alarms.each do |m|
@@ -165,7 +175,15 @@ module Aws::CloudWatch
     # @option options [Array<String>] :alarm_types
     #   Use this parameter to specify whether you want the operation to return
     #   metric alarms or composite alarms. If you omit this parameter, only
-    #   metric alarms are returned.
+    #   metric alarms are returned, even if composite alarms exist in the
+    #   account.
+    #
+    #   For example, if you omit this parameter or specify `MetricAlarms`, the
+    #   operation returns only a list of metric alarms. It does not return any
+    #   composite alarms, even if composite alarms exist in the account.
+    #
+    #   If you specify `CompositeAlarms`, the operation returns only a list of
+    #   composite alarms, and does not return any metric alarms.
     # @option options [String] :children_of_alarm_name
     #   If you use this parameter and specify the name of a composite alarm,
     #   the operation returns information about the "children" alarms of the
@@ -215,7 +233,9 @@ module Aws::CloudWatch
     # @return [CompositeAlarm::Collection]
     def composite_alarms(options = {})
       batches = Enumerator.new do |y|
-        resp = @client.describe_alarms(options)
+        resp = Aws::Plugins::UserAgent.feature('resource') do
+          @client.describe_alarms(options)
+        end
         resp.each_page do |page|
           batch = []
           page.data.composite_alarms.each do |c|
@@ -254,6 +274,8 @@ module Aws::CloudWatch
     #       },
     #     ],
     #     recently_active: "PT3H", # accepts PT3H
+    #     include_linked_accounts: false,
+    #     owning_account: "AccountId",
     #   })
     # @param [Hash] options ({})
     # @option options [String] :namespace
@@ -274,10 +296,22 @@ module Aws::CloudWatch
     #   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.
+    # @option options [Boolean] :include_linked_accounts
+    #   If you are using this operation in a monitoring account, specify
+    #   `true` to include metrics from source accounts in the returned data.
+    #
+    #   The default is `false`.
+    # @option options [String] :owning_account
+    #   When you use this operation in a monitoring account, use this field to
+    #   return metrics only from one source account. To do so, specify that
+    #   source account ID in this field, and also specify `true` for
+    #   `IncludeLinkedAccounts`.
     # @return [Metric::Collection]
     def metrics(options = {})
       batches = Enumerator.new do |y|
-        resp = @client.list_metrics(options)
+        resp = Aws::Plugins::UserAgent.feature('resource') do
+          @client.list_metrics(options)
+        end
         resp.each_page do |page|
           batch = []
           page.data.metrics.each do |m|