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