aws-sdk-cloudtrail 1.50.0 → 1.52.0

Sign up to get free protection for your applications and to get access to all the features.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 92437a7a7cb64e0c36d4094799380ba953562fec2d133de0271299cfd9733f1b
4
- data.tar.gz: a64de41244574754915618a7a79fc003a0c98ba7672fbff44ccdeebeab7a2895
3
+ metadata.gz: 9fd98c848dea62b03bdbe8b53bd0697af08f98035546f4f0fd11bcac9b0916cc
4
+ data.tar.gz: 67792ad77475cb8ee735d3f66a6acc0c9fc7be108c65f7f6dd31c5487c33a2bf
5
5
  SHA512:
6
- metadata.gz: 3abd5b513985fe3c06e1497f965fbaa318686a627f5870f742204378909b24361c4a465308770a61530b10eebd6334b2238748ae3e5c606a3edc1d70651bff41
7
- data.tar.gz: 0e89f2c4758a430eb4bdca0bc7d1a855bef3da80911cdb36f43686ebe570d2264d03da11d9f286f4cfeb88bcb629ff9199a5ce713b09ebf58e9ff1df5ee47578
6
+ metadata.gz: 3c8e1be6d40035da296cda86d2ef3f730721adf4c7b36c14b4c427f484183aaff97690116f9763293450b269f76edee57ce1ef6b469449044e4b5f736ce22329
7
+ data.tar.gz: 4660fc6a4bc8580998fc3fe02ea802a6d852d2957e5d70f0758cf4b3011d6122ebce0b2b5146dc5d6b81a48eff645d7d29be2af8246f2209fcb3033d463ddc3f
data/CHANGELOG.md CHANGED
@@ -1,6 +1,16 @@
1
1
  Unreleased Changes
2
2
  ------------------
3
3
 
4
+ 1.52.0 (2022-10-19)
5
+ ------------------
6
+
7
+ * Feature - This release includes support for exporting CloudTrail Lake query results to an Amazon S3 bucket.
8
+
9
+ 1.51.0 (2022-09-19)
10
+ ------------------
11
+
12
+ * Feature - This release includes support for importing existing trails into CloudTrail Lake.
13
+
4
14
  1.50.0 (2022-09-09)
5
15
  ------------------
6
16
 
data/VERSION CHANGED
@@ -1 +1 @@
1
- 1.50.0
1
+ 1.52.0
@@ -644,7 +644,7 @@ module Aws::CloudTrail
644
644
  #
645
645
  # @option params [String] :kms_key_id
646
646
  # Specifies the KMS key ID to use to encrypt the logs delivered by
647
- # CloudTrail. The value can be an alias name prefixed by "alias/", a
647
+ # CloudTrail. The value can be an alias name prefixed by `alias/`, a
648
648
  # fully specified ARN to an alias, a fully specified ARN to a key, or a
649
649
  # globally unique identifier.
650
650
  #
@@ -654,13 +654,13 @@ module Aws::CloudTrail
654
654
  #
655
655
  # Examples:
656
656
  #
657
- # * alias/MyAliasName
657
+ # * `alias/MyAliasName`
658
658
  #
659
- # * arn:aws:kms:us-east-2:123456789012:alias/MyAliasName
659
+ # * `arn:aws:kms:us-east-2:123456789012:alias/MyAliasName`
660
660
  #
661
- # * arn:aws:kms:us-east-2:123456789012:key/12345678-1234-1234-1234-123456789012
661
+ # * `arn:aws:kms:us-east-2:123456789012:key/12345678-1234-1234-1234-123456789012`
662
662
  #
663
- # * 12345678-1234-1234-1234-123456789012
663
+ # * `12345678-1234-1234-1234-123456789012`
664
664
  #
665
665
  #
666
666
  #
@@ -820,6 +820,8 @@ module Aws::CloudTrail
820
820
  # * {Types::DescribeQueryResponse#query_status #query_status} => String
821
821
  # * {Types::DescribeQueryResponse#query_statistics #query_statistics} => Types::QueryStatisticsForDescribeQuery
822
822
  # * {Types::DescribeQueryResponse#error_message #error_message} => String
823
+ # * {Types::DescribeQueryResponse#delivery_s3_uri #delivery_s3_uri} => String
824
+ # * {Types::DescribeQueryResponse#delivery_status #delivery_status} => String
823
825
  #
824
826
  # @example Request syntax with placeholder values
825
827
  #
@@ -839,6 +841,8 @@ module Aws::CloudTrail
839
841
  # resp.query_statistics.execution_time_in_millis #=> Integer
840
842
  # resp.query_statistics.creation_time #=> Time
841
843
  # resp.error_message #=> String
844
+ # resp.delivery_s3_uri #=> String
845
+ # resp.delivery_status #=> String, one of "SUCCESS", "FAILED", "FAILED_SIGNING_FILE", "PENDING", "RESOURCE_NOT_FOUND", "ACCESS_DENIED", "ACCESS_DENIED_SIGNING_FILE", "CANCELLED", "UNKNOWN"
842
846
  #
843
847
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/DescribeQuery AWS API Documentation
844
848
  #
@@ -923,13 +927,18 @@ module Aws::CloudTrail
923
927
  req.send_request(options)
924
928
  end
925
929
 
926
- # Returns the specified CloudTrail service-linked channel. Amazon Web
927
- # Services services create service-linked channels to view CloudTrail
928
- # events.
930
+ # Returns information about a specific channel. Amazon Web Services
931
+ # services create service-linked channels to get information about
932
+ # CloudTrail events on your behalf. For more information about
933
+ # service-linked channels, see [Viewing service-linked channels for
934
+ # CloudTrail by using the CLI.][1].
935
+ #
936
+ #
937
+ #
938
+ # [1]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/viewing-service-linked-channels.html
929
939
  #
930
940
  # @option params [required, String] :channel
931
- # The Amazon Resource Name (ARN) of the CloudTrail service-linked
932
- # channel.
941
+ # The ARN or `UUID` of a channel.
933
942
  #
934
943
  # @return [Types::GetChannelResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
935
944
  #
@@ -1056,12 +1065,17 @@ module Aws::CloudTrail
1056
1065
  # * If your event selector includes data events, the resources on which
1057
1066
  # you are logging data events.
1058
1067
  #
1059
- # For more information, see [Logging Data and Management Events for
1060
- # Trails ][1] in the *CloudTrail User Guide*.
1068
+ # For more information about logging management and data events, see the
1069
+ # following topics in the *CloudTrail User Guide*\:
1070
+ #
1071
+ # * [Logging management events for trails ][1]
1061
1072
  #
1073
+ # * [Logging data events for trails ][2]
1062
1074
  #
1063
1075
  #
1064
- # [1]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-management-and-data-events-with-cloudtrail.html
1076
+ #
1077
+ # [1]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-management-events-with-cloudtrail.html
1078
+ # [2]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-data-events-with-cloudtrail.html
1065
1079
  #
1066
1080
  # @option params [required, String] :trail_name
1067
1081
  # Specifies the name of the trail or trail ARN. If you specify a trail
@@ -1133,6 +1147,57 @@ module Aws::CloudTrail
1133
1147
  req.send_request(options)
1134
1148
  end
1135
1149
 
1150
+ # Returns information about a specific import.
1151
+ #
1152
+ # @option params [required, String] :import_id
1153
+ # The ID for the import.
1154
+ #
1155
+ # @return [Types::GetImportResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1156
+ #
1157
+ # * {Types::GetImportResponse#import_id #import_id} => String
1158
+ # * {Types::GetImportResponse#destinations #destinations} => Array<String>
1159
+ # * {Types::GetImportResponse#import_source #import_source} => Types::ImportSource
1160
+ # * {Types::GetImportResponse#start_event_time #start_event_time} => Time
1161
+ # * {Types::GetImportResponse#end_event_time #end_event_time} => Time
1162
+ # * {Types::GetImportResponse#import_status #import_status} => String
1163
+ # * {Types::GetImportResponse#created_timestamp #created_timestamp} => Time
1164
+ # * {Types::GetImportResponse#updated_timestamp #updated_timestamp} => Time
1165
+ # * {Types::GetImportResponse#import_statistics #import_statistics} => Types::ImportStatistics
1166
+ #
1167
+ # @example Request syntax with placeholder values
1168
+ #
1169
+ # resp = client.get_import({
1170
+ # import_id: "UUID", # required
1171
+ # })
1172
+ #
1173
+ # @example Response structure
1174
+ #
1175
+ # resp.import_id #=> String
1176
+ # resp.destinations #=> Array
1177
+ # resp.destinations[0] #=> String
1178
+ # resp.import_source.s3.s3_location_uri #=> String
1179
+ # resp.import_source.s3.s3_bucket_region #=> String
1180
+ # resp.import_source.s3.s3_bucket_access_role_arn #=> String
1181
+ # resp.start_event_time #=> Time
1182
+ # resp.end_event_time #=> Time
1183
+ # resp.import_status #=> String, one of "INITIALIZING", "IN_PROGRESS", "FAILED", "STOPPED", "COMPLETED"
1184
+ # resp.created_timestamp #=> Time
1185
+ # resp.updated_timestamp #=> Time
1186
+ # resp.import_statistics.prefixes_found #=> Integer
1187
+ # resp.import_statistics.prefixes_completed #=> Integer
1188
+ # resp.import_statistics.files_completed #=> Integer
1189
+ # resp.import_statistics.events_completed #=> Integer
1190
+ # resp.import_statistics.failed_entries #=> Integer
1191
+ #
1192
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/GetImport AWS API Documentation
1193
+ #
1194
+ # @overload get_import(params = {})
1195
+ # @param [Hash] params ({})
1196
+ def get_import(params = {}, options = {})
1197
+ req = build_request(:get_import, params)
1198
+ req.send_request(options)
1199
+ end
1200
+
1136
1201
  # Describes the settings for the Insights event selectors that you
1137
1202
  # configured for your trail. `GetInsightSelectors` shows if CloudTrail
1138
1203
  # Insights event logging is enabled on the trail, and if it is, which
@@ -1365,13 +1430,25 @@ module Aws::CloudTrail
1365
1430
  req.send_request(options)
1366
1431
  end
1367
1432
 
1368
- # Returns all CloudTrail channels.
1433
+ # Lists the channels in the current account, and their source names.
1434
+ # Amazon Web Services services create service-linked channels get
1435
+ # information about CloudTrail events on your behalf. For more
1436
+ # information about service-linked channels, see [Viewing service-linked
1437
+ # channels for CloudTrail by using the CLI][1].
1438
+ #
1439
+ #
1440
+ #
1441
+ # [1]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/viewing-service-linked-channels.html
1369
1442
  #
1370
1443
  # @option params [Integer] :max_results
1371
1444
  # The maximum number of CloudTrail channels to display on a single page.
1372
1445
  #
1373
1446
  # @option params [String] :next_token
1374
- # A token you can use to get the next page of results.
1447
+ # The token to use to get the next page of results after a previous API
1448
+ # call. This token must be passed in with the same parameters that were
1449
+ # specified in the original call. For example, if the original call
1450
+ # specified an AttributeKey of 'Username' with a value of 'root',
1451
+ # the call with NextToken should include those same parameters.
1375
1452
  #
1376
1453
  # @return [Types::ListChannelsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1377
1454
  #
@@ -1465,6 +1542,102 @@ module Aws::CloudTrail
1465
1542
  req.send_request(options)
1466
1543
  end
1467
1544
 
1545
+ # Returns a list of failures for the specified import.
1546
+ #
1547
+ # @option params [required, String] :import_id
1548
+ # The ID of the import.
1549
+ #
1550
+ # @option params [Integer] :max_results
1551
+ # The maximum number of failures to display on a single page.
1552
+ #
1553
+ # @option params [String] :next_token
1554
+ # A token you can use to get the next page of import failures.
1555
+ #
1556
+ # @return [Types::ListImportFailuresResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1557
+ #
1558
+ # * {Types::ListImportFailuresResponse#failures #failures} => Array<Types::ImportFailureListItem>
1559
+ # * {Types::ListImportFailuresResponse#next_token #next_token} => String
1560
+ #
1561
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
1562
+ #
1563
+ # @example Request syntax with placeholder values
1564
+ #
1565
+ # resp = client.list_import_failures({
1566
+ # import_id: "UUID", # required
1567
+ # max_results: 1,
1568
+ # next_token: "PaginationToken",
1569
+ # })
1570
+ #
1571
+ # @example Response structure
1572
+ #
1573
+ # resp.failures #=> Array
1574
+ # resp.failures[0].location #=> String
1575
+ # resp.failures[0].status #=> String, one of "FAILED", "RETRY", "SUCCEEDED"
1576
+ # resp.failures[0].error_type #=> String
1577
+ # resp.failures[0].error_message #=> String
1578
+ # resp.failures[0].last_updated_time #=> Time
1579
+ # resp.next_token #=> String
1580
+ #
1581
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/ListImportFailures AWS API Documentation
1582
+ #
1583
+ # @overload list_import_failures(params = {})
1584
+ # @param [Hash] params ({})
1585
+ def list_import_failures(params = {}, options = {})
1586
+ req = build_request(:list_import_failures, params)
1587
+ req.send_request(options)
1588
+ end
1589
+
1590
+ # Returns information on all imports, or a select set of imports by
1591
+ # `ImportStatus` or `Destination`.
1592
+ #
1593
+ # @option params [Integer] :max_results
1594
+ # The maximum number of imports to display on a single page.
1595
+ #
1596
+ # @option params [String] :destination
1597
+ # The ARN of the destination event data store.
1598
+ #
1599
+ # @option params [String] :import_status
1600
+ # The status of the import.
1601
+ #
1602
+ # @option params [String] :next_token
1603
+ # A token you can use to get the next page of import results.
1604
+ #
1605
+ # @return [Types::ListImportsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1606
+ #
1607
+ # * {Types::ListImportsResponse#imports #imports} => Array<Types::ImportsListItem>
1608
+ # * {Types::ListImportsResponse#next_token #next_token} => String
1609
+ #
1610
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
1611
+ #
1612
+ # @example Request syntax with placeholder values
1613
+ #
1614
+ # resp = client.list_imports({
1615
+ # max_results: 1,
1616
+ # destination: "EventDataStoreArn",
1617
+ # import_status: "INITIALIZING", # accepts INITIALIZING, IN_PROGRESS, FAILED, STOPPED, COMPLETED
1618
+ # next_token: "PaginationToken",
1619
+ # })
1620
+ #
1621
+ # @example Response structure
1622
+ #
1623
+ # resp.imports #=> Array
1624
+ # resp.imports[0].import_id #=> String
1625
+ # resp.imports[0].import_status #=> String, one of "INITIALIZING", "IN_PROGRESS", "FAILED", "STOPPED", "COMPLETED"
1626
+ # resp.imports[0].destinations #=> Array
1627
+ # resp.imports[0].destinations[0] #=> String
1628
+ # resp.imports[0].created_timestamp #=> Time
1629
+ # resp.imports[0].updated_timestamp #=> Time
1630
+ # resp.next_token #=> String
1631
+ #
1632
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/ListImports AWS API Documentation
1633
+ #
1634
+ # @overload list_imports(params = {})
1635
+ # @param [Hash] params ({})
1636
+ def list_imports(params = {}, options = {})
1637
+ req = build_request(:list_imports, params)
1638
+ req.send_request(options)
1639
+ end
1640
+
1468
1641
  # Returns all public keys whose private keys were used to sign the
1469
1642
  # digest files within the specified time range. The public key is needed
1470
1643
  # to validate digest files that were signed with its corresponding
@@ -1823,8 +1996,9 @@ module Aws::CloudTrail
1823
1996
  # `InvalidHomeRegionException` exception is thrown.
1824
1997
  #
1825
1998
  # You can configure up to five event selectors for each trail. For more
1826
- # information, see [Logging data and management events for trails ][1]
1827
- # and [Quotas in CloudTrail][2] in the *CloudTrail User Guide*.
1999
+ # information, see [Logging management events for trails ][1], [Logging
2000
+ # data events for trails ][2], and [Quotas in CloudTrail][3] in the
2001
+ # *CloudTrail User Guide*.
1828
2002
  #
1829
2003
  # You can add advanced event selectors, and conditions for your advanced
1830
2004
  # event selectors, up to a maximum of 500 values for all conditions and
@@ -1832,13 +2006,13 @@ module Aws::CloudTrail
1832
2006
  # `EventSelectors`, but not both. If you apply `AdvancedEventSelectors`
1833
2007
  # to a trail, any existing `EventSelectors` are overwritten. For more
1834
2008
  # information about advanced event selectors, see [Logging data events
1835
- # for trails][3] in the *CloudTrail User Guide*.
2009
+ # for trails][2] in the *CloudTrail User Guide*.
1836
2010
  #
1837
2011
  #
1838
2012
  #
1839
- # [1]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-management-and-data-events-with-cloudtrail.html
1840
- # [2]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/WhatIsCloudTrail-Limits.html
1841
- # [3]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-data-events-with-cloudtrail.html
2013
+ # [1]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-management-events-with-cloudtrail.html
2014
+ # [2]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-data-events-with-cloudtrail.html
2015
+ # [3]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/WhatIsCloudTrail-Limits.html
1842
2016
  #
1843
2017
  # @option params [required, String] :trail_name
1844
2018
  # Specifies the name of the trail or trail ARN. If you specify a trail
@@ -2110,6 +2284,106 @@ module Aws::CloudTrail
2110
2284
  req.send_request(options)
2111
2285
  end
2112
2286
 
2287
+ # Starts an import of logged trail events from a source S3 bucket to a
2288
+ # destination event data store. By default, CloudTrail only imports
2289
+ # events contained in the S3 bucket's `CloudTrail` prefix and the
2290
+ # prefixes inside the `CloudTrail` prefix, and does not check prefixes
2291
+ # for other Amazon Web Services services. If you want to import
2292
+ # CloudTrail events contained in another prefix, you must include the
2293
+ # prefix in the `S3LocationUri`. For more considerations about importing
2294
+ # trail events, see [Considerations][1].
2295
+ #
2296
+ # When you start a new import, the `Destinations` and `ImportSource`
2297
+ # parameters are required. Before starting a new import, disable any
2298
+ # access control lists (ACLs) attached to the source S3 bucket. For more
2299
+ # information about disabling ACLs, see [Controlling ownership of
2300
+ # objects and disabling ACLs for your bucket][2].
2301
+ #
2302
+ # When you retry an import, the `ImportID` parameter is required.
2303
+ #
2304
+ #
2305
+ #
2306
+ # [1]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-copy-trail-to-lake.html#cloudtrail-trail-copy-considerations
2307
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/about-object-ownership.html
2308
+ #
2309
+ # @option params [Array<String>] :destinations
2310
+ # The ARN of the destination event data store. Use this parameter for a
2311
+ # new import.
2312
+ #
2313
+ # @option params [Types::ImportSource] :import_source
2314
+ # The source S3 bucket for the import. Use this parameter for a new
2315
+ # import.
2316
+ #
2317
+ # @option params [Time,DateTime,Date,Integer,String] :start_event_time
2318
+ # Use with `EndEventTime` to bound a `StartImport` request, and limit
2319
+ # imported trail events to only those events logged within a specified
2320
+ # time period. When you specify a time range, CloudTrail checks the
2321
+ # prefix and log file names to verify the names contain a date between
2322
+ # the specified `StartEventTime` and `EndEventTime` before attempting to
2323
+ # import events.
2324
+ #
2325
+ # @option params [Time,DateTime,Date,Integer,String] :end_event_time
2326
+ # Use with `StartEventTime` to bound a `StartImport` request, and limit
2327
+ # imported trail events to only those events logged within a specified
2328
+ # time period. When you specify a time range, CloudTrail checks the
2329
+ # prefix and log file names to verify the names contain a date between
2330
+ # the specified `StartEventTime` and `EndEventTime` before attempting to
2331
+ # import events.
2332
+ #
2333
+ # @option params [String] :import_id
2334
+ # The ID of the import. Use this parameter when you are retrying an
2335
+ # import.
2336
+ #
2337
+ # @return [Types::StartImportResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2338
+ #
2339
+ # * {Types::StartImportResponse#import_id #import_id} => String
2340
+ # * {Types::StartImportResponse#destinations #destinations} => Array&lt;String&gt;
2341
+ # * {Types::StartImportResponse#import_source #import_source} => Types::ImportSource
2342
+ # * {Types::StartImportResponse#start_event_time #start_event_time} => Time
2343
+ # * {Types::StartImportResponse#end_event_time #end_event_time} => Time
2344
+ # * {Types::StartImportResponse#import_status #import_status} => String
2345
+ # * {Types::StartImportResponse#created_timestamp #created_timestamp} => Time
2346
+ # * {Types::StartImportResponse#updated_timestamp #updated_timestamp} => Time
2347
+ #
2348
+ # @example Request syntax with placeholder values
2349
+ #
2350
+ # resp = client.start_import({
2351
+ # destinations: ["EventDataStoreArn"],
2352
+ # import_source: {
2353
+ # s3: { # required
2354
+ # s3_location_uri: "String", # required
2355
+ # s3_bucket_region: "String", # required
2356
+ # s3_bucket_access_role_arn: "String", # required
2357
+ # },
2358
+ # },
2359
+ # start_event_time: Time.now,
2360
+ # end_event_time: Time.now,
2361
+ # import_id: "UUID",
2362
+ # })
2363
+ #
2364
+ # @example Response structure
2365
+ #
2366
+ # resp.import_id #=> String
2367
+ # resp.destinations #=> Array
2368
+ # resp.destinations[0] #=> String
2369
+ # resp.import_source.s3.s3_location_uri #=> String
2370
+ # resp.import_source.s3.s3_bucket_region #=> String
2371
+ # resp.import_source.s3.s3_bucket_access_role_arn #=> String
2372
+ # resp.start_event_time #=> Time
2373
+ # resp.end_event_time #=> Time
2374
+ # resp.import_status #=> String, one of "INITIALIZING", "IN_PROGRESS", "FAILED", "STOPPED", "COMPLETED"
2375
+ # resp.created_timestamp #=> Time
2376
+ # resp.updated_timestamp #=> Time
2377
+ #
2378
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/StartImport AWS API Documentation
2379
+ #
2380
+ # @overload start_import(params = {})
2381
+ # @param [Hash] params ({})
2382
+ def start_import(params = {}, options = {})
2383
+ req = build_request(:start_import, params)
2384
+ req.send_request(options)
2385
+ end
2386
+
2113
2387
  # Starts the recording of Amazon Web Services API calls and log file
2114
2388
  # delivery for a trail. For a trail that is enabled in all regions, this
2115
2389
  # operation must be called from the region in which the trail was
@@ -2143,10 +2417,15 @@ module Aws::CloudTrail
2143
2417
 
2144
2418
  # Starts a CloudTrail Lake query. The required `QueryStatement`
2145
2419
  # parameter provides your SQL query, enclosed in single quotation marks.
2420
+ # Use the optional `DeliveryS3Uri` parameter to deliver the query
2421
+ # results to an S3 bucket.
2146
2422
  #
2147
2423
  # @option params [required, String] :query_statement
2148
2424
  # The SQL code of your query.
2149
2425
  #
2426
+ # @option params [String] :delivery_s3_uri
2427
+ # The URI for the S3 bucket where CloudTrail delivers the query results.
2428
+ #
2150
2429
  # @return [Types::StartQueryResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2151
2430
  #
2152
2431
  # * {Types::StartQueryResponse#query_id #query_id} => String
@@ -2155,6 +2434,7 @@ module Aws::CloudTrail
2155
2434
  #
2156
2435
  # resp = client.start_query({
2157
2436
  # query_statement: "QueryStatement", # required
2437
+ # delivery_s3_uri: "DeliveryS3Uri",
2158
2438
  # })
2159
2439
  #
2160
2440
  # @example Response structure
@@ -2170,6 +2450,57 @@ module Aws::CloudTrail
2170
2450
  req.send_request(options)
2171
2451
  end
2172
2452
 
2453
+ # Stops a specified import.
2454
+ #
2455
+ # @option params [required, String] :import_id
2456
+ # The ID of the import.
2457
+ #
2458
+ # @return [Types::StopImportResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2459
+ #
2460
+ # * {Types::StopImportResponse#import_id #import_id} => String
2461
+ # * {Types::StopImportResponse#import_source #import_source} => Types::ImportSource
2462
+ # * {Types::StopImportResponse#destinations #destinations} => Array&lt;String&gt;
2463
+ # * {Types::StopImportResponse#import_status #import_status} => String
2464
+ # * {Types::StopImportResponse#created_timestamp #created_timestamp} => Time
2465
+ # * {Types::StopImportResponse#updated_timestamp #updated_timestamp} => Time
2466
+ # * {Types::StopImportResponse#start_event_time #start_event_time} => Time
2467
+ # * {Types::StopImportResponse#end_event_time #end_event_time} => Time
2468
+ # * {Types::StopImportResponse#import_statistics #import_statistics} => Types::ImportStatistics
2469
+ #
2470
+ # @example Request syntax with placeholder values
2471
+ #
2472
+ # resp = client.stop_import({
2473
+ # import_id: "UUID", # required
2474
+ # })
2475
+ #
2476
+ # @example Response structure
2477
+ #
2478
+ # resp.import_id #=> String
2479
+ # resp.import_source.s3.s3_location_uri #=> String
2480
+ # resp.import_source.s3.s3_bucket_region #=> String
2481
+ # resp.import_source.s3.s3_bucket_access_role_arn #=> String
2482
+ # resp.destinations #=> Array
2483
+ # resp.destinations[0] #=> String
2484
+ # resp.import_status #=> String, one of "INITIALIZING", "IN_PROGRESS", "FAILED", "STOPPED", "COMPLETED"
2485
+ # resp.created_timestamp #=> Time
2486
+ # resp.updated_timestamp #=> Time
2487
+ # resp.start_event_time #=> Time
2488
+ # resp.end_event_time #=> Time
2489
+ # resp.import_statistics.prefixes_found #=> Integer
2490
+ # resp.import_statistics.prefixes_completed #=> Integer
2491
+ # resp.import_statistics.files_completed #=> Integer
2492
+ # resp.import_statistics.events_completed #=> Integer
2493
+ # resp.import_statistics.failed_entries #=> Integer
2494
+ #
2495
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/StopImport AWS API Documentation
2496
+ #
2497
+ # @overload stop_import(params = {})
2498
+ # @param [Hash] params ({})
2499
+ def stop_import(params = {}, options = {})
2500
+ req = build_request(:stop_import, params)
2501
+ req.send_request(options)
2502
+ end
2503
+
2173
2504
  # Suspends the recording of Amazon Web Services API calls and log file
2174
2505
  # delivery for the specified trail. Under most circumstances, there is
2175
2506
  # no need to use this action. You can update a trail without stopping it
@@ -2223,7 +2554,8 @@ module Aws::CloudTrail
2223
2554
  #
2224
2555
  # @option params [Array<Types::AdvancedEventSelector>] :advanced_event_selectors
2225
2556
  # The advanced event selectors used to select events for the event data
2226
- # store.
2557
+ # store. You can configure up to five advanced event selectors for each
2558
+ # event data store.
2227
2559
  #
2228
2560
  # @option params [Boolean] :multi_region_enabled
2229
2561
  # Specifies whether an event data store collects events from all
@@ -2513,7 +2845,7 @@ module Aws::CloudTrail
2513
2845
  params: params,
2514
2846
  config: config)
2515
2847
  context[:gem_name] = 'aws-sdk-cloudtrail'
2516
- context[:gem_version] = '1.50.0'
2848
+ context[:gem_version] = '1.52.0'
2517
2849
  Seahorse::Client::Request.new(handlers, context)
2518
2850
  end
2519
2851