aws-sdk-cloudtrail 1.50.0 → 1.52.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
@@ -366,7 +373,7 @@ module Aws::CloudTrail
366
373
  # Contains information about a returned CloudTrail channel.
367
374
  #
368
375
  # @!attribute [rw] channel_arn
369
- # The Amazon Resource Name (ARN) of the channel.
376
+ # The Amazon Resource Name (ARN) of a channel.
370
377
  # @return [String]
371
378
  #
372
379
  # @!attribute [rw] name
@@ -386,8 +393,8 @@ module Aws::CloudTrail
386
393
  include Aws::Structure
387
394
  end
388
395
 
389
- # The specified channel ARN is not valid or does not map to a channel in
390
- # your account.
396
+ # This exception is thrown when the specified value of `ChannelARN` is
397
+ # not valid.
391
398
  #
392
399
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/ChannelARNInvalidException AWS API Documentation
393
400
  #
@@ -713,7 +720,7 @@ module Aws::CloudTrail
713
720
  #
714
721
  # @!attribute [rw] kms_key_id
715
722
  # Specifies the KMS key ID to use to encrypt the logs delivered by
716
- # CloudTrail. The value can be an alias name prefixed by "alias/", a
723
+ # CloudTrail. The value can be an alias name prefixed by `alias/`, a
717
724
  # fully specified ARN to an alias, a fully specified ARN to a key, or
718
725
  # a globally unique identifier.
719
726
  #
@@ -723,13 +730,13 @@ module Aws::CloudTrail
723
730
  #
724
731
  # Examples:
725
732
  #
726
- # * alias/MyAliasName
733
+ # * `alias/MyAliasName`
727
734
  #
728
- # * arn:aws:kms:us-east-2:123456789012:alias/MyAliasName
735
+ # * `arn:aws:kms:us-east-2:123456789012:alias/MyAliasName`
729
736
  #
730
- # * arn:aws:kms:us-east-2:123456789012:key/12345678-1234-1234-1234-123456789012
737
+ # * `arn:aws:kms:us-east-2:123456789012:key/12345678-1234-1234-1234-123456789012`
731
738
  #
732
- # * 12345678-1234-1234-1234-123456789012
739
+ # * `12345678-1234-1234-1234-123456789012`
733
740
  #
734
741
  #
735
742
  #
@@ -832,7 +839,7 @@ module Aws::CloudTrail
832
839
  # @return [String]
833
840
  #
834
841
  # @!attribute [rw] kms_key_id
835
- # Specifies the KMS key ID that encrypts the logs delivered by
842
+ # Specifies the KMS key ID that encrypts the events delivered by
836
843
  # CloudTrail. The value is a fully specified ARN to a KMS key in the
837
844
  # following format.
838
845
  #
@@ -938,7 +945,7 @@ module Aws::CloudTrail
938
945
  #
939
946
  # * `AWS::DynamoDB::Table`
940
947
  #
941
- # The following resource types are also availble through *advanced*
948
+ # The following resource types are also available through *advanced*
942
949
  # event selectors. Basic event selector resource types are valid in
943
950
  # advanced event selectors, but advanced event selector resource types
944
951
  # are not valid in basic event selectors. For more information, see
@@ -964,8 +971,7 @@ module Aws::CloudTrail
964
971
  # strings for the specified objects.
965
972
  #
966
973
  # * To log data events for all objects in all S3 buckets in your
967
- # Amazon Web Services account, specify the prefix as
968
- # `arn:aws:s3:::`.
974
+ # Amazon Web Services account, specify the prefix as `arn:aws:s3`.
969
975
  #
970
976
  # <note markdown="1"> This also enables logging of data event activity performed by any
971
977
  # user or role in your Amazon Web Services account, even if that
@@ -1123,6 +1129,15 @@ module Aws::CloudTrail
1123
1129
  # The error message returned if a query failed.
1124
1130
  # @return [String]
1125
1131
  #
1132
+ # @!attribute [rw] delivery_s3_uri
1133
+ # The URI for the S3 bucket where CloudTrail delivered query results,
1134
+ # if applicable.
1135
+ # @return [String]
1136
+ #
1137
+ # @!attribute [rw] delivery_status
1138
+ # The delivery status.
1139
+ # @return [String]
1140
+ #
1126
1141
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/DescribeQueryResponse AWS API Documentation
1127
1142
  #
1128
1143
  class DescribeQueryResponse < Struct.new(
@@ -1130,7 +1145,9 @@ module Aws::CloudTrail
1130
1145
  :query_string,
1131
1146
  :query_status,
1132
1147
  :query_statistics,
1133
- :error_message)
1148
+ :error_message,
1149
+ :delivery_s3_uri,
1150
+ :delivery_status)
1134
1151
  SENSITIVE = []
1135
1152
  include Aws::Structure
1136
1153
  end
@@ -1212,13 +1229,13 @@ module Aws::CloudTrail
1212
1229
  # events.
1213
1230
  #
1214
1231
  # @!attribute [rw] type
1215
- # The type of service. For service-linked channels, the value is
1216
- # `AWS_SERVICE`.
1232
+ # The type of destination for events arriving from a channel. For
1233
+ # service-linked channels, the value is `AWS_SERVICE`.
1217
1234
  # @return [String]
1218
1235
  #
1219
1236
  # @!attribute [rw] location
1220
- # The location of the service. For service-linked channels, this is
1221
- # the name of the Amazon Web Services service.
1237
+ # For service-linked channels, the value is the name of the Amazon Web
1238
+ # Services service.
1222
1239
  # @return [String]
1223
1240
  #
1224
1241
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/Destination AWS API Documentation
@@ -1378,6 +1395,13 @@ module Aws::CloudTrail
1378
1395
  #
1379
1396
  class EventDataStoreAlreadyExistsException < Aws::EmptyStructure; end
1380
1397
 
1398
+ # This exception is thrown when you try to update or delete an event
1399
+ # data store that currently has an import in progress.
1400
+ #
1401
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/EventDataStoreHasOngoingImportException AWS API Documentation
1402
+ #
1403
+ class EventDataStoreHasOngoingImportException < Aws::EmptyStructure; end
1404
+
1381
1405
  # Your account has used the maximum number of event data stores.
1382
1406
  #
1383
1407
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/EventDataStoreMaxLimitExceededException AWS API Documentation
@@ -1451,7 +1475,7 @@ module Aws::CloudTrail
1451
1475
  #
1452
1476
  #
1453
1477
  #
1454
- # [1]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-management-and-data-events-with-cloudtrail.html#logging-management-events
1478
+ # [1]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-management-events-with-cloudtrail.html
1455
1479
  # [2]: http://aws.amazon.com/cloudtrail/pricing/
1456
1480
  # @return [Boolean]
1457
1481
  #
@@ -1468,7 +1492,7 @@ module Aws::CloudTrail
1468
1492
  #
1469
1493
  #
1470
1494
  #
1471
- # [1]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-management-and-data-events-with-cloudtrail.html#logging-data-events
1495
+ # [1]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-data-events-with-cloudtrail.html
1472
1496
  # [2]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/WhatIsCloudTrail-Limits.html
1473
1497
  # @return [Array<Types::DataResource>]
1474
1498
  #
@@ -1502,8 +1526,7 @@ module Aws::CloudTrail
1502
1526
  # }
1503
1527
  #
1504
1528
  # @!attribute [rw] channel
1505
- # The Amazon Resource Name (ARN) of the CloudTrail service-linked
1506
- # channel.
1529
+ # The ARN or `UUID` of a channel.
1507
1530
  # @return [String]
1508
1531
  #
1509
1532
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/GetChannelRequest AWS API Documentation
@@ -1515,32 +1538,30 @@ module Aws::CloudTrail
1515
1538
  end
1516
1539
 
1517
1540
  # @!attribute [rw] channel_arn
1518
- # The ARN of the CloudTrail service-linked channel.
1541
+ # The ARN of an channel returned by a `GetChannel` request.
1519
1542
  # @return [String]
1520
1543
  #
1521
1544
  # @!attribute [rw] name
1522
- # The name of the CloudTrail service-linked channel. For
1523
- # service-linked channels, the value is
1524
- # `aws-service-channel/service-name/custom-suffix` where
1545
+ # The name of the CloudTrail channel. For service-linked channels, the
1546
+ # value is `aws-service-channel/service-name/custom-suffix` where
1525
1547
  # `service-name` represents the name of the Amazon Web Services
1526
1548
  # service that created the channel and `custom-suffix` represents the
1527
1549
  # suffix generated by the Amazon Web Services service.
1528
1550
  # @return [String]
1529
1551
  #
1530
1552
  # @!attribute [rw] source
1531
- # The trail or event data store for the CloudTrail service-linked
1532
- # channel.
1553
+ # The event source for the CloudTrail channel.
1533
1554
  # @return [String]
1534
1555
  #
1535
1556
  # @!attribute [rw] source_config
1536
1557
  # Provides information about the advanced event selectors configured
1537
- # for the service-linked channel, and whether the service-linked
1538
- # channel applies to all regions or one region.
1558
+ # for the channel, and whether the channel applies to all regions or a
1559
+ # single region.
1539
1560
  # @return [Types::SourceConfig]
1540
1561
  #
1541
1562
  # @!attribute [rw] destinations
1542
- # The Amazon Web Services service that created the CloudTrail
1543
- # service-linked channel.
1563
+ # The Amazon Web Services service that created the service-linked
1564
+ # channel.
1544
1565
  # @return [Array<Types::Destination>]
1545
1566
  #
1546
1567
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/GetChannelResponse AWS API Documentation
@@ -1696,6 +1717,85 @@ module Aws::CloudTrail
1696
1717
  include Aws::Structure
1697
1718
  end
1698
1719
 
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
+ # @!attribute [rw] import_id
1728
+ # The ID for the import.
1729
+ # @return [String]
1730
+ #
1731
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/GetImportRequest AWS API Documentation
1732
+ #
1733
+ class GetImportRequest < Struct.new(
1734
+ :import_id)
1735
+ SENSITIVE = []
1736
+ include Aws::Structure
1737
+ end
1738
+
1739
+ # @!attribute [rw] import_id
1740
+ # The ID of the import.
1741
+ # @return [String]
1742
+ #
1743
+ # @!attribute [rw] destinations
1744
+ # The ARN of the destination event data store.
1745
+ # @return [Array<String>]
1746
+ #
1747
+ # @!attribute [rw] import_source
1748
+ # The source S3 bucket.
1749
+ # @return [Types::ImportSource]
1750
+ #
1751
+ # @!attribute [rw] start_event_time
1752
+ # Used with `EndEventTime` to bound a `StartImport` request, and limit
1753
+ # imported trail events to only those events logged within a specified
1754
+ # time period.
1755
+ # @return [Time]
1756
+ #
1757
+ # @!attribute [rw] end_event_time
1758
+ # Used with `StartEventTime` to bound a `StartImport` request, and
1759
+ # limit imported trail events to only those events logged within a
1760
+ # specified time period.
1761
+ # @return [Time]
1762
+ #
1763
+ # @!attribute [rw] import_status
1764
+ # The status of the import.
1765
+ # @return [String]
1766
+ #
1767
+ # @!attribute [rw] created_timestamp
1768
+ # The timestamp of the import's creation.
1769
+ # @return [Time]
1770
+ #
1771
+ # @!attribute [rw] updated_timestamp
1772
+ # The timestamp of when the import was updated.
1773
+ # @return [Time]
1774
+ #
1775
+ # @!attribute [rw] import_statistics
1776
+ # Provides statistics for the import. CloudTrail does not update
1777
+ # import statistics in real-time. Returned values for parameters such
1778
+ # as `EventsCompleted` may be lower than the actual value, because
1779
+ # CloudTrail updates statistics incrementally over the course of the
1780
+ # import.
1781
+ # @return [Types::ImportStatistics]
1782
+ #
1783
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/GetImportResponse AWS API Documentation
1784
+ #
1785
+ class GetImportResponse < Struct.new(
1786
+ :import_id,
1787
+ :destinations,
1788
+ :import_source,
1789
+ :start_event_time,
1790
+ :end_event_time,
1791
+ :import_status,
1792
+ :created_timestamp,
1793
+ :updated_timestamp,
1794
+ :import_statistics)
1795
+ SENSITIVE = []
1796
+ include Aws::Structure
1797
+ end
1798
+
1699
1799
  # @note When making an API call, you may pass GetInsightSelectorsRequest
1700
1800
  # data as a hash:
1701
1801
  #
@@ -2021,6 +2121,144 @@ module Aws::CloudTrail
2021
2121
  include Aws::Structure
2022
2122
  end
2023
2123
 
2124
+ # Provides information about an import failure.
2125
+ #
2126
+ # @!attribute [rw] location
2127
+ # The location of the failure in the S3 bucket.
2128
+ # @return [String]
2129
+ #
2130
+ # @!attribute [rw] status
2131
+ # The status of the import.
2132
+ # @return [String]
2133
+ #
2134
+ # @!attribute [rw] error_type
2135
+ # The type of import error.
2136
+ # @return [String]
2137
+ #
2138
+ # @!attribute [rw] error_message
2139
+ # Provides the reason the import failed.
2140
+ # @return [String]
2141
+ #
2142
+ # @!attribute [rw] last_updated_time
2143
+ # When the import was last updated.
2144
+ # @return [Time]
2145
+ #
2146
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/ImportFailureListItem AWS API Documentation
2147
+ #
2148
+ class ImportFailureListItem < Struct.new(
2149
+ :location,
2150
+ :status,
2151
+ :error_type,
2152
+ :error_message,
2153
+ :last_updated_time)
2154
+ SENSITIVE = []
2155
+ include Aws::Structure
2156
+ end
2157
+
2158
+ # The specified import was not found.
2159
+ #
2160
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/ImportNotFoundException AWS API Documentation
2161
+ #
2162
+ class ImportNotFoundException < Aws::EmptyStructure; end
2163
+
2164
+ # The import source.
2165
+ #
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
+ # @!attribute [rw] s3
2178
+ # The source S3 bucket.
2179
+ # @return [Types::S3ImportSource]
2180
+ #
2181
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/ImportSource AWS API Documentation
2182
+ #
2183
+ class ImportSource < Struct.new(
2184
+ :s3)
2185
+ SENSITIVE = []
2186
+ include Aws::Structure
2187
+ end
2188
+
2189
+ # Provides statistics for the specified `ImportID`. CloudTrail does not
2190
+ # update import statistics in real-time. Returned values for parameters
2191
+ # such as `EventsCompleted` may be lower than the actual value, because
2192
+ # CloudTrail updates statistics incrementally over the course of the
2193
+ # import.
2194
+ #
2195
+ # @!attribute [rw] prefixes_found
2196
+ # The number of S3 prefixes found for the import.
2197
+ # @return [Integer]
2198
+ #
2199
+ # @!attribute [rw] prefixes_completed
2200
+ # The number of S3 prefixes that completed import.
2201
+ # @return [Integer]
2202
+ #
2203
+ # @!attribute [rw] files_completed
2204
+ # The number of log files that completed import.
2205
+ # @return [Integer]
2206
+ #
2207
+ # @!attribute [rw] events_completed
2208
+ # The number of trail events imported into the event data store.
2209
+ # @return [Integer]
2210
+ #
2211
+ # @!attribute [rw] failed_entries
2212
+ # The number of failed entries.
2213
+ # @return [Integer]
2214
+ #
2215
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/ImportStatistics AWS API Documentation
2216
+ #
2217
+ class ImportStatistics < Struct.new(
2218
+ :prefixes_found,
2219
+ :prefixes_completed,
2220
+ :files_completed,
2221
+ :events_completed,
2222
+ :failed_entries)
2223
+ SENSITIVE = []
2224
+ include Aws::Structure
2225
+ end
2226
+
2227
+ # Contains information about an import that was returned by a lookup
2228
+ # request.
2229
+ #
2230
+ # @!attribute [rw] import_id
2231
+ # The ID of the import.
2232
+ # @return [String]
2233
+ #
2234
+ # @!attribute [rw] import_status
2235
+ # The status of the import.
2236
+ # @return [String]
2237
+ #
2238
+ # @!attribute [rw] destinations
2239
+ # The ARN of the destination event data store.
2240
+ # @return [Array<String>]
2241
+ #
2242
+ # @!attribute [rw] created_timestamp
2243
+ # The timestamp of the import's creation.
2244
+ # @return [Time]
2245
+ #
2246
+ # @!attribute [rw] updated_timestamp
2247
+ # The timestamp of the import's last update.
2248
+ # @return [Time]
2249
+ #
2250
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/ImportsListItem AWS API Documentation
2251
+ #
2252
+ class ImportsListItem < Struct.new(
2253
+ :import_id,
2254
+ :import_status,
2255
+ :destinations,
2256
+ :created_timestamp,
2257
+ :updated_timestamp)
2258
+ SENSITIVE = []
2259
+ include Aws::Structure
2260
+ end
2261
+
2024
2262
  # The event data store is inactive.
2025
2263
  #
2026
2264
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/InactiveEventDataStoreException AWS API Documentation
@@ -2075,7 +2313,7 @@ module Aws::CloudTrail
2075
2313
  class InsufficientDependencyServiceAccessPermissionException < Aws::EmptyStructure; end
2076
2314
 
2077
2315
  # This exception is thrown when the policy on the S3 bucket or KMS key
2078
- # is not sufficient.
2316
+ # does not have sufficient permissions for the operation.
2079
2317
  #
2080
2318
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/InsufficientEncryptionPolicyException AWS API Documentation
2081
2319
  #
@@ -2128,6 +2366,13 @@ module Aws::CloudTrail
2128
2366
  #
2129
2367
  class InvalidEventCategoryException < Aws::EmptyStructure; end
2130
2368
 
2369
+ # This exception is thrown when event categories of specified event data
2370
+ # stores are not valid.
2371
+ #
2372
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/InvalidEventDataStoreCategoryException AWS API Documentation
2373
+ #
2374
+ class InvalidEventDataStoreCategoryException < Aws::EmptyStructure; end
2375
+
2131
2376
  # The event data store is not in a status that supports the operation.
2132
2377
  #
2133
2378
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/InvalidEventDataStoreStatusException AWS API Documentation
@@ -2171,6 +2416,13 @@ module Aws::CloudTrail
2171
2416
  #
2172
2417
  class InvalidHomeRegionException < Aws::EmptyStructure; end
2173
2418
 
2419
+ # This exception is thrown when the provided source S3 bucket is not
2420
+ # valid for import.
2421
+ #
2422
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/InvalidImportSourceException AWS API Documentation
2423
+ #
2424
+ class InvalidImportSourceException < Aws::EmptyStructure; end
2425
+
2174
2426
  # The formatting or syntax of the `InsightSelectors` JSON statement in
2175
2427
  # your `PutInsightSelectors` or `GetInsightSelectors` request is not
2176
2428
  # valid, or the specified insight type in the `InsightSelectors`
@@ -2334,7 +2586,12 @@ module Aws::CloudTrail
2334
2586
  # @return [Integer]
2335
2587
  #
2336
2588
  # @!attribute [rw] next_token
2337
- # A token you can use to get the next page of results.
2589
+ # The token to use to get the next page of results after a previous
2590
+ # API call. This token must be passed in with the same parameters that
2591
+ # were specified in the original call. For example, if the original
2592
+ # call specified an AttributeKey of 'Username' with a value of
2593
+ # 'root', the call with NextToken should include those same
2594
+ # parameters.
2338
2595
  # @return [String]
2339
2596
  #
2340
2597
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/ListChannelsRequest AWS API Documentation
@@ -2347,11 +2604,12 @@ module Aws::CloudTrail
2347
2604
  end
2348
2605
 
2349
2606
  # @!attribute [rw] channels
2350
- # The list of CloudTrail channels.
2607
+ # The list of channels in the account.
2351
2608
  # @return [Array<Types::Channel>]
2352
2609
  #
2353
2610
  # @!attribute [rw] next_token
2354
- # A token used to get the next page of results.
2611
+ # The token to use to get the next page of results after a previous
2612
+ # API call.
2355
2613
  # @return [String]
2356
2614
  #
2357
2615
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/ListChannelsResponse AWS API Documentation
@@ -2407,6 +2665,108 @@ module Aws::CloudTrail
2407
2665
  include Aws::Structure
2408
2666
  end
2409
2667
 
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
+ # @!attribute [rw] import_id
2678
+ # The ID of the import.
2679
+ # @return [String]
2680
+ #
2681
+ # @!attribute [rw] max_results
2682
+ # The maximum number of failures to display on a single page.
2683
+ # @return [Integer]
2684
+ #
2685
+ # @!attribute [rw] next_token
2686
+ # A token you can use to get the next page of import failures.
2687
+ # @return [String]
2688
+ #
2689
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/ListImportFailuresRequest AWS API Documentation
2690
+ #
2691
+ class ListImportFailuresRequest < Struct.new(
2692
+ :import_id,
2693
+ :max_results,
2694
+ :next_token)
2695
+ SENSITIVE = []
2696
+ include Aws::Structure
2697
+ end
2698
+
2699
+ # @!attribute [rw] failures
2700
+ # Contains information about the import failures.
2701
+ # @return [Array<Types::ImportFailureListItem>]
2702
+ #
2703
+ # @!attribute [rw] next_token
2704
+ # A token you can use to get the next page of results.
2705
+ # @return [String]
2706
+ #
2707
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/ListImportFailuresResponse AWS API Documentation
2708
+ #
2709
+ class ListImportFailuresResponse < Struct.new(
2710
+ :failures,
2711
+ :next_token)
2712
+ SENSITIVE = []
2713
+ include Aws::Structure
2714
+ end
2715
+
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
+ # @!attribute [rw] max_results
2727
+ # The maximum number of imports to display on a single page.
2728
+ # @return [Integer]
2729
+ #
2730
+ # @!attribute [rw] destination
2731
+ # The ARN of the destination event data store.
2732
+ # @return [String]
2733
+ #
2734
+ # @!attribute [rw] import_status
2735
+ # The status of the import.
2736
+ # @return [String]
2737
+ #
2738
+ # @!attribute [rw] next_token
2739
+ # A token you can use to get the next page of import results.
2740
+ # @return [String]
2741
+ #
2742
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/ListImportsRequest AWS API Documentation
2743
+ #
2744
+ class ListImportsRequest < Struct.new(
2745
+ :max_results,
2746
+ :destination,
2747
+ :import_status,
2748
+ :next_token)
2749
+ SENSITIVE = []
2750
+ include Aws::Structure
2751
+ end
2752
+
2753
+ # @!attribute [rw] imports
2754
+ # The list of returned imports.
2755
+ # @return [Array<Types::ImportsListItem>]
2756
+ #
2757
+ # @!attribute [rw] next_token
2758
+ # A token you can use to get the next page of import results.
2759
+ # @return [String]
2760
+ #
2761
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/ListImportsResponse AWS API Documentation
2762
+ #
2763
+ class ListImportsResponse < Struct.new(
2764
+ :imports,
2765
+ :next_token)
2766
+ SENSITIVE = []
2767
+ include Aws::Structure
2768
+ end
2769
+
2410
2770
  # Requests the public keys for a specified time range.
2411
2771
  #
2412
2772
  # @note When making an API call, you may pass ListPublicKeysRequest
@@ -3303,16 +3663,48 @@ module Aws::CloudTrail
3303
3663
  #
3304
3664
  class S3BucketDoesNotExistException < Aws::EmptyStructure; end
3305
3665
 
3306
- # Contains configuration information about the service-linked channel.
3666
+ # The settings for the source S3 bucket.
3667
+ #
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
+ # @!attribute [rw] s3_location_uri
3678
+ # The URI for the source S3 bucket.
3679
+ # @return [String]
3680
+ #
3681
+ # @!attribute [rw] s3_bucket_region
3682
+ # The region associated with the source S3 bucket.
3683
+ # @return [String]
3684
+ #
3685
+ # @!attribute [rw] s3_bucket_access_role_arn
3686
+ # The IAM ARN role used to access the source S3 bucket.
3687
+ # @return [String]
3688
+ #
3689
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/S3ImportSource AWS API Documentation
3690
+ #
3691
+ class S3ImportSource < Struct.new(
3692
+ :s3_location_uri,
3693
+ :s3_bucket_region,
3694
+ :s3_bucket_access_role_arn)
3695
+ SENSITIVE = []
3696
+ include Aws::Structure
3697
+ end
3698
+
3699
+ # Contains configuration information about the channel.
3307
3700
  #
3308
3701
  # @!attribute [rw] apply_to_all_regions
3309
- # Specifies whether the service-linked channel applies to one region
3310
- # or all regions.
3702
+ # Specifies whether the channel applies to a single region or to all
3703
+ # regions.
3311
3704
  # @return [Boolean]
3312
3705
  #
3313
3706
  # @!attribute [rw] advanced_event_selectors
3314
- # The advanced event selectors configured for the service-linked
3315
- # channel.
3707
+ # The advanced event selectors that are configured for the channel.
3316
3708
  # @return [Array<Types::AdvancedEventSelector>]
3317
3709
  #
3318
3710
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/SourceConfig AWS API Documentation
@@ -3324,6 +3716,121 @@ module Aws::CloudTrail
3324
3716
  include Aws::Structure
3325
3717
  end
3326
3718
 
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
+ # @!attribute [rw] destinations
3737
+ # The ARN of the destination event data store. Use this parameter for
3738
+ # a new import.
3739
+ # @return [Array<String>]
3740
+ #
3741
+ # @!attribute [rw] import_source
3742
+ # The source S3 bucket for the import. Use this parameter for a new
3743
+ # import.
3744
+ # @return [Types::ImportSource]
3745
+ #
3746
+ # @!attribute [rw] start_event_time
3747
+ # Use with `EndEventTime` to bound a `StartImport` request, and limit
3748
+ # imported trail events to only those events logged within a specified
3749
+ # time period. When you specify a time range, CloudTrail checks the
3750
+ # prefix and log file names to verify the names contain a date between
3751
+ # the specified `StartEventTime` and `EndEventTime` before attempting
3752
+ # to import events.
3753
+ # @return [Time]
3754
+ #
3755
+ # @!attribute [rw] end_event_time
3756
+ # Use with `StartEventTime` to bound a `StartImport` request, and
3757
+ # limit imported trail events to only those events logged within a
3758
+ # specified time period. When you specify a time range, CloudTrail
3759
+ # checks the prefix and log file names to verify the names contain a
3760
+ # date between the specified `StartEventTime` and `EndEventTime`
3761
+ # before attempting to import events.
3762
+ # @return [Time]
3763
+ #
3764
+ # @!attribute [rw] import_id
3765
+ # The ID of the import. Use this parameter when you are retrying an
3766
+ # import.
3767
+ # @return [String]
3768
+ #
3769
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/StartImportRequest AWS API Documentation
3770
+ #
3771
+ class StartImportRequest < Struct.new(
3772
+ :destinations,
3773
+ :import_source,
3774
+ :start_event_time,
3775
+ :end_event_time,
3776
+ :import_id)
3777
+ SENSITIVE = []
3778
+ include Aws::Structure
3779
+ end
3780
+
3781
+ # @!attribute [rw] import_id
3782
+ # The ID of the import.
3783
+ # @return [String]
3784
+ #
3785
+ # @!attribute [rw] destinations
3786
+ # The ARN of the destination event data store.
3787
+ # @return [Array<String>]
3788
+ #
3789
+ # @!attribute [rw] import_source
3790
+ # The source S3 bucket for the import.
3791
+ # @return [Types::ImportSource]
3792
+ #
3793
+ # @!attribute [rw] start_event_time
3794
+ # Used with `EndEventTime` to bound a `StartImport` request, and limit
3795
+ # imported trail events to only those events logged within a specified
3796
+ # time period.
3797
+ # @return [Time]
3798
+ #
3799
+ # @!attribute [rw] end_event_time
3800
+ # Used with `StartEventTime` to bound a `StartImport` request, and
3801
+ # limit imported trail events to only those events logged within a
3802
+ # specified time period.
3803
+ # @return [Time]
3804
+ #
3805
+ # @!attribute [rw] import_status
3806
+ # Shows the status of the import after a `StartImport` request. An
3807
+ # import finishes with a status of `COMPLETED` if there were no
3808
+ # failures, or `FAILED` if there were failures.
3809
+ # @return [String]
3810
+ #
3811
+ # @!attribute [rw] created_timestamp
3812
+ # The timestamp for the import's creation.
3813
+ # @return [Time]
3814
+ #
3815
+ # @!attribute [rw] updated_timestamp
3816
+ # The timestamp of the import's last update, if applicable.
3817
+ # @return [Time]
3818
+ #
3819
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/StartImportResponse AWS API Documentation
3820
+ #
3821
+ class StartImportResponse < Struct.new(
3822
+ :import_id,
3823
+ :destinations,
3824
+ :import_source,
3825
+ :start_event_time,
3826
+ :end_event_time,
3827
+ :import_status,
3828
+ :created_timestamp,
3829
+ :updated_timestamp)
3830
+ SENSITIVE = []
3831
+ include Aws::Structure
3832
+ end
3833
+
3327
3834
  # The request to CloudTrail to start logging Amazon Web Services API
3328
3835
  # calls for an account.
3329
3836
  #
@@ -3362,16 +3869,23 @@ module Aws::CloudTrail
3362
3869
  #
3363
3870
  # {
3364
3871
  # query_statement: "QueryStatement", # required
3872
+ # delivery_s3_uri: "DeliveryS3Uri",
3365
3873
  # }
3366
3874
  #
3367
3875
  # @!attribute [rw] query_statement
3368
3876
  # The SQL code of your query.
3369
3877
  # @return [String]
3370
3878
  #
3879
+ # @!attribute [rw] delivery_s3_uri
3880
+ # The URI for the S3 bucket where CloudTrail delivers the query
3881
+ # results.
3882
+ # @return [String]
3883
+ #
3371
3884
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/StartQueryRequest AWS API Documentation
3372
3885
  #
3373
3886
  class StartQueryRequest < Struct.new(
3374
- :query_statement)
3887
+ :query_statement,
3888
+ :delivery_s3_uri)
3375
3889
  SENSITIVE = []
3376
3890
  include Aws::Structure
3377
3891
  end
@@ -3388,6 +3902,81 @@ module Aws::CloudTrail
3388
3902
  include Aws::Structure
3389
3903
  end
3390
3904
 
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
+ # @!attribute [rw] import_id
3913
+ # The ID of the import.
3914
+ # @return [String]
3915
+ #
3916
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/StopImportRequest AWS API Documentation
3917
+ #
3918
+ class StopImportRequest < Struct.new(
3919
+ :import_id)
3920
+ SENSITIVE = []
3921
+ include Aws::Structure
3922
+ end
3923
+
3924
+ # @!attribute [rw] import_id
3925
+ # The ID for the import.
3926
+ # @return [String]
3927
+ #
3928
+ # @!attribute [rw] import_source
3929
+ # The source S3 bucket for the import.
3930
+ # @return [Types::ImportSource]
3931
+ #
3932
+ # @!attribute [rw] destinations
3933
+ # The ARN of the destination event data store.
3934
+ # @return [Array<String>]
3935
+ #
3936
+ # @!attribute [rw] import_status
3937
+ # The status of the import.
3938
+ # @return [String]
3939
+ #
3940
+ # @!attribute [rw] created_timestamp
3941
+ # The timestamp of the import's creation.
3942
+ # @return [Time]
3943
+ #
3944
+ # @!attribute [rw] updated_timestamp
3945
+ # The timestamp of the import's last update.
3946
+ # @return [Time]
3947
+ #
3948
+ # @!attribute [rw] start_event_time
3949
+ # Used with `EndEventTime` to bound a `StartImport` request, and limit
3950
+ # imported trail events to only those events logged within a specified
3951
+ # time period.
3952
+ # @return [Time]
3953
+ #
3954
+ # @!attribute [rw] end_event_time
3955
+ # Used with `StartEventTime` to bound a `StartImport` request, and
3956
+ # limit imported trail events to only those events logged within a
3957
+ # specified time period.
3958
+ # @return [Time]
3959
+ #
3960
+ # @!attribute [rw] import_statistics
3961
+ # Returns information on the stopped import.
3962
+ # @return [Types::ImportStatistics]
3963
+ #
3964
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/StopImportResponse AWS API Documentation
3965
+ #
3966
+ class StopImportResponse < Struct.new(
3967
+ :import_id,
3968
+ :import_source,
3969
+ :destinations,
3970
+ :import_status,
3971
+ :created_timestamp,
3972
+ :updated_timestamp,
3973
+ :start_event_time,
3974
+ :end_event_time,
3975
+ :import_statistics)
3976
+ SENSITIVE = []
3977
+ include Aws::Structure
3978
+ end
3979
+
3391
3980
  # Passes the request to CloudTrail to stop logging Amazon Web Services
3392
3981
  # API calls for the specified account.
3393
3982
  #
@@ -3667,7 +4256,8 @@ module Aws::CloudTrail
3667
4256
  #
3668
4257
  # @!attribute [rw] advanced_event_selectors
3669
4258
  # The advanced event selectors used to select events for the event
3670
- # data store.
4259
+ # data store. You can configure up to five advanced event selectors
4260
+ # for each event data store.
3671
4261
  # @return [Array<Types::AdvancedEventSelector>]
3672
4262
  #
3673
4263
  # @!attribute [rw] multi_region_enabled