aws-sdk-detective 1.24.0 → 1.41.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.
@@ -10,13 +10,6 @@
10
10
  module Aws::Detective
11
11
  module Types
12
12
 
13
- # @note When making an API call, you may pass AcceptInvitationRequest
14
- # data as a hash:
15
- #
16
- # {
17
- # graph_arn: "GraphArn", # required
18
- # }
19
- #
20
13
  # @!attribute [rw] graph_arn
21
14
  # The ARN of the behavior graph that the member account is accepting
22
15
  # the invitation for.
@@ -32,23 +25,51 @@ module Aws::Detective
32
25
  include Aws::Structure
33
26
  end
34
27
 
35
- # An AWS account that is the administrator account of or a member of a
36
- # behavior graph.
28
+ # The request issuer does not have permission to access this resource or
29
+ # perform this operation.
30
+ #
31
+ # @!attribute [rw] message
32
+ # @return [String]
33
+ #
34
+ # @!attribute [rw] error_code
35
+ # The SDK default error code associated with the access denied
36
+ # exception.
37
+ # @return [String]
38
+ #
39
+ # @!attribute [rw] error_code_reason
40
+ # The SDK default explanation of why access was denied.
41
+ # @return [String]
37
42
  #
38
- # @note When making an API call, you may pass Account
39
- # data as a hash:
43
+ # @!attribute [rw] sub_error_code
44
+ # The error code associated with the access denied exception.
45
+ # @return [String]
46
+ #
47
+ # @!attribute [rw] sub_error_code_reason
48
+ # An explanation of why access was denied.
49
+ # @return [String]
40
50
  #
41
- # {
42
- # account_id: "AccountId", # required
43
- # email_address: "EmailAddress", # required
44
- # }
51
+ # @see http://docs.aws.amazon.com/goto/WebAPI/detective-2018-10-26/AccessDeniedException AWS API Documentation
52
+ #
53
+ class AccessDeniedException < Struct.new(
54
+ :message,
55
+ :error_code,
56
+ :error_code_reason,
57
+ :sub_error_code,
58
+ :sub_error_code_reason)
59
+ SENSITIVE = []
60
+ include Aws::Structure
61
+ end
62
+
63
+ # An Amazon Web Services account that is the administrator account of or
64
+ # a member of a behavior graph.
45
65
  #
46
66
  # @!attribute [rw] account_id
47
- # The account identifier of the AWS account.
67
+ # The account identifier of the Amazon Web Services account.
48
68
  # @return [String]
49
69
  #
50
70
  # @!attribute [rw] email_address
51
- # The AWS account root user email address for the AWS account.
71
+ # The Amazon Web Services account root user email address for the
72
+ # Amazon Web Services account.
52
73
  # @return [String]
53
74
  #
54
75
  # @see http://docs.aws.amazon.com/goto/WebAPI/detective-2018-10-26/Account AWS API Documentation
@@ -56,6 +77,102 @@ module Aws::Detective
56
77
  class Account < Struct.new(
57
78
  :account_id,
58
79
  :email_address)
80
+ SENSITIVE = [:email_address]
81
+ include Aws::Structure
82
+ end
83
+
84
+ # Information about the Detective administrator account for an
85
+ # organization.
86
+ #
87
+ # @!attribute [rw] account_id
88
+ # The Amazon Web Services account identifier of the Detective
89
+ # administrator account for the organization.
90
+ # @return [String]
91
+ #
92
+ # @!attribute [rw] graph_arn
93
+ # The ARN of the organization behavior graph.
94
+ # @return [String]
95
+ #
96
+ # @!attribute [rw] delegation_time
97
+ # The date and time when the Detective administrator account was
98
+ # enabled. The value is an ISO8601 formatted string. For example,
99
+ # `2021-08-18T16:35:56.284Z`.
100
+ # @return [Time]
101
+ #
102
+ # @see http://docs.aws.amazon.com/goto/WebAPI/detective-2018-10-26/Administrator AWS API Documentation
103
+ #
104
+ class Administrator < Struct.new(
105
+ :account_id,
106
+ :graph_arn,
107
+ :delegation_time)
108
+ SENSITIVE = []
109
+ include Aws::Structure
110
+ end
111
+
112
+ # @!attribute [rw] graph_arn
113
+ # The ARN of the behavior graph.
114
+ # @return [String]
115
+ #
116
+ # @!attribute [rw] account_ids
117
+ # The list of Amazon Web Services accounts to get data source package
118
+ # information on.
119
+ # @return [Array<String>]
120
+ #
121
+ # @see http://docs.aws.amazon.com/goto/WebAPI/detective-2018-10-26/BatchGetGraphMemberDatasourcesRequest AWS API Documentation
122
+ #
123
+ class BatchGetGraphMemberDatasourcesRequest < Struct.new(
124
+ :graph_arn,
125
+ :account_ids)
126
+ SENSITIVE = []
127
+ include Aws::Structure
128
+ end
129
+
130
+ # @!attribute [rw] member_datasources
131
+ # Details on the status of data source packages for members of the
132
+ # behavior graph.
133
+ # @return [Array<Types::MembershipDatasources>]
134
+ #
135
+ # @!attribute [rw] unprocessed_accounts
136
+ # Accounts that data source package information could not be retrieved
137
+ # for.
138
+ # @return [Array<Types::UnprocessedAccount>]
139
+ #
140
+ # @see http://docs.aws.amazon.com/goto/WebAPI/detective-2018-10-26/BatchGetGraphMemberDatasourcesResponse AWS API Documentation
141
+ #
142
+ class BatchGetGraphMemberDatasourcesResponse < Struct.new(
143
+ :member_datasources,
144
+ :unprocessed_accounts)
145
+ SENSITIVE = []
146
+ include Aws::Structure
147
+ end
148
+
149
+ # @!attribute [rw] graph_arns
150
+ # The ARN of the behavior graph.
151
+ # @return [Array<String>]
152
+ #
153
+ # @see http://docs.aws.amazon.com/goto/WebAPI/detective-2018-10-26/BatchGetMembershipDatasourcesRequest AWS API Documentation
154
+ #
155
+ class BatchGetMembershipDatasourcesRequest < Struct.new(
156
+ :graph_arns)
157
+ SENSITIVE = []
158
+ include Aws::Structure
159
+ end
160
+
161
+ # @!attribute [rw] membership_datasources
162
+ # Details on the data source package history for an member of the
163
+ # behavior graph.
164
+ # @return [Array<Types::MembershipDatasources>]
165
+ #
166
+ # @!attribute [rw] unprocessed_graphs
167
+ # Graphs that data source package information could not be retrieved
168
+ # for.
169
+ # @return [Array<Types::UnprocessedGraph>]
170
+ #
171
+ # @see http://docs.aws.amazon.com/goto/WebAPI/detective-2018-10-26/BatchGetMembershipDatasourcesResponse AWS API Documentation
172
+ #
173
+ class BatchGetMembershipDatasourcesResponse < Struct.new(
174
+ :membership_datasources,
175
+ :unprocessed_graphs)
59
176
  SENSITIVE = []
60
177
  include Aws::Structure
61
178
  end
@@ -73,15 +190,6 @@ module Aws::Detective
73
190
  include Aws::Structure
74
191
  end
75
192
 
76
- # @note When making an API call, you may pass CreateGraphRequest
77
- # data as a hash:
78
- #
79
- # {
80
- # tags: {
81
- # "TagKey" => "TagValue",
82
- # },
83
- # }
84
- #
85
193
  # @!attribute [rw] tags
86
194
  # The tags to assign to the new behavior graph. You can add up to 50
87
195
  # tags. For each tag, you provide the tag key and the tag value. Each
@@ -109,24 +217,8 @@ module Aws::Detective
109
217
  include Aws::Structure
110
218
  end
111
219
 
112
- # @note When making an API call, you may pass CreateMembersRequest
113
- # data as a hash:
114
- #
115
- # {
116
- # graph_arn: "GraphArn", # required
117
- # message: "EmailMessage",
118
- # disable_email_notification: false,
119
- # accounts: [ # required
120
- # {
121
- # account_id: "AccountId", # required
122
- # email_address: "EmailAddress", # required
123
- # },
124
- # ],
125
- # }
126
- #
127
220
  # @!attribute [rw] graph_arn
128
- # The ARN of the behavior graph to invite the member accounts to
129
- # contribute their data to.
221
+ # The ARN of the behavior graph.
130
222
  # @return [String]
131
223
  #
132
224
  # @!attribute [rw] message
@@ -135,16 +227,21 @@ module Aws::Detective
135
227
  # @return [String]
136
228
  #
137
229
  # @!attribute [rw] disable_email_notification
138
- # if set to `true`, then the member accounts do not receive email
139
- # notifications. By default, this is set to `false`, and the member
230
+ # if set to `true`, then the invited accounts do not receive email
231
+ # notifications. By default, this is set to `false`, and the invited
140
232
  # accounts receive email notifications.
233
+ #
234
+ # Organization accounts in the organization behavior graph do not
235
+ # receive email notifications.
141
236
  # @return [Boolean]
142
237
  #
143
238
  # @!attribute [rw] accounts
144
- # The list of AWS accounts to invite to become member accounts in the
145
- # behavior graph. You can invite up to 50 accounts at a time. For each
146
- # invited account, the account list contains the account identifier
147
- # and the AWS account root user email address.
239
+ # The list of Amazon Web Services accounts to invite or to enable. You
240
+ # can invite or enable up to 50 accounts at a time. For each invited
241
+ # account, the account list contains the account identifier and the
242
+ # Amazon Web Services account root user email address. For
243
+ # organization accounts in the organization behavior graph, the email
244
+ # address is not required.
148
245
  # @return [Array<Types::Account>]
149
246
  #
150
247
  # @see http://docs.aws.amazon.com/goto/WebAPI/detective-2018-10-26/CreateMembersRequest AWS API Documentation
@@ -154,22 +251,23 @@ module Aws::Detective
154
251
  :message,
155
252
  :disable_email_notification,
156
253
  :accounts)
157
- SENSITIVE = []
254
+ SENSITIVE = [:message]
158
255
  include Aws::Structure
159
256
  end
160
257
 
161
258
  # @!attribute [rw] members
162
- # The set of member account invitation requests that Detective was
163
- # able to process. This includes accounts that are being verified,
164
- # that failed verification, and that passed verification and are being
165
- # sent an invitation.
259
+ # The set of member account invitation or enablement requests that
260
+ # Detective was able to process. This includes accounts that are being
261
+ # verified, that failed verification, and that passed verification and
262
+ # are being sent an invitation or are being enabled.
166
263
  # @return [Array<Types::MemberDetail>]
167
264
  #
168
265
  # @!attribute [rw] unprocessed_accounts
169
266
  # The list of accounts for which Detective was unable to process the
170
- # invitation request. For each account, the list provides the reason
171
- # why the request could not be processed. The list includes accounts
172
- # that are already member accounts in the behavior graph.
267
+ # invitation or enablement request. For each account, the list
268
+ # provides the reason why the request could not be processed. The list
269
+ # includes accounts that are already member accounts in the behavior
270
+ # graph.
173
271
  # @return [Array<Types::UnprocessedAccount>]
174
272
  #
175
273
  # @see http://docs.aws.amazon.com/goto/WebAPI/detective-2018-10-26/CreateMembersResponse AWS API Documentation
@@ -181,13 +279,50 @@ module Aws::Detective
181
279
  include Aws::Structure
182
280
  end
183
281
 
184
- # @note When making an API call, you may pass DeleteGraphRequest
185
- # data as a hash:
282
+ # Details about the data source packages ingested by your behavior
283
+ # graph.
284
+ #
285
+ # @!attribute [rw] datasource_package_ingest_state
286
+ # Details on which data source packages are ingested for a member
287
+ # account.
288
+ # @return [String]
289
+ #
290
+ # @!attribute [rw] last_ingest_state_change
291
+ # The date a data source package was enabled for this account
292
+ # @return [Hash<String,Types::TimestampForCollection>]
293
+ #
294
+ # @see http://docs.aws.amazon.com/goto/WebAPI/detective-2018-10-26/DatasourcePackageIngestDetail AWS API Documentation
295
+ #
296
+ class DatasourcePackageIngestDetail < Struct.new(
297
+ :datasource_package_ingest_state,
298
+ :last_ingest_state_change)
299
+ SENSITIVE = []
300
+ include Aws::Structure
301
+ end
302
+
303
+ # Information on the usage of a data source package in the behavior
304
+ # graph.
186
305
  #
187
- # {
188
- # graph_arn: "GraphArn", # required
189
- # }
306
+ # @!attribute [rw] volume_usage_in_bytes
307
+ # Total volume of data in bytes per day ingested for a given data
308
+ # source package.
309
+ # @return [Integer]
310
+ #
311
+ # @!attribute [rw] volume_usage_update_time
312
+ # The data and time when the member account data volume was last
313
+ # updated. The value is an ISO8601 formatted string. For example,
314
+ # `2021-08-18T16:35:56.284Z`.
315
+ # @return [Time]
190
316
  #
317
+ # @see http://docs.aws.amazon.com/goto/WebAPI/detective-2018-10-26/DatasourcePackageUsageInfo AWS API Documentation
318
+ #
319
+ class DatasourcePackageUsageInfo < Struct.new(
320
+ :volume_usage_in_bytes,
321
+ :volume_usage_update_time)
322
+ SENSITIVE = []
323
+ include Aws::Structure
324
+ end
325
+
191
326
  # @!attribute [rw] graph_arn
192
327
  # The ARN of the behavior graph to disable.
193
328
  # @return [String]
@@ -200,22 +335,14 @@ module Aws::Detective
200
335
  include Aws::Structure
201
336
  end
202
337
 
203
- # @note When making an API call, you may pass DeleteMembersRequest
204
- # data as a hash:
205
- #
206
- # {
207
- # graph_arn: "GraphArn", # required
208
- # account_ids: ["AccountId"], # required
209
- # }
210
- #
211
338
  # @!attribute [rw] graph_arn
212
- # The ARN of the behavior graph to delete members from.
339
+ # The ARN of the behavior graph to remove members from.
213
340
  # @return [String]
214
341
  #
215
342
  # @!attribute [rw] account_ids
216
- # The list of AWS account identifiers for the member accounts to
217
- # delete from the behavior graph. You can delete up to 50 member
218
- # accounts at a time.
343
+ # The list of Amazon Web Services account identifiers for the member
344
+ # accounts to remove from the behavior graph. You can remove up to 50
345
+ # member accounts at a time.
219
346
  # @return [Array<String>]
220
347
  #
221
348
  # @see http://docs.aws.amazon.com/goto/WebAPI/detective-2018-10-26/DeleteMembersRequest AWS API Documentation
@@ -228,12 +355,13 @@ module Aws::Detective
228
355
  end
229
356
 
230
357
  # @!attribute [rw] account_ids
231
- # The list of AWS account identifiers for the member accounts that
232
- # Detective successfully deleted from the behavior graph.
358
+ # The list of Amazon Web Services account identifiers for the member
359
+ # accounts that Detective successfully removed from the behavior
360
+ # graph.
233
361
  # @return [Array<String>]
234
362
  #
235
363
  # @!attribute [rw] unprocessed_accounts
236
- # The list of member accounts that Detective was not able to delete
364
+ # The list of member accounts that Detective was not able to remove
237
365
  # from the behavior graph. For each member account, provides the
238
366
  # reason that the deletion could not be processed.
239
367
  # @return [Array<Types::UnprocessedAccount>]
@@ -247,13 +375,31 @@ module Aws::Detective
247
375
  include Aws::Structure
248
376
  end
249
377
 
250
- # @note When making an API call, you may pass DisassociateMembershipRequest
251
- # data as a hash:
378
+ # @!attribute [rw] graph_arn
379
+ # The ARN of the organization behavior graph.
380
+ # @return [String]
381
+ #
382
+ # @see http://docs.aws.amazon.com/goto/WebAPI/detective-2018-10-26/DescribeOrganizationConfigurationRequest AWS API Documentation
383
+ #
384
+ class DescribeOrganizationConfigurationRequest < Struct.new(
385
+ :graph_arn)
386
+ SENSITIVE = []
387
+ include Aws::Structure
388
+ end
389
+
390
+ # @!attribute [rw] auto_enable
391
+ # Indicates whether to automatically enable new organization accounts
392
+ # as member accounts in the organization behavior graph.
393
+ # @return [Boolean]
252
394
  #
253
- # {
254
- # graph_arn: "GraphArn", # required
255
- # }
395
+ # @see http://docs.aws.amazon.com/goto/WebAPI/detective-2018-10-26/DescribeOrganizationConfigurationResponse AWS API Documentation
256
396
  #
397
+ class DescribeOrganizationConfigurationResponse < Struct.new(
398
+ :auto_enable)
399
+ SENSITIVE = []
400
+ include Aws::Structure
401
+ end
402
+
257
403
  # @!attribute [rw] graph_arn
258
404
  # The ARN of the behavior graph to remove the member account from.
259
405
  #
@@ -269,23 +415,29 @@ module Aws::Detective
269
415
  include Aws::Structure
270
416
  end
271
417
 
272
- # @note When making an API call, you may pass GetMembersRequest
273
- # data as a hash:
418
+ # @!attribute [rw] account_id
419
+ # The Amazon Web Services account identifier of the account to
420
+ # designate as the Detective administrator account for the
421
+ # organization.
422
+ # @return [String]
274
423
  #
275
- # {
276
- # graph_arn: "GraphArn", # required
277
- # account_ids: ["AccountId"], # required
278
- # }
424
+ # @see http://docs.aws.amazon.com/goto/WebAPI/detective-2018-10-26/EnableOrganizationAdminAccountRequest AWS API Documentation
279
425
  #
426
+ class EnableOrganizationAdminAccountRequest < Struct.new(
427
+ :account_id)
428
+ SENSITIVE = []
429
+ include Aws::Structure
430
+ end
431
+
280
432
  # @!attribute [rw] graph_arn
281
433
  # The ARN of the behavior graph for which to request the member
282
434
  # details.
283
435
  # @return [String]
284
436
  #
285
437
  # @!attribute [rw] account_ids
286
- # The list of AWS account identifiers for the member account for which
287
- # to return member details. You can request details for up to 50
288
- # member accounts at a time.
438
+ # The list of Amazon Web Services account identifiers for the member
439
+ # account for which to return member details. You can request details
440
+ # for up to 50 member accounts at a time.
289
441
  #
290
442
  # You cannot use `GetMembers` to retrieve information about member
291
443
  # accounts that were removed from the behavior graph.
@@ -330,7 +482,8 @@ module Aws::Detective
330
482
  #
331
483
  # @!attribute [rw] created_time
332
484
  # The date and time that the behavior graph was created. The value is
333
- # in milliseconds since the epoch.
485
+ # an ISO8601 formatted string. For example,
486
+ # `2021-08-18T16:35:56.284Z`.
334
487
  # @return [Time]
335
488
  #
336
489
  # @see http://docs.aws.amazon.com/goto/WebAPI/detective-2018-10-26/Graph AWS API Documentation
@@ -356,14 +509,49 @@ module Aws::Detective
356
509
  include Aws::Structure
357
510
  end
358
511
 
359
- # @note When making an API call, you may pass ListGraphsRequest
360
- # data as a hash:
512
+ # @!attribute [rw] graph_arn
513
+ # The ARN of the behavior graph.
514
+ # @return [String]
515
+ #
516
+ # @!attribute [rw] next_token
517
+ # For requests to get the next page of results, the pagination token
518
+ # that was returned with the previous set of results. The initial
519
+ # request does not include a pagination token.
520
+ # @return [String]
361
521
  #
362
- # {
363
- # next_token: "PaginationToken",
364
- # max_results: 1,
365
- # }
522
+ # @!attribute [rw] max_results
523
+ # The maximum number of results to return.
524
+ # @return [Integer]
525
+ #
526
+ # @see http://docs.aws.amazon.com/goto/WebAPI/detective-2018-10-26/ListDatasourcePackagesRequest AWS API Documentation
366
527
  #
528
+ class ListDatasourcePackagesRequest < Struct.new(
529
+ :graph_arn,
530
+ :next_token,
531
+ :max_results)
532
+ SENSITIVE = []
533
+ include Aws::Structure
534
+ end
535
+
536
+ # @!attribute [rw] datasource_packages
537
+ # Details on the data source packages active in the behavior graph.
538
+ # @return [Hash<String,Types::DatasourcePackageIngestDetail>]
539
+ #
540
+ # @!attribute [rw] next_token
541
+ # For requests to get the next page of results, the pagination token
542
+ # that was returned with the previous set of results. The initial
543
+ # request does not include a pagination token.
544
+ # @return [String]
545
+ #
546
+ # @see http://docs.aws.amazon.com/goto/WebAPI/detective-2018-10-26/ListDatasourcePackagesResponse AWS API Documentation
547
+ #
548
+ class ListDatasourcePackagesResponse < Struct.new(
549
+ :datasource_packages,
550
+ :next_token)
551
+ SENSITIVE = []
552
+ include Aws::Structure
553
+ end
554
+
367
555
  # @!attribute [rw] next_token
368
556
  # For requests to get the next page of results, the pagination token
369
557
  # that was returned with the previous set of results. The initial
@@ -405,14 +593,6 @@ module Aws::Detective
405
593
  include Aws::Structure
406
594
  end
407
595
 
408
- # @note When making an API call, you may pass ListInvitationsRequest
409
- # data as a hash:
410
- #
411
- # {
412
- # next_token: "PaginationToken",
413
- # max_results: 1,
414
- # }
415
- #
416
596
  # @!attribute [rw] next_token
417
597
  # For requests to retrieve the next page of results, the pagination
418
598
  # token that was returned with the previous page of results. The
@@ -454,15 +634,6 @@ module Aws::Detective
454
634
  include Aws::Structure
455
635
  end
456
636
 
457
- # @note When making an API call, you may pass ListMembersRequest
458
- # data as a hash:
459
- #
460
- # {
461
- # graph_arn: "GraphArn", # required
462
- # next_token: "PaginationToken",
463
- # max_results: 1,
464
- # }
465
- #
466
637
  # @!attribute [rw] graph_arn
467
638
  # The ARN of the behavior graph for which to retrieve the list of
468
639
  # member accounts.
@@ -493,16 +664,19 @@ module Aws::Detective
493
664
  # @!attribute [rw] member_details
494
665
  # The list of member accounts in the behavior graph.
495
666
  #
496
- # The results include member accounts that did not pass verification
497
- # and member accounts that have not yet accepted the invitation to the
498
- # behavior graph. The results do not include member accounts that were
499
- # removed from the behavior graph.
667
+ # For invited accounts, the results include member accounts that did
668
+ # not pass verification and member accounts that have not yet accepted
669
+ # the invitation to the behavior graph. The results do not include
670
+ # member accounts that were removed from the behavior graph.
671
+ #
672
+ # For the organization behavior graph, the results do not include
673
+ # organization accounts that the Detective administrator account has
674
+ # not enabled as member accounts.
500
675
  # @return [Array<Types::MemberDetail>]
501
676
  #
502
677
  # @!attribute [rw] next_token
503
- # If there are more member accounts remaining in the results, then
504
- # this is the pagination token to use to request the next page of
505
- # member accounts.
678
+ # If there are more member accounts remaining in the results, then use
679
+ # this pagination token to request the next page of member accounts.
506
680
  # @return [String]
507
681
  #
508
682
  # @see http://docs.aws.amazon.com/goto/WebAPI/detective-2018-10-26/ListMembersResponse AWS API Documentation
@@ -514,13 +688,43 @@ module Aws::Detective
514
688
  include Aws::Structure
515
689
  end
516
690
 
517
- # @note When making an API call, you may pass ListTagsForResourceRequest
518
- # data as a hash:
691
+ # @!attribute [rw] next_token
692
+ # For requests to get the next page of results, the pagination token
693
+ # that was returned with the previous set of results. The initial
694
+ # request does not include a pagination token.
695
+ # @return [String]
696
+ #
697
+ # @!attribute [rw] max_results
698
+ # The maximum number of results to return.
699
+ # @return [Integer]
700
+ #
701
+ # @see http://docs.aws.amazon.com/goto/WebAPI/detective-2018-10-26/ListOrganizationAdminAccountsRequest AWS API Documentation
702
+ #
703
+ class ListOrganizationAdminAccountsRequest < Struct.new(
704
+ :next_token,
705
+ :max_results)
706
+ SENSITIVE = []
707
+ include Aws::Structure
708
+ end
709
+
710
+ # @!attribute [rw] administrators
711
+ # The list of Detective administrator accounts.
712
+ # @return [Array<Types::Administrator>]
519
713
  #
520
- # {
521
- # resource_arn: "GraphArn", # required
522
- # }
714
+ # @!attribute [rw] next_token
715
+ # If there are more accounts remaining in the results, then this is
716
+ # the pagination token to use to request the next page of accounts.
717
+ # @return [String]
523
718
  #
719
+ # @see http://docs.aws.amazon.com/goto/WebAPI/detective-2018-10-26/ListOrganizationAdminAccountsResponse AWS API Documentation
720
+ #
721
+ class ListOrganizationAdminAccountsResponse < Struct.new(
722
+ :administrators,
723
+ :next_token)
724
+ SENSITIVE = []
725
+ include Aws::Structure
726
+ end
727
+
524
728
  # @!attribute [rw] resource_arn
525
729
  # The ARN of the behavior graph for which to retrieve the tag values.
526
730
  # @return [String]
@@ -546,59 +750,70 @@ module Aws::Detective
546
750
  include Aws::Structure
547
751
  end
548
752
 
549
- # Details about a member account that was invited to contribute to a
550
- # behavior graph.
753
+ # Details about a member account in a behavior graph.
551
754
  #
552
755
  # @!attribute [rw] account_id
553
- # The AWS account identifier for the member account.
756
+ # The Amazon Web Services account identifier for the member account.
554
757
  # @return [String]
555
758
  #
556
759
  # @!attribute [rw] email_address
557
- # The AWS account root user email address for the member account.
760
+ # The Amazon Web Services account root user email address for the
761
+ # member account.
558
762
  # @return [String]
559
763
  #
560
764
  # @!attribute [rw] graph_arn
561
- # The ARN of the behavior graph that the member account was invited
562
- # to.
765
+ # The ARN of the behavior graph.
563
766
  # @return [String]
564
767
  #
565
768
  # @!attribute [rw] master_id
566
- # The AWS account identifier of the administrator account for the
567
- # behavior graph.
769
+ # The Amazon Web Services account identifier of the administrator
770
+ # account for the behavior graph.
568
771
  # @return [String]
569
772
  #
570
773
  # @!attribute [rw] administrator_id
571
- # The AWS account identifier of the administrator account for the
572
- # behavior graph.
774
+ # The Amazon Web Services account identifier of the administrator
775
+ # account for the behavior graph.
573
776
  # @return [String]
574
777
  #
575
778
  # @!attribute [rw] status
576
779
  # The current membership status of the member account. The status can
577
780
  # have one of the following values:
578
781
  #
579
- # * `INVITED` - Indicates that the member was sent an invitation but
580
- # has not yet responded.
581
- #
582
- # * `VERIFICATION_IN_PROGRESS` - Indicates that Detective is verifying
583
- # that the account identifier and email address provided for the
584
- # member account match. If they do match, then Detective sends the
585
- # invitation. If the email address and account identifier don't
586
- # match, then the member cannot be added to the behavior graph.
587
- #
588
- # * `VERIFICATION_FAILED` - Indicates that the account and email
589
- # address provided for the member account do not match, and
590
- # Detective did not send an invitation to the account.
591
- #
592
- # * `ENABLED` - Indicates that the member account accepted the
593
- # invitation to contribute to the behavior graph.
594
- #
595
- # * `ACCEPTED_BUT_DISABLED` - Indicates that the member account
596
- # accepted the invitation but is prevented from contributing data to
597
- # the behavior graph. `DisabledReason` provides the reason why the
598
- # member account is not enabled.
599
- #
600
- # Member accounts that declined an invitation or that were removed
601
- # from the behavior graph are not included.
782
+ # * `INVITED` - For invited accounts only. Indicates that the member
783
+ # was sent an invitation but has not yet responded.
784
+ #
785
+ # * `VERIFICATION_IN_PROGRESS` - For invited accounts only, indicates
786
+ # that Detective is verifying that the account identifier and email
787
+ # address provided for the member account match. If they do match,
788
+ # then Detective sends the invitation. If the email address and
789
+ # account identifier don't match, then the member cannot be added
790
+ # to the behavior graph.
791
+ #
792
+ # For organization accounts in the organization behavior graph,
793
+ # indicates that Detective is verifying that the account belongs to
794
+ # the organization.
795
+ #
796
+ # * `VERIFICATION_FAILED` - For invited accounts only. Indicates that
797
+ # the account and email address provided for the member account do
798
+ # not match, and Detective did not send an invitation to the
799
+ # account.
800
+ #
801
+ # * `ENABLED` - Indicates that the member account currently
802
+ # contributes data to the behavior graph. For invited accounts, the
803
+ # member account accepted the invitation. For organization accounts
804
+ # in the organization behavior graph, the Detective administrator
805
+ # account enabled the organization account as a member account.
806
+ #
807
+ # * `ACCEPTED_BUT_DISABLED` - The account accepted the invitation, or
808
+ # was enabled by the Detective administrator account, but is
809
+ # prevented from contributing data to the behavior graph.
810
+ # `DisabledReason` provides the reason why the member account is not
811
+ # enabled.
812
+ #
813
+ # Invited accounts that declined an invitation or that were removed
814
+ # from the behavior graph are not included. In the organization
815
+ # behavior graph, organization accounts that the Detective
816
+ # administrator account did not enable are not included.
602
817
  # @return [String]
603
818
  #
604
819
  # @!attribute [rw] disabled_reason
@@ -616,13 +831,15 @@ module Aws::Detective
616
831
  # @return [String]
617
832
  #
618
833
  # @!attribute [rw] invited_time
619
- # The date and time that Detective sent the invitation to the member
620
- # account. The value is in milliseconds since the epoch.
834
+ # For invited accounts, the date and time that Detective sent the
835
+ # invitation to the account. The value is an ISO8601 formatted string.
836
+ # For example, `2021-08-18T16:35:56.284Z`.
621
837
  # @return [Time]
622
838
  #
623
839
  # @!attribute [rw] updated_time
624
840
  # The date and time that the member account was last updated. The
625
- # value is in milliseconds since the epoch.
841
+ # value is an ISO8601 formatted string. For example,
842
+ # `2021-08-18T16:35:56.284Z`.
626
843
  # @return [Time]
627
844
  #
628
845
  # @!attribute [rw] volume_usage_in_bytes
@@ -631,7 +848,8 @@ module Aws::Detective
631
848
  #
632
849
  # @!attribute [rw] volume_usage_updated_time
633
850
  # The data and time when the member account data volume was last
634
- # updated.
851
+ # updated. The value is an ISO8601 formatted string. For example,
852
+ # `2021-08-18T16:35:56.284Z`.
635
853
  # @return [Time]
636
854
  #
637
855
  # @!attribute [rw] percent_of_graph_utilization
@@ -651,9 +869,29 @@ module Aws::Detective
651
869
  #
652
870
  # @!attribute [rw] percent_of_graph_utilization_updated_time
653
871
  # The date and time when the graph utilization percentage was last
654
- # updated.
872
+ # updated. The value is an ISO8601 formatted string. For example,
873
+ # `2021-08-18T16:35:56.284Z`.
655
874
  # @return [Time]
656
875
  #
876
+ # @!attribute [rw] invitation_type
877
+ # The type of behavior graph membership.
878
+ #
879
+ # For an organization account in the organization behavior graph, the
880
+ # type is `ORGANIZATION`.
881
+ #
882
+ # For an account that was invited to a behavior graph, the type is
883
+ # `INVITATION`.
884
+ # @return [String]
885
+ #
886
+ # @!attribute [rw] volume_usage_by_datasource_package
887
+ # Details on the volume of usage for each data source package in a
888
+ # behavior graph.
889
+ # @return [Hash<String,Types::DatasourcePackageUsageInfo>]
890
+ #
891
+ # @!attribute [rw] datasource_package_ingest_states
892
+ # The state of a data source package for the behavior graph.
893
+ # @return [Hash<String,String>]
894
+ #
657
895
  # @see http://docs.aws.amazon.com/goto/WebAPI/detective-2018-10-26/MemberDetail AWS API Documentation
658
896
  #
659
897
  class MemberDetail < Struct.new(
@@ -669,18 +907,38 @@ module Aws::Detective
669
907
  :volume_usage_in_bytes,
670
908
  :volume_usage_updated_time,
671
909
  :percent_of_graph_utilization,
672
- :percent_of_graph_utilization_updated_time)
673
- SENSITIVE = []
910
+ :percent_of_graph_utilization_updated_time,
911
+ :invitation_type,
912
+ :volume_usage_by_datasource_package,
913
+ :datasource_package_ingest_states)
914
+ SENSITIVE = [:email_address]
674
915
  include Aws::Structure
675
916
  end
676
917
 
677
- # @note When making an API call, you may pass RejectInvitationRequest
678
- # data as a hash:
918
+ # Details on data source packages for members of the behavior graph.
679
919
  #
680
- # {
681
- # graph_arn: "GraphArn", # required
682
- # }
920
+ # @!attribute [rw] account_id
921
+ # The account identifier of the Amazon Web Services account.
922
+ # @return [String]
683
923
  #
924
+ # @!attribute [rw] graph_arn
925
+ # The ARN of the organization behavior graph.
926
+ # @return [String]
927
+ #
928
+ # @!attribute [rw] datasource_package_ingest_history
929
+ # Details on when a data source package was added to a behavior graph.
930
+ # @return [Hash<String,Hash<String,Types::TimestampForCollection>>]
931
+ #
932
+ # @see http://docs.aws.amazon.com/goto/WebAPI/detective-2018-10-26/MembershipDatasources AWS API Documentation
933
+ #
934
+ class MembershipDatasources < Struct.new(
935
+ :account_id,
936
+ :graph_arn,
937
+ :datasource_package_ingest_history)
938
+ SENSITIVE = []
939
+ include Aws::Structure
940
+ end
941
+
684
942
  # @!attribute [rw] graph_arn
685
943
  # The ARN of the behavior graph to reject the invitation to.
686
944
  #
@@ -713,7 +971,7 @@ module Aws::Detective
713
971
  #
714
972
  # * The request would cause the number of member accounts in the
715
973
  # behavior graph to exceed the maximum allowed. A behavior graph
716
- # cannot have more than 1000 member accounts.
974
+ # cannot have more than 1200 member accounts.
717
975
  #
718
976
  # * The request would cause the data rate for the behavior graph to
719
977
  # exceed the maximum allowed.
@@ -725,22 +983,19 @@ module Aws::Detective
725
983
  # @!attribute [rw] message
726
984
  # @return [String]
727
985
  #
986
+ # @!attribute [rw] resources
987
+ # The type of resource that has exceeded the service quota.
988
+ # @return [Array<String>]
989
+ #
728
990
  # @see http://docs.aws.amazon.com/goto/WebAPI/detective-2018-10-26/ServiceQuotaExceededException AWS API Documentation
729
991
  #
730
992
  class ServiceQuotaExceededException < Struct.new(
731
- :message)
993
+ :message,
994
+ :resources)
732
995
  SENSITIVE = []
733
996
  include Aws::Structure
734
997
  end
735
998
 
736
- # @note When making an API call, you may pass StartMonitoringMemberRequest
737
- # data as a hash:
738
- #
739
- # {
740
- # graph_arn: "GraphArn", # required
741
- # account_id: "AccountId", # required
742
- # }
743
- #
744
999
  # @!attribute [rw] graph_arn
745
1000
  # The ARN of the behavior graph.
746
1001
  # @return [String]
@@ -761,16 +1016,6 @@ module Aws::Detective
761
1016
  include Aws::Structure
762
1017
  end
763
1018
 
764
- # @note When making an API call, you may pass TagResourceRequest
765
- # data as a hash:
766
- #
767
- # {
768
- # resource_arn: "GraphArn", # required
769
- # tags: { # required
770
- # "TagKey" => "TagValue",
771
- # },
772
- # }
773
- #
774
1019
  # @!attribute [rw] resource_arn
775
1020
  # The ARN of the behavior graph to assign the tags to.
776
1021
  # @return [String]
@@ -795,12 +1040,42 @@ module Aws::Detective
795
1040
  #
796
1041
  class TagResourceResponse < Aws::EmptyStructure; end
797
1042
 
1043
+ # Details on when data collection began for a source package.
1044
+ #
1045
+ # @!attribute [rw] timestamp
1046
+ # The data and time when data collection began for a source package.
1047
+ # The value is an ISO8601 formatted string. For example,
1048
+ # `2021-08-18T16:35:56.284Z`.
1049
+ # @return [Time]
1050
+ #
1051
+ # @see http://docs.aws.amazon.com/goto/WebAPI/detective-2018-10-26/TimestampForCollection AWS API Documentation
1052
+ #
1053
+ class TimestampForCollection < Struct.new(
1054
+ :timestamp)
1055
+ SENSITIVE = []
1056
+ include Aws::Structure
1057
+ end
1058
+
1059
+ # The request cannot be completed because too many other requests are
1060
+ # occurring at the same time.
1061
+ #
1062
+ # @!attribute [rw] message
1063
+ # @return [String]
1064
+ #
1065
+ # @see http://docs.aws.amazon.com/goto/WebAPI/detective-2018-10-26/TooManyRequestsException AWS API Documentation
1066
+ #
1067
+ class TooManyRequestsException < Struct.new(
1068
+ :message)
1069
+ SENSITIVE = []
1070
+ include Aws::Structure
1071
+ end
1072
+
798
1073
  # A member account that was included in a request but for which the
799
1074
  # request could not be processed.
800
1075
  #
801
1076
  # @!attribute [rw] account_id
802
- # The AWS account identifier of the member account that was not
803
- # processed.
1077
+ # The Amazon Web Services account identifier of the member account
1078
+ # that was not processed.
804
1079
  # @return [String]
805
1080
  #
806
1081
  # @!attribute [rw] reason
@@ -816,14 +1091,26 @@ module Aws::Detective
816
1091
  include Aws::Structure
817
1092
  end
818
1093
 
819
- # @note When making an API call, you may pass UntagResourceRequest
820
- # data as a hash:
1094
+ # Behavior graphs that could not be processed in the request.
1095
+ #
1096
+ # @!attribute [rw] graph_arn
1097
+ # The ARN of the organization behavior graph.
1098
+ # @return [String]
1099
+ #
1100
+ # @!attribute [rw] reason
1101
+ # The reason data source package information could not be processed
1102
+ # for a behavior graph.
1103
+ # @return [String]
821
1104
  #
822
- # {
823
- # resource_arn: "GraphArn", # required
824
- # tag_keys: ["TagKey"], # required
825
- # }
1105
+ # @see http://docs.aws.amazon.com/goto/WebAPI/detective-2018-10-26/UnprocessedGraph AWS API Documentation
826
1106
  #
1107
+ class UnprocessedGraph < Struct.new(
1108
+ :graph_arn,
1109
+ :reason)
1110
+ SENSITIVE = []
1111
+ include Aws::Structure
1112
+ end
1113
+
827
1114
  # @!attribute [rw] resource_arn
828
1115
  # The ARN of the behavior graph to remove the tags from.
829
1116
  # @return [String]
@@ -846,15 +1133,60 @@ module Aws::Detective
846
1133
  #
847
1134
  class UntagResourceResponse < Aws::EmptyStructure; end
848
1135
 
1136
+ # @!attribute [rw] graph_arn
1137
+ # The ARN of the behavior graph.
1138
+ # @return [String]
1139
+ #
1140
+ # @!attribute [rw] datasource_packages
1141
+ # The data source package start for the behavior graph.
1142
+ # @return [Array<String>]
1143
+ #
1144
+ # @see http://docs.aws.amazon.com/goto/WebAPI/detective-2018-10-26/UpdateDatasourcePackagesRequest AWS API Documentation
1145
+ #
1146
+ class UpdateDatasourcePackagesRequest < Struct.new(
1147
+ :graph_arn,
1148
+ :datasource_packages)
1149
+ SENSITIVE = []
1150
+ include Aws::Structure
1151
+ end
1152
+
1153
+ # @!attribute [rw] graph_arn
1154
+ # The ARN of the organization behavior graph.
1155
+ # @return [String]
1156
+ #
1157
+ # @!attribute [rw] auto_enable
1158
+ # Indicates whether to automatically enable new organization accounts
1159
+ # as member accounts in the organization behavior graph.
1160
+ # @return [Boolean]
1161
+ #
1162
+ # @see http://docs.aws.amazon.com/goto/WebAPI/detective-2018-10-26/UpdateOrganizationConfigurationRequest AWS API Documentation
1163
+ #
1164
+ class UpdateOrganizationConfigurationRequest < Struct.new(
1165
+ :graph_arn,
1166
+ :auto_enable)
1167
+ SENSITIVE = []
1168
+ include Aws::Structure
1169
+ end
1170
+
849
1171
  # The request parameters are invalid.
850
1172
  #
851
1173
  # @!attribute [rw] message
852
1174
  # @return [String]
853
1175
  #
1176
+ # @!attribute [rw] error_code
1177
+ # The error code associated with the validation failure.
1178
+ # @return [String]
1179
+ #
1180
+ # @!attribute [rw] error_code_reason
1181
+ # An explanation of why validation failed.
1182
+ # @return [String]
1183
+ #
854
1184
  # @see http://docs.aws.amazon.com/goto/WebAPI/detective-2018-10-26/ValidationException AWS API Documentation
855
1185
  #
856
1186
  class ValidationException < Struct.new(
857
- :message)
1187
+ :message,
1188
+ :error_code,
1189
+ :error_code_reason)
858
1190
  SENSITIVE = []
859
1191
  include Aws::Structure
860
1192
  end