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.
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