aws-sdk-cloudwatch 1.148.0 → 1.150.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -594,6 +594,74 @@ module Aws::CloudWatch
594
594
  req.send_request(options)
595
595
  end
596
596
 
597
+ # Creates a resource metrics configuration for an Amazon Web Services
598
+ # resource. After you create a configuration, Amazon CloudWatch collects
599
+ # detailed metrics for that resource.
600
+ #
601
+ # Each Amazon Web Services resource can have only one resource metrics
602
+ # configuration. If a configuration already exists for the specified
603
+ # resource ARN, this operation returns a `ConflictException`. To modify
604
+ # an existing configuration, use
605
+ # [UpdateResourceMetricsConfiguration][1].
606
+ #
607
+ # If the Amazon Web Services resource that you specify in `ResourceArn`
608
+ # does not exist, this operation returns a `ResourceNotFoundException`.
609
+ # Verify that the resource ARN is correct and that the resource exists
610
+ # before you retry the request.
611
+ #
612
+ # To create a resource metrics configuration, you must have the
613
+ # `cloudwatch:CreateResourceMetricsConfiguration` permission. For
614
+ # information about scoping this permission to specific resources, see
615
+ # [Condition keys for resource metrics configuration access][2] in the
616
+ # *Amazon CloudWatch User Guide*.
617
+ #
618
+ #
619
+ #
620
+ # [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_UpdateResourceMetricsConfiguration.html
621
+ # [2]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/iam-cw-condition-keys-resource-arn.html
622
+ #
623
+ # @option params [required, String] :resource_arn
624
+ # The Amazon Resource Name (ARN) of the Amazon Web Services resource to
625
+ # enable detailed monitoring for.
626
+ #
627
+ # @option params [Array<Types::ResourceMetricSelection>] :metric_selections
628
+ # Specifies which metrics Amazon CloudWatch collects for the resource.
629
+ # If you omit this parameter, Amazon CloudWatch collects all available
630
+ # detailed metrics for the resource.
631
+ #
632
+ # @return [Types::CreateResourceMetricsConfigurationOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
633
+ #
634
+ # * {Types::CreateResourceMetricsConfigurationOutput#resource_metrics_configuration #resource_metrics_configuration} => Types::ResourceMetricsConfiguration
635
+ #
636
+ # @example Request syntax with placeholder values
637
+ #
638
+ # resp = client.create_resource_metrics_configuration({
639
+ # resource_arn: "ResourceArn", # required
640
+ # metric_selections: [
641
+ # {
642
+ # include_metrics: ["MetricName"], # required
643
+ # },
644
+ # ],
645
+ # })
646
+ #
647
+ # @example Response structure
648
+ #
649
+ # resp.resource_metrics_configuration.resource_arn #=> String
650
+ # resp.resource_metrics_configuration.created_at #=> Time
651
+ # resp.resource_metrics_configuration.updated_at #=> Time
652
+ # resp.resource_metrics_configuration.metric_selections #=> Array
653
+ # resp.resource_metrics_configuration.metric_selections[0].include_metrics #=> Array
654
+ # resp.resource_metrics_configuration.metric_selections[0].include_metrics[0] #=> String
655
+ #
656
+ # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/CreateResourceMetricsConfiguration AWS API Documentation
657
+ #
658
+ # @overload create_resource_metrics_configuration(params = {})
659
+ # @param [Hash] params ({})
660
+ def create_resource_metrics_configuration(params = {}, options = {})
661
+ req = build_request(:create_resource_metrics_configuration, params)
662
+ req.send_request(options)
663
+ end
664
+
597
665
  # Deletes a specific alarm mute rule.
598
666
  #
599
667
  # When you delete a mute rule, any alarms that are currently being muted
@@ -903,6 +971,46 @@ module Aws::CloudWatch
903
971
  req.send_request(options)
904
972
  end
905
973
 
974
+ # Deletes the resource metrics configuration for an Amazon Web Services
975
+ # resource. After you delete the configuration, Amazon CloudWatch stops
976
+ # collecting detailed metrics for the resource. Metric data that Amazon
977
+ # CloudWatch already collected for the resource is not deleted.
978
+ #
979
+ # This operation returns a `ResourceNotFoundException` if no resource
980
+ # metrics configuration exists for the specified resource ARN. Verify
981
+ # that the resource ARN is correct.
982
+ #
983
+ # To delete a resource metrics configuration, you must have the
984
+ # `cloudwatch:DeleteResourceMetricsConfiguration` permission. For
985
+ # information about scoping this permission to specific resources, see
986
+ # [Condition keys for resource metrics configuration access][1] in the
987
+ # *Amazon CloudWatch User Guide*.
988
+ #
989
+ #
990
+ #
991
+ # [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/iam-cw-condition-keys-resource-arn.html
992
+ #
993
+ # @option params [required, String] :resource_arn
994
+ # The Amazon Resource Name (ARN) of the Amazon Web Services resource to
995
+ # delete the resource metrics configuration for.
996
+ #
997
+ # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
998
+ #
999
+ # @example Request syntax with placeholder values
1000
+ #
1001
+ # resp = client.delete_resource_metrics_configuration({
1002
+ # resource_arn: "ResourceArn", # required
1003
+ # })
1004
+ #
1005
+ # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/DeleteResourceMetricsConfiguration AWS API Documentation
1006
+ #
1007
+ # @overload delete_resource_metrics_configuration(params = {})
1008
+ # @param [Hash] params ({})
1009
+ def delete_resource_metrics_configuration(params = {}, options = {})
1010
+ req = build_request(:delete_resource_metrics_configuration, params)
1011
+ req.send_request(options)
1012
+ end
1013
+
906
1014
  # Returns the information of the current alarm contributors that are in
907
1015
  # `ALARM` state. This operation returns details about the individual
908
1016
  # time series that contribute to the alarm's state.
@@ -1178,6 +1286,11 @@ module Aws::CloudWatch
1178
1286
  # resp.composite_alarms[0].actions_suppressor #=> String
1179
1287
  # resp.composite_alarms[0].actions_suppressor_wait_period #=> Integer
1180
1288
  # resp.composite_alarms[0].actions_suppressor_extension_period #=> Integer
1289
+ # resp.composite_alarms[0].action_configuration.alarm_tags_propagation.enabled #=> Boolean
1290
+ # resp.composite_alarms[0].action_configuration.alarm_tags_propagation.included_tag_keys #=> Array
1291
+ # resp.composite_alarms[0].action_configuration.alarm_tags_propagation.included_tag_keys[0] #=> String
1292
+ # resp.composite_alarms[0].action_configuration.alarm_tags_propagation.excluded_tag_keys #=> Array
1293
+ # resp.composite_alarms[0].action_configuration.alarm_tags_propagation.excluded_tag_keys[0] #=> String
1181
1294
  # resp.metric_alarms #=> Array
1182
1295
  # resp.metric_alarms[0].alarm_name #=> String
1183
1296
  # resp.metric_alarms[0].alarm_arn #=> String
@@ -1234,6 +1347,11 @@ module Aws::CloudWatch
1234
1347
  # resp.metric_alarms[0].evaluation_criteria.prom_ql_criteria.pending_period #=> Integer
1235
1348
  # resp.metric_alarms[0].evaluation_criteria.prom_ql_criteria.recovery_period #=> Integer
1236
1349
  # resp.metric_alarms[0].evaluation_interval #=> Integer
1350
+ # resp.metric_alarms[0].action_configuration.alarm_tags_propagation.enabled #=> Boolean
1351
+ # resp.metric_alarms[0].action_configuration.alarm_tags_propagation.included_tag_keys #=> Array
1352
+ # resp.metric_alarms[0].action_configuration.alarm_tags_propagation.included_tag_keys[0] #=> String
1353
+ # resp.metric_alarms[0].action_configuration.alarm_tags_propagation.excluded_tag_keys #=> Array
1354
+ # resp.metric_alarms[0].action_configuration.alarm_tags_propagation.excluded_tag_keys[0] #=> String
1237
1355
  # resp.log_alarms #=> Array
1238
1356
  # resp.log_alarms[0].alarm_name #=> String
1239
1357
  # resp.log_alarms[0].alarm_arn #=> String
@@ -1273,6 +1391,11 @@ module Aws::CloudWatch
1273
1391
  # resp.log_alarms[0].action_log_line_role_arn #=> String
1274
1392
  # resp.log_alarms[0].warm_up_configuration.warm_up_period_duration_in_minutes #=> Integer
1275
1393
  # resp.log_alarms[0].warm_up_configuration.only_start_evaluating_after_warm_up_period_ends #=> Boolean
1394
+ # resp.log_alarms[0].action_configuration.alarm_tags_propagation.enabled #=> Boolean
1395
+ # resp.log_alarms[0].action_configuration.alarm_tags_propagation.included_tag_keys #=> Array
1396
+ # resp.log_alarms[0].action_configuration.alarm_tags_propagation.included_tag_keys[0] #=> String
1397
+ # resp.log_alarms[0].action_configuration.alarm_tags_propagation.excluded_tag_keys #=> Array
1398
+ # resp.log_alarms[0].action_configuration.alarm_tags_propagation.excluded_tag_keys[0] #=> String
1276
1399
  # resp.next_token #=> String
1277
1400
  #
1278
1401
  #
@@ -1403,6 +1526,11 @@ module Aws::CloudWatch
1403
1526
  # resp.metric_alarms[0].evaluation_criteria.prom_ql_criteria.pending_period #=> Integer
1404
1527
  # resp.metric_alarms[0].evaluation_criteria.prom_ql_criteria.recovery_period #=> Integer
1405
1528
  # resp.metric_alarms[0].evaluation_interval #=> Integer
1529
+ # resp.metric_alarms[0].action_configuration.alarm_tags_propagation.enabled #=> Boolean
1530
+ # resp.metric_alarms[0].action_configuration.alarm_tags_propagation.included_tag_keys #=> Array
1531
+ # resp.metric_alarms[0].action_configuration.alarm_tags_propagation.included_tag_keys[0] #=> String
1532
+ # resp.metric_alarms[0].action_configuration.alarm_tags_propagation.excluded_tag_keys #=> Array
1533
+ # resp.metric_alarms[0].action_configuration.alarm_tags_propagation.excluded_tag_keys[0] #=> String
1406
1534
  #
1407
1535
  # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/DescribeAlarmsForMetric AWS API Documentation
1408
1536
  #
@@ -1849,6 +1977,19 @@ module Aws::CloudWatch
1849
1977
  # data returned within `DashboardBody` as the template for the new
1850
1978
  # dashboard when you call `PutDashboard` to create the copy.
1851
1979
  #
1980
+ # You might have recently enabled an [opt-in Region (Region that is
1981
+ # disabled by default)][1] for your account. In that Region,
1982
+ # `GetDashboard` can return an access denied error for up to 24 hours
1983
+ # after you enable the Region. This delay occurs while dashboard data
1984
+ # propagates. The error does not indicate a problem with your
1985
+ # permissions. Because dashboards are global, you can call
1986
+ # `GetDashboard` in any other enabled Region, or retry after propagation
1987
+ # completes.
1988
+ #
1989
+ #
1990
+ #
1991
+ # [1]: https://docs.aws.amazon.com/glossary/latest/reference/glos-chap.html#optinregion
1992
+ #
1852
1993
  # @option params [required, String] :dashboard_name
1853
1994
  # The name of the dashboard to be described.
1854
1995
  #
@@ -2094,9 +2235,11 @@ module Aws::CloudWatch
2094
2235
  # If you include a Metrics Insights query, each `GetMetricData`
2095
2236
  # operation can include only one query. But the same `GetMetricData`
2096
2237
  # operation can also retrieve other metrics. Metrics Insights queries
2097
- # can query only the most recent three hours of metric data. For more
2098
- # information about Metrics Insights, see [Query your metrics with
2099
- # CloudWatch Metrics Insights][2].
2238
+ # can query the most recent two weeks of metric data. For alarm
2239
+ # condition evaluations, Metrics Insights queries can query only the
2240
+ # most recent three hours of metric data. For more information about
2241
+ # Metrics Insights, see [Query your metrics with CloudWatch Metrics
2242
+ # Insights][2].
2100
2243
  #
2101
2244
  # Calls to the `GetMetricData` API have a different pricing structure
2102
2245
  # than calls to `GetMetricStatistics`. For more information about
@@ -2583,6 +2726,14 @@ module Aws::CloudWatch
2583
2726
  # regularly, such as every minute, and create your own custom live
2584
2727
  # dashboard.
2585
2728
  #
2729
+ # <note markdown="1"> `GetMetricWidgetImage` is not available in the Amazon Web Services
2730
+ # GovCloud (US) Regions. In those Regions, calls to this operation fail.
2731
+ # For the list of Amazon CloudWatch features that are not available in
2732
+ # Amazon Web Services GovCloud (US), see [Amazon CloudWatch in Amazon
2733
+ # Web Services GovCloud (US)][1].
2734
+ #
2735
+ # </note>
2736
+ #
2586
2737
  # The graph you retrieve can include all CloudWatch metric graph
2587
2738
  # features, including metric math and horizontal and vertical
2588
2739
  # annotations.
@@ -2594,6 +2745,10 @@ module Aws::CloudWatch
2594
2745
  #
2595
2746
  # * Up to 100 KB uncompressed payload.
2596
2747
  #
2748
+ #
2749
+ #
2750
+ # [1]: https://docs.aws.amazon.com/govcloud-us/latest/UserGuide/govcloud-cw.html
2751
+ #
2597
2752
  # @option params [required, String] :metric_widget
2598
2753
  # A JSON string that defines the bitmap graph to be retrieved. The
2599
2754
  # string includes the metrics to include in the graph, statistics,
@@ -2681,10 +2836,24 @@ module Aws::CloudWatch
2681
2836
  # @return [Types::GetOTelEnrichmentOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2682
2837
  #
2683
2838
  # * {Types::GetOTelEnrichmentOutput#status #status} => String
2839
+ # * {Types::GetOTelEnrichmentOutput#include_filters #include_filters} => Array&lt;Types::OTelEnrichmentMetricSelector&gt;
2840
+ # * {Types::GetOTelEnrichmentOutput#exclude_filters #exclude_filters} => Array&lt;Types::OTelEnrichmentMetricSelector&gt;
2841
+ # * {Types::GetOTelEnrichmentOutput#created_at #created_at} => Time
2842
+ # * {Types::GetOTelEnrichmentOutput#updated_at #updated_at} => Time
2684
2843
  #
2685
2844
  # @example Response structure
2686
2845
  #
2687
2846
  # resp.status #=> String, one of "Running", "Stopped"
2847
+ # resp.include_filters #=> Array
2848
+ # resp.include_filters[0].namespace #=> String
2849
+ # resp.include_filters[0].metric_names #=> Array
2850
+ # resp.include_filters[0].metric_names[0] #=> String
2851
+ # resp.exclude_filters #=> Array
2852
+ # resp.exclude_filters[0].namespace #=> String
2853
+ # resp.exclude_filters[0].metric_names #=> Array
2854
+ # resp.exclude_filters[0].metric_names[0] #=> String
2855
+ # resp.created_at #=> Time
2856
+ # resp.updated_at #=> Time
2688
2857
  #
2689
2858
  # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/GetOTelEnrichment AWS API Documentation
2690
2859
  #
@@ -2695,6 +2864,58 @@ module Aws::CloudWatch
2695
2864
  req.send_request(options)
2696
2865
  end
2697
2866
 
2867
+ # Retrieves the current resource metrics configuration for an Amazon Web
2868
+ # Services resource. The response includes the resource ARN, any metric
2869
+ # selections, and the times at which the configuration was created and
2870
+ # last updated.
2871
+ #
2872
+ # This operation returns a `ResourceNotFoundException` if no resource
2873
+ # metrics configuration exists for the specified resource ARN. To create
2874
+ # a configuration, use [CreateResourceMetricsConfiguration][1].
2875
+ #
2876
+ # To retrieve a resource metrics configuration, you must have the
2877
+ # `cloudwatch:GetResourceMetricsConfiguration` permission. For
2878
+ # information about scoping this permission to specific resources, see
2879
+ # [Condition keys for resource metrics configuration access][2] in the
2880
+ # *Amazon CloudWatch User Guide*.
2881
+ #
2882
+ #
2883
+ #
2884
+ # [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_CreateResourceMetricsConfiguration.html
2885
+ # [2]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/iam-cw-condition-keys-resource-arn.html
2886
+ #
2887
+ # @option params [required, String] :resource_arn
2888
+ # The Amazon Resource Name (ARN) of the Amazon Web Services resource to
2889
+ # retrieve the resource metrics configuration for.
2890
+ #
2891
+ # @return [Types::GetResourceMetricsConfigurationOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2892
+ #
2893
+ # * {Types::GetResourceMetricsConfigurationOutput#resource_metrics_configuration #resource_metrics_configuration} => Types::ResourceMetricsConfiguration
2894
+ #
2895
+ # @example Request syntax with placeholder values
2896
+ #
2897
+ # resp = client.get_resource_metrics_configuration({
2898
+ # resource_arn: "ResourceArn", # required
2899
+ # })
2900
+ #
2901
+ # @example Response structure
2902
+ #
2903
+ # resp.resource_metrics_configuration.resource_arn #=> String
2904
+ # resp.resource_metrics_configuration.created_at #=> Time
2905
+ # resp.resource_metrics_configuration.updated_at #=> Time
2906
+ # resp.resource_metrics_configuration.metric_selections #=> Array
2907
+ # resp.resource_metrics_configuration.metric_selections[0].include_metrics #=> Array
2908
+ # resp.resource_metrics_configuration.metric_selections[0].include_metrics[0] #=> String
2909
+ #
2910
+ # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/GetResourceMetricsConfiguration AWS API Documentation
2911
+ #
2912
+ # @overload get_resource_metrics_configuration(params = {})
2913
+ # @param [Hash] params ({})
2914
+ def get_resource_metrics_configuration(params = {}, options = {})
2915
+ req = build_request(:get_resource_metrics_configuration, params)
2916
+ req.send_request(options)
2917
+ end
2918
+
2698
2919
  # Lists alarm mute rules in your Amazon Web Services account and region.
2699
2920
  #
2700
2921
  # You can filter the results by alarm name to find all mute rules
@@ -2771,6 +2992,19 @@ module Aws::CloudWatch
2771
2992
  # include the value you received for `NextToken` in the first call, to
2772
2993
  # receive the next 1000 results.
2773
2994
  #
2995
+ # You might have recently enabled an [opt-in Region (Region that is
2996
+ # disabled by default)][1] for your account. In that Region,
2997
+ # `ListDashboards` can return an access denied error for up to 24 hours
2998
+ # after you enable the Region. This delay occurs while dashboard data
2999
+ # propagates. The error does not indicate a problem with your
3000
+ # permissions. Because dashboards are global, you can call
3001
+ # `ListDashboards` in any other enabled Region, or retry after
3002
+ # propagation completes.
3003
+ #
3004
+ #
3005
+ #
3006
+ # [1]: https://docs.aws.amazon.com/glossary/latest/reference/glos-chap.html#optinregion
3007
+ #
2774
3008
  # @option params [String] :dashboard_name_prefix
2775
3009
  # If you specify this parameter, only the dashboards with names starting
2776
3010
  # with the specified string are listed. The maximum length is 255, and
@@ -3591,6 +3825,11 @@ module Aws::CloudWatch
3591
3825
  # `ExtensionPeriod` is required only when `ActionsSuppressor` is
3592
3826
  # specified.
3593
3827
  #
3828
+ # @option params [Types::ActionConfiguration] :action_configuration
3829
+ # Settings that change the content of the notifications and events that
3830
+ # the alarm sends when its state changes. These settings apply to the
3831
+ # alarm's actions, whichever state triggers them.
3832
+ #
3594
3833
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
3595
3834
  #
3596
3835
  # @example Request syntax with placeholder values
@@ -3612,6 +3851,13 @@ module Aws::CloudWatch
3612
3851
  # actions_suppressor: "AlarmArn",
3613
3852
  # actions_suppressor_wait_period: 1,
3614
3853
  # actions_suppressor_extension_period: 1,
3854
+ # action_configuration: {
3855
+ # alarm_tags_propagation: {
3856
+ # enabled: false, # required
3857
+ # included_tag_keys: ["AlarmTagsPropagationTagKey"],
3858
+ # excluded_tag_keys: ["AlarmTagsPropagationTagKey"],
3859
+ # },
3860
+ # },
3615
3861
  # })
3616
3862
  #
3617
3863
  # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/PutCompositeAlarm AWS API Documentation
@@ -3984,6 +4230,11 @@ module Aws::CloudWatch
3984
4230
  #
3985
4231
  # [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/alarm-warm-up.html
3986
4232
  #
4233
+ # @option params [Types::ActionConfiguration] :action_configuration
4234
+ # Settings that change the content of the notifications and events that
4235
+ # the alarm sends when its state changes. These settings apply to the
4236
+ # alarm's actions, whichever state triggers them.
4237
+ #
3987
4238
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
3988
4239
  #
3989
4240
  # @example Request syntax with placeholder values
@@ -4030,6 +4281,13 @@ module Aws::CloudWatch
4030
4281
  # warm_up_period_duration_in_minutes: 1, # required
4031
4282
  # only_start_evaluating_after_warm_up_period_ends: false,
4032
4283
  # },
4284
+ # action_configuration: {
4285
+ # alarm_tags_propagation: {
4286
+ # enabled: false, # required
4287
+ # included_tag_keys: ["AlarmTagsPropagationTagKey"],
4288
+ # excluded_tag_keys: ["AlarmTagsPropagationTagKey"],
4289
+ # },
4290
+ # },
4033
4291
  # })
4034
4292
  #
4035
4293
  # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/PutLogAlarm AWS API Documentation
@@ -4641,6 +4899,11 @@ module Aws::CloudWatch
4641
4899
  # and cannot be specified for alarms configured with `MetricName` or
4642
4900
  # `Metrics`.
4643
4901
  #
4902
+ # @option params [Types::ActionConfiguration] :action_configuration
4903
+ # Settings that change the content of the notifications and events that
4904
+ # the alarm sends when its state changes. These settings apply to the
4905
+ # alarm's actions, whichever state triggers them.
4906
+ #
4644
4907
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
4645
4908
  #
4646
4909
  # @example Request syntax with placeholder values
@@ -4721,6 +4984,13 @@ module Aws::CloudWatch
4721
4984
  # },
4722
4985
  # },
4723
4986
  # evaluation_interval: 1,
4987
+ # action_configuration: {
4988
+ # alarm_tags_propagation: {
4989
+ # enabled: false, # required
4990
+ # included_tag_keys: ["AlarmTagsPropagationTagKey"],
4991
+ # excluded_tag_keys: ["AlarmTagsPropagationTagKey"],
4992
+ # },
4993
+ # },
4724
4994
  # })
4725
4995
  #
4726
4996
  # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/PutMetricAlarm AWS API Documentation
@@ -5231,12 +5501,73 @@ module Aws::CloudWatch
5231
5501
  # telemetry for your account. For more information, see [Enable resource
5232
5502
  # tags on telemetry][2].
5233
5503
  #
5504
+ # Optionally, `IncludeFilters` and `ExcludeFilters` limit enrichment to
5505
+ # a subset of the account's metrics. These filters are stored only when
5506
+ # this operation starts enrichment. Calling `StartOTelEnrichment` for an
5507
+ # account where enrichment is already running has no effect and does not
5508
+ # modify the filters that are applied. To change them, use
5509
+ # [UpdateOTelEnrichment][3].
5510
+ #
5234
5511
  #
5235
5512
  #
5236
5513
  # [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/UsingResourceTagsForTelemetry.html
5237
5514
  # [2]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/EnableResourceTagsOnTelemetry.html
5515
+ # [3]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_UpdateOTelEnrichment.html
5238
5516
  #
5239
- # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
5517
+ # @option params [Array<Types::OTelEnrichmentMetricSelector>] :include_filters
5518
+ # The metric namespaces, and the metric names, to enrich. If this
5519
+ # parameter is omitted, every namespace that Amazon CloudWatch supports
5520
+ # for enrichment is in scope.
5521
+ #
5522
+ # A maximum of 100 filters is allowed across `IncludeFilters` and
5523
+ # `ExcludeFilters` combined.
5524
+ #
5525
+ # @option params [Array<Types::OTelEnrichmentMetricSelector>] :exclude_filters
5526
+ # The metric namespaces, and the metric names, to leave unenriched. If
5527
+ # this parameter is omitted, nothing is excluded.
5528
+ #
5529
+ # Amazon CloudWatch applies `ExcludeFilters` after `IncludeFilters`, so
5530
+ # a metric that both parameters match is not enriched.
5531
+ #
5532
+ # A maximum of 100 filters is allowed across `IncludeFilters` and
5533
+ # `ExcludeFilters` combined.
5534
+ #
5535
+ # @return [Types::StartOTelEnrichmentOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
5536
+ #
5537
+ # * {Types::StartOTelEnrichmentOutput#include_filters #include_filters} => Array&lt;Types::OTelEnrichmentMetricSelector&gt;
5538
+ # * {Types::StartOTelEnrichmentOutput#exclude_filters #exclude_filters} => Array&lt;Types::OTelEnrichmentMetricSelector&gt;
5539
+ # * {Types::StartOTelEnrichmentOutput#created_at #created_at} => Time
5540
+ # * {Types::StartOTelEnrichmentOutput#updated_at #updated_at} => Time
5541
+ #
5542
+ # @example Request syntax with placeholder values
5543
+ #
5544
+ # resp = client.start_o_tel_enrichment({
5545
+ # include_filters: [
5546
+ # {
5547
+ # namespace: "Namespace", # required
5548
+ # metric_names: ["MetricName"],
5549
+ # },
5550
+ # ],
5551
+ # exclude_filters: [
5552
+ # {
5553
+ # namespace: "Namespace", # required
5554
+ # metric_names: ["MetricName"],
5555
+ # },
5556
+ # ],
5557
+ # })
5558
+ #
5559
+ # @example Response structure
5560
+ #
5561
+ # resp.include_filters #=> Array
5562
+ # resp.include_filters[0].namespace #=> String
5563
+ # resp.include_filters[0].metric_names #=> Array
5564
+ # resp.include_filters[0].metric_names[0] #=> String
5565
+ # resp.exclude_filters #=> Array
5566
+ # resp.exclude_filters[0].namespace #=> String
5567
+ # resp.exclude_filters[0].metric_names #=> Array
5568
+ # resp.exclude_filters[0].metric_names[0] #=> String
5569
+ # resp.created_at #=> Time
5570
+ # resp.updated_at #=> Time
5240
5571
  #
5241
5572
  # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/StartOTelEnrichment AWS API Documentation
5242
5573
  #
@@ -5409,6 +5740,156 @@ module Aws::CloudWatch
5409
5740
  req.send_request(options)
5410
5741
  end
5411
5742
 
5743
+ # Replaces the filters that determine which CloudWatch vended metrics
5744
+ # are enriched with resource ARN and resource tag labels for the
5745
+ # account. Enrichment must already be running for the account. If it is
5746
+ # not, this operation returns a `ResourceNotFoundException`. To start
5747
+ # enrichment, use [StartOTelEnrichment][1].
5748
+ #
5749
+ # The filters in the request completely replace the stored filters; they
5750
+ # are not merged with them. `IncludeFilters` and `ExcludeFilters` are
5751
+ # replaced as a pair, so a request that specifies only `IncludeFilters`
5752
+ # also clears the stored `ExcludeFilters`, and a request that specifies
5753
+ # neither clears both.
5754
+ #
5755
+ #
5756
+ #
5757
+ # [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_StartOTelEnrichment.html
5758
+ #
5759
+ # @option params [Array<Types::OTelEnrichmentMetricSelector>] :include_filters
5760
+ # The metric namespaces, and the metric names, to enrich. If this
5761
+ # parameter is omitted, every namespace that Amazon CloudWatch supports
5762
+ # for enrichment is in scope.
5763
+ #
5764
+ # A maximum of 100 filters is allowed across `IncludeFilters` and
5765
+ # `ExcludeFilters` combined.
5766
+ #
5767
+ # @option params [Array<Types::OTelEnrichmentMetricSelector>] :exclude_filters
5768
+ # The metric namespaces, and the metric names, to leave unenriched. If
5769
+ # this parameter is omitted, nothing is excluded.
5770
+ #
5771
+ # Amazon CloudWatch applies `ExcludeFilters` after `IncludeFilters`, so
5772
+ # a metric that both parameters match is not enriched.
5773
+ #
5774
+ # A maximum of 100 filters is allowed across `IncludeFilters` and
5775
+ # `ExcludeFilters` combined.
5776
+ #
5777
+ # @return [Types::UpdateOTelEnrichmentOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
5778
+ #
5779
+ # * {Types::UpdateOTelEnrichmentOutput#include_filters #include_filters} => Array&lt;Types::OTelEnrichmentMetricSelector&gt;
5780
+ # * {Types::UpdateOTelEnrichmentOutput#exclude_filters #exclude_filters} => Array&lt;Types::OTelEnrichmentMetricSelector&gt;
5781
+ # * {Types::UpdateOTelEnrichmentOutput#created_at #created_at} => Time
5782
+ # * {Types::UpdateOTelEnrichmentOutput#updated_at #updated_at} => Time
5783
+ #
5784
+ # @example Request syntax with placeholder values
5785
+ #
5786
+ # resp = client.update_o_tel_enrichment({
5787
+ # include_filters: [
5788
+ # {
5789
+ # namespace: "Namespace", # required
5790
+ # metric_names: ["MetricName"],
5791
+ # },
5792
+ # ],
5793
+ # exclude_filters: [
5794
+ # {
5795
+ # namespace: "Namespace", # required
5796
+ # metric_names: ["MetricName"],
5797
+ # },
5798
+ # ],
5799
+ # })
5800
+ #
5801
+ # @example Response structure
5802
+ #
5803
+ # resp.include_filters #=> Array
5804
+ # resp.include_filters[0].namespace #=> String
5805
+ # resp.include_filters[0].metric_names #=> Array
5806
+ # resp.include_filters[0].metric_names[0] #=> String
5807
+ # resp.exclude_filters #=> Array
5808
+ # resp.exclude_filters[0].namespace #=> String
5809
+ # resp.exclude_filters[0].metric_names #=> Array
5810
+ # resp.exclude_filters[0].metric_names[0] #=> String
5811
+ # resp.created_at #=> Time
5812
+ # resp.updated_at #=> Time
5813
+ #
5814
+ # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/UpdateOTelEnrichment AWS API Documentation
5815
+ #
5816
+ # @overload update_o_tel_enrichment(params = {})
5817
+ # @param [Hash] params ({})
5818
+ def update_o_tel_enrichment(params = {}, options = {})
5819
+ req = build_request(:update_o_tel_enrichment, params)
5820
+ req.send_request(options)
5821
+ end
5822
+
5823
+ # Updates the resource metrics configuration for an Amazon Web Services
5824
+ # resource. The `MetricSelections` value that you provide replaces any
5825
+ # existing metric selections for the resource; it is not merged with
5826
+ # them.
5827
+ #
5828
+ # If you omit `MetricSelections`, Amazon CloudWatch removes any existing
5829
+ # metric selection filter and collects all available detailed metrics
5830
+ # for the resource.
5831
+ #
5832
+ # This operation returns a `ResourceNotFoundException` if no resource
5833
+ # metrics configuration exists for the specified resource ARN. To create
5834
+ # a configuration, use [CreateResourceMetricsConfiguration][1].
5835
+ #
5836
+ # To update a resource metrics configuration, you must have the
5837
+ # `cloudwatch:UpdateResourceMetricsConfiguration` permission. For
5838
+ # information about scoping this permission to specific resources, see
5839
+ # [Condition keys for resource metrics configuration access][2] in the
5840
+ # *Amazon CloudWatch User Guide*.
5841
+ #
5842
+ #
5843
+ #
5844
+ # [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_CreateResourceMetricsConfiguration.html
5845
+ # [2]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/iam-cw-condition-keys-resource-arn.html
5846
+ #
5847
+ # @option params [required, String] :resource_arn
5848
+ # The Amazon Resource Name (ARN) of the Amazon Web Services resource to
5849
+ # update the resource metrics configuration for.
5850
+ #
5851
+ # @option params [Array<Types::ResourceMetricSelection>] :metric_selections
5852
+ # Specifies which metrics Amazon CloudWatch collects for the resource.
5853
+ # The selections that you provide completely replace any existing metric
5854
+ # selections.
5855
+ #
5856
+ # If you omit this parameter, Amazon CloudWatch removes any existing
5857
+ # metric selection filter and collects all available detailed metrics
5858
+ # for the resource.
5859
+ #
5860
+ # @return [Types::UpdateResourceMetricsConfigurationOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
5861
+ #
5862
+ # * {Types::UpdateResourceMetricsConfigurationOutput#resource_metrics_configuration #resource_metrics_configuration} => Types::ResourceMetricsConfiguration
5863
+ #
5864
+ # @example Request syntax with placeholder values
5865
+ #
5866
+ # resp = client.update_resource_metrics_configuration({
5867
+ # resource_arn: "ResourceArn", # required
5868
+ # metric_selections: [
5869
+ # {
5870
+ # include_metrics: ["MetricName"], # required
5871
+ # },
5872
+ # ],
5873
+ # })
5874
+ #
5875
+ # @example Response structure
5876
+ #
5877
+ # resp.resource_metrics_configuration.resource_arn #=> String
5878
+ # resp.resource_metrics_configuration.created_at #=> Time
5879
+ # resp.resource_metrics_configuration.updated_at #=> Time
5880
+ # resp.resource_metrics_configuration.metric_selections #=> Array
5881
+ # resp.resource_metrics_configuration.metric_selections[0].include_metrics #=> Array
5882
+ # resp.resource_metrics_configuration.metric_selections[0].include_metrics[0] #=> String
5883
+ #
5884
+ # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/UpdateResourceMetricsConfiguration AWS API Documentation
5885
+ #
5886
+ # @overload update_resource_metrics_configuration(params = {})
5887
+ # @param [Hash] params ({})
5888
+ def update_resource_metrics_configuration(params = {}, options = {})
5889
+ req = build_request(:update_resource_metrics_configuration, params)
5890
+ req.send_request(options)
5891
+ end
5892
+
5412
5893
  # @!endgroup
5413
5894
 
5414
5895
  # @param params ({})
@@ -5427,7 +5908,7 @@ module Aws::CloudWatch
5427
5908
  tracer: tracer
5428
5909
  )
5429
5910
  context[:gem_name] = 'aws-sdk-cloudwatch'
5430
- context[:gem_version] = '1.148.0'
5911
+ context[:gem_version] = '1.150.0'
5431
5912
  Seahorse::Client::Request.new(handlers, context)
5432
5913
  end
5433
5914