aws-sdk-cloudtrail 1.53.0 → 1.55.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -17,20 +17,28 @@ module Aws::CloudTrail
17
17
  #
18
18
  class AccountHasOngoingImportException < Aws::EmptyStructure; end
19
19
 
20
- # Specifies the tags to add to a trail or event data store.
20
+ # This exception is thrown when when the specified account is not found
21
+ # or not part of an organization.
22
+ #
23
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/AccountNotFoundException AWS API Documentation
24
+ #
25
+ class AccountNotFoundException < Aws::EmptyStructure; end
26
+
27
+ # This exception is thrown when the specified account is not registered
28
+ # as the CloudTrail delegated administrator.
29
+ #
30
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/AccountNotRegisteredException AWS API Documentation
31
+ #
32
+ class AccountNotRegisteredException < Aws::EmptyStructure; end
33
+
34
+ # This exception is thrown when the account is already registered as the
35
+ # CloudTrail delegated administrator.
21
36
  #
22
- # @note When making an API call, you may pass AddTagsRequest
23
- # data as a hash:
37
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/AccountRegisteredException AWS API Documentation
24
38
  #
25
- # {
26
- # resource_id: "String", # required
27
- # tags_list: [ # required
28
- # {
29
- # key: "TagKey", # required
30
- # value: "TagValue",
31
- # },
32
- # ],
33
- # }
39
+ class AccountRegisteredException < Aws::EmptyStructure; end
40
+
41
+ # Specifies the tags to add to a trail or event data store.
34
42
  #
35
43
  # @!attribute [rw] resource_id
36
44
  # Specifies the ARN of the trail or event data store to which one or
@@ -84,24 +92,6 @@ module Aws::CloudTrail
84
92
  #
85
93
  # [1]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-data-events-with-cloudtrail.html
86
94
  #
87
- # @note When making an API call, you may pass AdvancedEventSelector
88
- # data as a hash:
89
- #
90
- # {
91
- # name: "SelectorName",
92
- # field_selectors: [ # required
93
- # {
94
- # field: "SelectorField", # required
95
- # equals: ["OperatorValue"],
96
- # starts_with: ["OperatorValue"],
97
- # ends_with: ["OperatorValue"],
98
- # not_equals: ["OperatorValue"],
99
- # not_starts_with: ["OperatorValue"],
100
- # not_ends_with: ["OperatorValue"],
101
- # },
102
- # ],
103
- # }
104
- #
105
95
  # @!attribute [rw] name
106
96
  # An optional, descriptive name for an advanced event selector, such
107
97
  # as "Log data events for only two S3 buckets".
@@ -122,19 +112,6 @@ module Aws::CloudTrail
122
112
 
123
113
  # A single selector statement in an advanced event selector.
124
114
  #
125
- # @note When making an API call, you may pass AdvancedFieldSelector
126
- # data as a hash:
127
- #
128
- # {
129
- # field: "SelectorField", # required
130
- # equals: ["OperatorValue"],
131
- # starts_with: ["OperatorValue"],
132
- # ends_with: ["OperatorValue"],
133
- # not_equals: ["OperatorValue"],
134
- # not_starts_with: ["OperatorValue"],
135
- # not_ends_with: ["OperatorValue"],
136
- # }
137
- #
138
115
  # @!attribute [rw] field
139
116
  # A field in an event record on which to filter events to be logged.
140
117
  # Supported fields include `readOnly`, `eventCategory`, `eventSource`
@@ -325,14 +302,6 @@ module Aws::CloudTrail
325
302
  include Aws::Structure
326
303
  end
327
304
 
328
- # @note When making an API call, you may pass CancelQueryRequest
329
- # data as a hash:
330
- #
331
- # {
332
- # event_data_store: "EventDataStoreArn", # required
333
- # query_id: "UUID", # required
334
- # }
335
- #
336
305
  # @!attribute [rw] event_data_store
337
306
  # The ARN (or the ID suffix of the ARN) of an event data store on
338
307
  # which the specified query is running.
@@ -370,6 +339,13 @@ module Aws::CloudTrail
370
339
  include Aws::Structure
371
340
  end
372
341
 
342
+ # This exception is thrown when the management account of an
343
+ # organization is registered as the CloudTrail delegated administrator.
344
+ #
345
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/CannotDelegateManagementAccountException AWS API Documentation
346
+ #
347
+ class CannotDelegateManagementAccountException < Aws::EmptyStructure; end
348
+
373
349
  # Contains information about a returned CloudTrail channel.
374
350
  #
375
351
  # @!attribute [rw] channel_arn
@@ -454,39 +430,6 @@ module Aws::CloudTrail
454
430
  #
455
431
  class ConflictException < Aws::EmptyStructure; end
456
432
 
457
- # @note When making an API call, you may pass CreateEventDataStoreRequest
458
- # data as a hash:
459
- #
460
- # {
461
- # name: "EventDataStoreName", # required
462
- # advanced_event_selectors: [
463
- # {
464
- # name: "SelectorName",
465
- # field_selectors: [ # required
466
- # {
467
- # field: "SelectorField", # required
468
- # equals: ["OperatorValue"],
469
- # starts_with: ["OperatorValue"],
470
- # ends_with: ["OperatorValue"],
471
- # not_equals: ["OperatorValue"],
472
- # not_starts_with: ["OperatorValue"],
473
- # not_ends_with: ["OperatorValue"],
474
- # },
475
- # ],
476
- # },
477
- # ],
478
- # multi_region_enabled: false,
479
- # organization_enabled: false,
480
- # retention_period: 1,
481
- # termination_protection_enabled: false,
482
- # tags_list: [
483
- # {
484
- # key: "TagKey", # required
485
- # value: "TagValue",
486
- # },
487
- # ],
488
- # }
489
- #
490
433
  # @!attribute [rw] name
491
434
  # The name of the event data store.
492
435
  # @return [String]
@@ -528,6 +471,40 @@ module Aws::CloudTrail
528
471
  # A list of tags.
529
472
  # @return [Array<Types::Tag>]
530
473
  #
474
+ # @!attribute [rw] kms_key_id
475
+ # Specifies the KMS key ID to use to encrypt the events delivered by
476
+ # CloudTrail. The value can be an alias name prefixed by `alias/`, a
477
+ # fully specified ARN to an alias, a fully specified ARN to a key, or
478
+ # a globally unique identifier.
479
+ #
480
+ # Disabling or deleting the KMS key, or removing CloudTrail
481
+ # permissions on the key, prevents CloudTrail from logging events to
482
+ # the event data store, and prevents users from querying the data in
483
+ # the event data store that was encrypted with the key. After you
484
+ # associate an event data store with a KMS key, the KMS key cannot be
485
+ # removed or changed. Before you disable or delete a KMS key that you
486
+ # are using with an event data store, delete or back up your event
487
+ # data store.
488
+ #
489
+ # CloudTrail also supports KMS multi-Region keys. For more information
490
+ # about multi-Region keys, see [Using multi-Region keys][1] in the
491
+ # *Key Management Service Developer Guide*.
492
+ #
493
+ # Examples:
494
+ #
495
+ # * `alias/MyAliasName`
496
+ #
497
+ # * `arn:aws:kms:us-east-2:123456789012:alias/MyAliasName`
498
+ #
499
+ # * `arn:aws:kms:us-east-2:123456789012:key/12345678-1234-1234-1234-123456789012`
500
+ #
501
+ # * `12345678-1234-1234-1234-123456789012`
502
+ #
503
+ #
504
+ #
505
+ # [1]: https://docs.aws.amazon.com/kms/latest/developerguide/multi-region-keys-overview.html
506
+ # @return [String]
507
+ #
531
508
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/CreateEventDataStoreRequest AWS API Documentation
532
509
  #
533
510
  class CreateEventDataStoreRequest < Struct.new(
@@ -537,7 +514,8 @@ module Aws::CloudTrail
537
514
  :organization_enabled,
538
515
  :retention_period,
539
516
  :termination_protection_enabled,
540
- :tags_list)
517
+ :tags_list,
518
+ :kms_key_id)
541
519
  SENSITIVE = []
542
520
  include Aws::Structure
543
521
  end
@@ -592,6 +570,14 @@ module Aws::CloudTrail
592
570
  # than the time shown in `CreatedTimestamp`.
593
571
  # @return [Time]
594
572
  #
573
+ # @!attribute [rw] kms_key_id
574
+ # Specifies the KMS key ID that encrypts the events delivered by
575
+ # CloudTrail. The value is a fully specified ARN to a KMS key in the
576
+ # following format.
577
+ #
578
+ # `arn:aws:kms:us-east-2:123456789012:key/12345678-1234-1234-1234-123456789012`
579
+ # @return [String]
580
+ #
595
581
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/CreateEventDataStoreResponse AWS API Documentation
596
582
  #
597
583
  class CreateEventDataStoreResponse < Struct.new(
@@ -605,36 +591,14 @@ module Aws::CloudTrail
605
591
  :termination_protection_enabled,
606
592
  :tags_list,
607
593
  :created_timestamp,
608
- :updated_timestamp)
594
+ :updated_timestamp,
595
+ :kms_key_id)
609
596
  SENSITIVE = []
610
597
  include Aws::Structure
611
598
  end
612
599
 
613
600
  # Specifies the settings for each trail.
614
601
  #
615
- # @note When making an API call, you may pass CreateTrailRequest
616
- # data as a hash:
617
- #
618
- # {
619
- # name: "String", # required
620
- # s3_bucket_name: "String", # required
621
- # s3_key_prefix: "String",
622
- # sns_topic_name: "String",
623
- # include_global_service_events: false,
624
- # is_multi_region_trail: false,
625
- # enable_log_file_validation: false,
626
- # cloud_watch_logs_log_group_arn: "String",
627
- # cloud_watch_logs_role_arn: "String",
628
- # kms_key_id: "String",
629
- # is_organization_trail: false,
630
- # tags_list: [
631
- # {
632
- # key: "TagKey", # required
633
- # value: "TagValue",
634
- # },
635
- # ],
636
- # }
637
- #
638
602
  # @!attribute [rw] name
639
603
  # Specifies the name of the trail. The name must meet the following
640
604
  # requirements:
@@ -927,14 +891,6 @@ module Aws::CloudTrail
927
891
  # *MyOtherLambdaFunction* does not match the function specified for
928
892
  # the trail. The trail doesn’t log the event.
929
893
  #
930
- # @note When making an API call, you may pass DataResource
931
- # data as a hash:
932
- #
933
- # {
934
- # type: "String",
935
- # values: ["String"],
936
- # }
937
- #
938
894
  # @!attribute [rw] type
939
895
  # The resource type in which you want to log data events. You can
940
896
  # specify the following *basic* event selector resource types:
@@ -1026,13 +982,13 @@ module Aws::CloudTrail
1026
982
  include Aws::Structure
1027
983
  end
1028
984
 
1029
- # @note When making an API call, you may pass DeleteEventDataStoreRequest
1030
- # data as a hash:
985
+ # This exception is thrown when the maximum number of CloudTrail
986
+ # delegated administrators is reached.
1031
987
  #
1032
- # {
1033
- # event_data_store: "EventDataStoreArn", # required
1034
- # }
988
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/DelegatedAdminAccountLimitExceededException AWS API Documentation
1035
989
  #
990
+ class DelegatedAdminAccountLimitExceededException < Aws::EmptyStructure; end
991
+
1036
992
  # @!attribute [rw] event_data_store
1037
993
  # The ARN (or the ID suffix of the ARN) of the event data store to
1038
994
  # delete.
@@ -1052,13 +1008,6 @@ module Aws::CloudTrail
1052
1008
 
1053
1009
  # The request that specifies the name of a trail to delete.
1054
1010
  #
1055
- # @note When making an API call, you may pass DeleteTrailRequest
1056
- # data as a hash:
1057
- #
1058
- # {
1059
- # name: "String", # required
1060
- # }
1061
- #
1062
1011
  # @!attribute [rw] name
1063
1012
  # Specifies the name or the CloudTrail ARN of the trail to be deleted.
1064
1013
  # The following is the format of a trail ARN.
@@ -1080,14 +1029,31 @@ module Aws::CloudTrail
1080
1029
  #
1081
1030
  class DeleteTrailResponse < Aws::EmptyStructure; end
1082
1031
 
1083
- # @note When making an API call, you may pass DescribeQueryRequest
1084
- # data as a hash:
1032
+ # Removes CloudTrail delegated administrator permissions from a
1033
+ # specified member account in an organization that is currently
1034
+ # designated as a delegated administrator.
1035
+ #
1036
+ # @!attribute [rw] delegated_admin_account_id
1037
+ # A delegated administrator account ID. This is a member account in an
1038
+ # organization that is currently designated as a delegated
1039
+ # administrator.
1040
+ # @return [String]
1041
+ #
1042
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/DeregisterOrganizationDelegatedAdminRequest AWS API Documentation
1043
+ #
1044
+ class DeregisterOrganizationDelegatedAdminRequest < Struct.new(
1045
+ :delegated_admin_account_id)
1046
+ SENSITIVE = []
1047
+ include Aws::Structure
1048
+ end
1049
+
1050
+ # Returns the following response if successful. Otherwise, returns an
1051
+ # error.
1085
1052
  #
1086
- # {
1087
- # event_data_store: "EventDataStoreArn", # required
1088
- # query_id: "UUID", # required
1089
- # }
1053
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/DeregisterOrganizationDelegatedAdminResponse AWS API Documentation
1090
1054
  #
1055
+ class DeregisterOrganizationDelegatedAdminResponse < Aws::EmptyStructure; end
1056
+
1091
1057
  # @!attribute [rw] event_data_store
1092
1058
  # The ARN (or the ID suffix of the ARN) of an event data store on
1093
1059
  # which the specified query was run.
@@ -1154,14 +1120,6 @@ module Aws::CloudTrail
1154
1120
 
1155
1121
  # Returns information about the trail.
1156
1122
  #
1157
- # @note When making an API call, you may pass DescribeTrailsRequest
1158
- # data as a hash:
1159
- #
1160
- # {
1161
- # trail_name_list: ["String"],
1162
- # include_shadow_trails: false,
1163
- # }
1164
- #
1165
1123
  # @!attribute [rw] trail_name_list
1166
1124
  # Specifies a list of trail names, trail ARNs, or both, of the trails
1167
1125
  # to describe. The format of a trail ARN is:
@@ -1435,21 +1393,6 @@ module Aws::CloudTrail
1435
1393
  # You cannot apply both event selectors and advanced event selectors to
1436
1394
  # a trail.
1437
1395
  #
1438
- # @note When making an API call, you may pass EventSelector
1439
- # data as a hash:
1440
- #
1441
- # {
1442
- # read_write_type: "ReadOnly", # accepts ReadOnly, WriteOnly, All
1443
- # include_management_events: false,
1444
- # data_resources: [
1445
- # {
1446
- # type: "String",
1447
- # values: ["String"],
1448
- # },
1449
- # ],
1450
- # exclude_management_event_sources: ["String"],
1451
- # }
1452
- #
1453
1396
  # @!attribute [rw] read_write_type
1454
1397
  # Specify if you want your trail to log read-only events, write-only
1455
1398
  # events, or all. For example, the EC2 `GetConsoleOutput` is a
@@ -1518,13 +1461,6 @@ module Aws::CloudTrail
1518
1461
  include Aws::Structure
1519
1462
  end
1520
1463
 
1521
- # @note When making an API call, you may pass GetChannelRequest
1522
- # data as a hash:
1523
- #
1524
- # {
1525
- # channel: "ChannelArn", # required
1526
- # }
1527
- #
1528
1464
  # @!attribute [rw] channel
1529
1465
  # The ARN or `UUID` of a channel.
1530
1466
  # @return [String]
@@ -1576,13 +1512,6 @@ module Aws::CloudTrail
1576
1512
  include Aws::Structure
1577
1513
  end
1578
1514
 
1579
- # @note When making an API call, you may pass GetEventDataStoreRequest
1580
- # data as a hash:
1581
- #
1582
- # {
1583
- # event_data_store: "EventDataStoreArn", # required
1584
- # }
1585
- #
1586
1515
  # @!attribute [rw] event_data_store
1587
1516
  # The ARN (or ID suffix of the ARN) of the event data store about
1588
1517
  # which you want information.
@@ -1642,6 +1571,14 @@ module Aws::CloudTrail
1642
1571
  # shown in `CreatedTimestamp`.
1643
1572
  # @return [Time]
1644
1573
  #
1574
+ # @!attribute [rw] kms_key_id
1575
+ # Specifies the KMS key ID that encrypts the events delivered by
1576
+ # CloudTrail. The value is a fully specified ARN to a KMS key in the
1577
+ # following format.
1578
+ #
1579
+ # `arn:aws:kms:us-east-2:123456789012:key/12345678-1234-1234-1234-123456789012`
1580
+ # @return [String]
1581
+ #
1645
1582
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/GetEventDataStoreResponse AWS API Documentation
1646
1583
  #
1647
1584
  class GetEventDataStoreResponse < Struct.new(
@@ -1654,18 +1591,12 @@ module Aws::CloudTrail
1654
1591
  :retention_period,
1655
1592
  :termination_protection_enabled,
1656
1593
  :created_timestamp,
1657
- :updated_timestamp)
1594
+ :updated_timestamp,
1595
+ :kms_key_id)
1658
1596
  SENSITIVE = []
1659
1597
  include Aws::Structure
1660
1598
  end
1661
1599
 
1662
- # @note When making an API call, you may pass GetEventSelectorsRequest
1663
- # data as a hash:
1664
- #
1665
- # {
1666
- # trail_name: "String", # required
1667
- # }
1668
- #
1669
1600
  # @!attribute [rw] trail_name
1670
1601
  # Specifies the name of the trail or trail ARN. If you specify a trail
1671
1602
  # name, the string must meet the following requirements:
@@ -1717,13 +1648,6 @@ module Aws::CloudTrail
1717
1648
  include Aws::Structure
1718
1649
  end
1719
1650
 
1720
- # @note When making an API call, you may pass GetImportRequest
1721
- # data as a hash:
1722
- #
1723
- # {
1724
- # import_id: "UUID", # required
1725
- # }
1726
- #
1727
1651
  # @!attribute [rw] import_id
1728
1652
  # The ID for the import.
1729
1653
  # @return [String]
@@ -1796,13 +1720,6 @@ module Aws::CloudTrail
1796
1720
  include Aws::Structure
1797
1721
  end
1798
1722
 
1799
- # @note When making an API call, you may pass GetInsightSelectorsRequest
1800
- # data as a hash:
1801
- #
1802
- # {
1803
- # trail_name: "String", # required
1804
- # }
1805
- #
1806
1723
  # @!attribute [rw] trail_name
1807
1724
  # Specifies the name of the trail or trail ARN. If you specify a trail
1808
1725
  # name, the string must meet the following requirements:
@@ -1852,16 +1769,6 @@ module Aws::CloudTrail
1852
1769
  include Aws::Structure
1853
1770
  end
1854
1771
 
1855
- # @note When making an API call, you may pass GetQueryResultsRequest
1856
- # data as a hash:
1857
- #
1858
- # {
1859
- # event_data_store: "EventDataStoreArn", # required
1860
- # query_id: "UUID", # required
1861
- # next_token: "PaginationToken",
1862
- # max_query_results: 1,
1863
- # }
1864
- #
1865
1772
  # @!attribute [rw] event_data_store
1866
1773
  # The ARN (or ID suffix of the ARN) of the event data store against
1867
1774
  # which the query was run.
@@ -1923,13 +1830,6 @@ module Aws::CloudTrail
1923
1830
  include Aws::Structure
1924
1831
  end
1925
1832
 
1926
- # @note When making an API call, you may pass GetTrailRequest
1927
- # data as a hash:
1928
- #
1929
- # {
1930
- # name: "String", # required
1931
- # }
1932
- #
1933
1833
  # @!attribute [rw] name
1934
1834
  # The name or the Amazon Resource Name (ARN) of the trail for which
1935
1835
  # you want to retrieve settings information.
@@ -1957,13 +1857,6 @@ module Aws::CloudTrail
1957
1857
 
1958
1858
  # The name of a trail about which you want the current status.
1959
1859
  #
1960
- # @note When making an API call, you may pass GetTrailStatusRequest
1961
- # data as a hash:
1962
- #
1963
- # {
1964
- # name: "String", # required
1965
- # }
1966
- #
1967
1860
  # @!attribute [rw] name
1968
1861
  # Specifies the name or the CloudTrail ARN of the trail for which you
1969
1862
  # are requesting status. To get the status of a shadow trail (a
@@ -2163,17 +2056,6 @@ module Aws::CloudTrail
2163
2056
 
2164
2057
  # The import source.
2165
2058
  #
2166
- # @note When making an API call, you may pass ImportSource
2167
- # data as a hash:
2168
- #
2169
- # {
2170
- # s3: { # required
2171
- # s3_location_uri: "String", # required
2172
- # s3_bucket_region: "String", # required
2173
- # s3_bucket_access_role_arn: "String", # required
2174
- # },
2175
- # }
2176
- #
2177
2059
  # @!attribute [rw] s3
2178
2060
  # The source S3 bucket.
2179
2061
  # @return [Types::S3ImportSource]
@@ -2283,13 +2165,6 @@ module Aws::CloudTrail
2283
2165
  # A JSON string that contains a list of insight types that are logged on
2284
2166
  # a trail.
2285
2167
  #
2286
- # @note When making an API call, you may pass InsightSelector
2287
- # data as a hash:
2288
- #
2289
- # {
2290
- # insight_type: "ApiCallRateInsight", # accepts ApiCallRateInsight, ApiErrorRateInsight
2291
- # }
2292
- #
2293
2168
  # @!attribute [rw] insight_type
2294
2169
  # The type of insights to log on a trail. `ApiCallRateInsight` and
2295
2170
  # `ApiErrorRateInsight` are valid insight types.
@@ -2551,7 +2426,7 @@ module Aws::CloudTrail
2551
2426
  class InvalidTrailNameException < Aws::EmptyStructure; end
2552
2427
 
2553
2428
  # This exception is thrown when there is an issue with the specified KMS
2554
- # key and the trail cant be updated.
2429
+ # key and the trail or event data store can't be updated.
2555
2430
  #
2556
2431
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/KmsException AWS API Documentation
2557
2432
  #
@@ -2572,14 +2447,6 @@ module Aws::CloudTrail
2572
2447
  #
2573
2448
  class KmsKeyNotFoundException < Aws::EmptyStructure; end
2574
2449
 
2575
- # @note When making an API call, you may pass ListChannelsRequest
2576
- # data as a hash:
2577
- #
2578
- # {
2579
- # max_results: 1,
2580
- # next_token: "PaginationToken",
2581
- # }
2582
- #
2583
2450
  # @!attribute [rw] max_results
2584
2451
  # The maximum number of CloudTrail channels to display on a single
2585
2452
  # page.
@@ -2621,14 +2488,6 @@ module Aws::CloudTrail
2621
2488
  include Aws::Structure
2622
2489
  end
2623
2490
 
2624
- # @note When making an API call, you may pass ListEventDataStoresRequest
2625
- # data as a hash:
2626
- #
2627
- # {
2628
- # next_token: "PaginationToken",
2629
- # max_results: 1,
2630
- # }
2631
- #
2632
2491
  # @!attribute [rw] next_token
2633
2492
  # A token you can use to get the next page of event data store
2634
2493
  # results.
@@ -2665,15 +2524,6 @@ module Aws::CloudTrail
2665
2524
  include Aws::Structure
2666
2525
  end
2667
2526
 
2668
- # @note When making an API call, you may pass ListImportFailuresRequest
2669
- # data as a hash:
2670
- #
2671
- # {
2672
- # import_id: "UUID", # required
2673
- # max_results: 1,
2674
- # next_token: "PaginationToken",
2675
- # }
2676
- #
2677
2527
  # @!attribute [rw] import_id
2678
2528
  # The ID of the import.
2679
2529
  # @return [String]
@@ -2713,16 +2563,6 @@ module Aws::CloudTrail
2713
2563
  include Aws::Structure
2714
2564
  end
2715
2565
 
2716
- # @note When making an API call, you may pass ListImportsRequest
2717
- # data as a hash:
2718
- #
2719
- # {
2720
- # max_results: 1,
2721
- # destination: "EventDataStoreArn",
2722
- # import_status: "INITIALIZING", # accepts INITIALIZING, IN_PROGRESS, FAILED, STOPPED, COMPLETED
2723
- # next_token: "PaginationToken",
2724
- # }
2725
- #
2726
2566
  # @!attribute [rw] max_results
2727
2567
  # The maximum number of imports to display on a single page.
2728
2568
  # @return [Integer]
@@ -2769,15 +2609,6 @@ module Aws::CloudTrail
2769
2609
 
2770
2610
  # Requests the public keys for a specified time range.
2771
2611
  #
2772
- # @note When making an API call, you may pass ListPublicKeysRequest
2773
- # data as a hash:
2774
- #
2775
- # {
2776
- # start_time: Time.now,
2777
- # end_time: Time.now,
2778
- # next_token: "String",
2779
- # }
2780
- #
2781
2612
  # @!attribute [rw] start_time
2782
2613
  # Optionally specifies, in UTC, the start of the time range to look up
2783
2614
  # public keys for CloudTrail digest files. If not specified, the
@@ -2828,18 +2659,6 @@ module Aws::CloudTrail
2828
2659
  include Aws::Structure
2829
2660
  end
2830
2661
 
2831
- # @note When making an API call, you may pass ListQueriesRequest
2832
- # data as a hash:
2833
- #
2834
- # {
2835
- # event_data_store: "EventDataStoreArn", # required
2836
- # next_token: "PaginationToken",
2837
- # max_results: 1,
2838
- # start_time: Time.now,
2839
- # end_time: Time.now,
2840
- # query_status: "QUEUED", # accepts QUEUED, RUNNING, FINISHED, FAILED, CANCELLED, TIMED_OUT
2841
- # }
2842
- #
2843
2662
  # @!attribute [rw] event_data_store
2844
2663
  # The ARN (or the ID suffix of the ARN) of an event data store on
2845
2664
  # which queries were run.
@@ -2902,14 +2721,6 @@ module Aws::CloudTrail
2902
2721
 
2903
2722
  # Specifies a list of tags to return.
2904
2723
  #
2905
- # @note When making an API call, you may pass ListTagsRequest
2906
- # data as a hash:
2907
- #
2908
- # {
2909
- # resource_id_list: ["String"], # required
2910
- # next_token: "String",
2911
- # }
2912
- #
2913
2724
  # @!attribute [rw] resource_id_list
2914
2725
  # Specifies a list of trail and event data store ARNs whose tags will
2915
2726
  # be listed. The list has a limit of 20 ARNs.
@@ -2948,13 +2759,6 @@ module Aws::CloudTrail
2948
2759
  include Aws::Structure
2949
2760
  end
2950
2761
 
2951
- # @note When making an API call, you may pass ListTrailsRequest
2952
- # data as a hash:
2953
- #
2954
- # {
2955
- # next_token: "String",
2956
- # }
2957
- #
2958
2762
  # @!attribute [rw] next_token
2959
2763
  # The token to use to get the next page of results after a previous
2960
2764
  # API call. This token must be passed in with the same parameters that
@@ -2997,14 +2801,6 @@ module Aws::CloudTrail
2997
2801
 
2998
2802
  # Specifies an attribute and value that filter the events returned.
2999
2803
  #
3000
- # @note When making an API call, you may pass LookupAttribute
3001
- # data as a hash:
3002
- #
3003
- # {
3004
- # attribute_key: "EventId", # required, accepts EventId, EventName, ReadOnly, Username, ResourceType, ResourceName, EventSource, AccessKeyId
3005
- # attribute_value: "String", # required
3006
- # }
3007
- #
3008
2804
  # @!attribute [rw] attribute_key
3009
2805
  # Specifies an attribute on which to filter the events returned.
3010
2806
  # @return [String]
@@ -3024,23 +2820,6 @@ module Aws::CloudTrail
3024
2820
 
3025
2821
  # Contains a request for LookupEvents.
3026
2822
  #
3027
- # @note When making an API call, you may pass LookupEventsRequest
3028
- # data as a hash:
3029
- #
3030
- # {
3031
- # lookup_attributes: [
3032
- # {
3033
- # attribute_key: "EventId", # required, accepts EventId, EventName, ReadOnly, Username, ResourceType, ResourceName, EventSource, AccessKeyId
3034
- # attribute_value: "String", # required
3035
- # },
3036
- # ],
3037
- # start_time: Time.now,
3038
- # end_time: Time.now,
3039
- # event_category: "insight", # accepts insight
3040
- # max_results: 1,
3041
- # next_token: "NextToken",
3042
- # }
3043
- #
3044
2823
  # @!attribute [rw] lookup_attributes
3045
2824
  # Contains a list of lookup attributes. Currently the list can contain
3046
2825
  # only one item.
@@ -3131,6 +2910,20 @@ module Aws::CloudTrail
3131
2910
  #
3132
2911
  class MaximumNumberOfTrailsExceededException < Aws::EmptyStructure; end
3133
2912
 
2913
+ # This exception is thrown when the management account does not have a
2914
+ # service-linked role.
2915
+ #
2916
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/NoManagementAccountSLRExistsException AWS API Documentation
2917
+ #
2918
+ class NoManagementAccountSLRExistsException < Aws::EmptyStructure; end
2919
+
2920
+ # This exception is thrown when the account making the request is not
2921
+ # the organization's management account.
2922
+ #
2923
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/NotOrganizationManagementAccountException AWS API Documentation
2924
+ #
2925
+ class NotOrganizationManagementAccountException < Aws::EmptyStructure; end
2926
+
3134
2927
  # This exception is thrown when the Amazon Web Services account making
3135
2928
  # the request to create or update an organization trail or event data
3136
2929
  # store is not the management account for an organization in
@@ -3199,42 +2992,6 @@ module Aws::CloudTrail
3199
2992
  include Aws::Structure
3200
2993
  end
3201
2994
 
3202
- # @note When making an API call, you may pass PutEventSelectorsRequest
3203
- # data as a hash:
3204
- #
3205
- # {
3206
- # trail_name: "String", # required
3207
- # event_selectors: [
3208
- # {
3209
- # read_write_type: "ReadOnly", # accepts ReadOnly, WriteOnly, All
3210
- # include_management_events: false,
3211
- # data_resources: [
3212
- # {
3213
- # type: "String",
3214
- # values: ["String"],
3215
- # },
3216
- # ],
3217
- # exclude_management_event_sources: ["String"],
3218
- # },
3219
- # ],
3220
- # advanced_event_selectors: [
3221
- # {
3222
- # name: "SelectorName",
3223
- # field_selectors: [ # required
3224
- # {
3225
- # field: "SelectorField", # required
3226
- # equals: ["OperatorValue"],
3227
- # starts_with: ["OperatorValue"],
3228
- # ends_with: ["OperatorValue"],
3229
- # not_equals: ["OperatorValue"],
3230
- # not_starts_with: ["OperatorValue"],
3231
- # not_ends_with: ["OperatorValue"],
3232
- # },
3233
- # ],
3234
- # },
3235
- # ],
3236
- # }
3237
- #
3238
2995
  # @!attribute [rw] trail_name
3239
2996
  # Specifies the name of the trail or trail ARN. If you specify a trail
3240
2997
  # name, the string must meet the following requirements:
@@ -3316,18 +3073,6 @@ module Aws::CloudTrail
3316
3073
  include Aws::Structure
3317
3074
  end
3318
3075
 
3319
- # @note When making an API call, you may pass PutInsightSelectorsRequest
3320
- # data as a hash:
3321
- #
3322
- # {
3323
- # trail_name: "String", # required
3324
- # insight_selectors: [ # required
3325
- # {
3326
- # insight_type: "ApiCallRateInsight", # accepts ApiCallRateInsight, ApiErrorRateInsight
3327
- # },
3328
- # ],
3329
- # }
3330
- #
3331
3076
  # @!attribute [rw] trail_name
3332
3077
  # The name of the CloudTrail trail for which you want to change or add
3333
3078
  # Insights selectors.
@@ -3464,20 +3209,30 @@ module Aws::CloudTrail
3464
3209
  include Aws::Structure
3465
3210
  end
3466
3211
 
3467
- # Specifies the tags to remove from a trail or event data store.
3212
+ # Specifies an organization member account ID as a CloudTrail delegated
3213
+ # administrator.
3468
3214
  #
3469
- # @note When making an API call, you may pass RemoveTagsRequest
3470
- # data as a hash:
3215
+ # @!attribute [rw] member_account_id
3216
+ # An organization member account ID that you want to designate as a
3217
+ # delegated administrator.
3218
+ # @return [String]
3471
3219
  #
3472
- # {
3473
- # resource_id: "String", # required
3474
- # tags_list: [ # required
3475
- # {
3476
- # key: "TagKey", # required
3477
- # value: "TagValue",
3478
- # },
3479
- # ],
3480
- # }
3220
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/RegisterOrganizationDelegatedAdminRequest AWS API Documentation
3221
+ #
3222
+ class RegisterOrganizationDelegatedAdminRequest < Struct.new(
3223
+ :member_account_id)
3224
+ SENSITIVE = []
3225
+ include Aws::Structure
3226
+ end
3227
+
3228
+ # Returns the following response if successful. Otherwise, returns an
3229
+ # error.
3230
+ #
3231
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/RegisterOrganizationDelegatedAdminResponse AWS API Documentation
3232
+ #
3233
+ class RegisterOrganizationDelegatedAdminResponse < Aws::EmptyStructure; end
3234
+
3235
+ # Specifies the tags to remove from a trail or event data store.
3481
3236
  #
3482
3237
  # @!attribute [rw] resource_id
3483
3238
  # Specifies the ARN of the trail or event data store from which tags
@@ -3574,13 +3329,6 @@ module Aws::CloudTrail
3574
3329
  #
3575
3330
  class ResourceTypeNotSupportedException < Aws::EmptyStructure; end
3576
3331
 
3577
- # @note When making an API call, you may pass RestoreEventDataStoreRequest
3578
- # data as a hash:
3579
- #
3580
- # {
3581
- # event_data_store: "EventDataStoreArn", # required
3582
- # }
3583
- #
3584
3332
  # @!attribute [rw] event_data_store
3585
3333
  # The ARN (or the ID suffix of the ARN) of the event data store that
3586
3334
  # you want to restore.
@@ -3640,6 +3388,14 @@ module Aws::CloudTrail
3640
3388
  # than the time shown in `CreatedTimestamp`.
3641
3389
  # @return [Time]
3642
3390
  #
3391
+ # @!attribute [rw] kms_key_id
3392
+ # Specifies the KMS key ID that encrypts the events delivered by
3393
+ # CloudTrail. The value is a fully specified ARN to a KMS key in the
3394
+ # following format.
3395
+ #
3396
+ # `arn:aws:kms:us-east-2:123456789012:key/12345678-1234-1234-1234-123456789012`
3397
+ # @return [String]
3398
+ #
3643
3399
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/RestoreEventDataStoreResponse AWS API Documentation
3644
3400
  #
3645
3401
  class RestoreEventDataStoreResponse < Struct.new(
@@ -3652,7 +3408,8 @@ module Aws::CloudTrail
3652
3408
  :retention_period,
3653
3409
  :termination_protection_enabled,
3654
3410
  :created_timestamp,
3655
- :updated_timestamp)
3411
+ :updated_timestamp,
3412
+ :kms_key_id)
3656
3413
  SENSITIVE = []
3657
3414
  include Aws::Structure
3658
3415
  end
@@ -3665,15 +3422,6 @@ module Aws::CloudTrail
3665
3422
 
3666
3423
  # The settings for the source S3 bucket.
3667
3424
  #
3668
- # @note When making an API call, you may pass S3ImportSource
3669
- # data as a hash:
3670
- #
3671
- # {
3672
- # s3_location_uri: "String", # required
3673
- # s3_bucket_region: "String", # required
3674
- # s3_bucket_access_role_arn: "String", # required
3675
- # }
3676
- #
3677
3425
  # @!attribute [rw] s3_location_uri
3678
3426
  # The URI for the source S3 bucket.
3679
3427
  # @return [String]
@@ -3716,23 +3464,6 @@ module Aws::CloudTrail
3716
3464
  include Aws::Structure
3717
3465
  end
3718
3466
 
3719
- # @note When making an API call, you may pass StartImportRequest
3720
- # data as a hash:
3721
- #
3722
- # {
3723
- # destinations: ["EventDataStoreArn"],
3724
- # import_source: {
3725
- # s3: { # required
3726
- # s3_location_uri: "String", # required
3727
- # s3_bucket_region: "String", # required
3728
- # s3_bucket_access_role_arn: "String", # required
3729
- # },
3730
- # },
3731
- # start_event_time: Time.now,
3732
- # end_event_time: Time.now,
3733
- # import_id: "UUID",
3734
- # }
3735
- #
3736
3467
  # @!attribute [rw] destinations
3737
3468
  # The ARN of the destination event data store. Use this parameter for
3738
3469
  # a new import.
@@ -3834,13 +3565,6 @@ module Aws::CloudTrail
3834
3565
  # The request to CloudTrail to start logging Amazon Web Services API
3835
3566
  # calls for an account.
3836
3567
  #
3837
- # @note When making an API call, you may pass StartLoggingRequest
3838
- # data as a hash:
3839
- #
3840
- # {
3841
- # name: "String", # required
3842
- # }
3843
- #
3844
3568
  # @!attribute [rw] name
3845
3569
  # Specifies the name or the CloudTrail ARN of the trail for which
3846
3570
  # CloudTrail logs Amazon Web Services API calls. The following is the
@@ -3864,14 +3588,6 @@ module Aws::CloudTrail
3864
3588
  #
3865
3589
  class StartLoggingResponse < Aws::EmptyStructure; end
3866
3590
 
3867
- # @note When making an API call, you may pass StartQueryRequest
3868
- # data as a hash:
3869
- #
3870
- # {
3871
- # query_statement: "QueryStatement", # required
3872
- # delivery_s3_uri: "DeliveryS3Uri",
3873
- # }
3874
- #
3875
3591
  # @!attribute [rw] query_statement
3876
3592
  # The SQL code of your query.
3877
3593
  # @return [String]
@@ -3902,13 +3618,6 @@ module Aws::CloudTrail
3902
3618
  include Aws::Structure
3903
3619
  end
3904
3620
 
3905
- # @note When making an API call, you may pass StopImportRequest
3906
- # data as a hash:
3907
- #
3908
- # {
3909
- # import_id: "UUID", # required
3910
- # }
3911
- #
3912
3621
  # @!attribute [rw] import_id
3913
3622
  # The ID of the import.
3914
3623
  # @return [String]
@@ -3980,13 +3689,6 @@ module Aws::CloudTrail
3980
3689
  # Passes the request to CloudTrail to stop logging Amazon Web Services
3981
3690
  # API calls for the specified account.
3982
3691
  #
3983
- # @note When making an API call, you may pass StopLoggingRequest
3984
- # data as a hash:
3985
- #
3986
- # {
3987
- # name: "String", # required
3988
- # }
3989
- #
3990
3692
  # @!attribute [rw] name
3991
3693
  # Specifies the name or the CloudTrail ARN of the trail for which
3992
3694
  # CloudTrail will stop logging Amazon Web Services API calls. The
@@ -4013,14 +3715,6 @@ module Aws::CloudTrail
4013
3715
  # A custom key-value pair associated with a resource such as a
4014
3716
  # CloudTrail trail.
4015
3717
  #
4016
- # @note When making an API call, you may pass Tag
4017
- # data as a hash:
4018
- #
4019
- # {
4020
- # key: "TagKey", # required
4021
- # value: "TagValue",
4022
- # }
4023
- #
4024
3718
  # @!attribute [rw] key
4025
3719
  # The key in a key-value pair. The key must be must be no longer than
4026
3720
  # 128 Unicode characters. The key must be unique for the resource to
@@ -4217,34 +3911,6 @@ module Aws::CloudTrail
4217
3911
  #
4218
3912
  class UnsupportedOperationException < Aws::EmptyStructure; end
4219
3913
 
4220
- # @note When making an API call, you may pass UpdateEventDataStoreRequest
4221
- # data as a hash:
4222
- #
4223
- # {
4224
- # event_data_store: "EventDataStoreArn", # required
4225
- # name: "EventDataStoreName",
4226
- # advanced_event_selectors: [
4227
- # {
4228
- # name: "SelectorName",
4229
- # field_selectors: [ # required
4230
- # {
4231
- # field: "SelectorField", # required
4232
- # equals: ["OperatorValue"],
4233
- # starts_with: ["OperatorValue"],
4234
- # ends_with: ["OperatorValue"],
4235
- # not_equals: ["OperatorValue"],
4236
- # not_starts_with: ["OperatorValue"],
4237
- # not_ends_with: ["OperatorValue"],
4238
- # },
4239
- # ],
4240
- # },
4241
- # ],
4242
- # multi_region_enabled: false,
4243
- # organization_enabled: false,
4244
- # retention_period: 1,
4245
- # termination_protection_enabled: false,
4246
- # }
4247
- #
4248
3914
  # @!attribute [rw] event_data_store
4249
3915
  # The ARN (or the ID suffix of the ARN) of the event data store that
4250
3916
  # you want to update.
@@ -4279,6 +3945,40 @@ module Aws::CloudTrail
4279
3945
  # store cannot be automatically deleted.
4280
3946
  # @return [Boolean]
4281
3947
  #
3948
+ # @!attribute [rw] kms_key_id
3949
+ # Specifies the KMS key ID to use to encrypt the events delivered by
3950
+ # CloudTrail. The value can be an alias name prefixed by `alias/`, a
3951
+ # fully specified ARN to an alias, a fully specified ARN to a key, or
3952
+ # a globally unique identifier.
3953
+ #
3954
+ # Disabling or deleting the KMS key, or removing CloudTrail
3955
+ # permissions on the key, prevents CloudTrail from logging events to
3956
+ # the event data store, and prevents users from querying the data in
3957
+ # the event data store that was encrypted with the key. After you
3958
+ # associate an event data store with a KMS key, the KMS key cannot be
3959
+ # removed or changed. Before you disable or delete a KMS key that you
3960
+ # are using with an event data store, delete or back up your event
3961
+ # data store.
3962
+ #
3963
+ # CloudTrail also supports KMS multi-Region keys. For more information
3964
+ # about multi-Region keys, see [Using multi-Region keys][1] in the
3965
+ # *Key Management Service Developer Guide*.
3966
+ #
3967
+ # Examples:
3968
+ #
3969
+ # * `alias/MyAliasName`
3970
+ #
3971
+ # * `arn:aws:kms:us-east-2:123456789012:alias/MyAliasName`
3972
+ #
3973
+ # * `arn:aws:kms:us-east-2:123456789012:key/12345678-1234-1234-1234-123456789012`
3974
+ #
3975
+ # * `12345678-1234-1234-1234-123456789012`
3976
+ #
3977
+ #
3978
+ #
3979
+ # [1]: https://docs.aws.amazon.com/kms/latest/developerguide/multi-region-keys-overview.html
3980
+ # @return [String]
3981
+ #
4282
3982
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/UpdateEventDataStoreRequest AWS API Documentation
4283
3983
  #
4284
3984
  class UpdateEventDataStoreRequest < Struct.new(
@@ -4288,7 +3988,8 @@ module Aws::CloudTrail
4288
3988
  :multi_region_enabled,
4289
3989
  :organization_enabled,
4290
3990
  :retention_period,
4291
- :termination_protection_enabled)
3991
+ :termination_protection_enabled,
3992
+ :kms_key_id)
4292
3993
  SENSITIVE = []
4293
3994
  include Aws::Structure
4294
3995
  end
@@ -4340,6 +4041,14 @@ module Aws::CloudTrail
4340
4041
  # shown in `CreatedTimestamp`.
4341
4042
  # @return [Time]
4342
4043
  #
4044
+ # @!attribute [rw] kms_key_id
4045
+ # Specifies the KMS key ID that encrypts the events delivered by
4046
+ # CloudTrail. The value is a fully specified ARN to a KMS key in the
4047
+ # following format.
4048
+ #
4049
+ # `arn:aws:kms:us-east-2:123456789012:key/12345678-1234-1234-1234-123456789012`
4050
+ # @return [String]
4051
+ #
4343
4052
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/UpdateEventDataStoreResponse AWS API Documentation
4344
4053
  #
4345
4054
  class UpdateEventDataStoreResponse < Struct.new(
@@ -4352,30 +4061,14 @@ module Aws::CloudTrail
4352
4061
  :retention_period,
4353
4062
  :termination_protection_enabled,
4354
4063
  :created_timestamp,
4355
- :updated_timestamp)
4064
+ :updated_timestamp,
4065
+ :kms_key_id)
4356
4066
  SENSITIVE = []
4357
4067
  include Aws::Structure
4358
4068
  end
4359
4069
 
4360
4070
  # Specifies settings to update for the trail.
4361
4071
  #
4362
- # @note When making an API call, you may pass UpdateTrailRequest
4363
- # data as a hash:
4364
- #
4365
- # {
4366
- # name: "String", # required
4367
- # s3_bucket_name: "String",
4368
- # s3_key_prefix: "String",
4369
- # sns_topic_name: "String",
4370
- # include_global_service_events: false,
4371
- # is_multi_region_trail: false,
4372
- # enable_log_file_validation: false,
4373
- # cloud_watch_logs_log_group_arn: "String",
4374
- # cloud_watch_logs_role_arn: "String",
4375
- # kms_key_id: "String",
4376
- # is_organization_trail: false,
4377
- # }
4378
- #
4379
4072
  # @!attribute [rw] name
4380
4073
  # Specifies the name of the trail or trail ARN. If `Name` is a trail
4381
4074
  # name, the string must meet the following requirements: