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 +4 -4
- data/CHANGELOG.md +10 -0
- data/VERSION +1 -1
- data/lib/aws-sdk-cloudtrail/client.rb +401 -15
- data/lib/aws-sdk-cloudtrail/client_api.rb +303 -0
- data/lib/aws-sdk-cloudtrail/errors.rb +77 -0
- data/lib/aws-sdk-cloudtrail/types.rb +755 -16
- data/lib/aws-sdk-cloudtrail.rb +1 -1
- metadata +2 -2
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA256:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: 0d913bff17768e79888c389935ccc3082f330e732957750fbc50e886567982c6
|
4
|
+
data.tar.gz: 691cb628f9e15c1f9b31663796bef4c358ea9590f36cff7e4dcb082c4c6b3c29
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
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.
|
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
|
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
|
1003
|
-
#
|
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-
|
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
|
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
|
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
|
1732
|
-
# and [Quotas in CloudTrail][
|
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][
|
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-
|
1745
|
-
# [2]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/
|
1746
|
-
# [3]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/
|
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<String>
|
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<String>
|
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
|
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.
|
2807
|
+
context[:gem_version] = '1.51.0'
|
2422
2808
|
Seahorse::Client::Request.new(handlers, context)
|
2423
2809
|
end
|
2424
2810
|
|