aws-sdk-cloudtrail 1.50.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: 92437a7a7cb64e0c36d4094799380ba953562fec2d133de0271299cfd9733f1b
4
- data.tar.gz: a64de41244574754915618a7a79fc003a0c98ba7672fbff44ccdeebeab7a2895
3
+ metadata.gz: 0d913bff17768e79888c389935ccc3082f330e732957750fbc50e886567982c6
4
+ data.tar.gz: 691cb628f9e15c1f9b31663796bef4c358ea9590f36cff7e4dcb082c4c6b3c29
5
5
  SHA512:
6
- metadata.gz: 3abd5b513985fe3c06e1497f965fbaa318686a627f5870f742204378909b24361c4a465308770a61530b10eebd6334b2238748ae3e5c606a3edc1d70651bff41
7
- data.tar.gz: 0e89f2c4758a430eb4bdca0bc7d1a855bef3da80911cdb36f43686ebe570d2264d03da11d9f286f4cfeb88bcb629ff9199a5ce713b09ebf58e9ff1df5ee47578
6
+ metadata.gz: f8bceeac781dab3962b59a9b193385094d3bab825a9f9ae2ce7ef015417ac3d4ea3774d9792b730c5b2726193d6c504d9b9c34182c955c77bdb6562f5e2d886b
7
+ data.tar.gz: 16c2d8a4a3a07c860911b7ac83ff706bd42f696ae9641a2328ef7e215dc721a8eaf98d15a718731924a8f97f45f311140675da8c6ac562c094e494e8c44aa3d5
data/CHANGELOG.md CHANGED
@@ -1,6 +1,11 @@
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
+
4
9
  1.50.0 (2022-09-09)
5
10
  ------------------
6
11
 
data/VERSION CHANGED
@@ -1 +1 @@
1
- 1.50.0
1
+ 1.51.0
@@ -1056,12 +1056,17 @@ module Aws::CloudTrail
1056
1056
  # * If your event selector includes data events, the resources on which
1057
1057
  # you are logging data events.
1058
1058
  #
1059
- # For more information, see [Logging Data and Management Events for
1060
- # 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]
1061
1063
  #
1064
+ # * [Logging data events for trails ][2]
1062
1065
  #
1063
1066
  #
1064
- # [1]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-management-and-data-events-with-cloudtrail.html
1067
+ #
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
1065
1070
  #
1066
1071
  # @option params [required, String] :trail_name
1067
1072
  # Specifies the name of the trail or trail ARN. If you specify a trail
@@ -1133,6 +1138,57 @@ module Aws::CloudTrail
1133
1138
  req.send_request(options)
1134
1139
  end
1135
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
+
1136
1192
  # Describes the settings for the Insights event selectors that you
1137
1193
  # configured for your trail. `GetInsightSelectors` shows if CloudTrail
1138
1194
  # Insights event logging is enabled on the trail, and if it is, which
@@ -1465,6 +1521,102 @@ module Aws::CloudTrail
1465
1521
  req.send_request(options)
1466
1522
  end
1467
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
+
1468
1620
  # Returns all public keys whose private keys were used to sign the
1469
1621
  # digest files within the specified time range. The public key is needed
1470
1622
  # to validate digest files that were signed with its corresponding
@@ -1823,8 +1975,9 @@ module Aws::CloudTrail
1823
1975
  # `InvalidHomeRegionException` exception is thrown.
1824
1976
  #
1825
1977
  # 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*.
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*.
1828
1981
  #
1829
1982
  # You can add advanced event selectors, and conditions for your advanced
1830
1983
  # event selectors, up to a maximum of 500 values for all conditions and
@@ -1832,13 +1985,13 @@ module Aws::CloudTrail
1832
1985
  # `EventSelectors`, but not both. If you apply `AdvancedEventSelectors`
1833
1986
  # to a trail, any existing `EventSelectors` are overwritten. For more
1834
1987
  # information about advanced event selectors, see [Logging data events
1835
- # for trails][3] in the *CloudTrail User Guide*.
1988
+ # for trails][2] in the *CloudTrail User Guide*.
1836
1989
  #
1837
1990
  #
1838
1991
  #
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
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
1842
1995
  #
1843
1996
  # @option params [required, String] :trail_name
1844
1997
  # Specifies the name of the trail or trail ARN. If you specify a trail
@@ -2110,6 +2263,92 @@ module Aws::CloudTrail
2110
2263
  req.send_request(options)
2111
2264
  end
2112
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
+
2113
2352
  # Starts the recording of Amazon Web Services API calls and log file
2114
2353
  # delivery for a trail. For a trail that is enabled in all regions, this
2115
2354
  # operation must be called from the region in which the trail was
@@ -2170,6 +2409,57 @@ module Aws::CloudTrail
2170
2409
  req.send_request(options)
2171
2410
  end
2172
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
+
2173
2463
  # Suspends the recording of Amazon Web Services API calls and log file
2174
2464
  # delivery for the specified trail. Under most circumstances, there is
2175
2465
  # no need to use this action. You can update a trail without stopping it
@@ -2223,7 +2513,8 @@ module Aws::CloudTrail
2223
2513
  #
2224
2514
  # @option params [Array<Types::AdvancedEventSelector>] :advanced_event_selectors
2225
2515
  # The advanced event selectors used to select events for the event data
2226
- # store.
2516
+ # store. You can configure up to five advanced event selectors for each
2517
+ # event data store.
2227
2518
  #
2228
2519
  # @option params [Boolean] :multi_region_enabled
2229
2520
  # Specifies whether an event data store collects events from all
@@ -2513,7 +2804,7 @@ module Aws::CloudTrail
2513
2804
  params: params,
2514
2805
  config: config)
2515
2806
  context[:gem_name] = 'aws-sdk-cloudtrail'
2516
- context[:gem_version] = '1.50.0'
2807
+ context[:gem_version] = '1.51.0'
2517
2808
  Seahorse::Client::Request.new(handlers, context)
2518
2809
  end
2519
2810