aws-sdk-cloudtrail 1.49.0 → 1.51.0

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