aws-sdk-cloudtrail 1.49.0 → 1.51.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: dec5d187176c43abe1b0f9e22af755232ba56d77e6046d484a4941906e768822
4
- data.tar.gz: 031acc2864f6fd5fc8a6378177056166b3d6a13bc591565c69ced8c63513e5c4
3
+ metadata.gz: 0d913bff17768e79888c389935ccc3082f330e732957750fbc50e886567982c6
4
+ data.tar.gz: 691cb628f9e15c1f9b31663796bef4c358ea9590f36cff7e4dcb082c4c6b3c29
5
5
  SHA512:
6
- metadata.gz: 55e951e6f59972a6cf10f73ceebc98d1764dfd9171d5dc84cee5b1b0f3618cb6d0ad6a2ae671357eca2cc30d43a6b282f19a2cef37667153033195a027b63c0e
7
- data.tar.gz: '0853615833aa071d8fce2194c44c1ae0c19f3c7d2e7c92ff79345f66b1b65abc9121ea292eacdd452f555dd2e92084c70d09d75e696d221591d0e43f4e8459d7'
6
+ metadata.gz: f8bceeac781dab3962b59a9b193385094d3bab825a9f9ae2ce7ef015417ac3d4ea3774d9792b730c5b2726193d6c504d9b9c34182c955c77bdb6562f5e2d886b
7
+ data.tar.gz: 16c2d8a4a3a07c860911b7ac83ff706bd42f696ae9641a2328ef7e215dc721a8eaf98d15a718731924a8f97f45f311140675da8c6ac562c094e494e8c44aa3d5
data/CHANGELOG.md CHANGED
@@ -1,6 +1,16 @@
1
1
  Unreleased Changes
2
2
  ------------------
3
3
 
4
+ 1.51.0 (2022-09-19)
5
+ ------------------
6
+
7
+ * Feature - This release includes support for importing existing trails into CloudTrail Lake.
8
+
9
+ 1.50.0 (2022-09-09)
10
+ ------------------
11
+
12
+ * Feature - This release adds CloudTrail getChannel and listChannels APIs to allow customer to view the ServiceLinkedChannel configurations.
13
+
4
14
  1.49.0 (2022-04-27)
5
15
  ------------------
6
16
 
data/VERSION CHANGED
@@ -1 +1 @@
1
- 1.49.0
1
+ 1.51.0
@@ -469,7 +469,7 @@ module Aws::CloudTrail
469
469
  #
470
470
  # @option params [Integer] :retention_period
471
471
  # The retention period of the event data store, in days. You can set a
472
- # retention period of up to 2555 days, the equivalent of seven years.
472
+ # retention period of up to 2557 days, the equivalent of seven years.
473
473
  #
474
474
  # @option params [Boolean] :termination_protection_enabled
475
475
  # Specifies whether termination protection is enabled for the event data
@@ -923,6 +923,63 @@ module Aws::CloudTrail
923
923
  req.send_request(options)
924
924
  end
925
925
 
926
+ # Returns the specified CloudTrail service-linked channel. Amazon Web
927
+ # Services services create service-linked channels to view CloudTrail
928
+ # events.
929
+ #
930
+ # @option params [required, String] :channel
931
+ # The Amazon Resource Name (ARN) of the CloudTrail service-linked
932
+ # channel.
933
+ #
934
+ # @return [Types::GetChannelResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
935
+ #
936
+ # * {Types::GetChannelResponse#channel_arn #channel_arn} => String
937
+ # * {Types::GetChannelResponse#name #name} => String
938
+ # * {Types::GetChannelResponse#source #source} => String
939
+ # * {Types::GetChannelResponse#source_config #source_config} => Types::SourceConfig
940
+ # * {Types::GetChannelResponse#destinations #destinations} => Array<Types::Destination>
941
+ #
942
+ # @example Request syntax with placeholder values
943
+ #
944
+ # resp = client.get_channel({
945
+ # channel: "ChannelArn", # required
946
+ # })
947
+ #
948
+ # @example Response structure
949
+ #
950
+ # resp.channel_arn #=> String
951
+ # resp.name #=> String
952
+ # resp.source #=> String
953
+ # resp.source_config.apply_to_all_regions #=> Boolean
954
+ # resp.source_config.advanced_event_selectors #=> Array
955
+ # resp.source_config.advanced_event_selectors[0].name #=> String
956
+ # resp.source_config.advanced_event_selectors[0].field_selectors #=> Array
957
+ # resp.source_config.advanced_event_selectors[0].field_selectors[0].field #=> String
958
+ # resp.source_config.advanced_event_selectors[0].field_selectors[0].equals #=> Array
959
+ # resp.source_config.advanced_event_selectors[0].field_selectors[0].equals[0] #=> String
960
+ # resp.source_config.advanced_event_selectors[0].field_selectors[0].starts_with #=> Array
961
+ # resp.source_config.advanced_event_selectors[0].field_selectors[0].starts_with[0] #=> String
962
+ # resp.source_config.advanced_event_selectors[0].field_selectors[0].ends_with #=> Array
963
+ # resp.source_config.advanced_event_selectors[0].field_selectors[0].ends_with[0] #=> String
964
+ # resp.source_config.advanced_event_selectors[0].field_selectors[0].not_equals #=> Array
965
+ # resp.source_config.advanced_event_selectors[0].field_selectors[0].not_equals[0] #=> String
966
+ # resp.source_config.advanced_event_selectors[0].field_selectors[0].not_starts_with #=> Array
967
+ # resp.source_config.advanced_event_selectors[0].field_selectors[0].not_starts_with[0] #=> String
968
+ # resp.source_config.advanced_event_selectors[0].field_selectors[0].not_ends_with #=> Array
969
+ # resp.source_config.advanced_event_selectors[0].field_selectors[0].not_ends_with[0] #=> String
970
+ # resp.destinations #=> Array
971
+ # resp.destinations[0].type #=> String, one of "EVENT_DATA_STORE", "AWS_SERVICE"
972
+ # resp.destinations[0].location #=> String
973
+ #
974
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/GetChannel AWS API Documentation
975
+ #
976
+ # @overload get_channel(params = {})
977
+ # @param [Hash] params ({})
978
+ def get_channel(params = {}, options = {})
979
+ req = build_request(:get_channel, params)
980
+ req.send_request(options)
981
+ end
982
+
926
983
  # Returns information about an event data store specified as either an
927
984
  # ARN or the ID portion of the ARN.
928
985
  #
@@ -999,12 +1056,17 @@ module Aws::CloudTrail
999
1056
  # * If your event selector includes data events, the resources on which
1000
1057
  # you are logging data events.
1001
1058
  #
1002
- # For more information, see [Logging Data and Management Events for
1003
- # Trails ][1] in the *CloudTrail User Guide*.
1059
+ # For more information about logging management and data events, see the
1060
+ # following topics in the *CloudTrail User Guide*\:
1061
+ #
1062
+ # * [Logging management events for trails ][1]
1063
+ #
1064
+ # * [Logging data events for trails ][2]
1004
1065
  #
1005
1066
  #
1006
1067
  #
1007
- # [1]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-management-and-data-events-with-cloudtrail.html
1068
+ # [1]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-management-events-with-cloudtrail.html
1069
+ # [2]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-data-events-with-cloudtrail.html
1008
1070
  #
1009
1071
  # @option params [required, String] :trail_name
1010
1072
  # Specifies the name of the trail or trail ARN. If you specify a trail
@@ -1076,6 +1138,57 @@ module Aws::CloudTrail
1076
1138
  req.send_request(options)
1077
1139
  end
1078
1140
 
1141
+ # Returns information for the specified import.
1142
+ #
1143
+ # @option params [required, String] :import_id
1144
+ # The ID for the import.
1145
+ #
1146
+ # @return [Types::GetImportResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1147
+ #
1148
+ # * {Types::GetImportResponse#import_id #import_id} => String
1149
+ # * {Types::GetImportResponse#destinations #destinations} => Array<String>
1150
+ # * {Types::GetImportResponse#import_source #import_source} => Types::ImportSource
1151
+ # * {Types::GetImportResponse#start_event_time #start_event_time} => Time
1152
+ # * {Types::GetImportResponse#end_event_time #end_event_time} => Time
1153
+ # * {Types::GetImportResponse#import_status #import_status} => String
1154
+ # * {Types::GetImportResponse#created_timestamp #created_timestamp} => Time
1155
+ # * {Types::GetImportResponse#updated_timestamp #updated_timestamp} => Time
1156
+ # * {Types::GetImportResponse#import_statistics #import_statistics} => Types::ImportStatistics
1157
+ #
1158
+ # @example Request syntax with placeholder values
1159
+ #
1160
+ # resp = client.get_import({
1161
+ # import_id: "UUID", # required
1162
+ # })
1163
+ #
1164
+ # @example Response structure
1165
+ #
1166
+ # resp.import_id #=> String
1167
+ # resp.destinations #=> Array
1168
+ # resp.destinations[0] #=> String
1169
+ # resp.import_source.s3.s3_location_uri #=> String
1170
+ # resp.import_source.s3.s3_bucket_region #=> String
1171
+ # resp.import_source.s3.s3_bucket_access_role_arn #=> String
1172
+ # resp.start_event_time #=> Time
1173
+ # resp.end_event_time #=> Time
1174
+ # resp.import_status #=> String, one of "INITIALIZING", "IN_PROGRESS", "FAILED", "STOPPED", "COMPLETED"
1175
+ # resp.created_timestamp #=> Time
1176
+ # resp.updated_timestamp #=> Time
1177
+ # resp.import_statistics.prefixes_found #=> Integer
1178
+ # resp.import_statistics.prefixes_completed #=> Integer
1179
+ # resp.import_statistics.files_completed #=> Integer
1180
+ # resp.import_statistics.events_completed #=> Integer
1181
+ # resp.import_statistics.failed_entries #=> Integer
1182
+ #
1183
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/GetImport AWS API Documentation
1184
+ #
1185
+ # @overload get_import(params = {})
1186
+ # @param [Hash] params ({})
1187
+ def get_import(params = {}, options = {})
1188
+ req = build_request(:get_import, params)
1189
+ req.send_request(options)
1190
+ end
1191
+
1079
1192
  # Describes the settings for the Insights event selectors that you
1080
1193
  # configured for your trail. `GetInsightSelectors` shows if CloudTrail
1081
1194
  # Insights event logging is enabled on the trail, and if it is, which
@@ -1308,6 +1421,44 @@ module Aws::CloudTrail
1308
1421
  req.send_request(options)
1309
1422
  end
1310
1423
 
1424
+ # Returns all CloudTrail channels.
1425
+ #
1426
+ # @option params [Integer] :max_results
1427
+ # The maximum number of CloudTrail channels to display on a single page.
1428
+ #
1429
+ # @option params [String] :next_token
1430
+ # A token you can use to get the next page of results.
1431
+ #
1432
+ # @return [Types::ListChannelsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1433
+ #
1434
+ # * {Types::ListChannelsResponse#channels #channels} => Array<Types::Channel>
1435
+ # * {Types::ListChannelsResponse#next_token #next_token} => String
1436
+ #
1437
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
1438
+ #
1439
+ # @example Request syntax with placeholder values
1440
+ #
1441
+ # resp = client.list_channels({
1442
+ # max_results: 1,
1443
+ # next_token: "PaginationToken",
1444
+ # })
1445
+ #
1446
+ # @example Response structure
1447
+ #
1448
+ # resp.channels #=> Array
1449
+ # resp.channels[0].channel_arn #=> String
1450
+ # resp.channels[0].name #=> String
1451
+ # resp.next_token #=> String
1452
+ #
1453
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/ListChannels AWS API Documentation
1454
+ #
1455
+ # @overload list_channels(params = {})
1456
+ # @param [Hash] params ({})
1457
+ def list_channels(params = {}, options = {})
1458
+ req = build_request(:list_channels, params)
1459
+ req.send_request(options)
1460
+ end
1461
+
1311
1462
  # Returns information about all event data stores in the account, in the
1312
1463
  # current region.
1313
1464
  #
@@ -1370,6 +1521,102 @@ module Aws::CloudTrail
1370
1521
  req.send_request(options)
1371
1522
  end
1372
1523
 
1524
+ # Returns a list of failures for the specified import.
1525
+ #
1526
+ # @option params [required, String] :import_id
1527
+ # The ID of the import.
1528
+ #
1529
+ # @option params [Integer] :max_results
1530
+ # The maximum number of failures to display on a single page.
1531
+ #
1532
+ # @option params [String] :next_token
1533
+ # A token you can use to get the next page of import failures.
1534
+ #
1535
+ # @return [Types::ListImportFailuresResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1536
+ #
1537
+ # * {Types::ListImportFailuresResponse#failures #failures} => Array<Types::ImportFailureListItem>
1538
+ # * {Types::ListImportFailuresResponse#next_token #next_token} => String
1539
+ #
1540
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
1541
+ #
1542
+ # @example Request syntax with placeholder values
1543
+ #
1544
+ # resp = client.list_import_failures({
1545
+ # import_id: "UUID", # required
1546
+ # max_results: 1,
1547
+ # next_token: "PaginationToken",
1548
+ # })
1549
+ #
1550
+ # @example Response structure
1551
+ #
1552
+ # resp.failures #=> Array
1553
+ # resp.failures[0].location #=> String
1554
+ # resp.failures[0].status #=> String, one of "FAILED", "RETRY", "SUCCEEDED"
1555
+ # resp.failures[0].error_type #=> String
1556
+ # resp.failures[0].error_message #=> String
1557
+ # resp.failures[0].last_updated_time #=> Time
1558
+ # resp.next_token #=> String
1559
+ #
1560
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/ListImportFailures AWS API Documentation
1561
+ #
1562
+ # @overload list_import_failures(params = {})
1563
+ # @param [Hash] params ({})
1564
+ def list_import_failures(params = {}, options = {})
1565
+ req = build_request(:list_import_failures, params)
1566
+ req.send_request(options)
1567
+ end
1568
+
1569
+ # Returns information on all imports, or a select set of imports by
1570
+ # `ImportStatus` or `Destination`.
1571
+ #
1572
+ # @option params [Integer] :max_results
1573
+ # The maximum number of imports to display on a single page.
1574
+ #
1575
+ # @option params [String] :destination
1576
+ # The destination event data store.
1577
+ #
1578
+ # @option params [String] :import_status
1579
+ # The status of the import.
1580
+ #
1581
+ # @option params [String] :next_token
1582
+ # A token you can use to get the next page of import results.
1583
+ #
1584
+ # @return [Types::ListImportsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1585
+ #
1586
+ # * {Types::ListImportsResponse#imports #imports} => Array<Types::ImportsListItem>
1587
+ # * {Types::ListImportsResponse#next_token #next_token} => String
1588
+ #
1589
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
1590
+ #
1591
+ # @example Request syntax with placeholder values
1592
+ #
1593
+ # resp = client.list_imports({
1594
+ # max_results: 1,
1595
+ # destination: "EventDataStoreArn",
1596
+ # import_status: "INITIALIZING", # accepts INITIALIZING, IN_PROGRESS, FAILED, STOPPED, COMPLETED
1597
+ # next_token: "PaginationToken",
1598
+ # })
1599
+ #
1600
+ # @example Response structure
1601
+ #
1602
+ # resp.imports #=> Array
1603
+ # resp.imports[0].import_id #=> String
1604
+ # resp.imports[0].import_status #=> String, one of "INITIALIZING", "IN_PROGRESS", "FAILED", "STOPPED", "COMPLETED"
1605
+ # resp.imports[0].destinations #=> Array
1606
+ # resp.imports[0].destinations[0] #=> String
1607
+ # resp.imports[0].created_timestamp #=> Time
1608
+ # resp.imports[0].updated_timestamp #=> Time
1609
+ # resp.next_token #=> String
1610
+ #
1611
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/ListImports AWS API Documentation
1612
+ #
1613
+ # @overload list_imports(params = {})
1614
+ # @param [Hash] params ({})
1615
+ def list_imports(params = {}, options = {})
1616
+ req = build_request(:list_imports, params)
1617
+ req.send_request(options)
1618
+ end
1619
+
1373
1620
  # Returns all public keys whose private keys were used to sign the
1374
1621
  # digest files within the specified time range. The public key is needed
1375
1622
  # to validate digest files that were signed with its corresponding
@@ -1540,7 +1787,7 @@ module Aws::CloudTrail
1540
1787
  # @option params [String] :next_token
1541
1788
  # The token to use to get the next page of results after a previous API
1542
1789
  # call. This token must be passed in with the same parameters that were
1543
- # specified in the the original call. For example, if the original call
1790
+ # specified in the original call. For example, if the original call
1544
1791
  # specified an AttributeKey of 'Username' with a value of 'root',
1545
1792
  # the call with NextToken should include those same parameters.
1546
1793
  #
@@ -1642,7 +1889,7 @@ module Aws::CloudTrail
1642
1889
  # @option params [String] :next_token
1643
1890
  # The token to use to get the next page of results after a previous API
1644
1891
  # call. This token must be passed in with the same parameters that were
1645
- # specified in the the original call. For example, if the original call
1892
+ # specified in the original call. For example, if the original call
1646
1893
  # specified an AttributeKey of 'Username' with a value of 'root',
1647
1894
  # the call with NextToken should include those same parameters.
1648
1895
  #
@@ -1728,8 +1975,9 @@ module Aws::CloudTrail
1728
1975
  # `InvalidHomeRegionException` exception is thrown.
1729
1976
  #
1730
1977
  # You can configure up to five event selectors for each trail. For more
1731
- # information, see [Logging data and management events for trails ][1]
1732
- # and [Quotas in CloudTrail][2] in the *CloudTrail User Guide*.
1978
+ # information, see [Logging management events for trails ][1], [Logging
1979
+ # data events for trails ][2], and [Quotas in CloudTrail][3] in the
1980
+ # *CloudTrail User Guide*.
1733
1981
  #
1734
1982
  # You can add advanced event selectors, and conditions for your advanced
1735
1983
  # event selectors, up to a maximum of 500 values for all conditions and
@@ -1737,13 +1985,13 @@ module Aws::CloudTrail
1737
1985
  # `EventSelectors`, but not both. If you apply `AdvancedEventSelectors`
1738
1986
  # to a trail, any existing `EventSelectors` are overwritten. For more
1739
1987
  # information about advanced event selectors, see [Logging data events
1740
- # for trails][3] in the *CloudTrail User Guide*.
1988
+ # for trails][2] in the *CloudTrail User Guide*.
1741
1989
  #
1742
1990
  #
1743
1991
  #
1744
- # [1]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-management-and-data-events-with-cloudtrail.html
1745
- # [2]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/WhatIsCloudTrail-Limits.html
1746
- # [3]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-data-events-with-cloudtrail.html
1992
+ # [1]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-management-events-with-cloudtrail.html
1993
+ # [2]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-data-events-with-cloudtrail.html
1994
+ # [3]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/WhatIsCloudTrail-Limits.html
1747
1995
  #
1748
1996
  # @option params [required, String] :trail_name
1749
1997
  # Specifies the name of the trail or trail ARN. If you specify a trail
@@ -2015,6 +2263,92 @@ module Aws::CloudTrail
2015
2263
  req.send_request(options)
2016
2264
  end
2017
2265
 
2266
+ # Starts an import of logged trail events from a source S3 bucket to a
2267
+ # destination event data store.
2268
+ #
2269
+ # When you start a new import, the `Destinations` and `ImportSource`
2270
+ # parameters are required. Before starting a new import, disable any
2271
+ # access control lists (ACLs) attached to the source S3 bucket. For more
2272
+ # information about disabling ACLs, see [Controlling ownership of
2273
+ # objects and disabling ACLs for your bucket][1].
2274
+ #
2275
+ # When you retry an import, the `ImportID` parameter is required.
2276
+ #
2277
+ #
2278
+ #
2279
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/about-object-ownership.html
2280
+ #
2281
+ # @option params [Array<String>] :destinations
2282
+ # The destination event data store. Use this parameter for a new import.
2283
+ #
2284
+ # @option params [Types::ImportSource] :import_source
2285
+ # The source S3 bucket for the import. Use this parameter for a new
2286
+ # import.
2287
+ #
2288
+ # @option params [Time,DateTime,Date,Integer,String] :start_event_time
2289
+ # Use with `EndEventTime` to bound a `StartImport` request, and limit
2290
+ # imported trail events to only those events logged within a specified
2291
+ # time period.
2292
+ #
2293
+ # @option params [Time,DateTime,Date,Integer,String] :end_event_time
2294
+ # Use with `StartEventTime` to bound a `StartImport` request, and limit
2295
+ # imported trail events to only those events logged within a specified
2296
+ # time period.
2297
+ #
2298
+ # @option params [String] :import_id
2299
+ # The ID of the import. Use this parameter when you are retrying an
2300
+ # import.
2301
+ #
2302
+ # @return [Types::StartImportResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2303
+ #
2304
+ # * {Types::StartImportResponse#import_id #import_id} => String
2305
+ # * {Types::StartImportResponse#destinations #destinations} => Array&lt;String&gt;
2306
+ # * {Types::StartImportResponse#import_source #import_source} => Types::ImportSource
2307
+ # * {Types::StartImportResponse#start_event_time #start_event_time} => Time
2308
+ # * {Types::StartImportResponse#end_event_time #end_event_time} => Time
2309
+ # * {Types::StartImportResponse#import_status #import_status} => String
2310
+ # * {Types::StartImportResponse#created_timestamp #created_timestamp} => Time
2311
+ # * {Types::StartImportResponse#updated_timestamp #updated_timestamp} => Time
2312
+ #
2313
+ # @example Request syntax with placeholder values
2314
+ #
2315
+ # resp = client.start_import({
2316
+ # destinations: ["EventDataStoreArn"],
2317
+ # import_source: {
2318
+ # s3: { # required
2319
+ # s3_location_uri: "String", # required
2320
+ # s3_bucket_region: "String", # required
2321
+ # s3_bucket_access_role_arn: "String", # required
2322
+ # },
2323
+ # },
2324
+ # start_event_time: Time.now,
2325
+ # end_event_time: Time.now,
2326
+ # import_id: "UUID",
2327
+ # })
2328
+ #
2329
+ # @example Response structure
2330
+ #
2331
+ # resp.import_id #=> String
2332
+ # resp.destinations #=> Array
2333
+ # resp.destinations[0] #=> String
2334
+ # resp.import_source.s3.s3_location_uri #=> String
2335
+ # resp.import_source.s3.s3_bucket_region #=> String
2336
+ # resp.import_source.s3.s3_bucket_access_role_arn #=> String
2337
+ # resp.start_event_time #=> Time
2338
+ # resp.end_event_time #=> Time
2339
+ # resp.import_status #=> String, one of "INITIALIZING", "IN_PROGRESS", "FAILED", "STOPPED", "COMPLETED"
2340
+ # resp.created_timestamp #=> Time
2341
+ # resp.updated_timestamp #=> Time
2342
+ #
2343
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/StartImport AWS API Documentation
2344
+ #
2345
+ # @overload start_import(params = {})
2346
+ # @param [Hash] params ({})
2347
+ def start_import(params = {}, options = {})
2348
+ req = build_request(:start_import, params)
2349
+ req.send_request(options)
2350
+ end
2351
+
2018
2352
  # Starts the recording of Amazon Web Services API calls and log file
2019
2353
  # delivery for a trail. For a trail that is enabled in all regions, this
2020
2354
  # operation must be called from the region in which the trail was
@@ -2075,6 +2409,57 @@ module Aws::CloudTrail
2075
2409
  req.send_request(options)
2076
2410
  end
2077
2411
 
2412
+ # Stops a specified import.
2413
+ #
2414
+ # @option params [required, String] :import_id
2415
+ # The ID of the import.
2416
+ #
2417
+ # @return [Types::StopImportResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2418
+ #
2419
+ # * {Types::StopImportResponse#import_id #import_id} => String
2420
+ # * {Types::StopImportResponse#import_source #import_source} => Types::ImportSource
2421
+ # * {Types::StopImportResponse#destinations #destinations} => Array&lt;String&gt;
2422
+ # * {Types::StopImportResponse#import_status #import_status} => String
2423
+ # * {Types::StopImportResponse#created_timestamp #created_timestamp} => Time
2424
+ # * {Types::StopImportResponse#updated_timestamp #updated_timestamp} => Time
2425
+ # * {Types::StopImportResponse#start_event_time #start_event_time} => Time
2426
+ # * {Types::StopImportResponse#end_event_time #end_event_time} => Time
2427
+ # * {Types::StopImportResponse#import_statistics #import_statistics} => Types::ImportStatistics
2428
+ #
2429
+ # @example Request syntax with placeholder values
2430
+ #
2431
+ # resp = client.stop_import({
2432
+ # import_id: "UUID", # required
2433
+ # })
2434
+ #
2435
+ # @example Response structure
2436
+ #
2437
+ # resp.import_id #=> String
2438
+ # resp.import_source.s3.s3_location_uri #=> String
2439
+ # resp.import_source.s3.s3_bucket_region #=> String
2440
+ # resp.import_source.s3.s3_bucket_access_role_arn #=> String
2441
+ # resp.destinations #=> Array
2442
+ # resp.destinations[0] #=> String
2443
+ # resp.import_status #=> String, one of "INITIALIZING", "IN_PROGRESS", "FAILED", "STOPPED", "COMPLETED"
2444
+ # resp.created_timestamp #=> Time
2445
+ # resp.updated_timestamp #=> Time
2446
+ # resp.start_event_time #=> Time
2447
+ # resp.end_event_time #=> Time
2448
+ # resp.import_statistics.prefixes_found #=> Integer
2449
+ # resp.import_statistics.prefixes_completed #=> Integer
2450
+ # resp.import_statistics.files_completed #=> Integer
2451
+ # resp.import_statistics.events_completed #=> Integer
2452
+ # resp.import_statistics.failed_entries #=> Integer
2453
+ #
2454
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/StopImport AWS API Documentation
2455
+ #
2456
+ # @overload stop_import(params = {})
2457
+ # @param [Hash] params ({})
2458
+ def stop_import(params = {}, options = {})
2459
+ req = build_request(:stop_import, params)
2460
+ req.send_request(options)
2461
+ end
2462
+
2078
2463
  # Suspends the recording of Amazon Web Services API calls and log file
2079
2464
  # delivery for the specified trail. Under most circumstances, there is
2080
2465
  # no need to use this action. You can update a trail without stopping it
@@ -2113,7 +2498,7 @@ module Aws::CloudTrail
2113
2498
  # ARN or the ID portion of the ARN. Other parameters are optional, but
2114
2499
  # at least one optional parameter must be specified, or CloudTrail
2115
2500
  # throws an error. `RetentionPeriod` is in days, and valid values are
2116
- # integers between 90 and 2555. By default, `TerminationProtection` is
2501
+ # integers between 90 and 2557. By default, `TerminationProtection` is
2117
2502
  # enabled. `AdvancedEventSelectors` includes or excludes management and
2118
2503
  # data events in your event data store; for more information about
2119
2504
  # `AdvancedEventSelectors`, see
@@ -2128,7 +2513,8 @@ module Aws::CloudTrail
2128
2513
  #
2129
2514
  # @option params [Array<Types::AdvancedEventSelector>] :advanced_event_selectors
2130
2515
  # The advanced event selectors used to select events for the event data
2131
- # store.
2516
+ # store. You can configure up to five advanced event selectors for each
2517
+ # event data store.
2132
2518
  #
2133
2519
  # @option params [Boolean] :multi_region_enabled
2134
2520
  # Specifies whether an event data store collects events from all
@@ -2418,7 +2804,7 @@ module Aws::CloudTrail
2418
2804
  params: params,
2419
2805
  config: config)
2420
2806
  context[:gem_name] = 'aws-sdk-cloudtrail'
2421
- context[:gem_version] = '1.49.0'
2807
+ context[:gem_version] = '1.51.0'
2422
2808
  Seahorse::Client::Request.new(handlers, context)
2423
2809
  end
2424
2810