aws-sdk-cloudtrail 1.49.0 → 1.51.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,6 +10,13 @@
10
10
  module Aws::CloudTrail
11
11
  module Types
12
12
 
13
+ # This exception is thrown when you start a new import and a previous
14
+ # import is still in progress.
15
+ #
16
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/AccountHasOngoingImportException AWS API Documentation
17
+ #
18
+ class AccountHasOngoingImportException < Aws::EmptyStructure; end
19
+
13
20
  # Specifies the tags to add to a trail or event data store.
14
21
  #
15
22
  # @note When making an API call, you may pass AddTagsRequest
@@ -136,9 +143,9 @@ module Aws::CloudTrail
136
143
  #
137
144
  # * <b> <code>readOnly</code> </b> - Optional. Can be set to `Equals`
138
145
  # a value of `true` or `false`. If you do not add this field,
139
- # CloudTrail logs both both `read` and `write` events. A value of
140
- # `true` logs only `read` events. A value of `false` logs only
141
- # `write` events.
146
+ # CloudTrail logs both `read` and `write` events. A value of `true`
147
+ # logs only `read` events. A value of `false` logs only `write`
148
+ # events.
142
149
  #
143
150
  # * <b> <code>eventSource</code> </b> - For filtering management
144
151
  # events only. This can be set only to `NotEquals`
@@ -363,6 +370,42 @@ module Aws::CloudTrail
363
370
  include Aws::Structure
364
371
  end
365
372
 
373
+ # Contains information about a returned CloudTrail channel.
374
+ #
375
+ # @!attribute [rw] channel_arn
376
+ # The Amazon Resource Name (ARN) of the channel.
377
+ # @return [String]
378
+ #
379
+ # @!attribute [rw] name
380
+ # The name of the CloudTrail channel. For service-linked channels, the
381
+ # name is `aws-service-channel/service-name/custom-suffix` where
382
+ # `service-name` represents the name of the Amazon Web Services
383
+ # service that created the channel and `custom-suffix` represents the
384
+ # suffix created by the Amazon Web Services service.
385
+ # @return [String]
386
+ #
387
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/Channel AWS API Documentation
388
+ #
389
+ class Channel < Struct.new(
390
+ :channel_arn,
391
+ :name)
392
+ SENSITIVE = []
393
+ include Aws::Structure
394
+ end
395
+
396
+ # The specified channel ARN is not valid or does not map to a channel in
397
+ # your account.
398
+ #
399
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/ChannelARNInvalidException AWS API Documentation
400
+ #
401
+ class ChannelARNInvalidException < Aws::EmptyStructure; end
402
+
403
+ # The specified channel was not found.
404
+ #
405
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/ChannelNotFoundException AWS API Documentation
406
+ #
407
+ class ChannelNotFoundException < Aws::EmptyStructure; end
408
+
366
409
  # This exception is thrown when an operation is called with a trail ARN
367
410
  # that is not valid. The following is the format of a trail ARN.
368
411
  #
@@ -472,7 +515,7 @@ module Aws::CloudTrail
472
515
  #
473
516
  # @!attribute [rw] retention_period
474
517
  # The retention period of the event data store, in days. You can set a
475
- # retention period of up to 2555 days, the equivalent of seven years.
518
+ # retention period of up to 2557 days, the equivalent of seven years.
476
519
  # @return [Integer]
477
520
  #
478
521
  # @!attribute [rw] termination_protection_enabled
@@ -928,8 +971,7 @@ module Aws::CloudTrail
928
971
  # strings for the specified objects.
929
972
  #
930
973
  # * To log data events for all objects in all S3 buckets in your
931
- # Amazon Web Services account, specify the prefix as
932
- # `arn:aws:s3:::`.
974
+ # Amazon Web Services account, specify the prefix as `arn:aws:s3`.
933
975
  #
934
976
  # <note markdown="1"> This also enables logging of data event activity performed by any
935
977
  # user or role in your Amazon Web Services account, even if that
@@ -1172,6 +1214,28 @@ module Aws::CloudTrail
1172
1214
  include Aws::Structure
1173
1215
  end
1174
1216
 
1217
+ # Contains information about the service where CloudTrail delivers
1218
+ # events.
1219
+ #
1220
+ # @!attribute [rw] type
1221
+ # The type of service. For service-linked channels, the value is
1222
+ # `AWS_SERVICE`.
1223
+ # @return [String]
1224
+ #
1225
+ # @!attribute [rw] location
1226
+ # The location of the service. For service-linked channels, this is
1227
+ # the name of the Amazon Web Services service.
1228
+ # @return [String]
1229
+ #
1230
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/Destination AWS API Documentation
1231
+ #
1232
+ class Destination < Struct.new(
1233
+ :type,
1234
+ :location)
1235
+ SENSITIVE = []
1236
+ include Aws::Structure
1237
+ end
1238
+
1175
1239
  # Contains information about an event that was returned by a lookup
1176
1240
  # request. The result includes a representation of a CloudTrail event.
1177
1241
  #
@@ -1233,7 +1297,7 @@ module Aws::CloudTrail
1233
1297
 
1234
1298
  # A storage lake of event data against which you can run complex
1235
1299
  # SQL-based queries. An event data store can include events that you
1236
- # have logged on your account from the last 90 to 2555 days (about three
1300
+ # have logged on your account from the last 90 to 2557 days (about three
1237
1301
  # months to up to seven years). To select events for an event data
1238
1302
  # store, use [advanced event selectors][1].
1239
1303
  #
@@ -1320,6 +1384,13 @@ module Aws::CloudTrail
1320
1384
  #
1321
1385
  class EventDataStoreAlreadyExistsException < Aws::EmptyStructure; end
1322
1386
 
1387
+ # This exception is thrown when you try to update or delete an event
1388
+ # data store that currently has an import in progress.
1389
+ #
1390
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/EventDataStoreHasOngoingImportException AWS API Documentation
1391
+ #
1392
+ class EventDataStoreHasOngoingImportException < Aws::EmptyStructure; end
1393
+
1323
1394
  # Your account has used the maximum number of event data stores.
1324
1395
  #
1325
1396
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/EventDataStoreMaxLimitExceededException AWS API Documentation
@@ -1393,7 +1464,7 @@ module Aws::CloudTrail
1393
1464
  #
1394
1465
  #
1395
1466
  #
1396
- # [1]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-management-and-data-events-with-cloudtrail.html#logging-management-events
1467
+ # [1]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-management-events-with-cloudtrail.html
1397
1468
  # [2]: http://aws.amazon.com/cloudtrail/pricing/
1398
1469
  # @return [Boolean]
1399
1470
  #
@@ -1410,7 +1481,7 @@ module Aws::CloudTrail
1410
1481
  #
1411
1482
  #
1412
1483
  #
1413
- # [1]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-management-and-data-events-with-cloudtrail.html#logging-data-events
1484
+ # [1]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-data-events-with-cloudtrail.html
1414
1485
  # [2]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/WhatIsCloudTrail-Limits.html
1415
1486
  # @return [Array<Types::DataResource>]
1416
1487
  #
@@ -1436,6 +1507,67 @@ module Aws::CloudTrail
1436
1507
  include Aws::Structure
1437
1508
  end
1438
1509
 
1510
+ # @note When making an API call, you may pass GetChannelRequest
1511
+ # data as a hash:
1512
+ #
1513
+ # {
1514
+ # channel: "ChannelArn", # required
1515
+ # }
1516
+ #
1517
+ # @!attribute [rw] channel
1518
+ # The Amazon Resource Name (ARN) of the CloudTrail service-linked
1519
+ # channel.
1520
+ # @return [String]
1521
+ #
1522
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/GetChannelRequest AWS API Documentation
1523
+ #
1524
+ class GetChannelRequest < Struct.new(
1525
+ :channel)
1526
+ SENSITIVE = []
1527
+ include Aws::Structure
1528
+ end
1529
+
1530
+ # @!attribute [rw] channel_arn
1531
+ # The ARN of the CloudTrail service-linked channel.
1532
+ # @return [String]
1533
+ #
1534
+ # @!attribute [rw] name
1535
+ # The name of the CloudTrail service-linked channel. For
1536
+ # service-linked channels, the value is
1537
+ # `aws-service-channel/service-name/custom-suffix` where
1538
+ # `service-name` represents the name of the Amazon Web Services
1539
+ # service that created the channel and `custom-suffix` represents the
1540
+ # suffix generated by the Amazon Web Services service.
1541
+ # @return [String]
1542
+ #
1543
+ # @!attribute [rw] source
1544
+ # The trail or event data store for the CloudTrail service-linked
1545
+ # channel.
1546
+ # @return [String]
1547
+ #
1548
+ # @!attribute [rw] source_config
1549
+ # Provides information about the advanced event selectors configured
1550
+ # for the service-linked channel, and whether the service-linked
1551
+ # channel applies to all regions or one region.
1552
+ # @return [Types::SourceConfig]
1553
+ #
1554
+ # @!attribute [rw] destinations
1555
+ # The Amazon Web Services service that created the CloudTrail
1556
+ # service-linked channel.
1557
+ # @return [Array<Types::Destination>]
1558
+ #
1559
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/GetChannelResponse AWS API Documentation
1560
+ #
1561
+ class GetChannelResponse < Struct.new(
1562
+ :channel_arn,
1563
+ :name,
1564
+ :source,
1565
+ :source_config,
1566
+ :destinations)
1567
+ SENSITIVE = []
1568
+ include Aws::Structure
1569
+ end
1570
+
1439
1571
  # @note When making an API call, you may pass GetEventDataStoreRequest
1440
1572
  # data as a hash:
1441
1573
  #
@@ -1577,6 +1709,81 @@ module Aws::CloudTrail
1577
1709
  include Aws::Structure
1578
1710
  end
1579
1711
 
1712
+ # @note When making an API call, you may pass GetImportRequest
1713
+ # data as a hash:
1714
+ #
1715
+ # {
1716
+ # import_id: "UUID", # required
1717
+ # }
1718
+ #
1719
+ # @!attribute [rw] import_id
1720
+ # The ID for the import.
1721
+ # @return [String]
1722
+ #
1723
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/GetImportRequest AWS API Documentation
1724
+ #
1725
+ class GetImportRequest < Struct.new(
1726
+ :import_id)
1727
+ SENSITIVE = []
1728
+ include Aws::Structure
1729
+ end
1730
+
1731
+ # @!attribute [rw] import_id
1732
+ # The ID of the import.
1733
+ # @return [String]
1734
+ #
1735
+ # @!attribute [rw] destinations
1736
+ # The destination event data store.
1737
+ # @return [Array<String>]
1738
+ #
1739
+ # @!attribute [rw] import_source
1740
+ # The source S3 bucket.
1741
+ # @return [Types::ImportSource]
1742
+ #
1743
+ # @!attribute [rw] start_event_time
1744
+ # Used with `EndEventTime` to bound a `StartImport` request, and limit
1745
+ # imported trail events to only those events logged within a specified
1746
+ # time period.
1747
+ # @return [Time]
1748
+ #
1749
+ # @!attribute [rw] end_event_time
1750
+ # Used with `StartEventTime` to bound a `StartImport` request, and
1751
+ # limit imported trail events to only those events logged within a
1752
+ # specified time period.
1753
+ # @return [Time]
1754
+ #
1755
+ # @!attribute [rw] import_status
1756
+ # The status of the import.
1757
+ # @return [String]
1758
+ #
1759
+ # @!attribute [rw] created_timestamp
1760
+ # The timestamp of the import's creation.
1761
+ # @return [Time]
1762
+ #
1763
+ # @!attribute [rw] updated_timestamp
1764
+ # The timestamp of when the import was updated.
1765
+ # @return [Time]
1766
+ #
1767
+ # @!attribute [rw] import_statistics
1768
+ # Provides statistics for the import.
1769
+ # @return [Types::ImportStatistics]
1770
+ #
1771
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/GetImportResponse AWS API Documentation
1772
+ #
1773
+ class GetImportResponse < Struct.new(
1774
+ :import_id,
1775
+ :destinations,
1776
+ :import_source,
1777
+ :start_event_time,
1778
+ :end_event_time,
1779
+ :import_status,
1780
+ :created_timestamp,
1781
+ :updated_timestamp,
1782
+ :import_statistics)
1783
+ SENSITIVE = []
1784
+ include Aws::Structure
1785
+ end
1786
+
1580
1787
  # @note When making an API call, you may pass GetInsightSelectorsRequest
1581
1788
  # data as a hash:
1582
1789
  #
@@ -1902,6 +2109,140 @@ module Aws::CloudTrail
1902
2109
  include Aws::Structure
1903
2110
  end
1904
2111
 
2112
+ # Provides information about an import failure.
2113
+ #
2114
+ # @!attribute [rw] location
2115
+ # The location of the failure in the S3 bucket.
2116
+ # @return [String]
2117
+ #
2118
+ # @!attribute [rw] status
2119
+ # The status of the import.
2120
+ # @return [String]
2121
+ #
2122
+ # @!attribute [rw] error_type
2123
+ # The type of import error.
2124
+ # @return [String]
2125
+ #
2126
+ # @!attribute [rw] error_message
2127
+ # Provides the reason the import failed.
2128
+ # @return [String]
2129
+ #
2130
+ # @!attribute [rw] last_updated_time
2131
+ # When the import was last updated.
2132
+ # @return [Time]
2133
+ #
2134
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/ImportFailureListItem AWS API Documentation
2135
+ #
2136
+ class ImportFailureListItem < Struct.new(
2137
+ :location,
2138
+ :status,
2139
+ :error_type,
2140
+ :error_message,
2141
+ :last_updated_time)
2142
+ SENSITIVE = []
2143
+ include Aws::Structure
2144
+ end
2145
+
2146
+ # The specified import was not found.
2147
+ #
2148
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/ImportNotFoundException AWS API Documentation
2149
+ #
2150
+ class ImportNotFoundException < Aws::EmptyStructure; end
2151
+
2152
+ # The import source.
2153
+ #
2154
+ # @note When making an API call, you may pass ImportSource
2155
+ # data as a hash:
2156
+ #
2157
+ # {
2158
+ # s3: { # required
2159
+ # s3_location_uri: "String", # required
2160
+ # s3_bucket_region: "String", # required
2161
+ # s3_bucket_access_role_arn: "String", # required
2162
+ # },
2163
+ # }
2164
+ #
2165
+ # @!attribute [rw] s3
2166
+ # The source S3 bucket.
2167
+ # @return [Types::S3ImportSource]
2168
+ #
2169
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/ImportSource AWS API Documentation
2170
+ #
2171
+ class ImportSource < Struct.new(
2172
+ :s3)
2173
+ SENSITIVE = []
2174
+ include Aws::Structure
2175
+ end
2176
+
2177
+ # Provides statistics for the specified `ImportID`.
2178
+ #
2179
+ # @!attribute [rw] prefixes_found
2180
+ # The number of S3 prefixes found for the import.
2181
+ # @return [Integer]
2182
+ #
2183
+ # @!attribute [rw] prefixes_completed
2184
+ # The number of S3 prefixes that completed import.
2185
+ # @return [Integer]
2186
+ #
2187
+ # @!attribute [rw] files_completed
2188
+ # The number of files that completed import.
2189
+ # @return [Integer]
2190
+ #
2191
+ # @!attribute [rw] events_completed
2192
+ # The number of trail events imported.
2193
+ # @return [Integer]
2194
+ #
2195
+ # @!attribute [rw] failed_entries
2196
+ # The number of failed entries.
2197
+ # @return [Integer]
2198
+ #
2199
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/ImportStatistics AWS API Documentation
2200
+ #
2201
+ class ImportStatistics < Struct.new(
2202
+ :prefixes_found,
2203
+ :prefixes_completed,
2204
+ :files_completed,
2205
+ :events_completed,
2206
+ :failed_entries)
2207
+ SENSITIVE = []
2208
+ include Aws::Structure
2209
+ end
2210
+
2211
+ # Contains information about an import that was returned by a lookup
2212
+ # request.
2213
+ #
2214
+ # @!attribute [rw] import_id
2215
+ # The ID of the import.
2216
+ # @return [String]
2217
+ #
2218
+ # @!attribute [rw] import_status
2219
+ # The status of the import.
2220
+ # @return [String]
2221
+ #
2222
+ # @!attribute [rw] destinations
2223
+ # The destination event data store.
2224
+ # @return [Array<String>]
2225
+ #
2226
+ # @!attribute [rw] created_timestamp
2227
+ # The timestamp of the import's creation.
2228
+ # @return [Time]
2229
+ #
2230
+ # @!attribute [rw] updated_timestamp
2231
+ # The timestamp of the import's last update.
2232
+ # @return [Time]
2233
+ #
2234
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/ImportsListItem AWS API Documentation
2235
+ #
2236
+ class ImportsListItem < Struct.new(
2237
+ :import_id,
2238
+ :import_status,
2239
+ :destinations,
2240
+ :created_timestamp,
2241
+ :updated_timestamp)
2242
+ SENSITIVE = []
2243
+ include Aws::Structure
2244
+ end
2245
+
1905
2246
  # The event data store is inactive.
1906
2247
  #
1907
2248
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/InactiveEventDataStoreException AWS API Documentation
@@ -2009,6 +2350,13 @@ module Aws::CloudTrail
2009
2350
  #
2010
2351
  class InvalidEventCategoryException < Aws::EmptyStructure; end
2011
2352
 
2353
+ # This exception is thrown when the event data store category is not
2354
+ # valid for the import.
2355
+ #
2356
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/InvalidEventDataStoreCategoryException AWS API Documentation
2357
+ #
2358
+ class InvalidEventDataStoreCategoryException < Aws::EmptyStructure; end
2359
+
2012
2360
  # The event data store is not in a status that supports the operation.
2013
2361
  #
2014
2362
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/InvalidEventDataStoreStatusException AWS API Documentation
@@ -2052,6 +2400,13 @@ module Aws::CloudTrail
2052
2400
  #
2053
2401
  class InvalidHomeRegionException < Aws::EmptyStructure; end
2054
2402
 
2403
+ # This exception is thrown when the provided source S3 bucket is not
2404
+ # valid for import.
2405
+ #
2406
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/InvalidImportSourceException AWS API Documentation
2407
+ #
2408
+ class InvalidImportSourceException < Aws::EmptyStructure; end
2409
+
2055
2410
  # The formatting or syntax of the `InsightSelectors` JSON statement in
2056
2411
  # your `PutInsightSelectors` or `GetInsightSelectors` request is not
2057
2412
  # valid, or the specified insight type in the `InsightSelectors`
@@ -2201,6 +2556,49 @@ module Aws::CloudTrail
2201
2556
  #
2202
2557
  class KmsKeyNotFoundException < Aws::EmptyStructure; end
2203
2558
 
2559
+ # @note When making an API call, you may pass ListChannelsRequest
2560
+ # data as a hash:
2561
+ #
2562
+ # {
2563
+ # max_results: 1,
2564
+ # next_token: "PaginationToken",
2565
+ # }
2566
+ #
2567
+ # @!attribute [rw] max_results
2568
+ # The maximum number of CloudTrail channels to display on a single
2569
+ # page.
2570
+ # @return [Integer]
2571
+ #
2572
+ # @!attribute [rw] next_token
2573
+ # A token you can use to get the next page of results.
2574
+ # @return [String]
2575
+ #
2576
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/ListChannelsRequest AWS API Documentation
2577
+ #
2578
+ class ListChannelsRequest < Struct.new(
2579
+ :max_results,
2580
+ :next_token)
2581
+ SENSITIVE = []
2582
+ include Aws::Structure
2583
+ end
2584
+
2585
+ # @!attribute [rw] channels
2586
+ # The list of CloudTrail channels.
2587
+ # @return [Array<Types::Channel>]
2588
+ #
2589
+ # @!attribute [rw] next_token
2590
+ # A token used to get the next page of results.
2591
+ # @return [String]
2592
+ #
2593
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/ListChannelsResponse AWS API Documentation
2594
+ #
2595
+ class ListChannelsResponse < Struct.new(
2596
+ :channels,
2597
+ :next_token)
2598
+ SENSITIVE = []
2599
+ include Aws::Structure
2600
+ end
2601
+
2204
2602
  # @note When making an API call, you may pass ListEventDataStoresRequest
2205
2603
  # data as a hash:
2206
2604
  #
@@ -2245,6 +2643,108 @@ module Aws::CloudTrail
2245
2643
  include Aws::Structure
2246
2644
  end
2247
2645
 
2646
+ # @note When making an API call, you may pass ListImportFailuresRequest
2647
+ # data as a hash:
2648
+ #
2649
+ # {
2650
+ # import_id: "UUID", # required
2651
+ # max_results: 1,
2652
+ # next_token: "PaginationToken",
2653
+ # }
2654
+ #
2655
+ # @!attribute [rw] import_id
2656
+ # The ID of the import.
2657
+ # @return [String]
2658
+ #
2659
+ # @!attribute [rw] max_results
2660
+ # The maximum number of failures to display on a single page.
2661
+ # @return [Integer]
2662
+ #
2663
+ # @!attribute [rw] next_token
2664
+ # A token you can use to get the next page of import failures.
2665
+ # @return [String]
2666
+ #
2667
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/ListImportFailuresRequest AWS API Documentation
2668
+ #
2669
+ class ListImportFailuresRequest < Struct.new(
2670
+ :import_id,
2671
+ :max_results,
2672
+ :next_token)
2673
+ SENSITIVE = []
2674
+ include Aws::Structure
2675
+ end
2676
+
2677
+ # @!attribute [rw] failures
2678
+ # Contains information about the import failures.
2679
+ # @return [Array<Types::ImportFailureListItem>]
2680
+ #
2681
+ # @!attribute [rw] next_token
2682
+ # A token you can use to get the next page of results.
2683
+ # @return [String]
2684
+ #
2685
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/ListImportFailuresResponse AWS API Documentation
2686
+ #
2687
+ class ListImportFailuresResponse < Struct.new(
2688
+ :failures,
2689
+ :next_token)
2690
+ SENSITIVE = []
2691
+ include Aws::Structure
2692
+ end
2693
+
2694
+ # @note When making an API call, you may pass ListImportsRequest
2695
+ # data as a hash:
2696
+ #
2697
+ # {
2698
+ # max_results: 1,
2699
+ # destination: "EventDataStoreArn",
2700
+ # import_status: "INITIALIZING", # accepts INITIALIZING, IN_PROGRESS, FAILED, STOPPED, COMPLETED
2701
+ # next_token: "PaginationToken",
2702
+ # }
2703
+ #
2704
+ # @!attribute [rw] max_results
2705
+ # The maximum number of imports to display on a single page.
2706
+ # @return [Integer]
2707
+ #
2708
+ # @!attribute [rw] destination
2709
+ # The destination event data store.
2710
+ # @return [String]
2711
+ #
2712
+ # @!attribute [rw] import_status
2713
+ # The status of the import.
2714
+ # @return [String]
2715
+ #
2716
+ # @!attribute [rw] next_token
2717
+ # A token you can use to get the next page of import results.
2718
+ # @return [String]
2719
+ #
2720
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/ListImportsRequest AWS API Documentation
2721
+ #
2722
+ class ListImportsRequest < Struct.new(
2723
+ :max_results,
2724
+ :destination,
2725
+ :import_status,
2726
+ :next_token)
2727
+ SENSITIVE = []
2728
+ include Aws::Structure
2729
+ end
2730
+
2731
+ # @!attribute [rw] imports
2732
+ # The list of returned imports.
2733
+ # @return [Array<Types::ImportsListItem>]
2734
+ #
2735
+ # @!attribute [rw] next_token
2736
+ # A token you can use to get the next page of import results.
2737
+ # @return [String]
2738
+ #
2739
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/ListImportsResponse AWS API Documentation
2740
+ #
2741
+ class ListImportsResponse < Struct.new(
2742
+ :imports,
2743
+ :next_token)
2744
+ SENSITIVE = []
2745
+ include Aws::Structure
2746
+ end
2747
+
2248
2748
  # Requests the public keys for a specified time range.
2249
2749
  #
2250
2750
  # @note When making an API call, you may pass ListPublicKeysRequest
@@ -2436,9 +2936,9 @@ module Aws::CloudTrail
2436
2936
  # @!attribute [rw] next_token
2437
2937
  # The token to use to get the next page of results after a previous
2438
2938
  # API call. This token must be passed in with the same parameters that
2439
- # were specified in the the original call. For example, if the
2440
- # original call specified an AttributeKey of 'Username' with a value
2441
- # of 'root', the call with NextToken should include those same
2939
+ # were specified in the original call. For example, if the original
2940
+ # call specified an AttributeKey of 'Username' with a value of
2941
+ # 'root', the call with NextToken should include those same
2442
2942
  # parameters.
2443
2943
  # @return [String]
2444
2944
  #
@@ -2551,9 +3051,9 @@ module Aws::CloudTrail
2551
3051
  # @!attribute [rw] next_token
2552
3052
  # The token to use to get the next page of results after a previous
2553
3053
  # API call. This token must be passed in with the same parameters that
2554
- # were specified in the the original call. For example, if the
2555
- # original call specified an AttributeKey of 'Username' with a value
2556
- # of 'root', the call with NextToken should include those same
3054
+ # were specified in the original call. For example, if the original
3055
+ # call specified an AttributeKey of 'Username' with a value of
3056
+ # 'root', the call with NextToken should include those same
2557
3057
  # parameters.
2558
3058
  # @return [String]
2559
3059
  #
@@ -3141,6 +3641,169 @@ module Aws::CloudTrail
3141
3641
  #
3142
3642
  class S3BucketDoesNotExistException < Aws::EmptyStructure; end
3143
3643
 
3644
+ # The settings for the source S3 bucket.
3645
+ #
3646
+ # @note When making an API call, you may pass S3ImportSource
3647
+ # data as a hash:
3648
+ #
3649
+ # {
3650
+ # s3_location_uri: "String", # required
3651
+ # s3_bucket_region: "String", # required
3652
+ # s3_bucket_access_role_arn: "String", # required
3653
+ # }
3654
+ #
3655
+ # @!attribute [rw] s3_location_uri
3656
+ # The URI for the source S3 bucket.
3657
+ # @return [String]
3658
+ #
3659
+ # @!attribute [rw] s3_bucket_region
3660
+ # The region associated with the source S3 bucket.
3661
+ # @return [String]
3662
+ #
3663
+ # @!attribute [rw] s3_bucket_access_role_arn
3664
+ # The IAM ARN role used to access the source S3 bucket.
3665
+ # @return [String]
3666
+ #
3667
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/S3ImportSource AWS API Documentation
3668
+ #
3669
+ class S3ImportSource < Struct.new(
3670
+ :s3_location_uri,
3671
+ :s3_bucket_region,
3672
+ :s3_bucket_access_role_arn)
3673
+ SENSITIVE = []
3674
+ include Aws::Structure
3675
+ end
3676
+
3677
+ # Contains configuration information about the service-linked channel.
3678
+ #
3679
+ # @!attribute [rw] apply_to_all_regions
3680
+ # Specifies whether the service-linked channel applies to one region
3681
+ # or all regions.
3682
+ # @return [Boolean]
3683
+ #
3684
+ # @!attribute [rw] advanced_event_selectors
3685
+ # The advanced event selectors configured for the service-linked
3686
+ # channel.
3687
+ # @return [Array<Types::AdvancedEventSelector>]
3688
+ #
3689
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/SourceConfig AWS API Documentation
3690
+ #
3691
+ class SourceConfig < Struct.new(
3692
+ :apply_to_all_regions,
3693
+ :advanced_event_selectors)
3694
+ SENSITIVE = []
3695
+ include Aws::Structure
3696
+ end
3697
+
3698
+ # @note When making an API call, you may pass StartImportRequest
3699
+ # data as a hash:
3700
+ #
3701
+ # {
3702
+ # destinations: ["EventDataStoreArn"],
3703
+ # import_source: {
3704
+ # s3: { # required
3705
+ # s3_location_uri: "String", # required
3706
+ # s3_bucket_region: "String", # required
3707
+ # s3_bucket_access_role_arn: "String", # required
3708
+ # },
3709
+ # },
3710
+ # start_event_time: Time.now,
3711
+ # end_event_time: Time.now,
3712
+ # import_id: "UUID",
3713
+ # }
3714
+ #
3715
+ # @!attribute [rw] destinations
3716
+ # The destination event data store. Use this parameter for a new
3717
+ # import.
3718
+ # @return [Array<String>]
3719
+ #
3720
+ # @!attribute [rw] import_source
3721
+ # The source S3 bucket for the import. Use this parameter for a new
3722
+ # import.
3723
+ # @return [Types::ImportSource]
3724
+ #
3725
+ # @!attribute [rw] start_event_time
3726
+ # Use with `EndEventTime` to bound a `StartImport` request, and limit
3727
+ # imported trail events to only those events logged within a specified
3728
+ # time period.
3729
+ # @return [Time]
3730
+ #
3731
+ # @!attribute [rw] end_event_time
3732
+ # Use with `StartEventTime` to bound a `StartImport` request, and
3733
+ # limit imported trail events to only those events logged within a
3734
+ # specified time period.
3735
+ # @return [Time]
3736
+ #
3737
+ # @!attribute [rw] import_id
3738
+ # The ID of the import. Use this parameter when you are retrying an
3739
+ # import.
3740
+ # @return [String]
3741
+ #
3742
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/StartImportRequest AWS API Documentation
3743
+ #
3744
+ class StartImportRequest < Struct.new(
3745
+ :destinations,
3746
+ :import_source,
3747
+ :start_event_time,
3748
+ :end_event_time,
3749
+ :import_id)
3750
+ SENSITIVE = []
3751
+ include Aws::Structure
3752
+ end
3753
+
3754
+ # @!attribute [rw] import_id
3755
+ # The ID of the import.
3756
+ # @return [String]
3757
+ #
3758
+ # @!attribute [rw] destinations
3759
+ # The destination event data store.
3760
+ # @return [Array<String>]
3761
+ #
3762
+ # @!attribute [rw] import_source
3763
+ # The source S3 bucket.
3764
+ # @return [Types::ImportSource]
3765
+ #
3766
+ # @!attribute [rw] start_event_time
3767
+ # Used with `EndEventTime` to bound a `StartImport` request, and limit
3768
+ # imported trail events to only those events logged within a specified
3769
+ # time period.
3770
+ # @return [Time]
3771
+ #
3772
+ # @!attribute [rw] end_event_time
3773
+ # Used with `StartEventTime` to bound a `StartImport` request, and
3774
+ # limit imported trail events to only those events logged within a
3775
+ # specified time period.
3776
+ # @return [Time]
3777
+ #
3778
+ # @!attribute [rw] import_status
3779
+ # Shows the status of the import after a `StartImport` request. An
3780
+ # import finishes with a status of `COMPLETED` if there were no
3781
+ # failures, or `FAILED` if there were failures.
3782
+ # @return [String]
3783
+ #
3784
+ # @!attribute [rw] created_timestamp
3785
+ # The timestamp for the import's creation.
3786
+ # @return [Time]
3787
+ #
3788
+ # @!attribute [rw] updated_timestamp
3789
+ # The timestamp of the import's last update, if applicable.
3790
+ # @return [Time]
3791
+ #
3792
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/StartImportResponse AWS API Documentation
3793
+ #
3794
+ class StartImportResponse < Struct.new(
3795
+ :import_id,
3796
+ :destinations,
3797
+ :import_source,
3798
+ :start_event_time,
3799
+ :end_event_time,
3800
+ :import_status,
3801
+ :created_timestamp,
3802
+ :updated_timestamp)
3803
+ SENSITIVE = []
3804
+ include Aws::Structure
3805
+ end
3806
+
3144
3807
  # The request to CloudTrail to start logging Amazon Web Services API
3145
3808
  # calls for an account.
3146
3809
  #
@@ -3205,6 +3868,81 @@ module Aws::CloudTrail
3205
3868
  include Aws::Structure
3206
3869
  end
3207
3870
 
3871
+ # @note When making an API call, you may pass StopImportRequest
3872
+ # data as a hash:
3873
+ #
3874
+ # {
3875
+ # import_id: "UUID", # required
3876
+ # }
3877
+ #
3878
+ # @!attribute [rw] import_id
3879
+ # The ID of the import.
3880
+ # @return [String]
3881
+ #
3882
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/StopImportRequest AWS API Documentation
3883
+ #
3884
+ class StopImportRequest < Struct.new(
3885
+ :import_id)
3886
+ SENSITIVE = []
3887
+ include Aws::Structure
3888
+ end
3889
+
3890
+ # @!attribute [rw] import_id
3891
+ # The ID for the import.
3892
+ # @return [String]
3893
+ #
3894
+ # @!attribute [rw] import_source
3895
+ # The source S3 bucket.
3896
+ # @return [Types::ImportSource]
3897
+ #
3898
+ # @!attribute [rw] destinations
3899
+ # The destination event data store.
3900
+ # @return [Array<String>]
3901
+ #
3902
+ # @!attribute [rw] import_status
3903
+ # The status of the import.
3904
+ # @return [String]
3905
+ #
3906
+ # @!attribute [rw] created_timestamp
3907
+ # The timestamp of the import's creation.
3908
+ # @return [Time]
3909
+ #
3910
+ # @!attribute [rw] updated_timestamp
3911
+ # The timestamp of the import's last update.
3912
+ # @return [Time]
3913
+ #
3914
+ # @!attribute [rw] start_event_time
3915
+ # Used with `EndEventTime` to bound a `StartImport` request, and limit
3916
+ # imported trail events to only those events logged within a specified
3917
+ # time period.
3918
+ # @return [Time]
3919
+ #
3920
+ # @!attribute [rw] end_event_time
3921
+ # Used with `StartEventTime` to bound a `StartImport` request, and
3922
+ # limit imported trail events to only those events logged within a
3923
+ # specified time period.
3924
+ # @return [Time]
3925
+ #
3926
+ # @!attribute [rw] import_statistics
3927
+ # Returns information on the stopped import.
3928
+ # @return [Types::ImportStatistics]
3929
+ #
3930
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/StopImportResponse AWS API Documentation
3931
+ #
3932
+ class StopImportResponse < Struct.new(
3933
+ :import_id,
3934
+ :import_source,
3935
+ :destinations,
3936
+ :import_status,
3937
+ :created_timestamp,
3938
+ :updated_timestamp,
3939
+ :start_event_time,
3940
+ :end_event_time,
3941
+ :import_statistics)
3942
+ SENSITIVE = []
3943
+ include Aws::Structure
3944
+ end
3945
+
3208
3946
  # Passes the request to CloudTrail to stop logging Amazon Web Services
3209
3947
  # API calls for the specified account.
3210
3948
  #
@@ -3484,7 +4222,8 @@ module Aws::CloudTrail
3484
4222
  #
3485
4223
  # @!attribute [rw] advanced_event_selectors
3486
4224
  # The advanced event selectors used to select events for the event
3487
- # data store.
4225
+ # data store. You can configure up to five advanced event selectors
4226
+ # for each event data store.
3488
4227
  # @return [Array<Types::AdvancedEventSelector>]
3489
4228
  #
3490
4229
  # @!attribute [rw] multi_region_enabled