aws-sdk-cloudwatch 1.120.0 → 1.121.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.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 24bad3758a98211d0a2a23dfbfa90b2bad80d29aef289fa2572c7df71a7413b7
4
- data.tar.gz: aa83b936516541343a6ee63f9c817d7294ab7e6d9ea814a06248a9e249cff480
3
+ metadata.gz: 8a03add7d40bed51f7c7c3288a0f106bafb4c9e4c2e6b460a1322f53fb6aba2d
4
+ data.tar.gz: 620618f349923856af6cd7251407f9519513cc171d4d30de55b96029820d456a
5
5
  SHA512:
6
- metadata.gz: 70d1752f7328485e8335d47c660b94fdfce599f1fd41c9955c4abceeffc58cfc52350cf5334e8434d5a4e44d4e19c9e167932f4b604d800e3b18a525bfaa7a20
7
- data.tar.gz: bc19436406fd85fdf9b7c2bc46e84e1fb1910db7128e2c90da16021f515d9be4b881b772596fa72cbb41006802c94fba8224a0744f25cfc4c3ca6fe1c6221a44
6
+ metadata.gz: 35e7f704a02ba5e3a0a9994bd5aecff28483ebb2629ee7268d6da151d95a70f2c6f2fbb47de471df6214e04d2e5703939de66c04ba3771db5998161f447ebabb
7
+ data.tar.gz: bdb4988441063d2cb42fca27804abaf04a5824b6e99114c40e1f6363e32150da545f57f0a01279795c1f6f0802b47e335be5d41d0a7ad3aa6b12148f9ec9c4d0
data/CHANGELOG.md CHANGED
@@ -1,6 +1,11 @@
1
1
  Unreleased Changes
2
2
  ------------------
3
3
 
4
+ 1.121.0 (2025-09-09)
5
+ ------------------
6
+
7
+ * Feature - Added a new API - DescribeAlarmContributors API, to retrieve alarm contributors in ALARM state. Added support in DescribeAlarmHistory API to query alarm contributor history
8
+
4
9
  1.120.0 (2025-08-26)
5
10
  ------------------
6
11
 
data/VERSION CHANGED
@@ -1 +1 @@
1
- 1.120.0
1
+ 1.121.0
@@ -431,8 +431,9 @@ module Aws::CloudWatch
431
431
  # @example Request syntax with placeholder values
432
432
  #
433
433
  # alarm.describe_history({
434
+ # alarm_contributor_id: "ContributorId",
434
435
  # alarm_types: ["CompositeAlarm"], # accepts CompositeAlarm, MetricAlarm
435
- # history_item_type: "ConfigurationUpdate", # accepts ConfigurationUpdate, StateUpdate, Action
436
+ # history_item_type: "ConfigurationUpdate", # accepts ConfigurationUpdate, StateUpdate, Action, AlarmContributorStateUpdate, AlarmContributorAction
436
437
  # start_date: Time.now,
437
438
  # end_date: Time.now,
438
439
  # max_records: 1,
@@ -440,6 +441,9 @@ module Aws::CloudWatch
440
441
  # scan_by: "TimestampDescending", # accepts TimestampDescending, TimestampAscending
441
442
  # })
442
443
  # @param [Hash] options ({})
444
+ # @option options [String] :alarm_contributor_id
445
+ # The unique identifier of a specific alarm contributor to filter the
446
+ # alarm history results.
443
447
  # @option options [Array<String>] :alarm_types
444
448
  # Use this parameter to specify whether you want the operation to return
445
449
  # metric alarms or composite alarms. If you omit this parameter, only
@@ -744,6 +744,48 @@ module Aws::CloudWatch
744
744
  req.send_request(options)
745
745
  end
746
746
 
747
+ # Returns the information of the current alarm contributors that are in
748
+ # `ALARM` state. This operation returns details about the individual
749
+ # time series that contribute to the alarm's state.
750
+ #
751
+ # @option params [required, String] :alarm_name
752
+ # The name of the alarm for which to retrieve contributor information.
753
+ #
754
+ # @option params [String] :next_token
755
+ # The token returned by a previous call to indicate that there is more
756
+ # data available.
757
+ #
758
+ # @return [Types::DescribeAlarmContributorsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
759
+ #
760
+ # * {Types::DescribeAlarmContributorsOutput#alarm_contributors #alarm_contributors} => Array&lt;Types::AlarmContributor&gt;
761
+ # * {Types::DescribeAlarmContributorsOutput#next_token #next_token} => String
762
+ #
763
+ # @example Request syntax with placeholder values
764
+ #
765
+ # resp = client.describe_alarm_contributors({
766
+ # alarm_name: "AlarmName", # required
767
+ # next_token: "NextToken",
768
+ # })
769
+ #
770
+ # @example Response structure
771
+ #
772
+ # resp.alarm_contributors #=> Array
773
+ # resp.alarm_contributors[0].contributor_id #=> String
774
+ # resp.alarm_contributors[0].contributor_attributes #=> Hash
775
+ # resp.alarm_contributors[0].contributor_attributes["AttributeName"] #=> <Hash,Array,String,Numeric,Boolean,IO,Set,nil>
776
+ # resp.alarm_contributors[0].state_reason #=> String
777
+ # resp.alarm_contributors[0].state_transitioned_timestamp #=> Time
778
+ # resp.next_token #=> String
779
+ #
780
+ # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/DescribeAlarmContributors AWS API Documentation
781
+ #
782
+ # @overload describe_alarm_contributors(params = {})
783
+ # @param [Hash] params ({})
784
+ def describe_alarm_contributors(params = {}, options = {})
785
+ req = build_request(:describe_alarm_contributors, params)
786
+ req.send_request(options)
787
+ end
788
+
747
789
  # Retrieves the history for the specified alarm. You can filter the
748
790
  # results by date range or item type. If an alarm name is not specified,
749
791
  # the histories for either all metric alarms or all composite alarms are
@@ -761,6 +803,10 @@ module Aws::CloudWatch
761
803
  # @option params [String] :alarm_name
762
804
  # The name of the alarm.
763
805
  #
806
+ # @option params [String] :alarm_contributor_id
807
+ # The unique identifier of a specific alarm contributor to filter the
808
+ # alarm history results.
809
+ #
764
810
  # @option params [Array<String>] :alarm_types
765
811
  # Use this parameter to specify whether you want the operation to return
766
812
  # metric alarms or composite alarms. If you omit this parameter, only
@@ -799,8 +845,9 @@ module Aws::CloudWatch
799
845
  #
800
846
  # resp = client.describe_alarm_history({
801
847
  # alarm_name: "AlarmName",
848
+ # alarm_contributor_id: "ContributorId",
802
849
  # alarm_types: ["CompositeAlarm"], # accepts CompositeAlarm, MetricAlarm
803
- # history_item_type: "ConfigurationUpdate", # accepts ConfigurationUpdate, StateUpdate, Action
850
+ # history_item_type: "ConfigurationUpdate", # accepts ConfigurationUpdate, StateUpdate, Action, AlarmContributorStateUpdate, AlarmContributorAction
804
851
  # start_date: Time.now,
805
852
  # end_date: Time.now,
806
853
  # max_records: 1,
@@ -812,11 +859,14 @@ module Aws::CloudWatch
812
859
  #
813
860
  # resp.alarm_history_items #=> Array
814
861
  # resp.alarm_history_items[0].alarm_name #=> String
862
+ # resp.alarm_history_items[0].alarm_contributor_id #=> String
815
863
  # resp.alarm_history_items[0].alarm_type #=> String, one of "CompositeAlarm", "MetricAlarm"
816
864
  # resp.alarm_history_items[0].timestamp #=> Time
817
- # resp.alarm_history_items[0].history_item_type #=> String, one of "ConfigurationUpdate", "StateUpdate", "Action"
865
+ # resp.alarm_history_items[0].history_item_type #=> String, one of "ConfigurationUpdate", "StateUpdate", "Action", "AlarmContributorStateUpdate", "AlarmContributorAction"
818
866
  # resp.alarm_history_items[0].history_summary #=> String
819
867
  # resp.alarm_history_items[0].history_data #=> String
868
+ # resp.alarm_history_items[0].alarm_contributor_attributes #=> Hash
869
+ # resp.alarm_history_items[0].alarm_contributor_attributes["AttributeName"] #=> <Hash,Array,String,Numeric,Boolean,IO,Set,nil>
820
870
  # resp.next_token #=> String
821
871
  #
822
872
  # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/DescribeAlarmHistory AWS API Documentation
@@ -3057,7 +3107,7 @@ module Aws::CloudWatch
3057
3107
  # [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_TagResource.html
3058
3108
  #
3059
3109
  # @option params [Boolean] :apply_on_transformed_logs
3060
- # Specify `true` to have this rule evalute log events after they have
3110
+ # Specify `true` to have this rule evaluate log events after they have
3061
3111
  # been transformed by [Log transformation][1]. If you specify `true`,
3062
3112
  # then the log events in log groups that have transformers will be
3063
3113
  # evaluated by Contributor Insights after being transformed. Log groups
@@ -4345,7 +4395,7 @@ module Aws::CloudWatch
4345
4395
  tracer: tracer
4346
4396
  )
4347
4397
  context[:gem_name] = 'aws-sdk-cloudwatch'
4348
- context[:gem_version] = '1.120.0'
4398
+ context[:gem_version] = '1.121.0'
4349
4399
  Seahorse::Client::Request.new(handlers, context)
4350
4400
  end
4351
4401
 
@@ -20,6 +20,8 @@ module Aws::CloudWatch
20
20
  ActionsSuppressedBy = Shapes::StringShape.new(name: 'ActionsSuppressedBy')
21
21
  ActionsSuppressedReason = Shapes::StringShape.new(name: 'ActionsSuppressedReason')
22
22
  AlarmArn = Shapes::StringShape.new(name: 'AlarmArn')
23
+ AlarmContributor = Shapes::StructureShape.new(name: 'AlarmContributor')
24
+ AlarmContributors = Shapes::ListShape.new(name: 'AlarmContributors')
23
25
  AlarmDescription = Shapes::StringShape.new(name: 'AlarmDescription')
24
26
  AlarmHistoryItem = Shapes::StructureShape.new(name: 'AlarmHistoryItem')
25
27
  AlarmHistoryItems = Shapes::ListShape.new(name: 'AlarmHistoryItems')
@@ -39,6 +41,8 @@ module Aws::CloudWatch
39
41
  AnomalyDetectorType = Shapes::StringShape.new(name: 'AnomalyDetectorType')
40
42
  AnomalyDetectorTypes = Shapes::ListShape.new(name: 'AnomalyDetectorTypes')
41
43
  AnomalyDetectors = Shapes::ListShape.new(name: 'AnomalyDetectors')
44
+ AttributeName = Shapes::StringShape.new(name: 'AttributeName')
45
+ AttributeValue = Shapes::StringShape.new(name: 'AttributeValue')
42
46
  AwsQueryErrorMessage = Shapes::StringShape.new(name: 'AwsQueryErrorMessage')
43
47
  BatchFailures = Shapes::ListShape.new(name: 'BatchFailures')
44
48
  ComparisonOperator = Shapes::StringShape.new(name: 'ComparisonOperator')
@@ -46,6 +50,8 @@ module Aws::CloudWatch
46
50
  CompositeAlarms = Shapes::ListShape.new(name: 'CompositeAlarms')
47
51
  ConcurrentModificationException = Shapes::StructureShape.new(name: 'ConcurrentModificationException', error: {"code" => "ConcurrentModificationException", "httpStatusCode" => 429, "senderFault" => true})
48
52
  ConflictException = Shapes::StructureShape.new(name: 'ConflictException')
53
+ ContributorAttributes = Shapes::MapShape.new(name: 'ContributorAttributes')
54
+ ContributorId = Shapes::StringShape.new(name: 'ContributorId')
49
55
  Counts = Shapes::ListShape.new(name: 'Counts')
50
56
  DashboardArn = Shapes::StringShape.new(name: 'DashboardArn')
51
57
  DashboardBody = Shapes::StringShape.new(name: 'DashboardBody')
@@ -75,6 +81,8 @@ module Aws::CloudWatch
75
81
  DeleteInsightRulesOutput = Shapes::StructureShape.new(name: 'DeleteInsightRulesOutput')
76
82
  DeleteMetricStreamInput = Shapes::StructureShape.new(name: 'DeleteMetricStreamInput')
77
83
  DeleteMetricStreamOutput = Shapes::StructureShape.new(name: 'DeleteMetricStreamOutput')
84
+ DescribeAlarmContributorsInput = Shapes::StructureShape.new(name: 'DescribeAlarmContributorsInput')
85
+ DescribeAlarmContributorsOutput = Shapes::StructureShape.new(name: 'DescribeAlarmContributorsOutput')
78
86
  DescribeAlarmHistoryInput = Shapes::StructureShape.new(name: 'DescribeAlarmHistoryInput')
79
87
  DescribeAlarmHistoryOutput = Shapes::StructureShape.new(name: 'DescribeAlarmHistoryOutput')
80
88
  DescribeAlarmsForMetricInput = Shapes::StructureShape.new(name: 'DescribeAlarmsForMetricInput')
@@ -295,12 +303,22 @@ module Aws::CloudWatch
295
303
  UntagResourceOutput = Shapes::StructureShape.new(name: 'UntagResourceOutput')
296
304
  Values = Shapes::ListShape.new(name: 'Values')
297
305
 
306
+ AlarmContributor.add_member(:contributor_id, Shapes::ShapeRef.new(shape: ContributorId, required: true, location_name: "ContributorId"))
307
+ AlarmContributor.add_member(:contributor_attributes, Shapes::ShapeRef.new(shape: ContributorAttributes, required: true, location_name: "ContributorAttributes"))
308
+ AlarmContributor.add_member(:state_reason, Shapes::ShapeRef.new(shape: StateReason, required: true, location_name: "StateReason"))
309
+ AlarmContributor.add_member(:state_transitioned_timestamp, Shapes::ShapeRef.new(shape: Timestamp, location_name: "StateTransitionedTimestamp"))
310
+ AlarmContributor.struct_class = Types::AlarmContributor
311
+
312
+ AlarmContributors.member = Shapes::ShapeRef.new(shape: AlarmContributor)
313
+
298
314
  AlarmHistoryItem.add_member(:alarm_name, Shapes::ShapeRef.new(shape: AlarmName, location_name: "AlarmName"))
315
+ AlarmHistoryItem.add_member(:alarm_contributor_id, Shapes::ShapeRef.new(shape: ContributorId, location_name: "AlarmContributorId"))
299
316
  AlarmHistoryItem.add_member(:alarm_type, Shapes::ShapeRef.new(shape: AlarmType, location_name: "AlarmType"))
300
317
  AlarmHistoryItem.add_member(:timestamp, Shapes::ShapeRef.new(shape: Timestamp, location_name: "Timestamp"))
301
318
  AlarmHistoryItem.add_member(:history_item_type, Shapes::ShapeRef.new(shape: HistoryItemType, location_name: "HistoryItemType"))
302
319
  AlarmHistoryItem.add_member(:history_summary, Shapes::ShapeRef.new(shape: HistorySummary, location_name: "HistorySummary"))
303
320
  AlarmHistoryItem.add_member(:history_data, Shapes::ShapeRef.new(shape: HistoryData, location_name: "HistoryData"))
321
+ AlarmHistoryItem.add_member(:alarm_contributor_attributes, Shapes::ShapeRef.new(shape: ContributorAttributes, location_name: "AlarmContributorAttributes"))
304
322
  AlarmHistoryItem.struct_class = Types::AlarmHistoryItem
305
323
 
306
324
  AlarmHistoryItems.member = Shapes::ShapeRef.new(shape: AlarmHistoryItem)
@@ -360,6 +378,9 @@ module Aws::CloudWatch
360
378
  ConflictException.add_member(:message, Shapes::ShapeRef.new(shape: ErrorMessage, location_name: "Message"))
361
379
  ConflictException.struct_class = Types::ConflictException
362
380
 
381
+ ContributorAttributes.key = Shapes::ShapeRef.new(shape: AttributeName)
382
+ ContributorAttributes.value = Shapes::ShapeRef.new(shape: AttributeValue)
383
+
363
384
  Counts.member = Shapes::ShapeRef.new(shape: DatapointValue)
364
385
 
365
386
  DashboardEntries.member = Shapes::ShapeRef.new(shape: DashboardEntry)
@@ -431,7 +452,16 @@ module Aws::CloudWatch
431
452
 
432
453
  DeleteMetricStreamOutput.struct_class = Types::DeleteMetricStreamOutput
433
454
 
455
+ DescribeAlarmContributorsInput.add_member(:alarm_name, Shapes::ShapeRef.new(shape: AlarmName, required: true, location_name: "AlarmName"))
456
+ DescribeAlarmContributorsInput.add_member(:next_token, Shapes::ShapeRef.new(shape: NextToken, location_name: "NextToken"))
457
+ DescribeAlarmContributorsInput.struct_class = Types::DescribeAlarmContributorsInput
458
+
459
+ DescribeAlarmContributorsOutput.add_member(:alarm_contributors, Shapes::ShapeRef.new(shape: AlarmContributors, required: true, location_name: "AlarmContributors"))
460
+ DescribeAlarmContributorsOutput.add_member(:next_token, Shapes::ShapeRef.new(shape: NextToken, location_name: "NextToken"))
461
+ DescribeAlarmContributorsOutput.struct_class = Types::DescribeAlarmContributorsOutput
462
+
434
463
  DescribeAlarmHistoryInput.add_member(:alarm_name, Shapes::ShapeRef.new(shape: AlarmName, location_name: "AlarmName"))
464
+ DescribeAlarmHistoryInput.add_member(:alarm_contributor_id, Shapes::ShapeRef.new(shape: ContributorId, location_name: "AlarmContributorId"))
435
465
  DescribeAlarmHistoryInput.add_member(:alarm_types, Shapes::ShapeRef.new(shape: AlarmTypes, location_name: "AlarmTypes"))
436
466
  DescribeAlarmHistoryInput.add_member(:history_item_type, Shapes::ShapeRef.new(shape: HistoryItemType, location_name: "HistoryItemType"))
437
467
  DescribeAlarmHistoryInput.add_member(:start_date, Shapes::ShapeRef.new(shape: Timestamp, location_name: "StartDate"))
@@ -1120,6 +1150,16 @@ module Aws::CloudWatch
1120
1150
  o.errors << Shapes::ShapeRef.new(shape: MissingRequiredParameterException)
1121
1151
  end)
1122
1152
 
1153
+ api.add_operation(:describe_alarm_contributors, Seahorse::Model::Operation.new.tap do |o|
1154
+ o.name = "DescribeAlarmContributors"
1155
+ o.http_method = "POST"
1156
+ o.http_request_uri = "/"
1157
+ o.input = Shapes::ShapeRef.new(shape: DescribeAlarmContributorsInput)
1158
+ o.output = Shapes::ShapeRef.new(shape: DescribeAlarmContributorsOutput)
1159
+ o.errors << Shapes::ShapeRef.new(shape: InvalidNextToken)
1160
+ o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
1161
+ end)
1162
+
1123
1163
  api.add_operation(:describe_alarm_history, Seahorse::Model::Operation.new.tap do |o|
1124
1164
  o.name = "DescribeAlarmHistory"
1125
1165
  o.http_method = "POST"
@@ -359,8 +359,9 @@ module Aws::CloudWatch
359
359
  # @example Request syntax with placeholder values
360
360
  #
361
361
  # composite_alarm.describe_history({
362
+ # alarm_contributor_id: "ContributorId",
362
363
  # alarm_types: ["CompositeAlarm"], # accepts CompositeAlarm, MetricAlarm
363
- # history_item_type: "ConfigurationUpdate", # accepts ConfigurationUpdate, StateUpdate, Action
364
+ # history_item_type: "ConfigurationUpdate", # accepts ConfigurationUpdate, StateUpdate, Action, AlarmContributorStateUpdate, AlarmContributorAction
364
365
  # start_date: Time.now,
365
366
  # end_date: Time.now,
366
367
  # max_records: 1,
@@ -368,6 +369,9 @@ module Aws::CloudWatch
368
369
  # scan_by: "TimestampDescending", # accepts TimestampDescending, TimestampAscending
369
370
  # })
370
371
  # @param [Hash] options ({})
372
+ # @option options [String] :alarm_contributor_id
373
+ # The unique identifier of a specific alarm contributor to filter the
374
+ # alarm history results.
371
375
  # @option options [Array<String>] :alarm_types
372
376
  # Use this parameter to specify whether you want the operation to return
373
377
  # metric alarms or composite alarms. If you omit this parameter, only
@@ -1,8 +0,0 @@
1
- # frozen_string_literal: true
2
- # WARNING ABOUT GENERATED CODE
3
- #
4
- # This file is generated. See the contributing for info on making contributions:
5
- # https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md
6
- #
7
- # WARNING ABOUT GENERATED CODE
8
-
@@ -10,12 +10,51 @@
10
10
  module Aws::CloudWatch
11
11
  module Types
12
12
 
13
+ # Represents an individual contributor to a multi-timeseries alarm,
14
+ # containing information about a specific time series and its
15
+ # contribution to the alarm's state.
16
+ #
17
+ # @!attribute [rw] contributor_id
18
+ # The unique identifier for this alarm contributor.
19
+ # @return [String]
20
+ #
21
+ # @!attribute [rw] contributor_attributes
22
+ # A map of attributes that describe the contributor, such as metric
23
+ # dimensions and other identifying characteristics.
24
+ # @return [Hash<String,String>]
25
+ #
26
+ # @!attribute [rw] state_reason
27
+ # An explanation for the contributor's current state, providing
28
+ # context about why it is in its current condition.
29
+ # @return [String]
30
+ #
31
+ # @!attribute [rw] state_transitioned_timestamp
32
+ # The timestamp when the contributor last transitioned to its current
33
+ # state.
34
+ # @return [Time]
35
+ #
36
+ # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/AlarmContributor AWS API Documentation
37
+ #
38
+ class AlarmContributor < Struct.new(
39
+ :contributor_id,
40
+ :contributor_attributes,
41
+ :state_reason,
42
+ :state_transitioned_timestamp)
43
+ SENSITIVE = []
44
+ include Aws::Structure
45
+ end
46
+
13
47
  # Represents the history of a specific alarm.
14
48
  #
15
49
  # @!attribute [rw] alarm_name
16
50
  # The descriptive name for the alarm.
17
51
  # @return [String]
18
52
  #
53
+ # @!attribute [rw] alarm_contributor_id
54
+ # The unique identifier of the alarm contributor associated with this
55
+ # history item, if applicable.
56
+ # @return [String]
57
+ #
19
58
  # @!attribute [rw] alarm_type
20
59
  # The type of alarm, either metric alarm or composite alarm.
21
60
  # @return [String]
@@ -36,15 +75,23 @@ module Aws::CloudWatch
36
75
  # Data about the alarm, in JSON format.
37
76
  # @return [String]
38
77
  #
78
+ # @!attribute [rw] alarm_contributor_attributes
79
+ # A map of attributes that describe the alarm contributor associated
80
+ # with this history item, providing context about the contributor's
81
+ # characteristics at the time of the event.
82
+ # @return [Hash<String,String>]
83
+ #
39
84
  # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/AlarmHistoryItem AWS API Documentation
40
85
  #
41
86
  class AlarmHistoryItem < Struct.new(
42
87
  :alarm_name,
88
+ :alarm_contributor_id,
43
89
  :alarm_type,
44
90
  :timestamp,
45
91
  :history_item_type,
46
92
  :history_summary,
47
- :history_data)
93
+ :history_data,
94
+ :alarm_contributor_attributes)
48
95
  SENSITIVE = []
49
96
  include Aws::Structure
50
97
  end
@@ -585,10 +632,52 @@ module Aws::CloudWatch
585
632
  #
586
633
  class DeleteMetricStreamOutput < Aws::EmptyStructure; end
587
634
 
635
+ # @!attribute [rw] alarm_name
636
+ # The name of the alarm for which to retrieve contributor information.
637
+ # @return [String]
638
+ #
639
+ # @!attribute [rw] next_token
640
+ # The token returned by a previous call to indicate that there is more
641
+ # data available.
642
+ # @return [String]
643
+ #
644
+ # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/DescribeAlarmContributorsInput AWS API Documentation
645
+ #
646
+ class DescribeAlarmContributorsInput < Struct.new(
647
+ :alarm_name,
648
+ :next_token)
649
+ SENSITIVE = []
650
+ include Aws::Structure
651
+ end
652
+
653
+ # @!attribute [rw] alarm_contributors
654
+ # A list of alarm contributors that provide details about the
655
+ # individual time series contributing to the alarm's state.
656
+ # @return [Array<Types::AlarmContributor>]
657
+ #
658
+ # @!attribute [rw] next_token
659
+ # The token that marks the start of the next batch of returned
660
+ # results.
661
+ # @return [String]
662
+ #
663
+ # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/DescribeAlarmContributorsOutput AWS API Documentation
664
+ #
665
+ class DescribeAlarmContributorsOutput < Struct.new(
666
+ :alarm_contributors,
667
+ :next_token)
668
+ SENSITIVE = []
669
+ include Aws::Structure
670
+ end
671
+
588
672
  # @!attribute [rw] alarm_name
589
673
  # The name of the alarm.
590
674
  # @return [String]
591
675
  #
676
+ # @!attribute [rw] alarm_contributor_id
677
+ # The unique identifier of a specific alarm contributor to filter the
678
+ # alarm history results.
679
+ # @return [String]
680
+ #
592
681
  # @!attribute [rw] alarm_types
593
682
  # Use this parameter to specify whether you want the operation to
594
683
  # return metric alarms or composite alarms. If you omit this
@@ -627,6 +716,7 @@ module Aws::CloudWatch
627
716
  #
628
717
  class DescribeAlarmHistoryInput < Struct.new(
629
718
  :alarm_name,
719
+ :alarm_contributor_id,
630
720
  :alarm_types,
631
721
  :history_item_type,
632
722
  :start_date,
@@ -3681,7 +3771,7 @@ module Aws::CloudWatch
3681
3771
  # @return [Array<Types::Tag>]
3682
3772
  #
3683
3773
  # @!attribute [rw] apply_on_transformed_logs
3684
- # Specify `true` to have this rule evalute log events after they have
3774
+ # Specify `true` to have this rule evaluate log events after they have
3685
3775
  # been transformed by [Log transformation][1]. If you specify `true`,
3686
3776
  # then the log events in log groups that have transformers will be
3687
3777
  # evaluated by Contributor Insights after being transformed. Log
@@ -58,7 +58,7 @@ module Aws::CloudWatch
58
58
  autoload :CompositeAlarm, 'aws-sdk-cloudwatch/composite_alarm'
59
59
  autoload :Metric, 'aws-sdk-cloudwatch/metric'
60
60
 
61
- GEM_VERSION = '1.120.0'
61
+ GEM_VERSION = '1.121.0'
62
62
 
63
63
  end
64
64
 
data/sig/alarm.rbs CHANGED
@@ -129,8 +129,9 @@ module Aws
129
129
 
130
130
  # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/CloudWatch/Alarm.html#describe_history-instance_method
131
131
  def describe_history: (
132
+ ?alarm_contributor_id: ::String,
132
133
  ?alarm_types: Array[("CompositeAlarm" | "MetricAlarm")],
133
- ?history_item_type: ("ConfigurationUpdate" | "StateUpdate" | "Action"),
134
+ ?history_item_type: ("ConfigurationUpdate" | "StateUpdate" | "Action" | "AlarmContributorStateUpdate" | "AlarmContributorAction"),
134
135
  ?start_date: ::Time,
135
136
  ?end_date: ::Time,
136
137
  ?max_records: ::Integer,
data/sig/client.rbs CHANGED
@@ -168,6 +168,18 @@ module Aws
168
168
  ) -> _DeleteMetricStreamResponseSuccess
169
169
  | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _DeleteMetricStreamResponseSuccess
170
170
 
171
+ interface _DescribeAlarmContributorsResponseSuccess
172
+ include ::Seahorse::Client::_ResponseSuccess[Types::DescribeAlarmContributorsOutput]
173
+ def alarm_contributors: () -> ::Array[Types::AlarmContributor]
174
+ def next_token: () -> ::String
175
+ end
176
+ # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/CloudWatch/Client.html#describe_alarm_contributors-instance_method
177
+ def describe_alarm_contributors: (
178
+ alarm_name: ::String,
179
+ ?next_token: ::String
180
+ ) -> _DescribeAlarmContributorsResponseSuccess
181
+ | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _DescribeAlarmContributorsResponseSuccess
182
+
171
183
  interface _DescribeAlarmHistoryResponseSuccess
172
184
  include ::Seahorse::Client::_ResponseSuccess[Types::DescribeAlarmHistoryOutput]
173
185
  def alarm_history_items: () -> ::Array[Types::AlarmHistoryItem]
@@ -176,8 +188,9 @@ module Aws
176
188
  # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/CloudWatch/Client.html#describe_alarm_history-instance_method
177
189
  def describe_alarm_history: (
178
190
  ?alarm_name: ::String,
191
+ ?alarm_contributor_id: ::String,
179
192
  ?alarm_types: Array[("CompositeAlarm" | "MetricAlarm")],
180
- ?history_item_type: ("ConfigurationUpdate" | "StateUpdate" | "Action"),
193
+ ?history_item_type: ("ConfigurationUpdate" | "StateUpdate" | "Action" | "AlarmContributorStateUpdate" | "AlarmContributorAction"),
181
194
  ?start_date: ::Time,
182
195
  ?end_date: ::Time,
183
196
  ?max_records: ::Integer,
@@ -99,8 +99,9 @@ module Aws
99
99
 
100
100
  # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/CloudWatch/CompositeAlarm.html#describe_history-instance_method
101
101
  def describe_history: (
102
+ ?alarm_contributor_id: ::String,
102
103
  ?alarm_types: Array[("CompositeAlarm" | "MetricAlarm")],
103
- ?history_item_type: ("ConfigurationUpdate" | "StateUpdate" | "Action"),
104
+ ?history_item_type: ("ConfigurationUpdate" | "StateUpdate" | "Action" | "AlarmContributorStateUpdate" | "AlarmContributorAction"),
104
105
  ?start_date: ::Time,
105
106
  ?end_date: ::Time,
106
107
  ?max_records: ::Integer,
data/sig/types.rbs CHANGED
@@ -8,13 +8,23 @@
8
8
  module Aws::CloudWatch
9
9
  module Types
10
10
 
11
+ class AlarmContributor
12
+ attr_accessor contributor_id: ::String
13
+ attr_accessor contributor_attributes: ::Hash[::String, ::String]
14
+ attr_accessor state_reason: ::String
15
+ attr_accessor state_transitioned_timestamp: ::Time
16
+ SENSITIVE: []
17
+ end
18
+
11
19
  class AlarmHistoryItem
12
20
  attr_accessor alarm_name: ::String
21
+ attr_accessor alarm_contributor_id: ::String
13
22
  attr_accessor alarm_type: ("CompositeAlarm" | "MetricAlarm")
14
23
  attr_accessor timestamp: ::Time
15
- attr_accessor history_item_type: ("ConfigurationUpdate" | "StateUpdate" | "Action")
24
+ attr_accessor history_item_type: ("ConfigurationUpdate" | "StateUpdate" | "Action" | "AlarmContributorStateUpdate" | "AlarmContributorAction")
16
25
  attr_accessor history_summary: ::String
17
26
  attr_accessor history_data: ::String
27
+ attr_accessor alarm_contributor_attributes: ::Hash[::String, ::String]
18
28
  SENSITIVE: []
19
29
  end
20
30
 
@@ -149,10 +159,23 @@ module Aws::CloudWatch
149
159
  class DeleteMetricStreamOutput < Aws::EmptyStructure
150
160
  end
151
161
 
162
+ class DescribeAlarmContributorsInput
163
+ attr_accessor alarm_name: ::String
164
+ attr_accessor next_token: ::String
165
+ SENSITIVE: []
166
+ end
167
+
168
+ class DescribeAlarmContributorsOutput
169
+ attr_accessor alarm_contributors: ::Array[Types::AlarmContributor]
170
+ attr_accessor next_token: ::String
171
+ SENSITIVE: []
172
+ end
173
+
152
174
  class DescribeAlarmHistoryInput
153
175
  attr_accessor alarm_name: ::String
176
+ attr_accessor alarm_contributor_id: ::String
154
177
  attr_accessor alarm_types: ::Array[("CompositeAlarm" | "MetricAlarm")]
155
- attr_accessor history_item_type: ("ConfigurationUpdate" | "StateUpdate" | "Action")
178
+ attr_accessor history_item_type: ("ConfigurationUpdate" | "StateUpdate" | "Action" | "AlarmContributorStateUpdate" | "AlarmContributorAction")
156
179
  attr_accessor start_date: ::Time
157
180
  attr_accessor end_date: ::Time
158
181
  attr_accessor max_records: ::Integer
metadata CHANGED
@@ -1,7 +1,7 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: aws-sdk-cloudwatch
3
3
  version: !ruby/object:Gem::Version
4
- version: 1.120.0
4
+ version: 1.121.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Amazon Web Services