aws-sdk-devopsguru 1.0.0 → 1.5.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.
@@ -3,7 +3,7 @@
3
3
  # WARNING ABOUT GENERATED CODE
4
4
  #
5
5
  # This file is generated. See the contributing guide for more information:
6
- # https://github.com/aws/aws-sdk-ruby/blob/master/CONTRIBUTING.md
6
+ # https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md
7
7
  #
8
8
  # WARNING ABOUT GENERATED CODE
9
9
 
@@ -94,6 +94,11 @@ module Aws::DevOpsGuru
94
94
  def message
95
95
  @message || @data[:message]
96
96
  end
97
+
98
+ # @return [String]
99
+ def retry_after_seconds
100
+ @data[:retry_after_seconds]
101
+ end
97
102
  end
98
103
 
99
104
  class ResourceNotFoundException < ServiceError
@@ -159,6 +164,11 @@ module Aws::DevOpsGuru
159
164
  def service_code
160
165
  @data[:service_code]
161
166
  end
167
+
168
+ # @return [String]
169
+ def retry_after_seconds
170
+ @data[:retry_after_seconds]
171
+ end
162
172
  end
163
173
 
164
174
  class ValidationException < ServiceError
@@ -170,11 +180,6 @@ module Aws::DevOpsGuru
170
180
  super(context, message, data)
171
181
  end
172
182
 
173
- # @return [String]
174
- def fields
175
- @data[:fields]
176
- end
177
-
178
183
  # @return [String]
179
184
  def message
180
185
  @message || @data[:message]
@@ -184,6 +189,11 @@ module Aws::DevOpsGuru
184
189
  def reason
185
190
  @data[:reason]
186
191
  end
192
+
193
+ # @return [String]
194
+ def fields
195
+ @data[:fields]
196
+ end
187
197
  end
188
198
 
189
199
  end
@@ -3,7 +3,7 @@
3
3
  # WARNING ABOUT GENERATED CODE
4
4
  #
5
5
  # This file is generated. See the contributing guide for more information:
6
- # https://github.com/aws/aws-sdk-ruby/blob/master/CONTRIBUTING.md
6
+ # https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md
7
7
  #
8
8
  # WARNING ABOUT GENERATED CODE
9
9
 
@@ -3,13 +3,22 @@
3
3
  # WARNING ABOUT GENERATED CODE
4
4
  #
5
5
  # This file is generated. See the contributing guide for more information:
6
- # https://github.com/aws/aws-sdk-ruby/blob/master/CONTRIBUTING.md
6
+ # https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md
7
7
  #
8
8
  # WARNING ABOUT GENERATED CODE
9
9
 
10
10
  module Aws::DevOpsGuru
11
11
  module Types
12
12
 
13
+ # You don't have permissions to perform the requested operation. The
14
+ # user or role that is making the request must have at least one IAM
15
+ # permissions policy attached that grants the required permissions. For
16
+ # more information, see [Access Management][1] in the *IAM User Guide*.
17
+ #
18
+ #
19
+ #
20
+ # [1]: https://docs.aws.amazon.com/IAM/latest/UserGuide/access.html
21
+ #
13
22
  # @!attribute [rw] message
14
23
  # @return [String]
15
24
  #
@@ -27,12 +36,15 @@ module Aws::DevOpsGuru
27
36
  # {
28
37
  # config: { # required
29
38
  # sns: { # required
30
- # topic_arn: "__stringMin36Max1024PatternArnAwsAZ09SnsAZ09D12",
39
+ # topic_arn: "TopicArn",
31
40
  # },
32
41
  # },
33
42
  # }
34
43
  #
35
44
  # @!attribute [rw] config
45
+ # A `NotificationChannelConfig` object that specifies what type of
46
+ # notification channel to add. The one supported notification channel
47
+ # is Amazon Simple Notification Service (Amazon SNS).
36
48
  # @return [Types::NotificationChannelConfig]
37
49
  #
38
50
  # @see http://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/AddNotificationChannelRequest AWS API Documentation
@@ -44,6 +56,7 @@ module Aws::DevOpsGuru
44
56
  end
45
57
 
46
58
  # @!attribute [rw] id
59
+ # The ID of the added notification channel.
47
60
  # @return [String]
48
61
  #
49
62
  # @see http://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/AddNotificationChannelResponse AWS API Documentation
@@ -54,7 +67,14 @@ module Aws::DevOpsGuru
54
67
  include Aws::Structure
55
68
  end
56
69
 
70
+ # Details about the source of the anomalous operational data that
71
+ # triggered the anomaly. The one supported source is Amazon CloudWatch
72
+ # metrics.
73
+ #
57
74
  # @!attribute [rw] cloud_watch_metrics
75
+ # An array of `CloudWatchMetricsDetail` object that contains
76
+ # information about the analyzed metrics that displayed anomalous
77
+ # behavior.
58
78
  # @return [Array<Types::CloudWatchMetricsDetail>]
59
79
  #
60
80
  # @see http://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/AnomalySourceDetails AWS API Documentation
@@ -65,29 +85,43 @@ module Aws::DevOpsGuru
65
85
  include Aws::Structure
66
86
  end
67
87
 
68
- # @!attribute [rw] end_time
69
- # @return [Time]
88
+ # A time range that specifies when the observed unusual behavior in an
89
+ # anomaly started and ended.
70
90
  #
71
91
  # @!attribute [rw] start_time
92
+ # The time when the anomalous behavior started.
93
+ # @return [Time]
94
+ #
95
+ # @!attribute [rw] end_time
96
+ # The time when the anomalous behavior ended.
72
97
  # @return [Time]
73
98
  #
74
99
  # @see http://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/AnomalyTimeRange AWS API Documentation
75
100
  #
76
101
  class AnomalyTimeRange < Struct.new(
77
- :end_time,
78
- :start_time)
102
+ :start_time,
103
+ :end_time)
79
104
  SENSITIVE = []
80
105
  include Aws::Structure
81
106
  end
82
107
 
108
+ # Information about AWS CloudFormation stacks. You can use stacks to
109
+ # specify which AWS resources in your account to analyze. For more
110
+ # information, see [Stacks][1] in the *AWS CloudFormation User Guide*.
111
+ #
112
+ #
113
+ #
114
+ # [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacks.html
115
+ #
83
116
  # @note When making an API call, you may pass CloudFormationCollection
84
117
  # data as a hash:
85
118
  #
86
119
  # {
87
- # stack_names: ["__stringMin1Max128PatternAZAZAZAZ09"],
120
+ # stack_names: ["StackName"],
88
121
  # }
89
122
  #
90
123
  # @!attribute [rw] stack_names
124
+ # An array of CloudFormation stack names.
91
125
  # @return [Array<String>]
92
126
  #
93
127
  # @see http://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/CloudFormationCollection AWS API Documentation
@@ -98,7 +132,16 @@ module Aws::DevOpsGuru
98
132
  include Aws::Structure
99
133
  end
100
134
 
135
+ # Information about AWS CloudFormation stacks. You can use stacks to
136
+ # specify which AWS resources in your account to analyze. For more
137
+ # information, see [Stacks][1] in the *AWS CloudFormation User Guide*.
138
+ #
139
+ #
140
+ #
141
+ # [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacks.html
142
+ #
101
143
  # @!attribute [rw] stack_names
144
+ # An array of CloudFormation stack names.
102
145
  # @return [Array<String>]
103
146
  #
104
147
  # @see http://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/CloudFormationCollectionFilter AWS API Documentation
@@ -109,56 +152,94 @@ module Aws::DevOpsGuru
109
152
  include Aws::Structure
110
153
  end
111
154
 
112
- # @!attribute [rw] insight
113
- # @return [Types::InsightHealth]
155
+ # Information about the health of AWS resources in your account that are
156
+ # specified by an AWS CloudFormation stack.
114
157
  #
115
158
  # @!attribute [rw] stack_name
159
+ # The name of the CloudFormation stack.
116
160
  # @return [String]
117
161
  #
162
+ # @!attribute [rw] insight
163
+ # Information about the health of the AWS resources in your account
164
+ # that are specified by an AWS CloudFormation stack, including the
165
+ # number of open proactive, open reactive insights, and the Mean Time
166
+ # to Recover (MTTR) of closed insights.
167
+ # @return [Types::InsightHealth]
168
+ #
118
169
  # @see http://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/CloudFormationHealth AWS API Documentation
119
170
  #
120
171
  class CloudFormationHealth < Struct.new(
121
- :insight,
122
- :stack_name)
172
+ :stack_name,
173
+ :insight)
123
174
  SENSITIVE = []
124
175
  include Aws::Structure
125
176
  end
126
177
 
127
- # @!attribute [rw] dimensions
128
- # @return [Array<Types::CloudWatchMetricsDimension>]
178
+ # Information about an Amazon CloudWatch metric.
129
179
  #
130
180
  # @!attribute [rw] metric_name
181
+ # The name of the CloudWatch metric.
131
182
  # @return [String]
132
183
  #
133
184
  # @!attribute [rw] namespace
185
+ # The namespace of the CloudWatch metric. A namespace is a container
186
+ # for CloudWatch metrics.
134
187
  # @return [String]
135
188
  #
136
- # @!attribute [rw] period
137
- # @return [Integer]
189
+ # @!attribute [rw] dimensions
190
+ # An array of CloudWatch dimensions associated with
191
+ # @return [Array<Types::CloudWatchMetricsDimension>]
138
192
  #
139
193
  # @!attribute [rw] stat
194
+ # The type of statistic associated with the CloudWatch metric. For
195
+ # more information, see [Statistics][1] in the *Amazon CloudWatch User
196
+ # Guide*.
197
+ #
198
+ #
199
+ #
200
+ # [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_concepts.html#Statistic
140
201
  # @return [String]
141
202
  #
142
203
  # @!attribute [rw] unit
204
+ # The unit of measure used for the CloudWatch metric. For example,
205
+ # `Bytes`, `Seconds`, `Count`, and `Percent`.
143
206
  # @return [String]
144
207
  #
208
+ # @!attribute [rw] period
209
+ # The length of time associated with the CloudWatch metric in number
210
+ # of seconds.
211
+ # @return [Integer]
212
+ #
145
213
  # @see http://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/CloudWatchMetricsDetail AWS API Documentation
146
214
  #
147
215
  class CloudWatchMetricsDetail < Struct.new(
148
- :dimensions,
149
216
  :metric_name,
150
217
  :namespace,
151
- :period,
218
+ :dimensions,
152
219
  :stat,
153
- :unit)
220
+ :unit,
221
+ :period)
154
222
  SENSITIVE = []
155
223
  include Aws::Structure
156
224
  end
157
225
 
226
+ # The dimension of a Amazon CloudWatch metric that is used when DevOps
227
+ # Guru analyzes the resources in your account for operational problems
228
+ # and anomalous behavior. A dimension is a name/value pair that is part
229
+ # of the identity of a metric. A metric can have up to 10 dimensions.
230
+ # For more information, see [Dimensions][1] in the *Amazon CloudWatch
231
+ # User Guide*.
232
+ #
233
+ #
234
+ #
235
+ # [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_concepts.html#Dimension
236
+ #
158
237
  # @!attribute [rw] name
238
+ # The name of the CloudWatch dimension.
159
239
  # @return [String]
160
240
  #
161
241
  # @!attribute [rw] value
242
+ # The value of the CloudWatch dimension.
162
243
  # @return [String]
163
244
  #
164
245
  # @see http://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/CloudWatchMetricsDimension AWS API Documentation
@@ -170,13 +251,17 @@ module Aws::DevOpsGuru
170
251
  include Aws::Structure
171
252
  end
172
253
 
254
+ # An exception that is thrown when a conflict occurs.
255
+ #
173
256
  # @!attribute [rw] message
174
257
  # @return [String]
175
258
  #
176
259
  # @!attribute [rw] resource_id
260
+ # The ID of the AWS resource in which a conflict occurred.
177
261
  # @return [String]
178
262
  #
179
263
  # @!attribute [rw] resource_type
264
+ # The type of the AWS resource in which a conflict occurred.
180
265
  # @return [String]
181
266
  #
182
267
  # @see http://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/ConflictException AWS API Documentation
@@ -195,21 +280,33 @@ module Aws::DevOpsGuru
195
280
  #
196
281
  class DescribeAccountHealthRequest < Aws::EmptyStructure; end
197
282
 
198
- # @!attribute [rw] metrics_analyzed
283
+ # @!attribute [rw] open_reactive_insights
284
+ # An integer that specifies the number of open reactive insights in
285
+ # your AWS account.
199
286
  # @return [Integer]
200
287
  #
201
288
  # @!attribute [rw] open_proactive_insights
289
+ # An integer that specifies the number of open proactive insights in
290
+ # your AWS account.
202
291
  # @return [Integer]
203
292
  #
204
- # @!attribute [rw] open_reactive_insights
293
+ # @!attribute [rw] metrics_analyzed
294
+ # An integer that specifies the number of metrics that have been
295
+ # analyzed in your AWS account.
296
+ # @return [Integer]
297
+ #
298
+ # @!attribute [rw] resource_hours
299
+ # The number of Amazon DevOps Guru resource analysis hours billed to
300
+ # the current AWS account in the last hour.
205
301
  # @return [Integer]
206
302
  #
207
303
  # @see http://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/DescribeAccountHealthResponse AWS API Documentation
208
304
  #
209
305
  class DescribeAccountHealthResponse < Struct.new(
210
- :metrics_analyzed,
306
+ :open_reactive_insights,
211
307
  :open_proactive_insights,
212
- :open_reactive_insights)
308
+ :metrics_analyzed,
309
+ :resource_hours)
213
310
  SENSITIVE = []
214
311
  include Aws::Structure
215
312
  end
@@ -223,9 +320,16 @@ module Aws::DevOpsGuru
223
320
  # }
224
321
  #
225
322
  # @!attribute [rw] from_time
323
+ # The start of the time range passed in. The start time granularity is
324
+ # at the day level. The floor of the start time is used. Returned
325
+ # information occurred after this day.
226
326
  # @return [Time]
227
327
  #
228
328
  # @!attribute [rw] to_time
329
+ # The end of the time range passed in. The start time granularity is
330
+ # at the day level. The floor of the start time is used. Returned
331
+ # information occurred before this day. If this is not specified, then
332
+ # the current day is used.
229
333
  # @return [Time]
230
334
  #
231
335
  # @see http://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/DescribeAccountOverviewRequest AWS API Documentation
@@ -237,21 +341,27 @@ module Aws::DevOpsGuru
237
341
  include Aws::Structure
238
342
  end
239
343
 
240
- # @!attribute [rw] mean_time_to_recover_in_milliseconds
344
+ # @!attribute [rw] reactive_insights
345
+ # An integer that specifies the number of open reactive insights in
346
+ # your AWS account that were created during the time range passed in.
241
347
  # @return [Integer]
242
348
  #
243
349
  # @!attribute [rw] proactive_insights
350
+ # An integer that specifies the number of open proactive insights in
351
+ # your AWS account that were created during the time range passed in.
244
352
  # @return [Integer]
245
353
  #
246
- # @!attribute [rw] reactive_insights
354
+ # @!attribute [rw] mean_time_to_recover_in_milliseconds
355
+ # The Mean Time to Recover (MTTR) for all closed insights that were
356
+ # created during the time range passed in.
247
357
  # @return [Integer]
248
358
  #
249
359
  # @see http://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/DescribeAccountOverviewResponse AWS API Documentation
250
360
  #
251
361
  class DescribeAccountOverviewResponse < Struct.new(
252
- :mean_time_to_recover_in_milliseconds,
362
+ :reactive_insights,
253
363
  :proactive_insights,
254
- :reactive_insights)
364
+ :mean_time_to_recover_in_milliseconds)
255
365
  SENSITIVE = []
256
366
  include Aws::Structure
257
367
  end
@@ -260,10 +370,11 @@ module Aws::DevOpsGuru
260
370
  # data as a hash:
261
371
  #
262
372
  # {
263
- # id: "__string", # required
373
+ # id: "AnomalyId", # required
264
374
  # }
265
375
  #
266
376
  # @!attribute [rw] id
377
+ # The ID of the anomaly.
267
378
  # @return [String]
268
379
  #
269
380
  # @see http://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/DescribeAnomalyRequest AWS API Documentation
@@ -275,9 +386,11 @@ module Aws::DevOpsGuru
275
386
  end
276
387
 
277
388
  # @!attribute [rw] proactive_anomaly
389
+ # An `ReactiveAnomaly` object that represents the requested anomaly.
278
390
  # @return [Types::ProactiveAnomaly]
279
391
  #
280
392
  # @!attribute [rw] reactive_anomaly
393
+ # An `ProactiveAnomaly` object that represents the requested anomaly.
281
394
  # @return [Types::ReactiveAnomaly]
282
395
  #
283
396
  # @see http://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/DescribeAnomalyResponse AWS API Documentation
@@ -289,14 +402,46 @@ module Aws::DevOpsGuru
289
402
  include Aws::Structure
290
403
  end
291
404
 
405
+ # @note When making an API call, you may pass DescribeFeedbackRequest
406
+ # data as a hash:
407
+ #
408
+ # {
409
+ # insight_id: "InsightId",
410
+ # }
411
+ #
412
+ # @!attribute [rw] insight_id
413
+ # The ID of the insight for which the feedback was provided.
414
+ # @return [String]
415
+ #
416
+ # @see http://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/DescribeFeedbackRequest AWS API Documentation
417
+ #
418
+ class DescribeFeedbackRequest < Struct.new(
419
+ :insight_id)
420
+ SENSITIVE = []
421
+ include Aws::Structure
422
+ end
423
+
424
+ # @!attribute [rw] insight_feedback
425
+ # Information about insight feedback received from a customer.
426
+ # @return [Types::InsightFeedback]
427
+ #
428
+ # @see http://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/DescribeFeedbackResponse AWS API Documentation
429
+ #
430
+ class DescribeFeedbackResponse < Struct.new(
431
+ :insight_feedback)
432
+ SENSITIVE = []
433
+ include Aws::Structure
434
+ end
435
+
292
436
  # @note When making an API call, you may pass DescribeInsightRequest
293
437
  # data as a hash:
294
438
  #
295
439
  # {
296
- # id: "__string", # required
440
+ # id: "InsightId", # required
297
441
  # }
298
442
  #
299
443
  # @!attribute [rw] id
444
+ # The ID of the insight.
300
445
  # @return [String]
301
446
  #
302
447
  # @see http://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/DescribeInsightRequest AWS API Documentation
@@ -308,9 +453,11 @@ module Aws::DevOpsGuru
308
453
  end
309
454
 
310
455
  # @!attribute [rw] proactive_insight
456
+ # An `ProactiveInsight` object that represents the requested insight.
311
457
  # @return [Types::ProactiveInsight]
312
458
  #
313
459
  # @!attribute [rw] reactive_insight
460
+ # An `ReactiveInsight` object that represents the requested insight.
314
461
  # @return [Types::ReactiveInsight]
315
462
  #
316
463
  # @see http://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/DescribeInsightResponse AWS API Documentation
@@ -326,29 +473,41 @@ module Aws::DevOpsGuru
326
473
  # data as a hash:
327
474
  #
328
475
  # {
329
- # next_token: "__string",
330
- # resource_collection_type: "__string", # required
476
+ # resource_collection_type: "AWS_CLOUD_FORMATION", # required, accepts AWS_CLOUD_FORMATION
477
+ # next_token: "UuidNextToken",
331
478
  # }
332
479
  #
333
- # @!attribute [rw] next_token
480
+ # @!attribute [rw] resource_collection_type
481
+ # An AWS resource collection type. This type specifies how analyzed
482
+ # AWS resources are defined. The one type of AWS resource collection
483
+ # supported is AWS CloudFormation stacks. DevOps Guru can be
484
+ # configured to analyze only the AWS resources that are defined in the
485
+ # stacks.
334
486
  # @return [String]
335
487
  #
336
- # @!attribute [rw] resource_collection_type
488
+ # @!attribute [rw] next_token
489
+ # The pagination token to use to retrieve the next page of results for
490
+ # this operation. If this value is null, it retrieves the first page.
337
491
  # @return [String]
338
492
  #
339
493
  # @see http://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/DescribeResourceCollectionHealthRequest AWS API Documentation
340
494
  #
341
495
  class DescribeResourceCollectionHealthRequest < Struct.new(
342
- :next_token,
343
- :resource_collection_type)
496
+ :resource_collection_type,
497
+ :next_token)
344
498
  SENSITIVE = []
345
499
  include Aws::Structure
346
500
  end
347
501
 
348
502
  # @!attribute [rw] cloud_formation
503
+ # The returned `CloudFormationHealthOverview` object that contains an
504
+ # `InsightHealthOverview` object with the requested system health
505
+ # information.
349
506
  # @return [Array<Types::CloudFormationHealth>]
350
507
  #
351
508
  # @!attribute [rw] next_token
509
+ # The pagination token to use to retrieve the next page of results for
510
+ # this operation. If there are no more pages, this value is null.
352
511
  # @return [String]
353
512
  #
354
513
  # @see http://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/DescribeResourceCollectionHealthResponse AWS API Documentation
@@ -367,6 +526,8 @@ module Aws::DevOpsGuru
367
526
  class DescribeServiceIntegrationRequest < Aws::EmptyStructure; end
368
527
 
369
528
  # @!attribute [rw] service_integration
529
+ # Information about the integration of DevOps Guru with another AWS
530
+ # service, such as AWS Systems Manager.
370
531
  # @return [Types::ServiceIntegrationConfig]
371
532
  #
372
533
  # @see http://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/DescribeServiceIntegrationResponse AWS API Documentation
@@ -377,6 +538,9 @@ module Aws::DevOpsGuru
377
538
  include Aws::Structure
378
539
  end
379
540
 
541
+ # A range of time that specifies when anomalous behavior in an anomaly
542
+ # or insight ended.
543
+ #
380
544
  # @note When making an API call, you may pass EndTimeRange
381
545
  # data as a hash:
382
546
  #
@@ -386,9 +550,11 @@ module Aws::DevOpsGuru
386
550
  # }
387
551
  #
388
552
  # @!attribute [rw] from_time
553
+ # The earliest end time in the time range.
389
554
  # @return [Time]
390
555
  #
391
556
  # @!attribute [rw] to_time
557
+ # The latest end time in the time range.
392
558
  # @return [Time]
393
559
  #
394
560
  # @see http://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/EndTimeRange AWS API Documentation
@@ -400,64 +566,95 @@ module Aws::DevOpsGuru
400
566
  include Aws::Structure
401
567
  end
402
568
 
403
- # @!attribute [rw] data_source
404
- # @return [String]
569
+ # An AWS resource event. AWS resource events and metrics are analyzed by
570
+ # DevOps Guru to find anomalous behavior and provide recommendations to
571
+ # improve your operational solutions.
405
572
  #
406
- # @!attribute [rw] event_class
573
+ # @!attribute [rw] resource_collection
574
+ # A collection of AWS resources supported by DevOps Guru. The one type
575
+ # of AWS resource collection supported is AWS CloudFormation stacks.
576
+ # DevOps Guru can be configured to analyze only the AWS resources that
577
+ # are defined in the stacks.
578
+ # @return [Types::ResourceCollection]
579
+ #
580
+ # @!attribute [rw] id
581
+ # The ID of the event.
407
582
  # @return [String]
408
583
  #
584
+ # @!attribute [rw] time
585
+ # A `Timestamp` that specifies the time the event occurred.
586
+ # @return [Time]
587
+ #
409
588
  # @!attribute [rw] event_source
589
+ # The AWS source that emitted the event.
410
590
  # @return [String]
411
591
  #
412
- # @!attribute [rw] id
592
+ # @!attribute [rw] name
593
+ # The name of the event.
413
594
  # @return [String]
414
595
  #
415
- # @!attribute [rw] name
596
+ # @!attribute [rw] data_source
597
+ # The source, `AWS_CLOUD_TRAIL` or `AWS_CODE_DEPLOY`, where DevOps
598
+ # Guru analysis found the event.
416
599
  # @return [String]
417
600
  #
418
- # @!attribute [rw] resource_collection
419
- # @return [Types::ResourceCollection]
601
+ # @!attribute [rw] event_class
602
+ # The class of the event. The class specifies what the event is
603
+ # related to, such as an infrastructure change, a deployment, or a
604
+ # schema change.
605
+ # @return [String]
420
606
  #
421
607
  # @!attribute [rw] resources
608
+ # An `EventResource` object that contains information about the
609
+ # resource that emitted the event.
422
610
  # @return [Array<Types::EventResource>]
423
611
  #
424
- # @!attribute [rw] time
425
- # @return [Time]
426
- #
427
612
  # @see http://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/Event AWS API Documentation
428
613
  #
429
614
  class Event < Struct.new(
430
- :data_source,
431
- :event_class,
432
- :event_source,
615
+ :resource_collection,
433
616
  :id,
617
+ :time,
618
+ :event_source,
434
619
  :name,
435
- :resource_collection,
436
- :resources,
437
- :time)
620
+ :data_source,
621
+ :event_class,
622
+ :resources)
438
623
  SENSITIVE = []
439
624
  include Aws::Structure
440
625
  end
441
626
 
442
- # @!attribute [rw] arn
627
+ # The AWS resource that emitted an event. AWS resource events and
628
+ # metrics are analyzed by DevOps Guru to find anomalous behavior and
629
+ # provide recommendations to improve your operational solutions.
630
+ #
631
+ # @!attribute [rw] type
632
+ # The type of resource that emitted an event.
443
633
  # @return [String]
444
634
  #
445
635
  # @!attribute [rw] name
636
+ # The name of the resource that emitted an event.
446
637
  # @return [String]
447
638
  #
448
- # @!attribute [rw] type
639
+ # @!attribute [rw] arn
640
+ # The Amazon Resource Name (ARN) of the resource that emitted an
641
+ # event.
449
642
  # @return [String]
450
643
  #
451
644
  # @see http://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/EventResource AWS API Documentation
452
645
  #
453
646
  class EventResource < Struct.new(
454
- :arn,
647
+ :type,
455
648
  :name,
456
- :type)
649
+ :arn)
457
650
  SENSITIVE = []
458
651
  include Aws::Structure
459
652
  end
460
653
 
654
+ # The time range during which an AWS event occurred. AWS resource events
655
+ # and metrics are analyzed by DevOps Guru to find anomalous behavior and
656
+ # provide recommendations to improve your operational solutions.
657
+ #
461
658
  # @note When making an API call, you may pass EventTimeRange
462
659
  # data as a hash:
463
660
  #
@@ -467,9 +664,11 @@ module Aws::DevOpsGuru
467
664
  # }
468
665
  #
469
666
  # @!attribute [rw] from_time
667
+ # The time when the event started.
470
668
  # @return [Time]
471
669
  #
472
670
  # @!attribute [rw] to_time
671
+ # The time when the event ended.
473
672
  # @return [Time]
474
673
  #
475
674
  # @see http://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/EventTimeRange AWS API Documentation
@@ -485,104 +684,137 @@ module Aws::DevOpsGuru
485
684
  # data as a hash:
486
685
  #
487
686
  # {
488
- # next_token: "__string",
489
- # resource_collection_type: "__string", # required
687
+ # resource_collection_type: "AWS_CLOUD_FORMATION", # required, accepts AWS_CLOUD_FORMATION
688
+ # next_token: "UuidNextToken",
490
689
  # }
491
690
  #
492
- # @!attribute [rw] next_token
691
+ # @!attribute [rw] resource_collection_type
692
+ # The type of AWS resource collections to return. The one valid value
693
+ # is `CLOUD_FORMATION` for AWS CloudFormation stacks.
493
694
  # @return [String]
494
695
  #
495
- # @!attribute [rw] resource_collection_type
696
+ # @!attribute [rw] next_token
697
+ # The pagination token to use to retrieve the next page of results for
698
+ # this operation. If this value is null, it retrieves the first page.
496
699
  # @return [String]
497
700
  #
498
701
  # @see http://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/GetResourceCollectionRequest AWS API Documentation
499
702
  #
500
703
  class GetResourceCollectionRequest < Struct.new(
501
- :next_token,
502
- :resource_collection_type)
704
+ :resource_collection_type,
705
+ :next_token)
503
706
  SENSITIVE = []
504
707
  include Aws::Structure
505
708
  end
506
709
 
507
- # @!attribute [rw] next_token
508
- # @return [String]
509
- #
510
710
  # @!attribute [rw] resource_collection
711
+ # The requested list of AWS resource collections. The one type of AWS
712
+ # resource collection supported is AWS CloudFormation stacks. DevOps
713
+ # Guru can be configured to analyze only the AWS resources that are
714
+ # defined in the stacks.
511
715
  # @return [Types::ResourceCollectionFilter]
512
716
  #
717
+ # @!attribute [rw] next_token
718
+ # The pagination token to use to retrieve the next page of results for
719
+ # this operation. If there are no more pages, this value is null.
720
+ # @return [String]
721
+ #
513
722
  # @see http://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/GetResourceCollectionResponse AWS API Documentation
514
723
  #
515
724
  class GetResourceCollectionResponse < Struct.new(
516
- :next_token,
517
- :resource_collection)
725
+ :resource_collection,
726
+ :next_token)
518
727
  SENSITIVE = []
519
728
  include Aws::Structure
520
729
  end
521
730
 
731
+ # Information about insight feedback received from a customer.
732
+ #
522
733
  # @note When making an API call, you may pass InsightFeedback
523
734
  # data as a hash:
524
735
  #
525
736
  # {
737
+ # id: "InsightId",
526
738
  # feedback: "VALID_COLLECTION", # accepts VALID_COLLECTION, RECOMMENDATION_USEFUL, ALERT_TOO_SENSITIVE, DATA_NOISY_ANOMALY, DATA_INCORRECT
527
- # id: "__stringMin1Max100PatternW",
528
739
  # }
529
740
  #
530
- # @!attribute [rw] feedback
741
+ # @!attribute [rw] id
742
+ # The insight feedback ID.
531
743
  # @return [String]
532
744
  #
533
- # @!attribute [rw] id
745
+ # @!attribute [rw] feedback
746
+ # The feedback provided by the customer.
534
747
  # @return [String]
535
748
  #
536
749
  # @see http://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/InsightFeedback AWS API Documentation
537
750
  #
538
751
  class InsightFeedback < Struct.new(
539
- :feedback,
540
- :id)
752
+ :id,
753
+ :feedback)
541
754
  SENSITIVE = []
542
755
  include Aws::Structure
543
756
  end
544
757
 
545
- # @!attribute [rw] mean_time_to_recover_in_milliseconds
546
- # @return [Integer]
758
+ # Information about the number of open reactive and proactive insights
759
+ # that can be used to gauge the health of your system.
547
760
  #
548
761
  # @!attribute [rw] open_proactive_insights
762
+ # The number of open proactive insights.
549
763
  # @return [Integer]
550
764
  #
551
765
  # @!attribute [rw] open_reactive_insights
766
+ # The number of open reactive insights.
767
+ # @return [Integer]
768
+ #
769
+ # @!attribute [rw] mean_time_to_recover_in_milliseconds
770
+ # The Meant Time to Recover (MTTR) for the insight.
552
771
  # @return [Integer]
553
772
  #
554
773
  # @see http://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/InsightHealth AWS API Documentation
555
774
  #
556
775
  class InsightHealth < Struct.new(
557
- :mean_time_to_recover_in_milliseconds,
558
776
  :open_proactive_insights,
559
- :open_reactive_insights)
777
+ :open_reactive_insights,
778
+ :mean_time_to_recover_in_milliseconds)
560
779
  SENSITIVE = []
561
780
  include Aws::Structure
562
781
  end
563
782
 
564
- # @!attribute [rw] end_time
565
- # @return [Time]
783
+ # A time ranged that specifies when the observed behavior in an insight
784
+ # started and ended.
566
785
  #
567
786
  # @!attribute [rw] start_time
787
+ # The time when the behavior described in an insight started.
788
+ # @return [Time]
789
+ #
790
+ # @!attribute [rw] end_time
791
+ # The time when the behavior described in an insight ended.
568
792
  # @return [Time]
569
793
  #
570
794
  # @see http://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/InsightTimeRange AWS API Documentation
571
795
  #
572
796
  class InsightTimeRange < Struct.new(
573
- :end_time,
574
- :start_time)
797
+ :start_time,
798
+ :end_time)
575
799
  SENSITIVE = []
576
800
  include Aws::Structure
577
801
  end
578
802
 
803
+ # An internal failure in an Amazon service occurred.
804
+ #
579
805
  # @!attribute [rw] message
580
806
  # @return [String]
581
807
  #
808
+ # @!attribute [rw] retry_after_seconds
809
+ # The number of seconds after which the action that caused the
810
+ # internal server exception can be retried.
811
+ # @return [Integer]
812
+ #
582
813
  # @see http://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/InternalServerException AWS API Documentation
583
814
  #
584
815
  class InternalServerException < Struct.new(
585
- :message)
816
+ :message,
817
+ :retry_after_seconds)
586
818
  SENSITIVE = []
587
819
  include Aws::Structure
588
820
  end
@@ -591,102 +823,133 @@ module Aws::DevOpsGuru
591
823
  # data as a hash:
592
824
  #
593
825
  # {
594
- # insight_id: "__string", # required
595
- # max_results: 1,
596
- # next_token: "__stringMin36Max36PatternAF098AF094AF094AF094AF0912",
826
+ # insight_id: "InsightId", # required
597
827
  # start_time_range: {
598
828
  # from_time: Time.now,
599
829
  # to_time: Time.now,
600
830
  # },
831
+ # max_results: 1,
832
+ # next_token: "UuidNextToken",
601
833
  # }
602
834
  #
603
835
  # @!attribute [rw] insight_id
836
+ # The ID of the insight. The returned anomalies belong to this
837
+ # insight.
604
838
  # @return [String]
605
839
  #
840
+ # @!attribute [rw] start_time_range
841
+ # A time range used to specify when the requested anomalies started.
842
+ # All returned anomalies started during this time range.
843
+ # @return [Types::StartTimeRange]
844
+ #
606
845
  # @!attribute [rw] max_results
846
+ # The maximum number of results to return with a single call. To
847
+ # retrieve the remaining results, make another call with the returned
848
+ # `nextToken` value.
607
849
  # @return [Integer]
608
850
  #
609
851
  # @!attribute [rw] next_token
852
+ # The pagination token to use to retrieve the next page of results for
853
+ # this operation. If this value is null, it retrieves the first page.
610
854
  # @return [String]
611
855
  #
612
- # @!attribute [rw] start_time_range
613
- # @return [Types::StartTimeRange]
614
- #
615
856
  # @see http://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/ListAnomaliesForInsightRequest AWS API Documentation
616
857
  #
617
858
  class ListAnomaliesForInsightRequest < Struct.new(
618
859
  :insight_id,
860
+ :start_time_range,
619
861
  :max_results,
620
- :next_token,
621
- :start_time_range)
862
+ :next_token)
622
863
  SENSITIVE = []
623
864
  include Aws::Structure
624
865
  end
625
866
 
626
- # @!attribute [rw] next_token
627
- # @return [String]
628
- #
629
867
  # @!attribute [rw] proactive_anomalies
868
+ # An array of `ProactiveAnomalySummary` objects that represent the
869
+ # requested anomalies
630
870
  # @return [Array<Types::ProactiveAnomalySummary>]
631
871
  #
632
872
  # @!attribute [rw] reactive_anomalies
873
+ # An array of `ReactiveAnomalySummary` objects that represent the
874
+ # requested anomalies
633
875
  # @return [Array<Types::ReactiveAnomalySummary>]
634
876
  #
877
+ # @!attribute [rw] next_token
878
+ # The pagination token to use to retrieve the next page of results for
879
+ # this operation. If there are no more pages, this value is null.
880
+ # @return [String]
881
+ #
635
882
  # @see http://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/ListAnomaliesForInsightResponse AWS API Documentation
636
883
  #
637
884
  class ListAnomaliesForInsightResponse < Struct.new(
638
- :next_token,
639
885
  :proactive_anomalies,
640
- :reactive_anomalies)
886
+ :reactive_anomalies,
887
+ :next_token)
641
888
  SENSITIVE = []
642
889
  include Aws::Structure
643
890
  end
644
891
 
892
+ # Filters you can use to specify which events are returned when
893
+ # `ListEvents` is called.
894
+ #
645
895
  # @note When making an API call, you may pass ListEventsFilters
646
896
  # data as a hash:
647
897
  #
648
898
  # {
649
- # data_source: "AWS_CLOUD_TRAIL", # accepts AWS_CLOUD_TRAIL, AWS_CODE_DEPLOY
650
- # event_class: "INFRASTRUCTURE", # accepts INFRASTRUCTURE, DEPLOYMENT, SECURITY_CHANGE, CONFIG_CHANGE, SCHEMA_CHANGE
651
- # event_source: "__stringMin10Max50PatternAZAZ09AmazonawsComAwsEvents",
899
+ # insight_id: "InsightId",
652
900
  # event_time_range: {
653
901
  # from_time: Time.now, # required
654
902
  # to_time: Time.now, # required
655
903
  # },
656
- # insight_id: "__stringMin1Max100PatternW",
904
+ # event_class: "INFRASTRUCTURE", # accepts INFRASTRUCTURE, DEPLOYMENT, SECURITY_CHANGE, CONFIG_CHANGE, SCHEMA_CHANGE
905
+ # event_source: "EventSource",
906
+ # data_source: "AWS_CLOUD_TRAIL", # accepts AWS_CLOUD_TRAIL, AWS_CODE_DEPLOY
657
907
  # resource_collection: {
658
908
  # cloud_formation: {
659
- # stack_names: ["__stringMin1Max128PatternAZAZAZAZ09"],
909
+ # stack_names: ["StackName"],
660
910
  # },
661
911
  # },
662
912
  # }
663
913
  #
664
- # @!attribute [rw] data_source
914
+ # @!attribute [rw] insight_id
915
+ # An ID of an insight that is related to the events you want to filter
916
+ # for.
665
917
  # @return [String]
666
918
  #
919
+ # @!attribute [rw] event_time_range
920
+ # A time range during which you want the filtered events to have
921
+ # occurred.
922
+ # @return [Types::EventTimeRange]
923
+ #
667
924
  # @!attribute [rw] event_class
925
+ # The class of the events you want to filter for, such as an
926
+ # infrastructure change, a deployment, or a schema change.
668
927
  # @return [String]
669
928
  #
670
929
  # @!attribute [rw] event_source
930
+ # The AWS source that emitted the events you want to filter for.
671
931
  # @return [String]
672
932
  #
673
- # @!attribute [rw] event_time_range
674
- # @return [Types::EventTimeRange]
675
- #
676
- # @!attribute [rw] insight_id
933
+ # @!attribute [rw] data_source
934
+ # The source, `AWS_CLOUD_TRAIL` or `AWS_CODE_DEPLOY`, of the events
935
+ # you want returned.
677
936
  # @return [String]
678
937
  #
679
938
  # @!attribute [rw] resource_collection
939
+ # A collection of AWS resources supported by DevOps Guru. The one type
940
+ # of AWS resource collection supported is AWS CloudFormation stacks.
941
+ # DevOps Guru can be configured to analyze only the AWS resources that
942
+ # are defined in the stacks.
680
943
  # @return [Types::ResourceCollection]
681
944
  #
682
945
  # @see http://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/ListEventsFilters AWS API Documentation
683
946
  #
684
947
  class ListEventsFilters < Struct.new(
685
- :data_source,
948
+ :insight_id,
949
+ :event_time_range,
686
950
  :event_class,
687
951
  :event_source,
688
- :event_time_range,
689
- :insight_id,
952
+ :data_source,
690
953
  :resource_collection)
691
954
  SENSITIVE = []
692
955
  include Aws::Structure
@@ -697,31 +960,37 @@ module Aws::DevOpsGuru
697
960
  #
698
961
  # {
699
962
  # filters: { # required
700
- # data_source: "AWS_CLOUD_TRAIL", # accepts AWS_CLOUD_TRAIL, AWS_CODE_DEPLOY
701
- # event_class: "INFRASTRUCTURE", # accepts INFRASTRUCTURE, DEPLOYMENT, SECURITY_CHANGE, CONFIG_CHANGE, SCHEMA_CHANGE
702
- # event_source: "__stringMin10Max50PatternAZAZ09AmazonawsComAwsEvents",
963
+ # insight_id: "InsightId",
703
964
  # event_time_range: {
704
965
  # from_time: Time.now, # required
705
966
  # to_time: Time.now, # required
706
967
  # },
707
- # insight_id: "__stringMin1Max100PatternW",
968
+ # event_class: "INFRASTRUCTURE", # accepts INFRASTRUCTURE, DEPLOYMENT, SECURITY_CHANGE, CONFIG_CHANGE, SCHEMA_CHANGE
969
+ # event_source: "EventSource",
970
+ # data_source: "AWS_CLOUD_TRAIL", # accepts AWS_CLOUD_TRAIL, AWS_CODE_DEPLOY
708
971
  # resource_collection: {
709
972
  # cloud_formation: {
710
- # stack_names: ["__stringMin1Max128PatternAZAZAZAZ09"],
973
+ # stack_names: ["StackName"],
711
974
  # },
712
975
  # },
713
976
  # },
714
977
  # max_results: 1,
715
- # next_token: "__stringMin36Max36PatternAF098AF094AF094AF094AF0912",
978
+ # next_token: "UuidNextToken",
716
979
  # }
717
980
  #
718
981
  # @!attribute [rw] filters
982
+ # A `ListEventsFilters` object used to specify which events to return.
719
983
  # @return [Types::ListEventsFilters]
720
984
  #
721
985
  # @!attribute [rw] max_results
986
+ # The maximum number of results to return with a single call. To
987
+ # retrieve the remaining results, make another call with the returned
988
+ # `nextToken` value.
722
989
  # @return [Integer]
723
990
  #
724
991
  # @!attribute [rw] next_token
992
+ # The pagination token to use to retrieve the next page of results for
993
+ # this operation. If this value is null, it retrieves the first page.
725
994
  # @return [String]
726
995
  #
727
996
  # @see http://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/ListEventsRequest AWS API Documentation
@@ -735,9 +1004,12 @@ module Aws::DevOpsGuru
735
1004
  end
736
1005
 
737
1006
  # @!attribute [rw] events
1007
+ # A list of the requested events.
738
1008
  # @return [Array<Types::Event>]
739
1009
  #
740
1010
  # @!attribute [rw] next_token
1011
+ # The pagination token to use to retrieve the next page of results for
1012
+ # this operation. If there are no more pages, this value is null.
741
1013
  # @return [String]
742
1014
  #
743
1015
  # @see http://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/ListEventsResponse AWS API Documentation
@@ -749,58 +1021,70 @@ module Aws::DevOpsGuru
749
1021
  include Aws::Structure
750
1022
  end
751
1023
 
1024
+ # Used to filter for insights that have any status.
1025
+ #
752
1026
  # @note When making an API call, you may pass ListInsightsAnyStatusFilter
753
1027
  # data as a hash:
754
1028
  #
755
1029
  # {
1030
+ # type: "REACTIVE", # required, accepts REACTIVE, PROACTIVE
756
1031
  # start_time_range: { # required
757
1032
  # from_time: Time.now,
758
1033
  # to_time: Time.now,
759
1034
  # },
760
- # type: "REACTIVE", # required, accepts REACTIVE, PROACTIVE
761
1035
  # }
762
1036
  #
763
- # @!attribute [rw] start_time_range
764
- # @return [Types::StartTimeRange]
765
- #
766
1037
  # @!attribute [rw] type
1038
+ # Use to filter for either `REACTIVE` or `PROACTIVE` insights.
767
1039
  # @return [String]
768
1040
  #
1041
+ # @!attribute [rw] start_time_range
1042
+ # A time range used to specify when the behavior of the filtered
1043
+ # insights started.
1044
+ # @return [Types::StartTimeRange]
1045
+ #
769
1046
  # @see http://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/ListInsightsAnyStatusFilter AWS API Documentation
770
1047
  #
771
1048
  class ListInsightsAnyStatusFilter < Struct.new(
772
- :start_time_range,
773
- :type)
1049
+ :type,
1050
+ :start_time_range)
774
1051
  SENSITIVE = []
775
1052
  include Aws::Structure
776
1053
  end
777
1054
 
1055
+ # Used to filter for insights that have the status `CLOSED`.
1056
+ #
778
1057
  # @note When making an API call, you may pass ListInsightsClosedStatusFilter
779
1058
  # data as a hash:
780
1059
  #
781
1060
  # {
1061
+ # type: "REACTIVE", # required, accepts REACTIVE, PROACTIVE
782
1062
  # end_time_range: { # required
783
1063
  # from_time: Time.now,
784
1064
  # to_time: Time.now,
785
1065
  # },
786
- # type: "REACTIVE", # required, accepts REACTIVE, PROACTIVE
787
1066
  # }
788
1067
  #
789
- # @!attribute [rw] end_time_range
790
- # @return [Types::EndTimeRange]
791
- #
792
1068
  # @!attribute [rw] type
1069
+ # Use to filter for either `REACTIVE` or `PROACTIVE` insights.
793
1070
  # @return [String]
794
1071
  #
1072
+ # @!attribute [rw] end_time_range
1073
+ # A time range used to specify when the behavior of the filtered
1074
+ # insights ended.
1075
+ # @return [Types::EndTimeRange]
1076
+ #
795
1077
  # @see http://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/ListInsightsClosedStatusFilter AWS API Documentation
796
1078
  #
797
1079
  class ListInsightsClosedStatusFilter < Struct.new(
798
- :end_time_range,
799
- :type)
1080
+ :type,
1081
+ :end_time_range)
800
1082
  SENSITIVE = []
801
1083
  include Aws::Structure
802
1084
  end
803
1085
 
1086
+ # Used to filter for insights that have the status `ONGOING`.
1087
+ #
804
1088
  # @note When making an API call, you may pass ListInsightsOngoingStatusFilter
805
1089
  # data as a hash:
806
1090
  #
@@ -809,6 +1093,7 @@ module Aws::DevOpsGuru
809
1093
  # }
810
1094
  #
811
1095
  # @!attribute [rw] type
1096
+ # Use to filter for either `REACTIVE` or `PROACTIVE` insights.
812
1097
  # @return [String]
813
1098
  #
814
1099
  # @see http://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/ListInsightsOngoingStatusFilter AWS API Documentation
@@ -823,105 +1108,124 @@ module Aws::DevOpsGuru
823
1108
  # data as a hash:
824
1109
  #
825
1110
  # {
826
- # max_results: 1,
827
- # next_token: "__stringMin36Max36PatternAF098AF094AF094AF094AF0912",
828
1111
  # status_filter: { # required
829
- # any: {
830
- # start_time_range: { # required
831
- # from_time: Time.now,
832
- # to_time: Time.now,
833
- # },
1112
+ # ongoing: {
834
1113
  # type: "REACTIVE", # required, accepts REACTIVE, PROACTIVE
835
1114
  # },
836
1115
  # closed: {
1116
+ # type: "REACTIVE", # required, accepts REACTIVE, PROACTIVE
837
1117
  # end_time_range: { # required
838
1118
  # from_time: Time.now,
839
1119
  # to_time: Time.now,
840
1120
  # },
841
- # type: "REACTIVE", # required, accepts REACTIVE, PROACTIVE
842
1121
  # },
843
- # ongoing: {
1122
+ # any: {
844
1123
  # type: "REACTIVE", # required, accepts REACTIVE, PROACTIVE
1124
+ # start_time_range: { # required
1125
+ # from_time: Time.now,
1126
+ # to_time: Time.now,
1127
+ # },
845
1128
  # },
846
1129
  # },
1130
+ # max_results: 1,
1131
+ # next_token: "UuidNextToken",
847
1132
  # }
848
1133
  #
1134
+ # @!attribute [rw] status_filter
1135
+ # A filter used to filter the returned insights by their status. You
1136
+ # can specify one status filter.
1137
+ # @return [Types::ListInsightsStatusFilter]
1138
+ #
849
1139
  # @!attribute [rw] max_results
1140
+ # The maximum number of results to return with a single call. To
1141
+ # retrieve the remaining results, make another call with the returned
1142
+ # `nextToken` value.
850
1143
  # @return [Integer]
851
1144
  #
852
1145
  # @!attribute [rw] next_token
1146
+ # The pagination token to use to retrieve the next page of results for
1147
+ # this operation. If this value is null, it retrieves the first page.
853
1148
  # @return [String]
854
1149
  #
855
- # @!attribute [rw] status_filter
856
- # @return [Types::ListInsightsStatusFilter]
857
- #
858
1150
  # @see http://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/ListInsightsRequest AWS API Documentation
859
1151
  #
860
1152
  class ListInsightsRequest < Struct.new(
1153
+ :status_filter,
861
1154
  :max_results,
862
- :next_token,
863
- :status_filter)
1155
+ :next_token)
864
1156
  SENSITIVE = []
865
1157
  include Aws::Structure
866
1158
  end
867
1159
 
868
- # @!attribute [rw] next_token
869
- # @return [String]
870
- #
871
1160
  # @!attribute [rw] proactive_insights
1161
+ # The returned list of proactive insights.
872
1162
  # @return [Array<Types::ProactiveInsightSummary>]
873
1163
  #
874
1164
  # @!attribute [rw] reactive_insights
1165
+ # The returned list of reactive insights.
875
1166
  # @return [Array<Types::ReactiveInsightSummary>]
876
1167
  #
877
- # @see http://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/ListInsightsResponse AWS API Documentation
878
- #
1168
+ # @!attribute [rw] next_token
1169
+ # The pagination token to use to retrieve the next page of results for
1170
+ # this operation. If there are no more pages, this value is null.
1171
+ # @return [String]
1172
+ #
1173
+ # @see http://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/ListInsightsResponse AWS API Documentation
1174
+ #
879
1175
  class ListInsightsResponse < Struct.new(
880
- :next_token,
881
1176
  :proactive_insights,
882
- :reactive_insights)
1177
+ :reactive_insights,
1178
+ :next_token)
883
1179
  SENSITIVE = []
884
1180
  include Aws::Structure
885
1181
  end
886
1182
 
1183
+ # A filter used by `ListInsights` to specify which insights to return.
1184
+ #
887
1185
  # @note When making an API call, you may pass ListInsightsStatusFilter
888
1186
  # data as a hash:
889
1187
  #
890
1188
  # {
891
- # any: {
892
- # start_time_range: { # required
893
- # from_time: Time.now,
894
- # to_time: Time.now,
895
- # },
1189
+ # ongoing: {
896
1190
  # type: "REACTIVE", # required, accepts REACTIVE, PROACTIVE
897
1191
  # },
898
1192
  # closed: {
1193
+ # type: "REACTIVE", # required, accepts REACTIVE, PROACTIVE
899
1194
  # end_time_range: { # required
900
1195
  # from_time: Time.now,
901
1196
  # to_time: Time.now,
902
1197
  # },
903
- # type: "REACTIVE", # required, accepts REACTIVE, PROACTIVE
904
1198
  # },
905
- # ongoing: {
1199
+ # any: {
906
1200
  # type: "REACTIVE", # required, accepts REACTIVE, PROACTIVE
1201
+ # start_time_range: { # required
1202
+ # from_time: Time.now,
1203
+ # to_time: Time.now,
1204
+ # },
907
1205
  # },
908
1206
  # }
909
1207
  #
910
- # @!attribute [rw] any
911
- # @return [Types::ListInsightsAnyStatusFilter]
1208
+ # @!attribute [rw] ongoing
1209
+ # A `ListInsightsAnyStatusFilter` that specifies ongoing insights that
1210
+ # are either `REACTIVE` or `PROACTIVE`.
1211
+ # @return [Types::ListInsightsOngoingStatusFilter]
912
1212
  #
913
1213
  # @!attribute [rw] closed
1214
+ # A `ListInsightsClosedStatusFilter` that specifies closed insights
1215
+ # that are either `REACTIVE` or `PROACTIVE`.
914
1216
  # @return [Types::ListInsightsClosedStatusFilter]
915
1217
  #
916
- # @!attribute [rw] ongoing
917
- # @return [Types::ListInsightsOngoingStatusFilter]
1218
+ # @!attribute [rw] any
1219
+ # A `ListInsightsAnyStatusFilter` that specifies insights of any
1220
+ # status that are either `REACTIVE` or `PROACTIVE`.
1221
+ # @return [Types::ListInsightsAnyStatusFilter]
918
1222
  #
919
1223
  # @see http://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/ListInsightsStatusFilter AWS API Documentation
920
1224
  #
921
1225
  class ListInsightsStatusFilter < Struct.new(
922
- :any,
1226
+ :ongoing,
923
1227
  :closed,
924
- :ongoing)
1228
+ :any)
925
1229
  SENSITIVE = []
926
1230
  include Aws::Structure
927
1231
  end
@@ -930,10 +1234,12 @@ module Aws::DevOpsGuru
930
1234
  # data as a hash:
931
1235
  #
932
1236
  # {
933
- # next_token: "__stringMin36Max36PatternAF098AF094AF094AF094AF0912",
1237
+ # next_token: "UuidNextToken",
934
1238
  # }
935
1239
  #
936
1240
  # @!attribute [rw] next_token
1241
+ # The pagination token to use to retrieve the next page of results for
1242
+ # this operation. If this value is null, it retrieves the first page.
937
1243
  # @return [String]
938
1244
  #
939
1245
  # @see http://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/ListNotificationChannelsRequest AWS API Documentation
@@ -945,9 +1251,12 @@ module Aws::DevOpsGuru
945
1251
  end
946
1252
 
947
1253
  # @!attribute [rw] channels
1254
+ # An array that contains the requested notification channels.
948
1255
  # @return [Array<Types::NotificationChannel>]
949
1256
  #
950
1257
  # @!attribute [rw] next_token
1258
+ # The pagination token to use to retrieve the next page of results for
1259
+ # this operation. If there are no more pages, this value is null.
951
1260
  # @return [String]
952
1261
  #
953
1262
  # @see http://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/ListNotificationChannelsResponse AWS API Documentation
@@ -963,14 +1272,17 @@ module Aws::DevOpsGuru
963
1272
  # data as a hash:
964
1273
  #
965
1274
  # {
966
- # insight_id: "__stringMin1Max100PatternW", # required
967
- # next_token: "__stringMin36Max36PatternAF098AF094AF094AF094AF0912",
1275
+ # insight_id: "InsightId", # required
1276
+ # next_token: "UuidNextToken",
968
1277
  # }
969
1278
  #
970
1279
  # @!attribute [rw] insight_id
1280
+ # The ID of the requested insight.
971
1281
  # @return [String]
972
1282
  #
973
1283
  # @!attribute [rw] next_token
1284
+ # The pagination token to use to retrieve the next page of results for
1285
+ # this operation. If this value is null, it retrieves the first page.
974
1286
  # @return [String]
975
1287
  #
976
1288
  # @see http://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/ListRecommendationsRequest AWS API Documentation
@@ -982,46 +1294,96 @@ module Aws::DevOpsGuru
982
1294
  include Aws::Structure
983
1295
  end
984
1296
 
985
- # @!attribute [rw] next_token
986
- # @return [String]
987
- #
988
1297
  # @!attribute [rw] recommendations
1298
+ # An array of the requested recommendations.
989
1299
  # @return [Array<Types::Recommendation>]
990
1300
  #
1301
+ # @!attribute [rw] next_token
1302
+ # The pagination token to use to retrieve the next page of results for
1303
+ # this operation. If there are no more pages, this value is null.
1304
+ # @return [String]
1305
+ #
991
1306
  # @see http://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/ListRecommendationsResponse AWS API Documentation
992
1307
  #
993
1308
  class ListRecommendationsResponse < Struct.new(
994
- :next_token,
995
- :recommendations)
1309
+ :recommendations,
1310
+ :next_token)
996
1311
  SENSITIVE = []
997
1312
  include Aws::Structure
998
1313
  end
999
1314
 
1000
- # @!attribute [rw] config
1001
- # @return [Types::NotificationChannelConfig]
1315
+ # Information about a notification channel. A notification channel is
1316
+ # used to notify you when DevOps Guru creates an insight. The one
1317
+ # supported notification channel is Amazon Simple Notification Service
1318
+ # (Amazon SNS).
1319
+ #
1320
+ # If you use an Amazon SNS topic in another account, you must attach a
1321
+ # policy to it that grants DevOps Guru permission to it notifications.
1322
+ # DevOps Guru adds the required policy on your behalf to send
1323
+ # notifications using Amazon SNS in your account. For more information,
1324
+ # see [Permissions for cross account Amazon SNS topics][1].
1325
+ #
1326
+ # If you use an Amazon SNS topic that is encrypted by an AWS Key
1327
+ # Management Service customer-managed key (CMK), then you must add
1328
+ # permissions to the CMK. For more information, see [Permissions for AWS
1329
+ # KMS–encrypted Amazon SNS topics][2].
1330
+ #
1331
+ #
1332
+ #
1333
+ # [1]: https://docs.aws.amazon.com/devops-guru/latest/userguide/sns-required-permissions.html
1334
+ # [2]: https://docs.aws.amazon.com/devops-guru/latest/userguide/sns-kms-permissions.html
1002
1335
  #
1003
1336
  # @!attribute [rw] id
1337
+ # The ID of a notification channel.
1004
1338
  # @return [String]
1005
1339
  #
1340
+ # @!attribute [rw] config
1341
+ # A `NotificationChannelConfig` object that contains information about
1342
+ # configured notification channels.
1343
+ # @return [Types::NotificationChannelConfig]
1344
+ #
1006
1345
  # @see http://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/NotificationChannel AWS API Documentation
1007
1346
  #
1008
1347
  class NotificationChannel < Struct.new(
1009
- :config,
1010
- :id)
1348
+ :id,
1349
+ :config)
1011
1350
  SENSITIVE = []
1012
1351
  include Aws::Structure
1013
1352
  end
1014
1353
 
1354
+ # Information about notification channels you have configured with
1355
+ # DevOps Guru. The one supported notification channel is Amazon Simple
1356
+ # Notification Service (Amazon SNS).
1357
+ #
1015
1358
  # @note When making an API call, you may pass NotificationChannelConfig
1016
1359
  # data as a hash:
1017
1360
  #
1018
1361
  # {
1019
1362
  # sns: { # required
1020
- # topic_arn: "__stringMin36Max1024PatternArnAwsAZ09SnsAZ09D12",
1363
+ # topic_arn: "TopicArn",
1021
1364
  # },
1022
1365
  # }
1023
1366
  #
1024
1367
  # @!attribute [rw] sns
1368
+ # Information about a notification channel configured in DevOps Guru
1369
+ # to send notifications when insights are created.
1370
+ #
1371
+ # If you use an Amazon SNS topic in another account, you must attach a
1372
+ # policy to it that grants DevOps Guru permission to it notifications.
1373
+ # DevOps Guru adds the required policy on your behalf to send
1374
+ # notifications using Amazon SNS in your account. For more
1375
+ # information, see [Permissions for cross account Amazon SNS
1376
+ # topics][1].
1377
+ #
1378
+ # If you use an Amazon SNS topic that is encrypted by an AWS Key
1379
+ # Management Service customer-managed key (CMK), then you must add
1380
+ # permissions to the CMK. For more information, see [Permissions for
1381
+ # AWS KMS–encrypted Amazon SNS topics][2].
1382
+ #
1383
+ #
1384
+ #
1385
+ # [1]: https://docs.aws.amazon.com/devops-guru/latest/userguide/sns-required-permissions.html
1386
+ # [2]: https://docs.aws.amazon.com/devops-guru/latest/userguide/sns-kms-permissions.html
1025
1387
  # @return [Types::SnsChannelConfig]
1026
1388
  #
1027
1389
  # @see http://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/NotificationChannelConfig AWS API Documentation
@@ -1032,7 +1394,12 @@ module Aws::DevOpsGuru
1032
1394
  include Aws::Structure
1033
1395
  end
1034
1396
 
1397
+ # Information about whether DevOps Guru is configured to create an
1398
+ # OpsItem in AWS Systems Manager OpsCenter for each created insight.
1399
+ #
1035
1400
  # @!attribute [rw] opt_in_status
1401
+ # Specifies if DevOps Guru is enabled to create an AWS Systems Manager
1402
+ # OpsItem for each created insight.
1036
1403
  # @return [String]
1037
1404
  #
1038
1405
  # @see http://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/OpsCenterIntegration AWS API Documentation
@@ -1043,6 +1410,9 @@ module Aws::DevOpsGuru
1043
1410
  include Aws::Structure
1044
1411
  end
1045
1412
 
1413
+ # Information about whether DevOps Guru is configured to create an
1414
+ # OpsItem in AWS Systems Manager OpsCenter for each created insight.
1415
+ #
1046
1416
  # @note When making an API call, you may pass OpsCenterIntegrationConfig
1047
1417
  # data as a hash:
1048
1418
  #
@@ -1051,6 +1421,8 @@ module Aws::DevOpsGuru
1051
1421
  # }
1052
1422
  #
1053
1423
  # @!attribute [rw] opt_in_status
1424
+ # Specifies if DevOps Guru is enabled to create an AWS Systems Manager
1425
+ # OpsItem for each created insight.
1054
1426
  # @return [String]
1055
1427
  #
1056
1428
  # @see http://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/OpsCenterIntegrationConfig AWS API Documentation
@@ -1061,185 +1433,271 @@ module Aws::DevOpsGuru
1061
1433
  include Aws::Structure
1062
1434
  end
1063
1435
 
1064
- # @!attribute [rw] end_time
1065
- # @return [Time]
1436
+ # The time range during which anomalous behavior in a proactive anomaly
1437
+ # or an insight is expected to occur.
1066
1438
  #
1067
1439
  # @!attribute [rw] start_time
1440
+ # The time range during which a metric limit is expected to be
1441
+ # exceeded. This applies to proactive insights only.
1442
+ # @return [Time]
1443
+ #
1444
+ # @!attribute [rw] end_time
1445
+ # The time when the behavior in a proactive insight is expected to
1446
+ # end.
1068
1447
  # @return [Time]
1069
1448
  #
1070
1449
  # @see http://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/PredictionTimeRange AWS API Documentation
1071
1450
  #
1072
1451
  class PredictionTimeRange < Struct.new(
1073
- :end_time,
1074
- :start_time)
1452
+ :start_time,
1453
+ :end_time)
1075
1454
  SENSITIVE = []
1076
1455
  include Aws::Structure
1077
1456
  end
1078
1457
 
1079
- # @!attribute [rw] anomaly_time_range
1080
- # @return [Types::AnomalyTimeRange]
1458
+ # Information about an anomaly. This object is returned by
1459
+ # `ListAnomalies`.
1081
1460
  #
1082
- # @!attribute [rw] associated_insight_id
1461
+ # @!attribute [rw] id
1462
+ # The ID of a proactive anomaly.
1083
1463
  # @return [String]
1084
1464
  #
1085
- # @!attribute [rw] id
1465
+ # @!attribute [rw] severity
1466
+ # The severity of a proactive anomaly.
1086
1467
  # @return [String]
1087
1468
  #
1088
- # @!attribute [rw] limit
1089
- # @return [Float]
1469
+ # @!attribute [rw] status
1470
+ # The status of a proactive anomaly.
1471
+ # @return [String]
1090
1472
  #
1091
- # @!attribute [rw] prediction_time_range
1092
- # @return [Types::PredictionTimeRange]
1473
+ # @!attribute [rw] update_time
1474
+ # The time of the anomaly's most recent update.
1475
+ # @return [Time]
1093
1476
  #
1094
- # @!attribute [rw] resource_collection
1095
- # @return [Types::ResourceCollection]
1477
+ # @!attribute [rw] anomaly_time_range
1478
+ # A time range that specifies when the observed unusual behavior in an
1479
+ # anomaly started and ended.
1480
+ # @return [Types::AnomalyTimeRange]
1096
1481
  #
1097
- # @!attribute [rw] severity
1098
- # @return [String]
1482
+ # @!attribute [rw] prediction_time_range
1483
+ # The time range during which anomalous behavior in a proactive
1484
+ # anomaly or an insight is expected to occur.
1485
+ # @return [Types::PredictionTimeRange]
1099
1486
  #
1100
1487
  # @!attribute [rw] source_details
1488
+ # Details about the source of the analyzed operational data that
1489
+ # triggered the anomaly. The one supported source is Amazon CloudWatch
1490
+ # metrics.
1101
1491
  # @return [Types::AnomalySourceDetails]
1102
1492
  #
1103
- # @!attribute [rw] status
1493
+ # @!attribute [rw] associated_insight_id
1494
+ # The ID of the insight that contains this anomaly. An insight is
1495
+ # composed of related anomalies.
1104
1496
  # @return [String]
1105
1497
  #
1106
- # @!attribute [rw] update_time
1107
- # @return [Time]
1498
+ # @!attribute [rw] resource_collection
1499
+ # A collection of AWS resources supported by DevOps Guru. The one type
1500
+ # of AWS resource collection supported is AWS CloudFormation stacks.
1501
+ # DevOps Guru can be configured to analyze only the AWS resources that
1502
+ # are defined in the stacks.
1503
+ # @return [Types::ResourceCollection]
1504
+ #
1505
+ # @!attribute [rw] limit
1506
+ # A threshold that was exceeded by behavior in analyzed resources.
1507
+ # Exceeding this threshold is related to the anomalous behavior that
1508
+ # generated this anomaly.
1509
+ # @return [Float]
1108
1510
  #
1109
1511
  # @see http://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/ProactiveAnomaly AWS API Documentation
1110
1512
  #
1111
1513
  class ProactiveAnomaly < Struct.new(
1112
- :anomaly_time_range,
1113
- :associated_insight_id,
1114
1514
  :id,
1115
- :limit,
1116
- :prediction_time_range,
1117
- :resource_collection,
1118
1515
  :severity,
1119
- :source_details,
1120
1516
  :status,
1121
- :update_time)
1517
+ :update_time,
1518
+ :anomaly_time_range,
1519
+ :prediction_time_range,
1520
+ :source_details,
1521
+ :associated_insight_id,
1522
+ :resource_collection,
1523
+ :limit)
1122
1524
  SENSITIVE = []
1123
1525
  include Aws::Structure
1124
1526
  end
1125
1527
 
1126
- # @!attribute [rw] anomaly_time_range
1127
- # @return [Types::AnomalyTimeRange]
1528
+ # Details about a proactive anomaly. This object is returned by
1529
+ # `DescribeAnomaly.`
1128
1530
  #
1129
- # @!attribute [rw] associated_insight_id
1531
+ # @!attribute [rw] id
1532
+ # The ID of the anomaly.
1130
1533
  # @return [String]
1131
1534
  #
1132
- # @!attribute [rw] id
1535
+ # @!attribute [rw] severity
1536
+ # The severity of the anomaly.
1133
1537
  # @return [String]
1134
1538
  #
1135
- # @!attribute [rw] limit
1136
- # @return [Float]
1539
+ # @!attribute [rw] status
1540
+ # The status of the anomaly.
1541
+ # @return [String]
1137
1542
  #
1138
- # @!attribute [rw] prediction_time_range
1139
- # @return [Types::PredictionTimeRange]
1543
+ # @!attribute [rw] update_time
1544
+ # The time of the anomaly's most recent update.
1545
+ # @return [Time]
1140
1546
  #
1141
- # @!attribute [rw] resource_collection
1142
- # @return [Types::ResourceCollection]
1547
+ # @!attribute [rw] anomaly_time_range
1548
+ # A time range that specifies when the observed unusual behavior in an
1549
+ # anomaly started and ended.
1550
+ # @return [Types::AnomalyTimeRange]
1143
1551
  #
1144
- # @!attribute [rw] severity
1145
- # @return [String]
1552
+ # @!attribute [rw] prediction_time_range
1553
+ # The time range during which anomalous behavior in a proactive
1554
+ # anomaly or an insight is expected to occur.
1555
+ # @return [Types::PredictionTimeRange]
1146
1556
  #
1147
1557
  # @!attribute [rw] source_details
1558
+ # Details about the source of the analyzed operational data that
1559
+ # triggered the anomaly. The one supported source is Amazon CloudWatch
1560
+ # metrics.
1148
1561
  # @return [Types::AnomalySourceDetails]
1149
1562
  #
1150
- # @!attribute [rw] status
1563
+ # @!attribute [rw] associated_insight_id
1564
+ # The ID of the insight that contains this anomaly. An insight is
1565
+ # composed of related anomalies.
1151
1566
  # @return [String]
1152
1567
  #
1153
- # @!attribute [rw] update_time
1154
- # @return [Time]
1568
+ # @!attribute [rw] resource_collection
1569
+ # A collection of AWS resources supported by DevOps Guru. The one type
1570
+ # of AWS resource collection supported is AWS CloudFormation stacks.
1571
+ # DevOps Guru can be configured to analyze only the AWS resources that
1572
+ # are defined in the stacks.
1573
+ # @return [Types::ResourceCollection]
1574
+ #
1575
+ # @!attribute [rw] limit
1576
+ # A threshold that was exceeded by behavior in analyzed resources.
1577
+ # Exceeding this threshold is related to the anomalous behavior that
1578
+ # generated this anomaly.
1579
+ # @return [Float]
1155
1580
  #
1156
1581
  # @see http://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/ProactiveAnomalySummary AWS API Documentation
1157
1582
  #
1158
1583
  class ProactiveAnomalySummary < Struct.new(
1159
- :anomaly_time_range,
1160
- :associated_insight_id,
1161
1584
  :id,
1162
- :limit,
1163
- :prediction_time_range,
1164
- :resource_collection,
1165
1585
  :severity,
1166
- :source_details,
1167
1586
  :status,
1168
- :update_time)
1587
+ :update_time,
1588
+ :anomaly_time_range,
1589
+ :prediction_time_range,
1590
+ :source_details,
1591
+ :associated_insight_id,
1592
+ :resource_collection,
1593
+ :limit)
1169
1594
  SENSITIVE = []
1170
1595
  include Aws::Structure
1171
1596
  end
1172
1597
 
1598
+ # Details about a proactive insight. This object is returned by
1599
+ # `ListInsights`.
1600
+ #
1173
1601
  # @!attribute [rw] id
1602
+ # The ID of the proactive insight.
1174
1603
  # @return [String]
1175
1604
  #
1176
- # @!attribute [rw] insight_time_range
1177
- # @return [Types::InsightTimeRange]
1178
- #
1179
1605
  # @!attribute [rw] name
1606
+ # The name of the proactive insight.
1607
+ # @return [String]
1608
+ #
1609
+ # @!attribute [rw] severity
1610
+ # The severity of the proactive insight.
1611
+ # @return [String]
1612
+ #
1613
+ # @!attribute [rw] status
1614
+ # The status of the proactive insight.
1180
1615
  # @return [String]
1181
1616
  #
1617
+ # @!attribute [rw] insight_time_range
1618
+ # A time ranged that specifies when the observed behavior in an
1619
+ # insight started and ended.
1620
+ # @return [Types::InsightTimeRange]
1621
+ #
1182
1622
  # @!attribute [rw] prediction_time_range
1623
+ # The time range during which anomalous behavior in a proactive
1624
+ # anomaly or an insight is expected to occur.
1183
1625
  # @return [Types::PredictionTimeRange]
1184
1626
  #
1185
1627
  # @!attribute [rw] resource_collection
1628
+ # A collection of AWS resources supported by DevOps Guru. The one type
1629
+ # of AWS resource collection supported is AWS CloudFormation stacks.
1630
+ # DevOps Guru can be configured to analyze only the AWS resources that
1631
+ # are defined in the stacks.
1186
1632
  # @return [Types::ResourceCollection]
1187
1633
  #
1188
- # @!attribute [rw] severity
1189
- # @return [String]
1190
- #
1191
1634
  # @!attribute [rw] ssm_ops_item_id
1192
- # @return [String]
1193
- #
1194
- # @!attribute [rw] status
1635
+ # The ID of the AWS System Manager OpsItem created for this insight.
1636
+ # You must enable the creation of OpstItems insights before they are
1637
+ # created for each insight.
1195
1638
  # @return [String]
1196
1639
  #
1197
1640
  # @see http://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/ProactiveInsight AWS API Documentation
1198
1641
  #
1199
1642
  class ProactiveInsight < Struct.new(
1200
1643
  :id,
1201
- :insight_time_range,
1202
1644
  :name,
1645
+ :severity,
1646
+ :status,
1647
+ :insight_time_range,
1203
1648
  :prediction_time_range,
1204
1649
  :resource_collection,
1205
- :severity,
1206
- :ssm_ops_item_id,
1207
- :status)
1650
+ :ssm_ops_item_id)
1208
1651
  SENSITIVE = []
1209
1652
  include Aws::Structure
1210
1653
  end
1211
1654
 
1655
+ # Details about a proactive insight. This object is returned by
1656
+ # `DescribeInsight.`
1657
+ #
1212
1658
  # @!attribute [rw] id
1659
+ # The ID of the proactive insight.
1213
1660
  # @return [String]
1214
1661
  #
1215
- # @!attribute [rw] insight_time_range
1216
- # @return [Types::InsightTimeRange]
1217
- #
1218
1662
  # @!attribute [rw] name
1663
+ # The name of the proactive insight.
1219
1664
  # @return [String]
1220
1665
  #
1221
- # @!attribute [rw] prediction_time_range
1222
- # @return [Types::PredictionTimeRange]
1223
- #
1224
- # @!attribute [rw] resource_collection
1225
- # @return [Types::ResourceCollection]
1226
- #
1227
1666
  # @!attribute [rw] severity
1667
+ # The severity of the proactive insight.
1228
1668
  # @return [String]
1229
1669
  #
1230
1670
  # @!attribute [rw] status
1671
+ # The status of the proactive insight.
1231
1672
  # @return [String]
1232
1673
  #
1674
+ # @!attribute [rw] insight_time_range
1675
+ # A time ranged that specifies when the observed behavior in an
1676
+ # insight started and ended.
1677
+ # @return [Types::InsightTimeRange]
1678
+ #
1679
+ # @!attribute [rw] prediction_time_range
1680
+ # The time range during which anomalous behavior in a proactive
1681
+ # anomaly or an insight is expected to occur.
1682
+ # @return [Types::PredictionTimeRange]
1683
+ #
1684
+ # @!attribute [rw] resource_collection
1685
+ # A collection of AWS resources supported by DevOps Guru. The one type
1686
+ # of AWS resource collection supported is AWS CloudFormation stacks.
1687
+ # DevOps Guru can be configured to analyze only the AWS resources that
1688
+ # are defined in the stacks.
1689
+ # @return [Types::ResourceCollection]
1690
+ #
1233
1691
  # @see http://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/ProactiveInsightSummary AWS API Documentation
1234
1692
  #
1235
1693
  class ProactiveInsightSummary < Struct.new(
1236
1694
  :id,
1237
- :insight_time_range,
1238
1695
  :name,
1239
- :prediction_time_range,
1240
- :resource_collection,
1241
1696
  :severity,
1242
- :status)
1697
+ :status,
1698
+ :insight_time_range,
1699
+ :prediction_time_range,
1700
+ :resource_collection)
1243
1701
  SENSITIVE = []
1244
1702
  include Aws::Structure
1245
1703
  end
@@ -1249,12 +1707,14 @@ module Aws::DevOpsGuru
1249
1707
  #
1250
1708
  # {
1251
1709
  # insight_feedback: {
1710
+ # id: "InsightId",
1252
1711
  # feedback: "VALID_COLLECTION", # accepts VALID_COLLECTION, RECOMMENDATION_USEFUL, ALERT_TOO_SENSITIVE, DATA_NOISY_ANOMALY, DATA_INCORRECT
1253
- # id: "__stringMin1Max100PatternW",
1254
1712
  # },
1255
1713
  # }
1256
1714
  #
1257
1715
  # @!attribute [rw] insight_feedback
1716
+ # The feedback from customers is about the recommendations in this
1717
+ # insight.
1258
1718
  # @return [Types::InsightFeedback]
1259
1719
  #
1260
1720
  # @see http://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/PutFeedbackRequest AWS API Documentation
@@ -1269,160 +1729,234 @@ module Aws::DevOpsGuru
1269
1729
  #
1270
1730
  class PutFeedbackResponse < Aws::EmptyStructure; end
1271
1731
 
1272
- # @!attribute [rw] anomaly_time_range
1273
- # @return [Types::AnomalyTimeRange]
1274
- #
1275
- # @!attribute [rw] associated_insight_id
1276
- # @return [String]
1732
+ # Details about a reactive anomaly. This object is returned by
1733
+ # `ListAnomalies`.
1277
1734
  #
1278
1735
  # @!attribute [rw] id
1736
+ # The ID of the reactive anomaly.
1279
1737
  # @return [String]
1280
1738
  #
1281
- # @!attribute [rw] resource_collection
1282
- # @return [Types::ResourceCollection]
1283
- #
1284
1739
  # @!attribute [rw] severity
1740
+ # The severity of the anomaly.
1741
+ # @return [String]
1742
+ #
1743
+ # @!attribute [rw] status
1744
+ # The status of the anomaly.
1285
1745
  # @return [String]
1286
1746
  #
1747
+ # @!attribute [rw] anomaly_time_range
1748
+ # A time range that specifies when the observed unusual behavior in an
1749
+ # anomaly started and ended.
1750
+ # @return [Types::AnomalyTimeRange]
1751
+ #
1287
1752
  # @!attribute [rw] source_details
1753
+ # Details about the source of the analyzed operational data that
1754
+ # triggered the anomaly. The one supported source is Amazon CloudWatch
1755
+ # metrics.
1288
1756
  # @return [Types::AnomalySourceDetails]
1289
1757
  #
1290
- # @!attribute [rw] status
1758
+ # @!attribute [rw] associated_insight_id
1759
+ # The ID of the insight that contains this anomaly. An insight is
1760
+ # composed of related anomalies.
1291
1761
  # @return [String]
1292
1762
  #
1763
+ # @!attribute [rw] resource_collection
1764
+ # A collection of AWS resources supported by DevOps Guru. The one type
1765
+ # of AWS resource collection supported is AWS CloudFormation stacks.
1766
+ # DevOps Guru can be configured to analyze only the AWS resources that
1767
+ # are defined in the stacks.
1768
+ # @return [Types::ResourceCollection]
1769
+ #
1293
1770
  # @see http://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/ReactiveAnomaly AWS API Documentation
1294
1771
  #
1295
1772
  class ReactiveAnomaly < Struct.new(
1296
- :anomaly_time_range,
1297
- :associated_insight_id,
1298
1773
  :id,
1299
- :resource_collection,
1300
1774
  :severity,
1775
+ :status,
1776
+ :anomaly_time_range,
1301
1777
  :source_details,
1302
- :status)
1778
+ :associated_insight_id,
1779
+ :resource_collection)
1303
1780
  SENSITIVE = []
1304
1781
  include Aws::Structure
1305
1782
  end
1306
1783
 
1307
- # @!attribute [rw] anomaly_time_range
1308
- # @return [Types::AnomalyTimeRange]
1309
- #
1310
- # @!attribute [rw] associated_insight_id
1311
- # @return [String]
1784
+ # Details about a reactive anomaly. This object is returned by
1785
+ # `DescribeAnomaly.`
1312
1786
  #
1313
1787
  # @!attribute [rw] id
1788
+ # The ID of the reactive anomaly.
1314
1789
  # @return [String]
1315
1790
  #
1316
- # @!attribute [rw] resource_collection
1317
- # @return [Types::ResourceCollection]
1318
- #
1319
1791
  # @!attribute [rw] severity
1792
+ # The severity of the reactive anomaly.
1320
1793
  # @return [String]
1321
1794
  #
1795
+ # @!attribute [rw] status
1796
+ # The status of the reactive anomaly.
1797
+ # @return [String]
1798
+ #
1799
+ # @!attribute [rw] anomaly_time_range
1800
+ # A time range that specifies when the observed unusual behavior in an
1801
+ # anomaly started and ended.
1802
+ # @return [Types::AnomalyTimeRange]
1803
+ #
1322
1804
  # @!attribute [rw] source_details
1805
+ # Details about the source of the analyzed operational data that
1806
+ # triggered the anomaly. The one supported source is Amazon CloudWatch
1807
+ # metrics.
1323
1808
  # @return [Types::AnomalySourceDetails]
1324
1809
  #
1325
- # @!attribute [rw] status
1810
+ # @!attribute [rw] associated_insight_id
1811
+ # The ID of the insight that contains this anomaly. An insight is
1812
+ # composed of related anomalies.
1326
1813
  # @return [String]
1327
1814
  #
1815
+ # @!attribute [rw] resource_collection
1816
+ # A collection of AWS resources supported by DevOps Guru. The one type
1817
+ # of AWS resource collection supported is AWS CloudFormation stacks.
1818
+ # DevOps Guru can be configured to analyze only the AWS resources that
1819
+ # are defined in the stacks.
1820
+ # @return [Types::ResourceCollection]
1821
+ #
1328
1822
  # @see http://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/ReactiveAnomalySummary AWS API Documentation
1329
1823
  #
1330
1824
  class ReactiveAnomalySummary < Struct.new(
1331
- :anomaly_time_range,
1332
- :associated_insight_id,
1333
1825
  :id,
1334
- :resource_collection,
1335
1826
  :severity,
1827
+ :status,
1828
+ :anomaly_time_range,
1336
1829
  :source_details,
1337
- :status)
1830
+ :associated_insight_id,
1831
+ :resource_collection)
1338
1832
  SENSITIVE = []
1339
1833
  include Aws::Structure
1340
1834
  end
1341
1835
 
1836
+ # Information about a reactive insight. This object is returned by
1837
+ # `ListInsights`.
1838
+ #
1342
1839
  # @!attribute [rw] id
1840
+ # The ID of a reactive insight.
1343
1841
  # @return [String]
1344
1842
  #
1345
- # @!attribute [rw] insight_time_range
1346
- # @return [Types::InsightTimeRange]
1347
- #
1348
1843
  # @!attribute [rw] name
1844
+ # The name of a reactive insight.
1349
1845
  # @return [String]
1350
1846
  #
1351
- # @!attribute [rw] resource_collection
1352
- # @return [Types::ResourceCollection]
1353
- #
1354
1847
  # @!attribute [rw] severity
1848
+ # The severity of a reactive insight.
1355
1849
  # @return [String]
1356
1850
  #
1357
- # @!attribute [rw] ssm_ops_item_id
1851
+ # @!attribute [rw] status
1852
+ # The status of a reactive insight.
1358
1853
  # @return [String]
1359
1854
  #
1360
- # @!attribute [rw] status
1855
+ # @!attribute [rw] insight_time_range
1856
+ # A time ranged that specifies when the observed behavior in an
1857
+ # insight started and ended.
1858
+ # @return [Types::InsightTimeRange]
1859
+ #
1860
+ # @!attribute [rw] resource_collection
1861
+ # A collection of AWS resources supported by DevOps Guru. The one type
1862
+ # of AWS resource collection supported is AWS CloudFormation stacks.
1863
+ # DevOps Guru can be configured to analyze only the AWS resources that
1864
+ # are defined in the stacks.
1865
+ # @return [Types::ResourceCollection]
1866
+ #
1867
+ # @!attribute [rw] ssm_ops_item_id
1868
+ # The ID of the AWS System Manager OpsItem created for this insight.
1869
+ # You must enable the creation of OpstItems insights before they are
1870
+ # created for each insight.
1361
1871
  # @return [String]
1362
1872
  #
1363
1873
  # @see http://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/ReactiveInsight AWS API Documentation
1364
1874
  #
1365
1875
  class ReactiveInsight < Struct.new(
1366
1876
  :id,
1367
- :insight_time_range,
1368
1877
  :name,
1369
- :resource_collection,
1370
1878
  :severity,
1371
- :ssm_ops_item_id,
1372
- :status)
1879
+ :status,
1880
+ :insight_time_range,
1881
+ :resource_collection,
1882
+ :ssm_ops_item_id)
1373
1883
  SENSITIVE = []
1374
1884
  include Aws::Structure
1375
1885
  end
1376
1886
 
1887
+ # Information about a reactive insight. This object is returned by
1888
+ # `DescribeInsight.`
1889
+ #
1377
1890
  # @!attribute [rw] id
1891
+ # The ID of a reactive summary.
1378
1892
  # @return [String]
1379
1893
  #
1380
- # @!attribute [rw] insight_time_range
1381
- # @return [Types::InsightTimeRange]
1382
- #
1383
1894
  # @!attribute [rw] name
1895
+ # The name of a reactive insight.
1384
1896
  # @return [String]
1385
1897
  #
1386
- # @!attribute [rw] resource_collection
1387
- # @return [Types::ResourceCollection]
1388
- #
1389
1898
  # @!attribute [rw] severity
1899
+ # The severity of a reactive insight.
1390
1900
  # @return [String]
1391
1901
  #
1392
1902
  # @!attribute [rw] status
1903
+ # The status of a reactive insight.
1393
1904
  # @return [String]
1394
1905
  #
1906
+ # @!attribute [rw] insight_time_range
1907
+ # A time ranged that specifies when the observed behavior in an
1908
+ # insight started and ended.
1909
+ # @return [Types::InsightTimeRange]
1910
+ #
1911
+ # @!attribute [rw] resource_collection
1912
+ # A collection of AWS resources supported by DevOps Guru. The one type
1913
+ # of AWS resource collection supported is AWS CloudFormation stacks.
1914
+ # DevOps Guru can be configured to analyze only the AWS resources that
1915
+ # are defined in the stacks.
1916
+ # @return [Types::ResourceCollection]
1917
+ #
1395
1918
  # @see http://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/ReactiveInsightSummary AWS API Documentation
1396
1919
  #
1397
1920
  class ReactiveInsightSummary < Struct.new(
1398
1921
  :id,
1399
- :insight_time_range,
1400
1922
  :name,
1401
- :resource_collection,
1402
1923
  :severity,
1403
- :status)
1924
+ :status,
1925
+ :insight_time_range,
1926
+ :resource_collection)
1404
1927
  SENSITIVE = []
1405
1928
  include Aws::Structure
1406
1929
  end
1407
1930
 
1931
+ # Recommendation information to help you remediate detected anomalous
1932
+ # behavior that generated an insight.
1933
+ #
1408
1934
  # @!attribute [rw] description
1935
+ # A description of the problem.
1409
1936
  # @return [String]
1410
1937
  #
1411
1938
  # @!attribute [rw] link
1939
+ # A hyperlink to information to help you address the problem.
1412
1940
  # @return [String]
1413
1941
  #
1414
1942
  # @!attribute [rw] name
1943
+ # The name of the recommendation.
1415
1944
  # @return [String]
1416
1945
  #
1417
1946
  # @!attribute [rw] reason
1947
+ # The reason DevOps Guru flagged the anomalous behavior as a problem.
1418
1948
  # @return [String]
1419
1949
  #
1420
- # @!attribute [rw] related_anomalies
1421
- # @return [Array<Types::RecommendationRelatedAnomaly>]
1422
- #
1423
1950
  # @!attribute [rw] related_events
1951
+ # Events that are related to the problem. Use these events to learn
1952
+ # more about what's happening and to help address the issue.
1424
1953
  # @return [Array<Types::RecommendationRelatedEvent>]
1425
1954
  #
1955
+ # @!attribute [rw] related_anomalies
1956
+ # Anomalies that are related to the problem. Use these Anomalies to
1957
+ # learn more about what's happening and to help address the issue.
1958
+ # @return [Array<Types::RecommendationRelatedAnomaly>]
1959
+ #
1426
1960
  # @see http://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/Recommendation AWS API Documentation
1427
1961
  #
1428
1962
  class Recommendation < Struct.new(
@@ -1430,16 +1964,24 @@ module Aws::DevOpsGuru
1430
1964
  :link,
1431
1965
  :name,
1432
1966
  :reason,
1433
- :related_anomalies,
1434
- :related_events)
1967
+ :related_events,
1968
+ :related_anomalies)
1435
1969
  SENSITIVE = []
1436
1970
  include Aws::Structure
1437
1971
  end
1438
1972
 
1973
+ # Information about an anomaly that is related to a recommendation.
1974
+ #
1439
1975
  # @!attribute [rw] resources
1976
+ # An array of objects that represent resources in which DevOps Guru
1977
+ # detected anomalous behavior. Each object contains the name and type
1978
+ # of the resource.
1440
1979
  # @return [Array<Types::RecommendationRelatedAnomalyResource>]
1441
1980
  #
1442
1981
  # @!attribute [rw] source_details
1982
+ # Information about where the anomalous behavior related the
1983
+ # recommendation was found. For example, details in Amazon CloudWatch
1984
+ # metrics.
1443
1985
  # @return [Array<Types::RecommendationRelatedAnomalySourceDetail>]
1444
1986
  #
1445
1987
  # @see http://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/RecommendationRelatedAnomaly AWS API Documentation
@@ -1451,10 +1993,15 @@ module Aws::DevOpsGuru
1451
1993
  include Aws::Structure
1452
1994
  end
1453
1995
 
1996
+ # Information about a resource in which DevOps Guru detected anomalous
1997
+ # behavior.
1998
+ #
1454
1999
  # @!attribute [rw] name
2000
+ # The name of the resource.
1455
2001
  # @return [String]
1456
2002
  #
1457
2003
  # @!attribute [rw] type
2004
+ # The type of the resource.
1458
2005
  # @return [String]
1459
2006
  #
1460
2007
  # @see http://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/RecommendationRelatedAnomalyResource AWS API Documentation
@@ -1466,7 +2013,14 @@ module Aws::DevOpsGuru
1466
2013
  include Aws::Structure
1467
2014
  end
1468
2015
 
2016
+ # Contains an array of
2017
+ # `RecommendationRelatedCloudWatchMetricsSourceDetail` objects that
2018
+ # contain the name and namespace of an Amazon CloudWatch metric.
2019
+ #
1469
2020
  # @!attribute [rw] cloud_watch_metrics
2021
+ # An array of `CloudWatchMetricsDetail` objects that contains
2022
+ # information about the analyzed metrics that displayed anomalous
2023
+ # behavior.
1470
2024
  # @return [Array<Types::RecommendationRelatedCloudWatchMetricsSourceDetail>]
1471
2025
  #
1472
2026
  # @see http://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/RecommendationRelatedAnomalySourceDetail AWS API Documentation
@@ -1477,10 +2031,17 @@ module Aws::DevOpsGuru
1477
2031
  include Aws::Structure
1478
2032
  end
1479
2033
 
2034
+ # Information about an Amazon CloudWatch metric that is analyzed by
2035
+ # DevOps Guru. It is one of many analyzed metrics that are used to
2036
+ # generate insights.
2037
+ #
1480
2038
  # @!attribute [rw] metric_name
2039
+ # The name of the CloudWatch metric.
1481
2040
  # @return [String]
1482
2041
  #
1483
2042
  # @!attribute [rw] namespace
2043
+ # The namespace of the CloudWatch metric. A namespace is a container
2044
+ # for CloudWatch metrics.
1484
2045
  # @return [String]
1485
2046
  #
1486
2047
  # @see http://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/RecommendationRelatedCloudWatchMetricsSourceDetail AWS API Documentation
@@ -1492,10 +2053,16 @@ module Aws::DevOpsGuru
1492
2053
  include Aws::Structure
1493
2054
  end
1494
2055
 
2056
+ # Information about an event that is related to a recommendation.
2057
+ #
1495
2058
  # @!attribute [rw] name
2059
+ # The name of the event. This corresponds to the `Name` field in an
2060
+ # `Event` object.
1496
2061
  # @return [String]
1497
2062
  #
1498
2063
  # @!attribute [rw] resources
2064
+ # A `ResourceCollection` object that contains arrays of the names of
2065
+ # AWS CloudFormation stacks.
1499
2066
  # @return [Array<Types::RecommendationRelatedEventResource>]
1500
2067
  #
1501
2068
  # @see http://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/RecommendationRelatedEvent AWS API Documentation
@@ -1507,10 +2074,17 @@ module Aws::DevOpsGuru
1507
2074
  include Aws::Structure
1508
2075
  end
1509
2076
 
2077
+ # Information about an AWS resource that emitted and event that is
2078
+ # related to a recommendation in an insight.
2079
+ #
1510
2080
  # @!attribute [rw] name
2081
+ # The name of the resource that emitted the event. This corresponds to
2082
+ # the `Name` field in an `EventResource` object.
1511
2083
  # @return [String]
1512
2084
  #
1513
2085
  # @!attribute [rw] type
2086
+ # The type of the resource that emitted the event. This corresponds to
2087
+ # the `Type` field in an `EventResource` object.
1514
2088
  # @return [String]
1515
2089
  #
1516
2090
  # @see http://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/RecommendationRelatedEventResource AWS API Documentation
@@ -1526,10 +2100,11 @@ module Aws::DevOpsGuru
1526
2100
  # data as a hash:
1527
2101
  #
1528
2102
  # {
1529
- # id: "__string", # required
2103
+ # id: "NotificationChannelId", # required
1530
2104
  # }
1531
2105
  #
1532
2106
  # @!attribute [rw] id
2107
+ # The ID of the notification channel to be removed.
1533
2108
  # @return [String]
1534
2109
  #
1535
2110
  # @see http://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/RemoveNotificationChannelRequest AWS API Documentation
@@ -1544,16 +2119,23 @@ module Aws::DevOpsGuru
1544
2119
  #
1545
2120
  class RemoveNotificationChannelResponse < Aws::EmptyStructure; end
1546
2121
 
2122
+ # A collection of AWS resources supported by DevOps Guru. The one type
2123
+ # of AWS resource collection supported is AWS CloudFormation stacks.
2124
+ # DevOps Guru can be configured to analyze only the AWS resources that
2125
+ # are defined in the stacks.
2126
+ #
1547
2127
  # @note When making an API call, you may pass ResourceCollection
1548
2128
  # data as a hash:
1549
2129
  #
1550
2130
  # {
1551
2131
  # cloud_formation: {
1552
- # stack_names: ["__stringMin1Max128PatternAZAZAZAZ09"],
2132
+ # stack_names: ["StackName"],
1553
2133
  # },
1554
2134
  # }
1555
2135
  #
1556
2136
  # @!attribute [rw] cloud_formation
2137
+ # An array of the names of AWS CloudFormation stacks. The stacks
2138
+ # define AWS resources that DevOps Guru analyzes.
1557
2139
  # @return [Types::CloudFormationCollection]
1558
2140
  #
1559
2141
  # @see http://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/ResourceCollection AWS API Documentation
@@ -1564,7 +2146,17 @@ module Aws::DevOpsGuru
1564
2146
  include Aws::Structure
1565
2147
  end
1566
2148
 
2149
+ # Information about a filter used to specify which AWS resources are
2150
+ # analyzed for anomalous behavior by DevOps Guru.
2151
+ #
1567
2152
  # @!attribute [rw] cloud_formation
2153
+ # Information about AWS CloudFormation stacks. You can use stacks to
2154
+ # specify which AWS resources in your account to analyze. For more
2155
+ # information, see [Stacks][1] in the *AWS CloudFormation User Guide*.
2156
+ #
2157
+ #
2158
+ #
2159
+ # [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacks.html
1568
2160
  # @return [Types::CloudFormationCollectionFilter]
1569
2161
  #
1570
2162
  # @see http://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/ResourceCollectionFilter AWS API Documentation
@@ -1575,13 +2167,17 @@ module Aws::DevOpsGuru
1575
2167
  include Aws::Structure
1576
2168
  end
1577
2169
 
2170
+ # A requested resource could not be found
2171
+ #
1578
2172
  # @!attribute [rw] message
1579
2173
  # @return [String]
1580
2174
  #
1581
2175
  # @!attribute [rw] resource_id
2176
+ # The ID of the AWS resource that could not be found.
1582
2177
  # @return [String]
1583
2178
  #
1584
2179
  # @!attribute [rw] resource_type
2180
+ # The type of the AWS resource that could not be found.
1585
2181
  # @return [String]
1586
2182
  #
1587
2183
  # @see http://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/ResourceNotFoundException AWS API Documentation
@@ -1594,34 +2190,43 @@ module Aws::DevOpsGuru
1594
2190
  include Aws::Structure
1595
2191
  end
1596
2192
 
2193
+ # Specifies one or more severity values and one or more status values
2194
+ # that are used to search for insights.
2195
+ #
1597
2196
  # @note When making an API call, you may pass SearchInsightsFilters
1598
2197
  # data as a hash:
1599
2198
  #
1600
2199
  # {
2200
+ # severities: ["LOW"], # accepts LOW, MEDIUM, HIGH
2201
+ # statuses: ["ONGOING"], # accepts ONGOING, CLOSED
1601
2202
  # resource_collection: {
1602
2203
  # cloud_formation: {
1603
- # stack_names: ["__stringMin1Max128PatternAZAZAZAZ09"],
2204
+ # stack_names: ["StackName"],
1604
2205
  # },
1605
2206
  # },
1606
- # severities: ["LOW"], # accepts LOW, MEDIUM, HIGH
1607
- # statuses: ["ONGOING"], # accepts ONGOING, CLOSED
1608
2207
  # }
1609
2208
  #
1610
- # @!attribute [rw] resource_collection
1611
- # @return [Types::ResourceCollection]
1612
- #
1613
2209
  # @!attribute [rw] severities
2210
+ # An array of severity values used to search for insights.
1614
2211
  # @return [Array<String>]
1615
2212
  #
1616
2213
  # @!attribute [rw] statuses
2214
+ # An array of status values used to search for insights.
1617
2215
  # @return [Array<String>]
1618
2216
  #
2217
+ # @!attribute [rw] resource_collection
2218
+ # A collection of AWS resources supported by DevOps Guru. The one type
2219
+ # of AWS resource collection supported is AWS CloudFormation stacks.
2220
+ # DevOps Guru can be configured to analyze only the AWS resources that
2221
+ # are defined in the stacks.
2222
+ # @return [Types::ResourceCollection]
2223
+ #
1619
2224
  # @see http://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/SearchInsightsFilters AWS API Documentation
1620
2225
  #
1621
2226
  class SearchInsightsFilters < Struct.new(
1622
- :resource_collection,
1623
2227
  :severities,
1624
- :statuses)
2228
+ :statuses,
2229
+ :resource_collection)
1625
2230
  SENSITIVE = []
1626
2231
  include Aws::Structure
1627
2232
  end
@@ -1630,71 +2235,91 @@ module Aws::DevOpsGuru
1630
2235
  # data as a hash:
1631
2236
  #
1632
2237
  # {
2238
+ # start_time_range: { # required
2239
+ # from_time: Time.now,
2240
+ # to_time: Time.now,
2241
+ # },
1633
2242
  # filters: {
2243
+ # severities: ["LOW"], # accepts LOW, MEDIUM, HIGH
2244
+ # statuses: ["ONGOING"], # accepts ONGOING, CLOSED
1634
2245
  # resource_collection: {
1635
2246
  # cloud_formation: {
1636
- # stack_names: ["__stringMin1Max128PatternAZAZAZAZ09"],
2247
+ # stack_names: ["StackName"],
1637
2248
  # },
1638
2249
  # },
1639
- # severities: ["LOW"], # accepts LOW, MEDIUM, HIGH
1640
- # statuses: ["ONGOING"], # accepts ONGOING, CLOSED
1641
2250
  # },
1642
2251
  # max_results: 1,
1643
- # next_token: "__stringMin36Max36PatternAF098AF094AF094AF094AF0912",
1644
- # start_time_range: { # required
1645
- # from_time: Time.now,
1646
- # to_time: Time.now,
1647
- # },
2252
+ # next_token: "UuidNextToken",
1648
2253
  # type: "REACTIVE", # required, accepts REACTIVE, PROACTIVE
1649
2254
  # }
1650
2255
  #
2256
+ # @!attribute [rw] start_time_range
2257
+ # The start of the time range passed in. Returned insights occurred
2258
+ # after this time.
2259
+ # @return [Types::StartTimeRange]
2260
+ #
1651
2261
  # @!attribute [rw] filters
2262
+ # A `SearchInsightsFilters` object that is used to set the severity
2263
+ # and status filters on your insight search.
1652
2264
  # @return [Types::SearchInsightsFilters]
1653
2265
  #
1654
2266
  # @!attribute [rw] max_results
2267
+ # The maximum number of results to return with a single call. To
2268
+ # retrieve the remaining results, make another call with the returned
2269
+ # `nextToken` value.
1655
2270
  # @return [Integer]
1656
2271
  #
1657
2272
  # @!attribute [rw] next_token
2273
+ # The pagination token to use to retrieve the next page of results for
2274
+ # this operation. If this value is null, it retrieves the first page.
1658
2275
  # @return [String]
1659
2276
  #
1660
- # @!attribute [rw] start_time_range
1661
- # @return [Types::StartTimeRange]
1662
- #
1663
2277
  # @!attribute [rw] type
2278
+ # The type of insights you are searching for (`REACTIVE` or
2279
+ # `PROACTIVE`).
1664
2280
  # @return [String]
1665
2281
  #
1666
2282
  # @see http://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/SearchInsightsRequest AWS API Documentation
1667
2283
  #
1668
2284
  class SearchInsightsRequest < Struct.new(
2285
+ :start_time_range,
1669
2286
  :filters,
1670
2287
  :max_results,
1671
2288
  :next_token,
1672
- :start_time_range,
1673
2289
  :type)
1674
2290
  SENSITIVE = []
1675
2291
  include Aws::Structure
1676
2292
  end
1677
2293
 
1678
- # @!attribute [rw] next_token
1679
- # @return [String]
1680
- #
1681
2294
  # @!attribute [rw] proactive_insights
2295
+ # The returned proactive insights.
1682
2296
  # @return [Array<Types::ProactiveInsightSummary>]
1683
2297
  #
1684
2298
  # @!attribute [rw] reactive_insights
2299
+ # The returned reactive insights.
1685
2300
  # @return [Array<Types::ReactiveInsightSummary>]
1686
2301
  #
2302
+ # @!attribute [rw] next_token
2303
+ # The pagination token to use to retrieve the next page of results for
2304
+ # this operation. If there are no more pages, this value is null.
2305
+ # @return [String]
2306
+ #
1687
2307
  # @see http://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/SearchInsightsResponse AWS API Documentation
1688
2308
  #
1689
2309
  class SearchInsightsResponse < Struct.new(
1690
- :next_token,
1691
2310
  :proactive_insights,
1692
- :reactive_insights)
2311
+ :reactive_insights,
2312
+ :next_token)
1693
2313
  SENSITIVE = []
1694
2314
  include Aws::Structure
1695
2315
  end
1696
2316
 
2317
+ # Information about the integration of DevOps Guru with another AWS
2318
+ # service, such as AWS Systems Manager.
2319
+ #
1697
2320
  # @!attribute [rw] ops_center
2321
+ # Information about whether DevOps Guru is configured to create an
2322
+ # OpsItem in AWS Systems Manager OpsCenter for each created insight.
1698
2323
  # @return [Types::OpsCenterIntegration]
1699
2324
  #
1700
2325
  # @see http://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/ServiceIntegrationConfig AWS API Documentation
@@ -1705,6 +2330,8 @@ module Aws::DevOpsGuru
1705
2330
  include Aws::Structure
1706
2331
  end
1707
2332
 
2333
+ # The request contains a value that exceeds a maximum quota.
2334
+ #
1708
2335
  # @!attribute [rw] message
1709
2336
  # @return [String]
1710
2337
  #
@@ -1716,14 +2343,35 @@ module Aws::DevOpsGuru
1716
2343
  include Aws::Structure
1717
2344
  end
1718
2345
 
2346
+ # Contains the Amazon Resource Name (ARN) of an Amazon Simple
2347
+ # Notification Service topic.
2348
+ #
2349
+ # If you use an Amazon SNS topic in another account, you must attach a
2350
+ # policy to it that grants DevOps Guru permission to it notifications.
2351
+ # DevOps Guru adds the required policy on your behalf to send
2352
+ # notifications using Amazon SNS in your account. For more information,
2353
+ # see [Permissions for cross account Amazon SNS topics][1].
2354
+ #
2355
+ # If you use an Amazon SNS topic that is encrypted by an AWS Key
2356
+ # Management Service customer-managed key (CMK), then you must add
2357
+ # permissions to the CMK. For more information, see [Permissions for AWS
2358
+ # KMS–encrypted Amazon SNS topics][2].
2359
+ #
2360
+ #
2361
+ #
2362
+ # [1]: https://docs.aws.amazon.com/devops-guru/latest/userguide/sns-required-permissions.html
2363
+ # [2]: https://docs.aws.amazon.com/devops-guru/latest/userguide/sns-kms-permissions.html
2364
+ #
1719
2365
  # @note When making an API call, you may pass SnsChannelConfig
1720
2366
  # data as a hash:
1721
2367
  #
1722
2368
  # {
1723
- # topic_arn: "__stringMin36Max1024PatternArnAwsAZ09SnsAZ09D12",
2369
+ # topic_arn: "TopicArn",
1724
2370
  # }
1725
2371
  #
1726
2372
  # @!attribute [rw] topic_arn
2373
+ # The Amazon Resource Name (ARN) of an Amazon Simple Notification
2374
+ # Service topic.
1727
2375
  # @return [String]
1728
2376
  #
1729
2377
  # @see http://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/SnsChannelConfig AWS API Documentation
@@ -1734,6 +2382,9 @@ module Aws::DevOpsGuru
1734
2382
  include Aws::Structure
1735
2383
  end
1736
2384
 
2385
+ # A time range used to specify when the behavior of an insight or
2386
+ # anomaly started.
2387
+ #
1737
2388
  # @note When making an API call, you may pass StartTimeRange
1738
2389
  # data as a hash:
1739
2390
  #
@@ -1743,9 +2394,11 @@ module Aws::DevOpsGuru
1743
2394
  # }
1744
2395
  #
1745
2396
  # @!attribute [rw] from_time
2397
+ # The start time of the time range.
1746
2398
  # @return [Time]
1747
2399
  #
1748
2400
  # @!attribute [rw] to_time
2401
+ # The end time of the time range.
1749
2402
  # @return [Time]
1750
2403
  #
1751
2404
  # @see http://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/StartTimeRange AWS API Documentation
@@ -1757,33 +2410,48 @@ module Aws::DevOpsGuru
1757
2410
  include Aws::Structure
1758
2411
  end
1759
2412
 
2413
+ # The request was denied due to a request throttling.
2414
+ #
1760
2415
  # @!attribute [rw] message
1761
2416
  # @return [String]
1762
2417
  #
1763
2418
  # @!attribute [rw] quota_code
2419
+ # The code of the quota that was exceeded, causing the throttling
2420
+ # exception.
1764
2421
  # @return [String]
1765
2422
  #
1766
2423
  # @!attribute [rw] service_code
2424
+ # The code of the service that caused the throttling exception.
1767
2425
  # @return [String]
1768
2426
  #
2427
+ # @!attribute [rw] retry_after_seconds
2428
+ # The number of seconds after which the action that caused the
2429
+ # throttling exception can be retried.
2430
+ # @return [Integer]
2431
+ #
1769
2432
  # @see http://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/ThrottlingException AWS API Documentation
1770
2433
  #
1771
2434
  class ThrottlingException < Struct.new(
1772
2435
  :message,
1773
2436
  :quota_code,
1774
- :service_code)
2437
+ :service_code,
2438
+ :retry_after_seconds)
1775
2439
  SENSITIVE = []
1776
2440
  include Aws::Structure
1777
2441
  end
1778
2442
 
2443
+ # Contains the names of AWS CloudFormation stacks used to update a
2444
+ # collection of stacks.
2445
+ #
1779
2446
  # @note When making an API call, you may pass UpdateCloudFormationCollectionFilter
1780
2447
  # data as a hash:
1781
2448
  #
1782
2449
  # {
1783
- # stack_names: ["__stringMin1Max128PatternAZAZAZAZ09"],
2450
+ # stack_names: ["StackName"],
1784
2451
  # }
1785
2452
  #
1786
2453
  # @!attribute [rw] stack_names
2454
+ # An array of the name of stacks to update.
1787
2455
  # @return [Array<String>]
1788
2456
  #
1789
2457
  # @see http://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/UpdateCloudFormationCollectionFilter AWS API Documentation
@@ -1794,16 +2462,19 @@ module Aws::DevOpsGuru
1794
2462
  include Aws::Structure
1795
2463
  end
1796
2464
 
2465
+ # Contains information used to update a collection of AWS resources.
2466
+ #
1797
2467
  # @note When making an API call, you may pass UpdateResourceCollectionFilter
1798
2468
  # data as a hash:
1799
2469
  #
1800
2470
  # {
1801
2471
  # cloud_formation: {
1802
- # stack_names: ["__stringMin1Max128PatternAZAZAZAZ09"],
2472
+ # stack_names: ["StackName"],
1803
2473
  # },
1804
2474
  # }
1805
2475
  #
1806
2476
  # @!attribute [rw] cloud_formation
2477
+ # An collection of AWS CloudFormation stacks.
1807
2478
  # @return [Types::UpdateCloudFormationCollectionFilter]
1808
2479
  #
1809
2480
  # @see http://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/UpdateResourceCollectionFilter AWS API Documentation
@@ -1821,15 +2492,18 @@ module Aws::DevOpsGuru
1821
2492
  # action: "ADD", # required, accepts ADD, REMOVE
1822
2493
  # resource_collection: { # required
1823
2494
  # cloud_formation: {
1824
- # stack_names: ["__stringMin1Max128PatternAZAZAZAZ09"],
2495
+ # stack_names: ["StackName"],
1825
2496
  # },
1826
2497
  # },
1827
2498
  # }
1828
2499
  #
1829
2500
  # @!attribute [rw] action
2501
+ # Specifies if the resource collection in the request is added or
2502
+ # deleted to the resource collection.
1830
2503
  # @return [String]
1831
2504
  #
1832
2505
  # @!attribute [rw] resource_collection
2506
+ # Contains information used to update a collection of AWS resources.
1833
2507
  # @return [Types::UpdateResourceCollectionFilter]
1834
2508
  #
1835
2509
  # @see http://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/UpdateResourceCollectionRequest AWS API Documentation
@@ -1845,6 +2519,9 @@ module Aws::DevOpsGuru
1845
2519
  #
1846
2520
  class UpdateResourceCollectionResponse < Aws::EmptyStructure; end
1847
2521
 
2522
+ # Information about updating the integration status of an AWS service,
2523
+ # such as AWS Systems Manager, with DevOps Guru.
2524
+ #
1848
2525
  # @note When making an API call, you may pass UpdateServiceIntegrationConfig
1849
2526
  # data as a hash:
1850
2527
  #
@@ -1855,6 +2532,8 @@ module Aws::DevOpsGuru
1855
2532
  # }
1856
2533
  #
1857
2534
  # @!attribute [rw] ops_center
2535
+ # Information about whether DevOps Guru is configured to create an
2536
+ # OpsItem in AWS Systems Manager OpsCenter for each created insight.
1858
2537
  # @return [Types::OpsCenterIntegrationConfig]
1859
2538
  #
1860
2539
  # @see http://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/UpdateServiceIntegrationConfig AWS API Documentation
@@ -1877,6 +2556,9 @@ module Aws::DevOpsGuru
1877
2556
  # }
1878
2557
  #
1879
2558
  # @!attribute [rw] service_integration
2559
+ # An `IntegratedServiceConfig` object used to specify the integrated
2560
+ # service you want to update, and whether you want to update it to
2561
+ # enabled or disabled.
1880
2562
  # @return [Types::UpdateServiceIntegrationConfig]
1881
2563
  #
1882
2564
  # @see http://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/UpdateServiceIntegrationRequest AWS API Documentation
@@ -1891,36 +2573,48 @@ module Aws::DevOpsGuru
1891
2573
  #
1892
2574
  class UpdateServiceIntegrationResponse < Aws::EmptyStructure; end
1893
2575
 
1894
- # @!attribute [rw] fields
1895
- # @return [Array<Types::ValidationExceptionField>]
2576
+ # Contains information about data passed in to a field during a request
2577
+ # that is not valid.
1896
2578
  #
1897
2579
  # @!attribute [rw] message
2580
+ # A message that describes the validation exception.
1898
2581
  # @return [String]
1899
2582
  #
1900
2583
  # @!attribute [rw] reason
2584
+ # The reason the validation exception was thrown.
1901
2585
  # @return [String]
1902
2586
  #
2587
+ # @!attribute [rw] fields
2588
+ # An array of fields that are associated with the validation
2589
+ # exception.
2590
+ # @return [Array<Types::ValidationExceptionField>]
2591
+ #
1903
2592
  # @see http://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/ValidationException AWS API Documentation
1904
2593
  #
1905
2594
  class ValidationException < Struct.new(
1906
- :fields,
1907
2595
  :message,
1908
- :reason)
2596
+ :reason,
2597
+ :fields)
1909
2598
  SENSITIVE = []
1910
2599
  include Aws::Structure
1911
2600
  end
1912
2601
 
1913
- # @!attribute [rw] message
1914
- # @return [String]
2602
+ # The field associated with the validation exception.
1915
2603
  #
1916
2604
  # @!attribute [rw] name
2605
+ # The name of the field.
2606
+ # @return [String]
2607
+ #
2608
+ # @!attribute [rw] message
2609
+ # The message associated with the validation exception with
2610
+ # information to help determine its cause.
1917
2611
  # @return [String]
1918
2612
  #
1919
2613
  # @see http://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/ValidationExceptionField AWS API Documentation
1920
2614
  #
1921
2615
  class ValidationExceptionField < Struct.new(
1922
- :message,
1923
- :name)
2616
+ :name,
2617
+ :message)
1924
2618
  SENSITIVE = []
1925
2619
  include Aws::Structure
1926
2620
  end