aws-sdk-cloudtrail 1.50.0 → 1.52.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 +355 -23
- data/lib/aws-sdk-cloudtrail/client_api.rb +228 -0
- data/lib/aws-sdk-cloudtrail/errors.rb +55 -0
- data/lib/aws-sdk-cloudtrail/types.rb +632 -42
- 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: 9fd98c848dea62b03bdbe8b53bd0697af08f98035546f4f0fd11bcac9b0916cc
|
4
|
+
data.tar.gz: 67792ad77475cb8ee735d3f66a6acc0c9fc7be108c65f7f6dd31c5487c33a2bf
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: 3c8e1be6d40035da296cda86d2ef3f730721adf4c7b36c14b4c427f484183aaff97690116f9763293450b269f76edee57ce1ef6b469449044e4b5f736ce22329
|
7
|
+
data.tar.gz: 4660fc6a4bc8580998fc3fe02ea802a6d852d2957e5d70f0758cf4b3011d6122ebce0b2b5146dc5d6b81a48eff645d7d29be2af8246f2209fcb3033d463ddc3f
|
data/CHANGELOG.md
CHANGED
@@ -1,6 +1,16 @@
|
|
1
1
|
Unreleased Changes
|
2
2
|
------------------
|
3
3
|
|
4
|
+
1.52.0 (2022-10-19)
|
5
|
+
------------------
|
6
|
+
|
7
|
+
* Feature - This release includes support for exporting CloudTrail Lake query results to an Amazon S3 bucket.
|
8
|
+
|
9
|
+
1.51.0 (2022-09-19)
|
10
|
+
------------------
|
11
|
+
|
12
|
+
* Feature - This release includes support for importing existing trails into CloudTrail Lake.
|
13
|
+
|
4
14
|
1.50.0 (2022-09-09)
|
5
15
|
------------------
|
6
16
|
|
data/VERSION
CHANGED
@@ -1 +1 @@
|
|
1
|
-
1.
|
1
|
+
1.52.0
|
@@ -644,7 +644,7 @@ module Aws::CloudTrail
|
|
644
644
|
#
|
645
645
|
# @option params [String] :kms_key_id
|
646
646
|
# Specifies the KMS key ID to use to encrypt the logs delivered by
|
647
|
-
# CloudTrail. The value can be an alias name prefixed by
|
647
|
+
# CloudTrail. The value can be an alias name prefixed by `alias/`, a
|
648
648
|
# fully specified ARN to an alias, a fully specified ARN to a key, or a
|
649
649
|
# globally unique identifier.
|
650
650
|
#
|
@@ -654,13 +654,13 @@ module Aws::CloudTrail
|
|
654
654
|
#
|
655
655
|
# Examples:
|
656
656
|
#
|
657
|
-
# * alias/MyAliasName
|
657
|
+
# * `alias/MyAliasName`
|
658
658
|
#
|
659
|
-
# * arn:aws:kms:us-east-2:123456789012:alias/MyAliasName
|
659
|
+
# * `arn:aws:kms:us-east-2:123456789012:alias/MyAliasName`
|
660
660
|
#
|
661
|
-
# * arn:aws:kms:us-east-2:123456789012:key/12345678-1234-1234-1234-123456789012
|
661
|
+
# * `arn:aws:kms:us-east-2:123456789012:key/12345678-1234-1234-1234-123456789012`
|
662
662
|
#
|
663
|
-
# * 12345678-1234-1234-1234-123456789012
|
663
|
+
# * `12345678-1234-1234-1234-123456789012`
|
664
664
|
#
|
665
665
|
#
|
666
666
|
#
|
@@ -820,6 +820,8 @@ module Aws::CloudTrail
|
|
820
820
|
# * {Types::DescribeQueryResponse#query_status #query_status} => String
|
821
821
|
# * {Types::DescribeQueryResponse#query_statistics #query_statistics} => Types::QueryStatisticsForDescribeQuery
|
822
822
|
# * {Types::DescribeQueryResponse#error_message #error_message} => String
|
823
|
+
# * {Types::DescribeQueryResponse#delivery_s3_uri #delivery_s3_uri} => String
|
824
|
+
# * {Types::DescribeQueryResponse#delivery_status #delivery_status} => String
|
823
825
|
#
|
824
826
|
# @example Request syntax with placeholder values
|
825
827
|
#
|
@@ -839,6 +841,8 @@ module Aws::CloudTrail
|
|
839
841
|
# resp.query_statistics.execution_time_in_millis #=> Integer
|
840
842
|
# resp.query_statistics.creation_time #=> Time
|
841
843
|
# resp.error_message #=> String
|
844
|
+
# resp.delivery_s3_uri #=> String
|
845
|
+
# resp.delivery_status #=> String, one of "SUCCESS", "FAILED", "FAILED_SIGNING_FILE", "PENDING", "RESOURCE_NOT_FOUND", "ACCESS_DENIED", "ACCESS_DENIED_SIGNING_FILE", "CANCELLED", "UNKNOWN"
|
842
846
|
#
|
843
847
|
# @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/DescribeQuery AWS API Documentation
|
844
848
|
#
|
@@ -923,13 +927,18 @@ module Aws::CloudTrail
|
|
923
927
|
req.send_request(options)
|
924
928
|
end
|
925
929
|
|
926
|
-
# Returns
|
927
|
-
#
|
928
|
-
# events.
|
930
|
+
# Returns information about a specific channel. Amazon Web Services
|
931
|
+
# services create service-linked channels to get information about
|
932
|
+
# CloudTrail events on your behalf. For more information about
|
933
|
+
# service-linked channels, see [Viewing service-linked channels for
|
934
|
+
# CloudTrail by using the CLI.][1].
|
935
|
+
#
|
936
|
+
#
|
937
|
+
#
|
938
|
+
# [1]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/viewing-service-linked-channels.html
|
929
939
|
#
|
930
940
|
# @option params [required, String] :channel
|
931
|
-
# The
|
932
|
-
# channel.
|
941
|
+
# The ARN or `UUID` of a channel.
|
933
942
|
#
|
934
943
|
# @return [Types::GetChannelResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
935
944
|
#
|
@@ -1056,12 +1065,17 @@ module Aws::CloudTrail
|
|
1056
1065
|
# * If your event selector includes data events, the resources on which
|
1057
1066
|
# you are logging data events.
|
1058
1067
|
#
|
1059
|
-
# For more information
|
1060
|
-
#
|
1068
|
+
# For more information about logging management and data events, see the
|
1069
|
+
# following topics in the *CloudTrail User Guide*\:
|
1070
|
+
#
|
1071
|
+
# * [Logging management events for trails ][1]
|
1061
1072
|
#
|
1073
|
+
# * [Logging data events for trails ][2]
|
1062
1074
|
#
|
1063
1075
|
#
|
1064
|
-
#
|
1076
|
+
#
|
1077
|
+
# [1]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-management-events-with-cloudtrail.html
|
1078
|
+
# [2]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-data-events-with-cloudtrail.html
|
1065
1079
|
#
|
1066
1080
|
# @option params [required, String] :trail_name
|
1067
1081
|
# Specifies the name of the trail or trail ARN. If you specify a trail
|
@@ -1133,6 +1147,57 @@ module Aws::CloudTrail
|
|
1133
1147
|
req.send_request(options)
|
1134
1148
|
end
|
1135
1149
|
|
1150
|
+
# Returns information about a specific import.
|
1151
|
+
#
|
1152
|
+
# @option params [required, String] :import_id
|
1153
|
+
# The ID for the import.
|
1154
|
+
#
|
1155
|
+
# @return [Types::GetImportResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
1156
|
+
#
|
1157
|
+
# * {Types::GetImportResponse#import_id #import_id} => String
|
1158
|
+
# * {Types::GetImportResponse#destinations #destinations} => Array<String>
|
1159
|
+
# * {Types::GetImportResponse#import_source #import_source} => Types::ImportSource
|
1160
|
+
# * {Types::GetImportResponse#start_event_time #start_event_time} => Time
|
1161
|
+
# * {Types::GetImportResponse#end_event_time #end_event_time} => Time
|
1162
|
+
# * {Types::GetImportResponse#import_status #import_status} => String
|
1163
|
+
# * {Types::GetImportResponse#created_timestamp #created_timestamp} => Time
|
1164
|
+
# * {Types::GetImportResponse#updated_timestamp #updated_timestamp} => Time
|
1165
|
+
# * {Types::GetImportResponse#import_statistics #import_statistics} => Types::ImportStatistics
|
1166
|
+
#
|
1167
|
+
# @example Request syntax with placeholder values
|
1168
|
+
#
|
1169
|
+
# resp = client.get_import({
|
1170
|
+
# import_id: "UUID", # required
|
1171
|
+
# })
|
1172
|
+
#
|
1173
|
+
# @example Response structure
|
1174
|
+
#
|
1175
|
+
# resp.import_id #=> String
|
1176
|
+
# resp.destinations #=> Array
|
1177
|
+
# resp.destinations[0] #=> String
|
1178
|
+
# resp.import_source.s3.s3_location_uri #=> String
|
1179
|
+
# resp.import_source.s3.s3_bucket_region #=> String
|
1180
|
+
# resp.import_source.s3.s3_bucket_access_role_arn #=> String
|
1181
|
+
# resp.start_event_time #=> Time
|
1182
|
+
# resp.end_event_time #=> Time
|
1183
|
+
# resp.import_status #=> String, one of "INITIALIZING", "IN_PROGRESS", "FAILED", "STOPPED", "COMPLETED"
|
1184
|
+
# resp.created_timestamp #=> Time
|
1185
|
+
# resp.updated_timestamp #=> Time
|
1186
|
+
# resp.import_statistics.prefixes_found #=> Integer
|
1187
|
+
# resp.import_statistics.prefixes_completed #=> Integer
|
1188
|
+
# resp.import_statistics.files_completed #=> Integer
|
1189
|
+
# resp.import_statistics.events_completed #=> Integer
|
1190
|
+
# resp.import_statistics.failed_entries #=> Integer
|
1191
|
+
#
|
1192
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/GetImport AWS API Documentation
|
1193
|
+
#
|
1194
|
+
# @overload get_import(params = {})
|
1195
|
+
# @param [Hash] params ({})
|
1196
|
+
def get_import(params = {}, options = {})
|
1197
|
+
req = build_request(:get_import, params)
|
1198
|
+
req.send_request(options)
|
1199
|
+
end
|
1200
|
+
|
1136
1201
|
# Describes the settings for the Insights event selectors that you
|
1137
1202
|
# configured for your trail. `GetInsightSelectors` shows if CloudTrail
|
1138
1203
|
# Insights event logging is enabled on the trail, and if it is, which
|
@@ -1365,13 +1430,25 @@ module Aws::CloudTrail
|
|
1365
1430
|
req.send_request(options)
|
1366
1431
|
end
|
1367
1432
|
|
1368
|
-
#
|
1433
|
+
# Lists the channels in the current account, and their source names.
|
1434
|
+
# Amazon Web Services services create service-linked channels get
|
1435
|
+
# information about CloudTrail events on your behalf. For more
|
1436
|
+
# information about service-linked channels, see [Viewing service-linked
|
1437
|
+
# channels for CloudTrail by using the CLI][1].
|
1438
|
+
#
|
1439
|
+
#
|
1440
|
+
#
|
1441
|
+
# [1]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/viewing-service-linked-channels.html
|
1369
1442
|
#
|
1370
1443
|
# @option params [Integer] :max_results
|
1371
1444
|
# The maximum number of CloudTrail channels to display on a single page.
|
1372
1445
|
#
|
1373
1446
|
# @option params [String] :next_token
|
1374
|
-
#
|
1447
|
+
# The token to use to get the next page of results after a previous API
|
1448
|
+
# call. This token must be passed in with the same parameters that were
|
1449
|
+
# specified in the original call. For example, if the original call
|
1450
|
+
# specified an AttributeKey of 'Username' with a value of 'root',
|
1451
|
+
# the call with NextToken should include those same parameters.
|
1375
1452
|
#
|
1376
1453
|
# @return [Types::ListChannelsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
1377
1454
|
#
|
@@ -1465,6 +1542,102 @@ module Aws::CloudTrail
|
|
1465
1542
|
req.send_request(options)
|
1466
1543
|
end
|
1467
1544
|
|
1545
|
+
# Returns a list of failures for the specified import.
|
1546
|
+
#
|
1547
|
+
# @option params [required, String] :import_id
|
1548
|
+
# The ID of the import.
|
1549
|
+
#
|
1550
|
+
# @option params [Integer] :max_results
|
1551
|
+
# The maximum number of failures to display on a single page.
|
1552
|
+
#
|
1553
|
+
# @option params [String] :next_token
|
1554
|
+
# A token you can use to get the next page of import failures.
|
1555
|
+
#
|
1556
|
+
# @return [Types::ListImportFailuresResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
1557
|
+
#
|
1558
|
+
# * {Types::ListImportFailuresResponse#failures #failures} => Array<Types::ImportFailureListItem>
|
1559
|
+
# * {Types::ListImportFailuresResponse#next_token #next_token} => String
|
1560
|
+
#
|
1561
|
+
# The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
|
1562
|
+
#
|
1563
|
+
# @example Request syntax with placeholder values
|
1564
|
+
#
|
1565
|
+
# resp = client.list_import_failures({
|
1566
|
+
# import_id: "UUID", # required
|
1567
|
+
# max_results: 1,
|
1568
|
+
# next_token: "PaginationToken",
|
1569
|
+
# })
|
1570
|
+
#
|
1571
|
+
# @example Response structure
|
1572
|
+
#
|
1573
|
+
# resp.failures #=> Array
|
1574
|
+
# resp.failures[0].location #=> String
|
1575
|
+
# resp.failures[0].status #=> String, one of "FAILED", "RETRY", "SUCCEEDED"
|
1576
|
+
# resp.failures[0].error_type #=> String
|
1577
|
+
# resp.failures[0].error_message #=> String
|
1578
|
+
# resp.failures[0].last_updated_time #=> Time
|
1579
|
+
# resp.next_token #=> String
|
1580
|
+
#
|
1581
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/ListImportFailures AWS API Documentation
|
1582
|
+
#
|
1583
|
+
# @overload list_import_failures(params = {})
|
1584
|
+
# @param [Hash] params ({})
|
1585
|
+
def list_import_failures(params = {}, options = {})
|
1586
|
+
req = build_request(:list_import_failures, params)
|
1587
|
+
req.send_request(options)
|
1588
|
+
end
|
1589
|
+
|
1590
|
+
# Returns information on all imports, or a select set of imports by
|
1591
|
+
# `ImportStatus` or `Destination`.
|
1592
|
+
#
|
1593
|
+
# @option params [Integer] :max_results
|
1594
|
+
# The maximum number of imports to display on a single page.
|
1595
|
+
#
|
1596
|
+
# @option params [String] :destination
|
1597
|
+
# The ARN of the destination event data store.
|
1598
|
+
#
|
1599
|
+
# @option params [String] :import_status
|
1600
|
+
# The status of the import.
|
1601
|
+
#
|
1602
|
+
# @option params [String] :next_token
|
1603
|
+
# A token you can use to get the next page of import results.
|
1604
|
+
#
|
1605
|
+
# @return [Types::ListImportsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
1606
|
+
#
|
1607
|
+
# * {Types::ListImportsResponse#imports #imports} => Array<Types::ImportsListItem>
|
1608
|
+
# * {Types::ListImportsResponse#next_token #next_token} => String
|
1609
|
+
#
|
1610
|
+
# The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
|
1611
|
+
#
|
1612
|
+
# @example Request syntax with placeholder values
|
1613
|
+
#
|
1614
|
+
# resp = client.list_imports({
|
1615
|
+
# max_results: 1,
|
1616
|
+
# destination: "EventDataStoreArn",
|
1617
|
+
# import_status: "INITIALIZING", # accepts INITIALIZING, IN_PROGRESS, FAILED, STOPPED, COMPLETED
|
1618
|
+
# next_token: "PaginationToken",
|
1619
|
+
# })
|
1620
|
+
#
|
1621
|
+
# @example Response structure
|
1622
|
+
#
|
1623
|
+
# resp.imports #=> Array
|
1624
|
+
# resp.imports[0].import_id #=> String
|
1625
|
+
# resp.imports[0].import_status #=> String, one of "INITIALIZING", "IN_PROGRESS", "FAILED", "STOPPED", "COMPLETED"
|
1626
|
+
# resp.imports[0].destinations #=> Array
|
1627
|
+
# resp.imports[0].destinations[0] #=> String
|
1628
|
+
# resp.imports[0].created_timestamp #=> Time
|
1629
|
+
# resp.imports[0].updated_timestamp #=> Time
|
1630
|
+
# resp.next_token #=> String
|
1631
|
+
#
|
1632
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/ListImports AWS API Documentation
|
1633
|
+
#
|
1634
|
+
# @overload list_imports(params = {})
|
1635
|
+
# @param [Hash] params ({})
|
1636
|
+
def list_imports(params = {}, options = {})
|
1637
|
+
req = build_request(:list_imports, params)
|
1638
|
+
req.send_request(options)
|
1639
|
+
end
|
1640
|
+
|
1468
1641
|
# Returns all public keys whose private keys were used to sign the
|
1469
1642
|
# digest files within the specified time range. The public key is needed
|
1470
1643
|
# to validate digest files that were signed with its corresponding
|
@@ -1823,8 +1996,9 @@ module Aws::CloudTrail
|
|
1823
1996
|
# `InvalidHomeRegionException` exception is thrown.
|
1824
1997
|
#
|
1825
1998
|
# You can configure up to five event selectors for each trail. For more
|
1826
|
-
# information, see [Logging
|
1827
|
-
# and [Quotas in CloudTrail][
|
1999
|
+
# information, see [Logging management events for trails ][1], [Logging
|
2000
|
+
# data events for trails ][2], and [Quotas in CloudTrail][3] in the
|
2001
|
+
# *CloudTrail User Guide*.
|
1828
2002
|
#
|
1829
2003
|
# You can add advanced event selectors, and conditions for your advanced
|
1830
2004
|
# event selectors, up to a maximum of 500 values for all conditions and
|
@@ -1832,13 +2006,13 @@ module Aws::CloudTrail
|
|
1832
2006
|
# `EventSelectors`, but not both. If you apply `AdvancedEventSelectors`
|
1833
2007
|
# to a trail, any existing `EventSelectors` are overwritten. For more
|
1834
2008
|
# information about advanced event selectors, see [Logging data events
|
1835
|
-
# for trails][
|
2009
|
+
# for trails][2] in the *CloudTrail User Guide*.
|
1836
2010
|
#
|
1837
2011
|
#
|
1838
2012
|
#
|
1839
|
-
# [1]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-management-
|
1840
|
-
# [2]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/
|
1841
|
-
# [3]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/
|
2013
|
+
# [1]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-management-events-with-cloudtrail.html
|
2014
|
+
# [2]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-data-events-with-cloudtrail.html
|
2015
|
+
# [3]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/WhatIsCloudTrail-Limits.html
|
1842
2016
|
#
|
1843
2017
|
# @option params [required, String] :trail_name
|
1844
2018
|
# Specifies the name of the trail or trail ARN. If you specify a trail
|
@@ -2110,6 +2284,106 @@ module Aws::CloudTrail
|
|
2110
2284
|
req.send_request(options)
|
2111
2285
|
end
|
2112
2286
|
|
2287
|
+
# Starts an import of logged trail events from a source S3 bucket to a
|
2288
|
+
# destination event data store. By default, CloudTrail only imports
|
2289
|
+
# events contained in the S3 bucket's `CloudTrail` prefix and the
|
2290
|
+
# prefixes inside the `CloudTrail` prefix, and does not check prefixes
|
2291
|
+
# for other Amazon Web Services services. If you want to import
|
2292
|
+
# CloudTrail events contained in another prefix, you must include the
|
2293
|
+
# prefix in the `S3LocationUri`. For more considerations about importing
|
2294
|
+
# trail events, see [Considerations][1].
|
2295
|
+
#
|
2296
|
+
# When you start a new import, the `Destinations` and `ImportSource`
|
2297
|
+
# parameters are required. Before starting a new import, disable any
|
2298
|
+
# access control lists (ACLs) attached to the source S3 bucket. For more
|
2299
|
+
# information about disabling ACLs, see [Controlling ownership of
|
2300
|
+
# objects and disabling ACLs for your bucket][2].
|
2301
|
+
#
|
2302
|
+
# When you retry an import, the `ImportID` parameter is required.
|
2303
|
+
#
|
2304
|
+
#
|
2305
|
+
#
|
2306
|
+
# [1]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-copy-trail-to-lake.html#cloudtrail-trail-copy-considerations
|
2307
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/about-object-ownership.html
|
2308
|
+
#
|
2309
|
+
# @option params [Array<String>] :destinations
|
2310
|
+
# The ARN of the destination event data store. Use this parameter for a
|
2311
|
+
# new import.
|
2312
|
+
#
|
2313
|
+
# @option params [Types::ImportSource] :import_source
|
2314
|
+
# The source S3 bucket for the import. Use this parameter for a new
|
2315
|
+
# import.
|
2316
|
+
#
|
2317
|
+
# @option params [Time,DateTime,Date,Integer,String] :start_event_time
|
2318
|
+
# Use with `EndEventTime` to bound a `StartImport` request, and limit
|
2319
|
+
# imported trail events to only those events logged within a specified
|
2320
|
+
# time period. When you specify a time range, CloudTrail checks the
|
2321
|
+
# prefix and log file names to verify the names contain a date between
|
2322
|
+
# the specified `StartEventTime` and `EndEventTime` before attempting to
|
2323
|
+
# import events.
|
2324
|
+
#
|
2325
|
+
# @option params [Time,DateTime,Date,Integer,String] :end_event_time
|
2326
|
+
# Use with `StartEventTime` to bound a `StartImport` request, and limit
|
2327
|
+
# imported trail events to only those events logged within a specified
|
2328
|
+
# time period. When you specify a time range, CloudTrail checks the
|
2329
|
+
# prefix and log file names to verify the names contain a date between
|
2330
|
+
# the specified `StartEventTime` and `EndEventTime` before attempting to
|
2331
|
+
# import events.
|
2332
|
+
#
|
2333
|
+
# @option params [String] :import_id
|
2334
|
+
# The ID of the import. Use this parameter when you are retrying an
|
2335
|
+
# import.
|
2336
|
+
#
|
2337
|
+
# @return [Types::StartImportResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
2338
|
+
#
|
2339
|
+
# * {Types::StartImportResponse#import_id #import_id} => String
|
2340
|
+
# * {Types::StartImportResponse#destinations #destinations} => Array<String>
|
2341
|
+
# * {Types::StartImportResponse#import_source #import_source} => Types::ImportSource
|
2342
|
+
# * {Types::StartImportResponse#start_event_time #start_event_time} => Time
|
2343
|
+
# * {Types::StartImportResponse#end_event_time #end_event_time} => Time
|
2344
|
+
# * {Types::StartImportResponse#import_status #import_status} => String
|
2345
|
+
# * {Types::StartImportResponse#created_timestamp #created_timestamp} => Time
|
2346
|
+
# * {Types::StartImportResponse#updated_timestamp #updated_timestamp} => Time
|
2347
|
+
#
|
2348
|
+
# @example Request syntax with placeholder values
|
2349
|
+
#
|
2350
|
+
# resp = client.start_import({
|
2351
|
+
# destinations: ["EventDataStoreArn"],
|
2352
|
+
# import_source: {
|
2353
|
+
# s3: { # required
|
2354
|
+
# s3_location_uri: "String", # required
|
2355
|
+
# s3_bucket_region: "String", # required
|
2356
|
+
# s3_bucket_access_role_arn: "String", # required
|
2357
|
+
# },
|
2358
|
+
# },
|
2359
|
+
# start_event_time: Time.now,
|
2360
|
+
# end_event_time: Time.now,
|
2361
|
+
# import_id: "UUID",
|
2362
|
+
# })
|
2363
|
+
#
|
2364
|
+
# @example Response structure
|
2365
|
+
#
|
2366
|
+
# resp.import_id #=> String
|
2367
|
+
# resp.destinations #=> Array
|
2368
|
+
# resp.destinations[0] #=> String
|
2369
|
+
# resp.import_source.s3.s3_location_uri #=> String
|
2370
|
+
# resp.import_source.s3.s3_bucket_region #=> String
|
2371
|
+
# resp.import_source.s3.s3_bucket_access_role_arn #=> String
|
2372
|
+
# resp.start_event_time #=> Time
|
2373
|
+
# resp.end_event_time #=> Time
|
2374
|
+
# resp.import_status #=> String, one of "INITIALIZING", "IN_PROGRESS", "FAILED", "STOPPED", "COMPLETED"
|
2375
|
+
# resp.created_timestamp #=> Time
|
2376
|
+
# resp.updated_timestamp #=> Time
|
2377
|
+
#
|
2378
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/StartImport AWS API Documentation
|
2379
|
+
#
|
2380
|
+
# @overload start_import(params = {})
|
2381
|
+
# @param [Hash] params ({})
|
2382
|
+
def start_import(params = {}, options = {})
|
2383
|
+
req = build_request(:start_import, params)
|
2384
|
+
req.send_request(options)
|
2385
|
+
end
|
2386
|
+
|
2113
2387
|
# Starts the recording of Amazon Web Services API calls and log file
|
2114
2388
|
# delivery for a trail. For a trail that is enabled in all regions, this
|
2115
2389
|
# operation must be called from the region in which the trail was
|
@@ -2143,10 +2417,15 @@ module Aws::CloudTrail
|
|
2143
2417
|
|
2144
2418
|
# Starts a CloudTrail Lake query. The required `QueryStatement`
|
2145
2419
|
# parameter provides your SQL query, enclosed in single quotation marks.
|
2420
|
+
# Use the optional `DeliveryS3Uri` parameter to deliver the query
|
2421
|
+
# results to an S3 bucket.
|
2146
2422
|
#
|
2147
2423
|
# @option params [required, String] :query_statement
|
2148
2424
|
# The SQL code of your query.
|
2149
2425
|
#
|
2426
|
+
# @option params [String] :delivery_s3_uri
|
2427
|
+
# The URI for the S3 bucket where CloudTrail delivers the query results.
|
2428
|
+
#
|
2150
2429
|
# @return [Types::StartQueryResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
2151
2430
|
#
|
2152
2431
|
# * {Types::StartQueryResponse#query_id #query_id} => String
|
@@ -2155,6 +2434,7 @@ module Aws::CloudTrail
|
|
2155
2434
|
#
|
2156
2435
|
# resp = client.start_query({
|
2157
2436
|
# query_statement: "QueryStatement", # required
|
2437
|
+
# delivery_s3_uri: "DeliveryS3Uri",
|
2158
2438
|
# })
|
2159
2439
|
#
|
2160
2440
|
# @example Response structure
|
@@ -2170,6 +2450,57 @@ module Aws::CloudTrail
|
|
2170
2450
|
req.send_request(options)
|
2171
2451
|
end
|
2172
2452
|
|
2453
|
+
# Stops a specified import.
|
2454
|
+
#
|
2455
|
+
# @option params [required, String] :import_id
|
2456
|
+
# The ID of the import.
|
2457
|
+
#
|
2458
|
+
# @return [Types::StopImportResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
2459
|
+
#
|
2460
|
+
# * {Types::StopImportResponse#import_id #import_id} => String
|
2461
|
+
# * {Types::StopImportResponse#import_source #import_source} => Types::ImportSource
|
2462
|
+
# * {Types::StopImportResponse#destinations #destinations} => Array<String>
|
2463
|
+
# * {Types::StopImportResponse#import_status #import_status} => String
|
2464
|
+
# * {Types::StopImportResponse#created_timestamp #created_timestamp} => Time
|
2465
|
+
# * {Types::StopImportResponse#updated_timestamp #updated_timestamp} => Time
|
2466
|
+
# * {Types::StopImportResponse#start_event_time #start_event_time} => Time
|
2467
|
+
# * {Types::StopImportResponse#end_event_time #end_event_time} => Time
|
2468
|
+
# * {Types::StopImportResponse#import_statistics #import_statistics} => Types::ImportStatistics
|
2469
|
+
#
|
2470
|
+
# @example Request syntax with placeholder values
|
2471
|
+
#
|
2472
|
+
# resp = client.stop_import({
|
2473
|
+
# import_id: "UUID", # required
|
2474
|
+
# })
|
2475
|
+
#
|
2476
|
+
# @example Response structure
|
2477
|
+
#
|
2478
|
+
# resp.import_id #=> String
|
2479
|
+
# resp.import_source.s3.s3_location_uri #=> String
|
2480
|
+
# resp.import_source.s3.s3_bucket_region #=> String
|
2481
|
+
# resp.import_source.s3.s3_bucket_access_role_arn #=> String
|
2482
|
+
# resp.destinations #=> Array
|
2483
|
+
# resp.destinations[0] #=> String
|
2484
|
+
# resp.import_status #=> String, one of "INITIALIZING", "IN_PROGRESS", "FAILED", "STOPPED", "COMPLETED"
|
2485
|
+
# resp.created_timestamp #=> Time
|
2486
|
+
# resp.updated_timestamp #=> Time
|
2487
|
+
# resp.start_event_time #=> Time
|
2488
|
+
# resp.end_event_time #=> Time
|
2489
|
+
# resp.import_statistics.prefixes_found #=> Integer
|
2490
|
+
# resp.import_statistics.prefixes_completed #=> Integer
|
2491
|
+
# resp.import_statistics.files_completed #=> Integer
|
2492
|
+
# resp.import_statistics.events_completed #=> Integer
|
2493
|
+
# resp.import_statistics.failed_entries #=> Integer
|
2494
|
+
#
|
2495
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/StopImport AWS API Documentation
|
2496
|
+
#
|
2497
|
+
# @overload stop_import(params = {})
|
2498
|
+
# @param [Hash] params ({})
|
2499
|
+
def stop_import(params = {}, options = {})
|
2500
|
+
req = build_request(:stop_import, params)
|
2501
|
+
req.send_request(options)
|
2502
|
+
end
|
2503
|
+
|
2173
2504
|
# Suspends the recording of Amazon Web Services API calls and log file
|
2174
2505
|
# delivery for the specified trail. Under most circumstances, there is
|
2175
2506
|
# no need to use this action. You can update a trail without stopping it
|
@@ -2223,7 +2554,8 @@ module Aws::CloudTrail
|
|
2223
2554
|
#
|
2224
2555
|
# @option params [Array<Types::AdvancedEventSelector>] :advanced_event_selectors
|
2225
2556
|
# The advanced event selectors used to select events for the event data
|
2226
|
-
# store.
|
2557
|
+
# store. You can configure up to five advanced event selectors for each
|
2558
|
+
# event data store.
|
2227
2559
|
#
|
2228
2560
|
# @option params [Boolean] :multi_region_enabled
|
2229
2561
|
# Specifies whether an event data store collects events from all
|
@@ -2513,7 +2845,7 @@ module Aws::CloudTrail
|
|
2513
2845
|
params: params,
|
2514
2846
|
config: config)
|
2515
2847
|
context[:gem_name] = 'aws-sdk-cloudtrail'
|
2516
|
-
context[:gem_version] = '1.
|
2848
|
+
context[:gem_version] = '1.52.0'
|
2517
2849
|
Seahorse::Client::Request.new(handlers, context)
|
2518
2850
|
end
|
2519
2851
|
|