aws-sdk-cloudtrail 1.53.0 → 1.55.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.
@@ -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: