aws-sdk-cloudtrail 1.49.0 → 1.51.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -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