aws-sdk-cloudtrail 1.50.0 → 1.52.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 +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
|
|