aws-sdk-cloudtrail 1.60.0 → 1.61.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 +5 -0
- data/VERSION +1 -1
- data/lib/aws-sdk-cloudtrail/client.rb +124 -58
- data/lib/aws-sdk-cloudtrail/client_api.rb +51 -0
- data/lib/aws-sdk-cloudtrail/endpoints.rb +28 -0
- data/lib/aws-sdk-cloudtrail/plugins/endpoints.rb +4 -0
- data/lib/aws-sdk-cloudtrail/types.rb +104 -58
- 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: 552835fa9020cb2d845ab5481ac3f5af7e7ca56e948f52fa8fa528197bdd97d4
|
4
|
+
data.tar.gz: 59b0f1f716909d88d66027ee4e7dc9327bf4734a5e767305b79a987a8ab574b6
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: 3bcb544e6d7feb0e1bfd113c898ab21526fc81913ff25fc21e6d4f202446ff18f409d24b8af686712ae12ee57a64b5301560e062bc6ef3efe297e0bcb42e035e
|
7
|
+
data.tar.gz: 07c077d084804f3c62c7203e20c076982b72f188482ab68375c842aff70be01c220f6bfc31c41c7bdc0dd1d89df830e60308ca1eae131bc8954ebe4026262eff
|
data/CHANGELOG.md
CHANGED
data/VERSION
CHANGED
@@ -1 +1 @@
|
|
1
|
-
1.
|
1
|
+
1.61.0
|
@@ -391,7 +391,7 @@ module Aws::CloudTrail
|
|
391
391
|
# specified key and a value of null. You can tag a trail or event data
|
392
392
|
# store that applies to all Amazon Web Services Regions only from the
|
393
393
|
# Region in which the trail or event data store was created (also known
|
394
|
-
# as its home
|
394
|
+
# as its home Region).
|
395
395
|
#
|
396
396
|
# @option params [required, String] :resource_id
|
397
397
|
# Specifies the ARN of the trail, event data store, or channel to which
|
@@ -401,7 +401,7 @@ module Aws::CloudTrail
|
|
401
401
|
# `arn:aws:cloudtrail:us-east-2:123456789012:trail/MyTrail`
|
402
402
|
#
|
403
403
|
# The format of an event data store ARN is:
|
404
|
-
# `arn:aws:cloudtrail:us-east-2:
|
404
|
+
# `arn:aws:cloudtrail:us-east-2:123456789012:eventdatastore/EXAMPLE-f852-4e8f-8bd1-bcf6cEXAMPLE`
|
405
405
|
#
|
406
406
|
# The format of a channel ARN is:
|
407
407
|
# `arn:aws:cloudtrail:us-east-2:123456789012:channel/01234567890`
|
@@ -580,7 +580,7 @@ module Aws::CloudTrail
|
|
580
580
|
#
|
581
581
|
# @option params [Boolean] :multi_region_enabled
|
582
582
|
# Specifies whether the event data store includes events from all
|
583
|
-
#
|
583
|
+
# Regions, or only from the Region in which the event data store is
|
584
584
|
# created.
|
585
585
|
#
|
586
586
|
# @option params [Boolean] :organization_enabled
|
@@ -631,6 +631,10 @@ module Aws::CloudTrail
|
|
631
631
|
#
|
632
632
|
# [1]: https://docs.aws.amazon.com/kms/latest/developerguide/multi-region-keys-overview.html
|
633
633
|
#
|
634
|
+
# @option params [Boolean] :start_ingestion
|
635
|
+
# Specifies whether the event data store should start ingesting live
|
636
|
+
# events. The default is true.
|
637
|
+
#
|
634
638
|
# @return [Types::CreateEventDataStoreResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
635
639
|
#
|
636
640
|
# * {Types::CreateEventDataStoreResponse#event_data_store_arn #event_data_store_arn} => String
|
@@ -677,13 +681,14 @@ module Aws::CloudTrail
|
|
677
681
|
# },
|
678
682
|
# ],
|
679
683
|
# kms_key_id: "EventDataStoreKmsKeyId",
|
684
|
+
# start_ingestion: false,
|
680
685
|
# })
|
681
686
|
#
|
682
687
|
# @example Response structure
|
683
688
|
#
|
684
689
|
# resp.event_data_store_arn #=> String
|
685
690
|
# resp.name #=> String
|
686
|
-
# resp.status #=> String, one of "CREATED", "ENABLED", "PENDING_DELETION"
|
691
|
+
# resp.status #=> String, one of "CREATED", "ENABLED", "PENDING_DELETION", "STARTING_INGESTION", "STOPPING_INGESTION", "STOPPED_INGESTION"
|
687
692
|
# resp.advanced_event_selectors #=> Array
|
688
693
|
# resp.advanced_event_selectors[0].name #=> String
|
689
694
|
# resp.advanced_event_selectors[0].field_selectors #=> Array
|
@@ -766,10 +771,10 @@ module Aws::CloudTrail
|
|
766
771
|
# such as IAM to the log files.
|
767
772
|
#
|
768
773
|
# @option params [Boolean] :is_multi_region_trail
|
769
|
-
# Specifies whether the trail is created in the current
|
770
|
-
#
|
771
|
-
#
|
772
|
-
# trails that log events in all
|
774
|
+
# Specifies whether the trail is created in the current Region or in all
|
775
|
+
# Regions. The default is false, which creates a trail only in the
|
776
|
+
# Region where you are signed in. As a best practice, consider creating
|
777
|
+
# trails that log events in all Regions.
|
773
778
|
#
|
774
779
|
# @option params [Boolean] :enable_log_file_validation
|
775
780
|
# Specifies whether log file integrity validation is enabled. The
|
@@ -980,10 +985,10 @@ module Aws::CloudTrail
|
|
980
985
|
req.send_request(options)
|
981
986
|
end
|
982
987
|
|
983
|
-
# Deletes a trail. This operation must be called from the
|
988
|
+
# Deletes a trail. This operation must be called from the Region in
|
984
989
|
# which the trail was created. `DeleteTrail` cannot be called on the
|
985
|
-
# shadow trails (replicated trails in other
|
986
|
-
# enabled in all
|
990
|
+
# shadow trails (replicated trails in other Regions) of a trail that is
|
991
|
+
# enabled in all Regions.
|
987
992
|
#
|
988
993
|
# @option params [required, String] :name
|
989
994
|
# Specifies the name or the CloudTrail ARN of the trail to be deleted.
|
@@ -1085,7 +1090,7 @@ module Aws::CloudTrail
|
|
1085
1090
|
end
|
1086
1091
|
|
1087
1092
|
# Retrieves settings for one or more trails associated with the current
|
1088
|
-
#
|
1093
|
+
# Region for your account.
|
1089
1094
|
#
|
1090
1095
|
# @option params [Array<String>] :trail_name_list
|
1091
1096
|
# Specifies a list of trail names, trail ARNs, or both, of the trails to
|
@@ -1094,29 +1099,29 @@ module Aws::CloudTrail
|
|
1094
1099
|
# `arn:aws:cloudtrail:us-east-2:123456789012:trail/MyTrail`
|
1095
1100
|
#
|
1096
1101
|
# If an empty list is specified, information for the trail in the
|
1097
|
-
# current
|
1102
|
+
# current Region is returned.
|
1098
1103
|
#
|
1099
1104
|
# * If an empty list is specified and `IncludeShadowTrails` is false,
|
1100
|
-
# then information for all trails in the current
|
1105
|
+
# then information for all trails in the current Region is returned.
|
1101
1106
|
#
|
1102
1107
|
# * If an empty list is specified and IncludeShadowTrails is null or
|
1103
|
-
# true, then information for all trails in the current
|
1104
|
-
# associated shadow trails in other
|
1108
|
+
# true, then information for all trails in the current Region and any
|
1109
|
+
# associated shadow trails in other Regions is returned.
|
1105
1110
|
#
|
1106
1111
|
# <note markdown="1"> If one or more trail names are specified, information is returned only
|
1107
1112
|
# if the names match the names of trails belonging only to the current
|
1108
|
-
#
|
1109
|
-
# another
|
1113
|
+
# Region and current account. To return information about a trail in
|
1114
|
+
# another Region, you must specify its trail ARN.
|
1110
1115
|
#
|
1111
1116
|
# </note>
|
1112
1117
|
#
|
1113
1118
|
# @option params [Boolean] :include_shadow_trails
|
1114
1119
|
# Specifies whether to include shadow trails in the response. A shadow
|
1115
|
-
# trail is the replication in a
|
1116
|
-
# different
|
1120
|
+
# trail is the replication in a Region of a trail that was created in a
|
1121
|
+
# different Region, or in the case of an organization trail, the
|
1117
1122
|
# replication of an organization trail in member accounts. If you do not
|
1118
1123
|
# include shadow trails, organization trails in a member account and
|
1119
|
-
#
|
1124
|
+
# Region replication trails will not be returned. The default is true.
|
1120
1125
|
#
|
1121
1126
|
# @return [Types::DescribeTrailsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
1122
1127
|
#
|
@@ -1249,7 +1254,7 @@ module Aws::CloudTrail
|
|
1249
1254
|
#
|
1250
1255
|
# resp.event_data_store_arn #=> String
|
1251
1256
|
# resp.name #=> String
|
1252
|
-
# resp.status #=> String, one of "CREATED", "ENABLED", "PENDING_DELETION"
|
1257
|
+
# resp.status #=> String, one of "CREATED", "ENABLED", "PENDING_DELETION", "STARTING_INGESTION", "STOPPING_INGESTION", "STOPPED_INGESTION"
|
1253
1258
|
# resp.advanced_event_selectors #=> Array
|
1254
1259
|
# resp.advanced_event_selectors[0].name #=> String
|
1255
1260
|
# resp.advanced_event_selectors[0].field_selectors #=> Array
|
@@ -1627,14 +1632,14 @@ module Aws::CloudTrail
|
|
1627
1632
|
# Returns a JSON-formatted list of information about the specified
|
1628
1633
|
# trail. Fields include information on delivery errors, Amazon SNS and
|
1629
1634
|
# Amazon S3 errors, and start and stop logging times for each trail.
|
1630
|
-
# This operation returns trail status from a single
|
1631
|
-
# trail status from all
|
1632
|
-
#
|
1635
|
+
# This operation returns trail status from a single Region. To return
|
1636
|
+
# trail status from all Regions, you must call the operation on each
|
1637
|
+
# Region.
|
1633
1638
|
#
|
1634
1639
|
# @option params [required, String] :name
|
1635
1640
|
# Specifies the name or the CloudTrail ARN of the trail for which you
|
1636
1641
|
# are requesting status. To get the status of a shadow trail (a
|
1637
|
-
# replication of the trail in another
|
1642
|
+
# replication of the trail in another Region), you must specify its ARN.
|
1638
1643
|
# The following is the format of a trail ARN.
|
1639
1644
|
#
|
1640
1645
|
# `arn:aws:cloudtrail:us-east-2:123456789012:trail/MyTrail`
|
@@ -1737,7 +1742,7 @@ module Aws::CloudTrail
|
|
1737
1742
|
end
|
1738
1743
|
|
1739
1744
|
# Returns information about all event data stores in the account, in the
|
1740
|
-
# current
|
1745
|
+
# current Region.
|
1741
1746
|
#
|
1742
1747
|
# @option params [String] :next_token
|
1743
1748
|
# A token you can use to get the next page of event data store results.
|
@@ -1765,7 +1770,7 @@ module Aws::CloudTrail
|
|
1765
1770
|
# resp.event_data_stores[0].event_data_store_arn #=> String
|
1766
1771
|
# resp.event_data_stores[0].name #=> String
|
1767
1772
|
# resp.event_data_stores[0].termination_protection_enabled #=> Boolean
|
1768
|
-
# resp.event_data_stores[0].status #=> String, one of "CREATED", "ENABLED", "PENDING_DELETION"
|
1773
|
+
# resp.event_data_stores[0].status #=> String, one of "CREATED", "ENABLED", "PENDING_DELETION", "STARTING_INGESTION", "STOPPING_INGESTION", "STOPPED_INGESTION"
|
1769
1774
|
# resp.event_data_stores[0].advanced_event_selectors #=> Array
|
1770
1775
|
# resp.event_data_stores[0].advanced_event_selectors[0].name #=> String
|
1771
1776
|
# resp.event_data_stores[0].advanced_event_selectors[0].field_selectors #=> Array
|
@@ -1899,10 +1904,10 @@ module Aws::CloudTrail
|
|
1899
1904
|
# to validate digest files that were signed with its corresponding
|
1900
1905
|
# private key.
|
1901
1906
|
#
|
1902
|
-
# <note markdown="1"> CloudTrail uses different private and public key pairs per
|
1903
|
-
# Each digest file is signed with a private key unique to its
|
1904
|
-
# When you validate a digest file from a specific
|
1905
|
-
# in the same
|
1907
|
+
# <note markdown="1"> CloudTrail uses different private and public key pairs per Region.
|
1908
|
+
# Each digest file is signed with a private key unique to its Region.
|
1909
|
+
# When you validate a digest file from a specific Region, you must look
|
1910
|
+
# in the same Region for its corresponding public key.
|
1906
1911
|
#
|
1907
1912
|
# </note>
|
1908
1913
|
#
|
@@ -2017,13 +2022,22 @@ module Aws::CloudTrail
|
|
2017
2022
|
req.send_request(options)
|
2018
2023
|
end
|
2019
2024
|
|
2020
|
-
# Lists the tags for the
|
2021
|
-
# current
|
2025
|
+
# Lists the tags for the specified trails, event data stores, or
|
2026
|
+
# channels in the current Region.
|
2022
2027
|
#
|
2023
2028
|
# @option params [required, Array<String>] :resource_id_list
|
2024
2029
|
# Specifies a list of trail, event data store, or channel ARNs whose
|
2025
2030
|
# tags will be listed. The list has a limit of 20 ARNs.
|
2026
2031
|
#
|
2032
|
+
# Example trail ARN format:
|
2033
|
+
# `arn:aws:cloudtrail:us-east-2:123456789012:trail/MyTrail`
|
2034
|
+
#
|
2035
|
+
# Example event data store ARN format:
|
2036
|
+
# `arn:aws:cloudtrail:us-east-2:123456789012:eventdatastore/EXAMPLE-f852-4e8f-8bd1-bcf6cEXAMPLE`
|
2037
|
+
#
|
2038
|
+
# Example channel ARN format:
|
2039
|
+
# `arn:aws:cloudtrail:us-east-2:123456789012:channel/01234567890`
|
2040
|
+
#
|
2027
2041
|
# @option params [String] :next_token
|
2028
2042
|
# Reserved for future use.
|
2029
2043
|
#
|
@@ -2100,7 +2114,7 @@ module Aws::CloudTrail
|
|
2100
2114
|
|
2101
2115
|
# Looks up [management events][1] or [CloudTrail Insights events][2]
|
2102
2116
|
# that are captured by CloudTrail. You can look up events that occurred
|
2103
|
-
# in a
|
2117
|
+
# in a Region within the last 90 days. Lookup supports the following
|
2104
2118
|
# attributes for management events:
|
2105
2119
|
#
|
2106
2120
|
# * Amazon Web Services access key
|
@@ -2132,7 +2146,7 @@ module Aws::CloudTrail
|
|
2132
2146
|
# you can use to get the next page of results.
|
2133
2147
|
#
|
2134
2148
|
# The rate of lookup requests is limited to two per second, per account,
|
2135
|
-
# per
|
2149
|
+
# per Region. If this limit is exceeded, a throttling error occurs.
|
2136
2150
|
#
|
2137
2151
|
#
|
2138
2152
|
#
|
@@ -2252,7 +2266,7 @@ module Aws::CloudTrail
|
|
2252
2266
|
# 5. The `GetConsoleOutput` is a read-only event that doesn't match
|
2253
2267
|
# your event selector. The trail doesn't log the event.
|
2254
2268
|
#
|
2255
|
-
# The `PutEventSelectors` operation must be called from the
|
2269
|
+
# The `PutEventSelectors` operation must be called from the Region in
|
2256
2270
|
# which the trail was created; otherwise, an
|
2257
2271
|
# `InvalidHomeRegionException` exception is thrown.
|
2258
2272
|
#
|
@@ -2545,7 +2559,7 @@ module Aws::CloudTrail
|
|
2545
2559
|
# `arn:aws:cloudtrail:us-east-2:123456789012:trail/MyTrail`
|
2546
2560
|
#
|
2547
2561
|
# Example event data store ARN format:
|
2548
|
-
# `arn:aws:cloudtrail:us-east-2:
|
2562
|
+
# `arn:aws:cloudtrail:us-east-2:123456789012:eventdatastore/EXAMPLE-f852-4e8f-8bd1-bcf6cEXAMPLE`
|
2549
2563
|
#
|
2550
2564
|
# Example channel ARN format:
|
2551
2565
|
# `arn:aws:cloudtrail:us-east-2:123456789012:channel/01234567890`
|
@@ -2610,7 +2624,7 @@ module Aws::CloudTrail
|
|
2610
2624
|
#
|
2611
2625
|
# resp.event_data_store_arn #=> String
|
2612
2626
|
# resp.name #=> String
|
2613
|
-
# resp.status #=> String, one of "CREATED", "ENABLED", "PENDING_DELETION"
|
2627
|
+
# resp.status #=> String, one of "CREATED", "ENABLED", "PENDING_DELETION", "STARTING_INGESTION", "STOPPING_INGESTION", "STOPPED_INGESTION"
|
2614
2628
|
# resp.advanced_event_selectors #=> Array
|
2615
2629
|
# resp.advanced_event_selectors[0].name #=> String
|
2616
2630
|
# resp.advanced_event_selectors[0].field_selectors #=> Array
|
@@ -2644,6 +2658,32 @@ module Aws::CloudTrail
|
|
2644
2658
|
req.send_request(options)
|
2645
2659
|
end
|
2646
2660
|
|
2661
|
+
# Starts the ingestion of live events on an event data store specified
|
2662
|
+
# as either an ARN or the ID portion of the ARN. To start ingestion, the
|
2663
|
+
# event data store `Status` must be `STOPPED_INGESTION` and the
|
2664
|
+
# `eventCategory` must be `Management`, `Data`, or `ConfigurationItem`.
|
2665
|
+
#
|
2666
|
+
# @option params [required, String] :event_data_store
|
2667
|
+
# The ARN (or ID suffix of the ARN) of the event data store for which
|
2668
|
+
# you want to start ingestion.
|
2669
|
+
#
|
2670
|
+
# @return [Struct] Returns an empty {Seahorse::Client::Response response}.
|
2671
|
+
#
|
2672
|
+
# @example Request syntax with placeholder values
|
2673
|
+
#
|
2674
|
+
# resp = client.start_event_data_store_ingestion({
|
2675
|
+
# event_data_store: "EventDataStoreArn", # required
|
2676
|
+
# })
|
2677
|
+
#
|
2678
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/StartEventDataStoreIngestion AWS API Documentation
|
2679
|
+
#
|
2680
|
+
# @overload start_event_data_store_ingestion(params = {})
|
2681
|
+
# @param [Hash] params ({})
|
2682
|
+
def start_event_data_store_ingestion(params = {}, options = {})
|
2683
|
+
req = build_request(:start_event_data_store_ingestion, params)
|
2684
|
+
req.send_request(options)
|
2685
|
+
end
|
2686
|
+
|
2647
2687
|
# Starts an import of logged trail events from a source S3 bucket to a
|
2648
2688
|
# destination event data store. By default, CloudTrail only imports
|
2649
2689
|
# events contained in the S3 bucket's `CloudTrail` prefix and the
|
@@ -2751,11 +2791,11 @@ module Aws::CloudTrail
|
|
2751
2791
|
end
|
2752
2792
|
|
2753
2793
|
# Starts the recording of Amazon Web Services API calls and log file
|
2754
|
-
# delivery for a trail. For a trail that is enabled in all
|
2755
|
-
# operation must be called from the
|
2794
|
+
# delivery for a trail. For a trail that is enabled in all Regions, this
|
2795
|
+
# operation must be called from the Region in which the trail was
|
2756
2796
|
# created. This operation cannot be called on the shadow trails
|
2757
|
-
# (replicated trails in other
|
2758
|
-
#
|
2797
|
+
# (replicated trails in other Regions) of a trail that is enabled in all
|
2798
|
+
# Regions.
|
2759
2799
|
#
|
2760
2800
|
# @option params [required, String] :name
|
2761
2801
|
# Specifies the name or the CloudTrail ARN of the trail for which
|
@@ -2816,6 +2856,32 @@ module Aws::CloudTrail
|
|
2816
2856
|
req.send_request(options)
|
2817
2857
|
end
|
2818
2858
|
|
2859
|
+
# Stops the ingestion of live events on an event data store specified as
|
2860
|
+
# either an ARN or the ID portion of the ARN. To stop ingestion, the
|
2861
|
+
# event data store `Status` must be `ENABLED` and the `eventCategory`
|
2862
|
+
# must be `Management`, `Data`, or `ConfigurationItem`.
|
2863
|
+
#
|
2864
|
+
# @option params [required, String] :event_data_store
|
2865
|
+
# The ARN (or ID suffix of the ARN) of the event data store for which
|
2866
|
+
# you want to stop ingestion.
|
2867
|
+
#
|
2868
|
+
# @return [Struct] Returns an empty {Seahorse::Client::Response response}.
|
2869
|
+
#
|
2870
|
+
# @example Request syntax with placeholder values
|
2871
|
+
#
|
2872
|
+
# resp = client.stop_event_data_store_ingestion({
|
2873
|
+
# event_data_store: "EventDataStoreArn", # required
|
2874
|
+
# })
|
2875
|
+
#
|
2876
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/StopEventDataStoreIngestion AWS API Documentation
|
2877
|
+
#
|
2878
|
+
# @overload stop_event_data_store_ingestion(params = {})
|
2879
|
+
# @param [Hash] params ({})
|
2880
|
+
def stop_event_data_store_ingestion(params = {}, options = {})
|
2881
|
+
req = build_request(:stop_event_data_store_ingestion, params)
|
2882
|
+
req.send_request(options)
|
2883
|
+
end
|
2884
|
+
|
2819
2885
|
# Stops a specified import.
|
2820
2886
|
#
|
2821
2887
|
# @option params [required, String] :import_id
|
@@ -2871,11 +2937,11 @@ module Aws::CloudTrail
|
|
2871
2937
|
# delivery for the specified trail. Under most circumstances, there is
|
2872
2938
|
# no need to use this action. You can update a trail without stopping it
|
2873
2939
|
# first. This action is the only way to stop recording. For a trail
|
2874
|
-
# enabled in all
|
2940
|
+
# enabled in all Regions, this operation must be called from the Region
|
2875
2941
|
# in which the trail was created, or an `InvalidHomeRegionException`
|
2876
2942
|
# will occur. This operation cannot be called on the shadow trails
|
2877
|
-
# (replicated trails in other
|
2878
|
-
#
|
2943
|
+
# (replicated trails in other Regions) of a trail enabled in all
|
2944
|
+
# Regions.
|
2879
2945
|
#
|
2880
2946
|
# @option params [required, String] :name
|
2881
2947
|
# Specifies the name or the CloudTrail ARN of the trail for which
|
@@ -2981,7 +3047,7 @@ module Aws::CloudTrail
|
|
2981
3047
|
#
|
2982
3048
|
# @option params [Boolean] :multi_region_enabled
|
2983
3049
|
# Specifies whether an event data store collects events from all
|
2984
|
-
#
|
3050
|
+
# Regions, or only from the Region in which it was created.
|
2985
3051
|
#
|
2986
3052
|
# @option params [Boolean] :organization_enabled
|
2987
3053
|
# Specifies whether an event data store collects events logged for an
|
@@ -3072,7 +3138,7 @@ module Aws::CloudTrail
|
|
3072
3138
|
#
|
3073
3139
|
# resp.event_data_store_arn #=> String
|
3074
3140
|
# resp.name #=> String
|
3075
|
-
# resp.status #=> String, one of "CREATED", "ENABLED", "PENDING_DELETION"
|
3141
|
+
# resp.status #=> String, one of "CREATED", "ENABLED", "PENDING_DELETION", "STARTING_INGESTION", "STOPPING_INGESTION", "STOPPED_INGESTION"
|
3076
3142
|
# resp.advanced_event_selectors #=> Array
|
3077
3143
|
# resp.advanced_event_selectors[0].name #=> String
|
3078
3144
|
# resp.advanced_event_selectors[0].field_selectors #=> Array
|
@@ -3111,7 +3177,7 @@ module Aws::CloudTrail
|
|
3111
3177
|
# the CloudTrail service. Use this action to designate an existing
|
3112
3178
|
# bucket for log delivery. If the existing bucket has previously been a
|
3113
3179
|
# target for CloudTrail log files, an IAM policy exists for the bucket.
|
3114
|
-
# `UpdateTrail` must be called from the
|
3180
|
+
# `UpdateTrail` must be called from the Region in which the trail was
|
3115
3181
|
# created; otherwise, an `InvalidHomeRegionException` is thrown.
|
3116
3182
|
#
|
3117
3183
|
# @option params [required, String] :name
|
@@ -3161,14 +3227,14 @@ module Aws::CloudTrail
|
|
3161
3227
|
# such as IAM to the log files.
|
3162
3228
|
#
|
3163
3229
|
# @option params [Boolean] :is_multi_region_trail
|
3164
|
-
# Specifies whether the trail applies only to the current
|
3165
|
-
# all
|
3166
|
-
# current
|
3167
|
-
# (replications of the trail) will be created in the other
|
3168
|
-
# the trail exists in all
|
3169
|
-
# trail will remain in the
|
3170
|
-
# trails in other
|
3171
|
-
# using trails that log events in all
|
3230
|
+
# Specifies whether the trail applies only to the current Region or to
|
3231
|
+
# all Regions. The default is false. If the trail exists only in the
|
3232
|
+
# current Region and this value is set to true, shadow trails
|
3233
|
+
# (replications of the trail) will be created in the other Regions. If
|
3234
|
+
# the trail exists in all Regions and this value is set to false, the
|
3235
|
+
# trail will remain in the Region where it was created, and its shadow
|
3236
|
+
# trails in other Regions will be deleted. As a best practice, consider
|
3237
|
+
# using trails that log events in all Regions.
|
3172
3238
|
#
|
3173
3239
|
# @option params [Boolean] :enable_log_file_validation
|
3174
3240
|
# Specifies whether log file validation is enabled. The default is
|
@@ -3306,7 +3372,7 @@ module Aws::CloudTrail
|
|
3306
3372
|
params: params,
|
3307
3373
|
config: config)
|
3308
3374
|
context[:gem_name] = 'aws-sdk-cloudtrail'
|
3309
|
-
context[:gem_version] = '1.
|
3375
|
+
context[:gem_version] = '1.61.0'
|
3310
3376
|
Seahorse::Client::Request.new(handlers, context)
|
3311
3377
|
end
|
3312
3378
|
|
@@ -250,12 +250,16 @@ module Aws::CloudTrail
|
|
250
250
|
SelectorName = Shapes::StringShape.new(name: 'SelectorName')
|
251
251
|
Source = Shapes::StringShape.new(name: 'Source')
|
252
252
|
SourceConfig = Shapes::StructureShape.new(name: 'SourceConfig')
|
253
|
+
StartEventDataStoreIngestionRequest = Shapes::StructureShape.new(name: 'StartEventDataStoreIngestionRequest')
|
254
|
+
StartEventDataStoreIngestionResponse = Shapes::StructureShape.new(name: 'StartEventDataStoreIngestionResponse')
|
253
255
|
StartImportRequest = Shapes::StructureShape.new(name: 'StartImportRequest')
|
254
256
|
StartImportResponse = Shapes::StructureShape.new(name: 'StartImportResponse')
|
255
257
|
StartLoggingRequest = Shapes::StructureShape.new(name: 'StartLoggingRequest')
|
256
258
|
StartLoggingResponse = Shapes::StructureShape.new(name: 'StartLoggingResponse')
|
257
259
|
StartQueryRequest = Shapes::StructureShape.new(name: 'StartQueryRequest')
|
258
260
|
StartQueryResponse = Shapes::StructureShape.new(name: 'StartQueryResponse')
|
261
|
+
StopEventDataStoreIngestionRequest = Shapes::StructureShape.new(name: 'StopEventDataStoreIngestionRequest')
|
262
|
+
StopEventDataStoreIngestionResponse = Shapes::StructureShape.new(name: 'StopEventDataStoreIngestionResponse')
|
259
263
|
StopImportRequest = Shapes::StructureShape.new(name: 'StopImportRequest')
|
260
264
|
StopImportResponse = Shapes::StructureShape.new(name: 'StopImportResponse')
|
261
265
|
StopLoggingRequest = Shapes::StructureShape.new(name: 'StopLoggingRequest')
|
@@ -372,6 +376,7 @@ module Aws::CloudTrail
|
|
372
376
|
CreateEventDataStoreRequest.add_member(:termination_protection_enabled, Shapes::ShapeRef.new(shape: TerminationProtectionEnabled, location_name: "TerminationProtectionEnabled"))
|
373
377
|
CreateEventDataStoreRequest.add_member(:tags_list, Shapes::ShapeRef.new(shape: TagsList, location_name: "TagsList"))
|
374
378
|
CreateEventDataStoreRequest.add_member(:kms_key_id, Shapes::ShapeRef.new(shape: EventDataStoreKmsKeyId, location_name: "KmsKeyId"))
|
379
|
+
CreateEventDataStoreRequest.add_member(:start_ingestion, Shapes::ShapeRef.new(shape: Boolean, location_name: "StartIngestion"))
|
375
380
|
CreateEventDataStoreRequest.struct_class = Types::CreateEventDataStoreRequest
|
376
381
|
|
377
382
|
CreateEventDataStoreResponse.add_member(:event_data_store_arn, Shapes::ShapeRef.new(shape: EventDataStoreArn, location_name: "EventDataStoreArn"))
|
@@ -978,6 +983,11 @@ module Aws::CloudTrail
|
|
978
983
|
SourceConfig.add_member(:advanced_event_selectors, Shapes::ShapeRef.new(shape: AdvancedEventSelectors, location_name: "AdvancedEventSelectors"))
|
979
984
|
SourceConfig.struct_class = Types::SourceConfig
|
980
985
|
|
986
|
+
StartEventDataStoreIngestionRequest.add_member(:event_data_store, Shapes::ShapeRef.new(shape: EventDataStoreArn, required: true, location_name: "EventDataStore"))
|
987
|
+
StartEventDataStoreIngestionRequest.struct_class = Types::StartEventDataStoreIngestionRequest
|
988
|
+
|
989
|
+
StartEventDataStoreIngestionResponse.struct_class = Types::StartEventDataStoreIngestionResponse
|
990
|
+
|
981
991
|
StartImportRequest.add_member(:destinations, Shapes::ShapeRef.new(shape: ImportDestinations, location_name: "Destinations"))
|
982
992
|
StartImportRequest.add_member(:import_source, Shapes::ShapeRef.new(shape: ImportSource, location_name: "ImportSource"))
|
983
993
|
StartImportRequest.add_member(:start_event_time, Shapes::ShapeRef.new(shape: Date, location_name: "StartEventTime"))
|
@@ -1007,6 +1017,11 @@ module Aws::CloudTrail
|
|
1007
1017
|
StartQueryResponse.add_member(:query_id, Shapes::ShapeRef.new(shape: UUID, location_name: "QueryId"))
|
1008
1018
|
StartQueryResponse.struct_class = Types::StartQueryResponse
|
1009
1019
|
|
1020
|
+
StopEventDataStoreIngestionRequest.add_member(:event_data_store, Shapes::ShapeRef.new(shape: EventDataStoreArn, required: true, location_name: "EventDataStore"))
|
1021
|
+
StopEventDataStoreIngestionRequest.struct_class = Types::StopEventDataStoreIngestionRequest
|
1022
|
+
|
1023
|
+
StopEventDataStoreIngestionResponse.struct_class = Types::StopEventDataStoreIngestionResponse
|
1024
|
+
|
1010
1025
|
StopImportRequest.add_member(:import_id, Shapes::ShapeRef.new(shape: UUID, required: true, location_name: "ImportId"))
|
1011
1026
|
StopImportRequest.struct_class = Types::StopImportRequest
|
1012
1027
|
|
@@ -1814,6 +1829,24 @@ module Aws::CloudTrail
|
|
1814
1829
|
o.errors << Shapes::ShapeRef.new(shape: OrganizationNotInAllFeaturesModeException)
|
1815
1830
|
end)
|
1816
1831
|
|
1832
|
+
api.add_operation(:start_event_data_store_ingestion, Seahorse::Model::Operation.new.tap do |o|
|
1833
|
+
o.name = "StartEventDataStoreIngestion"
|
1834
|
+
o.http_method = "POST"
|
1835
|
+
o.http_request_uri = "/"
|
1836
|
+
o.input = Shapes::ShapeRef.new(shape: StartEventDataStoreIngestionRequest)
|
1837
|
+
o.output = Shapes::ShapeRef.new(shape: StartEventDataStoreIngestionResponse)
|
1838
|
+
o.errors << Shapes::ShapeRef.new(shape: EventDataStoreARNInvalidException)
|
1839
|
+
o.errors << Shapes::ShapeRef.new(shape: EventDataStoreNotFoundException)
|
1840
|
+
o.errors << Shapes::ShapeRef.new(shape: InvalidEventDataStoreStatusException)
|
1841
|
+
o.errors << Shapes::ShapeRef.new(shape: InvalidParameterException)
|
1842
|
+
o.errors << Shapes::ShapeRef.new(shape: InvalidEventDataStoreCategoryException)
|
1843
|
+
o.errors << Shapes::ShapeRef.new(shape: OperationNotPermittedException)
|
1844
|
+
o.errors << Shapes::ShapeRef.new(shape: UnsupportedOperationException)
|
1845
|
+
o.errors << Shapes::ShapeRef.new(shape: NotOrganizationMasterAccountException)
|
1846
|
+
o.errors << Shapes::ShapeRef.new(shape: NoManagementAccountSLRExistsException)
|
1847
|
+
o.errors << Shapes::ShapeRef.new(shape: InsufficientDependencyServiceAccessPermissionException)
|
1848
|
+
end)
|
1849
|
+
|
1817
1850
|
api.add_operation(:start_import, Seahorse::Model::Operation.new.tap do |o|
|
1818
1851
|
o.name = "StartImport"
|
1819
1852
|
o.http_method = "POST"
|
@@ -1876,6 +1909,24 @@ module Aws::CloudTrail
|
|
1876
1909
|
o.errors << Shapes::ShapeRef.new(shape: NoManagementAccountSLRExistsException)
|
1877
1910
|
end)
|
1878
1911
|
|
1912
|
+
api.add_operation(:stop_event_data_store_ingestion, Seahorse::Model::Operation.new.tap do |o|
|
1913
|
+
o.name = "StopEventDataStoreIngestion"
|
1914
|
+
o.http_method = "POST"
|
1915
|
+
o.http_request_uri = "/"
|
1916
|
+
o.input = Shapes::ShapeRef.new(shape: StopEventDataStoreIngestionRequest)
|
1917
|
+
o.output = Shapes::ShapeRef.new(shape: StopEventDataStoreIngestionResponse)
|
1918
|
+
o.errors << Shapes::ShapeRef.new(shape: EventDataStoreARNInvalidException)
|
1919
|
+
o.errors << Shapes::ShapeRef.new(shape: EventDataStoreNotFoundException)
|
1920
|
+
o.errors << Shapes::ShapeRef.new(shape: InvalidEventDataStoreStatusException)
|
1921
|
+
o.errors << Shapes::ShapeRef.new(shape: InvalidParameterException)
|
1922
|
+
o.errors << Shapes::ShapeRef.new(shape: InvalidEventDataStoreCategoryException)
|
1923
|
+
o.errors << Shapes::ShapeRef.new(shape: OperationNotPermittedException)
|
1924
|
+
o.errors << Shapes::ShapeRef.new(shape: UnsupportedOperationException)
|
1925
|
+
o.errors << Shapes::ShapeRef.new(shape: NotOrganizationMasterAccountException)
|
1926
|
+
o.errors << Shapes::ShapeRef.new(shape: NoManagementAccountSLRExistsException)
|
1927
|
+
o.errors << Shapes::ShapeRef.new(shape: InsufficientDependencyServiceAccessPermissionException)
|
1928
|
+
end)
|
1929
|
+
|
1879
1930
|
api.add_operation(:stop_import, Seahorse::Model::Operation.new.tap do |o|
|
1880
1931
|
o.name = "StopImport"
|
1881
1932
|
o.http_method = "POST"
|
@@ -515,6 +515,20 @@ module Aws::CloudTrail
|
|
515
515
|
end
|
516
516
|
end
|
517
517
|
|
518
|
+
class StartEventDataStoreIngestion
|
519
|
+
def self.build(context)
|
520
|
+
unless context.config.regional_endpoint
|
521
|
+
endpoint = context.config.endpoint.to_s
|
522
|
+
end
|
523
|
+
Aws::CloudTrail::EndpointParameters.new(
|
524
|
+
region: context.config.region,
|
525
|
+
use_dual_stack: context.config.use_dualstack_endpoint,
|
526
|
+
use_fips: context.config.use_fips_endpoint,
|
527
|
+
endpoint: endpoint,
|
528
|
+
)
|
529
|
+
end
|
530
|
+
end
|
531
|
+
|
518
532
|
class StartImport
|
519
533
|
def self.build(context)
|
520
534
|
unless context.config.regional_endpoint
|
@@ -557,6 +571,20 @@ module Aws::CloudTrail
|
|
557
571
|
end
|
558
572
|
end
|
559
573
|
|
574
|
+
class StopEventDataStoreIngestion
|
575
|
+
def self.build(context)
|
576
|
+
unless context.config.regional_endpoint
|
577
|
+
endpoint = context.config.endpoint.to_s
|
578
|
+
end
|
579
|
+
Aws::CloudTrail::EndpointParameters.new(
|
580
|
+
region: context.config.region,
|
581
|
+
use_dual_stack: context.config.use_dualstack_endpoint,
|
582
|
+
use_fips: context.config.use_fips_endpoint,
|
583
|
+
endpoint: endpoint,
|
584
|
+
)
|
585
|
+
end
|
586
|
+
end
|
587
|
+
|
560
588
|
class StopImport
|
561
589
|
def self.build(context)
|
562
590
|
unless context.config.regional_endpoint
|
@@ -128,12 +128,16 @@ module Aws::CloudTrail
|
|
128
128
|
Aws::CloudTrail::Endpoints::RemoveTags.build(context)
|
129
129
|
when :restore_event_data_store
|
130
130
|
Aws::CloudTrail::Endpoints::RestoreEventDataStore.build(context)
|
131
|
+
when :start_event_data_store_ingestion
|
132
|
+
Aws::CloudTrail::Endpoints::StartEventDataStoreIngestion.build(context)
|
131
133
|
when :start_import
|
132
134
|
Aws::CloudTrail::Endpoints::StartImport.build(context)
|
133
135
|
when :start_logging
|
134
136
|
Aws::CloudTrail::Endpoints::StartLogging.build(context)
|
135
137
|
when :start_query
|
136
138
|
Aws::CloudTrail::Endpoints::StartQuery.build(context)
|
139
|
+
when :stop_event_data_store_ingestion
|
140
|
+
Aws::CloudTrail::Endpoints::StopEventDataStoreIngestion.build(context)
|
137
141
|
when :stop_import
|
138
142
|
Aws::CloudTrail::Endpoints::StopImport.build(context)
|
139
143
|
when :stop_logging
|
@@ -48,7 +48,7 @@ module Aws::CloudTrail
|
|
48
48
|
# `arn:aws:cloudtrail:us-east-2:123456789012:trail/MyTrail`
|
49
49
|
#
|
50
50
|
# The format of an event data store ARN is:
|
51
|
-
# `arn:aws:cloudtrail:us-east-2:
|
51
|
+
# `arn:aws:cloudtrail:us-east-2:123456789012:eventdatastore/EXAMPLE-f852-4e8f-8bd1-bcf6cEXAMPLE`
|
52
52
|
#
|
53
53
|
# The format of a channel ARN is:
|
54
54
|
# `arn:aws:cloudtrail:us-east-2:123456789012:channel/01234567890`
|
@@ -510,7 +510,7 @@ module Aws::CloudTrail
|
|
510
510
|
# not valid.
|
511
511
|
#
|
512
512
|
# The following is the format of an event data store ARN:
|
513
|
-
# `arn:aws:cloudtrail:us-east-2:
|
513
|
+
# `arn:aws:cloudtrail:us-east-2:123456789012:eventdatastore/EXAMPLE-f852-4e8f-8bd1-bcf6cEXAMPLE`
|
514
514
|
#
|
515
515
|
# The following is the format of a channel ARN:
|
516
516
|
# `arn:aws:cloudtrail:us-east-2:123456789012:channel/01234567890`
|
@@ -542,7 +542,7 @@ module Aws::CloudTrail
|
|
542
542
|
#
|
543
543
|
class CloudTrailInvalidClientTokenIdException < Aws::EmptyStructure; end
|
544
544
|
|
545
|
-
# Cannot set a CloudWatch Logs delivery for this
|
545
|
+
# Cannot set a CloudWatch Logs delivery for this Region.
|
546
546
|
#
|
547
547
|
# @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/CloudWatchLogsDeliveryUnavailableException AWS API Documentation
|
548
548
|
#
|
@@ -663,7 +663,7 @@ module Aws::CloudTrail
|
|
663
663
|
#
|
664
664
|
# @!attribute [rw] multi_region_enabled
|
665
665
|
# Specifies whether the event data store includes events from all
|
666
|
-
#
|
666
|
+
# Regions, or only from the Region in which the event data store is
|
667
667
|
# created.
|
668
668
|
# @return [Boolean]
|
669
669
|
#
|
@@ -721,6 +721,11 @@ module Aws::CloudTrail
|
|
721
721
|
# [1]: https://docs.aws.amazon.com/kms/latest/developerguide/multi-region-keys-overview.html
|
722
722
|
# @return [String]
|
723
723
|
#
|
724
|
+
# @!attribute [rw] start_ingestion
|
725
|
+
# Specifies whether the event data store should start ingesting live
|
726
|
+
# events. The default is true.
|
727
|
+
# @return [Boolean]
|
728
|
+
#
|
724
729
|
# @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/CreateEventDataStoreRequest AWS API Documentation
|
725
730
|
#
|
726
731
|
class CreateEventDataStoreRequest < Struct.new(
|
@@ -731,7 +736,8 @@ module Aws::CloudTrail
|
|
731
736
|
:retention_period,
|
732
737
|
:termination_protection_enabled,
|
733
738
|
:tags_list,
|
734
|
-
:kms_key_id
|
739
|
+
:kms_key_id,
|
740
|
+
:start_ingestion)
|
735
741
|
SENSITIVE = []
|
736
742
|
include Aws::Structure
|
737
743
|
end
|
@@ -755,7 +761,7 @@ module Aws::CloudTrail
|
|
755
761
|
#
|
756
762
|
# @!attribute [rw] multi_region_enabled
|
757
763
|
# Indicates whether the event data store collects events from all
|
758
|
-
#
|
764
|
+
# Regions, or only from the Region in which it was created.
|
759
765
|
# @return [Boolean]
|
760
766
|
#
|
761
767
|
# @!attribute [rw] organization_enabled
|
@@ -863,10 +869,10 @@ module Aws::CloudTrail
|
|
863
869
|
# @return [Boolean]
|
864
870
|
#
|
865
871
|
# @!attribute [rw] is_multi_region_trail
|
866
|
-
# Specifies whether the trail is created in the current
|
867
|
-
# all
|
868
|
-
#
|
869
|
-
# creating trails that log events in all
|
872
|
+
# Specifies whether the trail is created in the current Region or in
|
873
|
+
# all Regions. The default is false, which creates a trail only in the
|
874
|
+
# Region where you are signed in. As a best practice, consider
|
875
|
+
# creating trails that log events in all Regions.
|
870
876
|
# @return [Boolean]
|
871
877
|
#
|
872
878
|
# @!attribute [rw] enable_log_file_validation
|
@@ -998,7 +1004,7 @@ module Aws::CloudTrail
|
|
998
1004
|
# @return [Boolean]
|
999
1005
|
#
|
1000
1006
|
# @!attribute [rw] is_multi_region_trail
|
1001
|
-
# Specifies whether the trail exists in one
|
1007
|
+
# Specifies whether the trail exists in one Region or in all Regions.
|
1002
1008
|
# @return [Boolean]
|
1003
1009
|
#
|
1004
1010
|
# @!attribute [rw] trail_arn
|
@@ -1396,30 +1402,30 @@ module Aws::CloudTrail
|
|
1396
1402
|
# `arn:aws:cloudtrail:us-east-2:123456789012:trail/MyTrail`
|
1397
1403
|
#
|
1398
1404
|
# If an empty list is specified, information for the trail in the
|
1399
|
-
# current
|
1405
|
+
# current Region is returned.
|
1400
1406
|
#
|
1401
1407
|
# * If an empty list is specified and `IncludeShadowTrails` is false,
|
1402
|
-
# then information for all trails in the current
|
1408
|
+
# then information for all trails in the current Region is returned.
|
1403
1409
|
#
|
1404
1410
|
# * If an empty list is specified and IncludeShadowTrails is null or
|
1405
|
-
# true, then information for all trails in the current
|
1406
|
-
# any associated shadow trails in other
|
1411
|
+
# true, then information for all trails in the current Region and
|
1412
|
+
# any associated shadow trails in other Regions is returned.
|
1407
1413
|
#
|
1408
1414
|
# <note markdown="1"> If one or more trail names are specified, information is returned
|
1409
1415
|
# only if the names match the names of trails belonging only to the
|
1410
|
-
# current
|
1411
|
-
# trail in another
|
1416
|
+
# current Region and current account. To return information about a
|
1417
|
+
# trail in another Region, you must specify its trail ARN.
|
1412
1418
|
#
|
1413
1419
|
# </note>
|
1414
1420
|
# @return [Array<String>]
|
1415
1421
|
#
|
1416
1422
|
# @!attribute [rw] include_shadow_trails
|
1417
1423
|
# Specifies whether to include shadow trails in the response. A shadow
|
1418
|
-
# trail is the replication in a
|
1419
|
-
# a different
|
1424
|
+
# trail is the replication in a Region of a trail that was created in
|
1425
|
+
# a different Region, or in the case of an organization trail, the
|
1420
1426
|
# replication of an organization trail in member accounts. If you do
|
1421
1427
|
# not include shadow trails, organization trails in a member account
|
1422
|
-
# and
|
1428
|
+
# and Region replication trails will not be returned. The default is
|
1423
1429
|
# true.
|
1424
1430
|
# @return [Boolean]
|
1425
1431
|
#
|
@@ -1560,8 +1566,7 @@ module Aws::CloudTrail
|
|
1560
1566
|
# @return [Boolean]
|
1561
1567
|
#
|
1562
1568
|
# @!attribute [rw] status
|
1563
|
-
# The status of an event data store.
|
1564
|
-
# `PENDING_DELETION`.
|
1569
|
+
# The status of an event data store.
|
1565
1570
|
# @return [String]
|
1566
1571
|
#
|
1567
1572
|
# @!attribute [rw] advanced_event_selectors
|
@@ -1571,7 +1576,7 @@ module Aws::CloudTrail
|
|
1571
1576
|
#
|
1572
1577
|
# @!attribute [rw] multi_region_enabled
|
1573
1578
|
# Indicates whether the event data store includes events from all
|
1574
|
-
#
|
1579
|
+
# Regions, or only from the Region in which it was created.
|
1575
1580
|
# @return [Boolean]
|
1576
1581
|
#
|
1577
1582
|
# @!attribute [rw] organization_enabled
|
@@ -1683,7 +1688,7 @@ module Aws::CloudTrail
|
|
1683
1688
|
#
|
1684
1689
|
# The first copy of management events is free. You are charged for
|
1685
1690
|
# additional copies of management events that you are logging on any
|
1686
|
-
# subsequent trail in the same
|
1691
|
+
# subsequent trail in the same Region. For more information about
|
1687
1692
|
# CloudTrail pricing, see [CloudTrail Pricing][2].
|
1688
1693
|
#
|
1689
1694
|
#
|
@@ -1717,7 +1722,7 @@ module Aws::CloudTrail
|
|
1717
1722
|
# `kms.amazonaws.com` or `rdsdata.amazonaws.com`. By default,
|
1718
1723
|
# `ExcludeManagementEventSources` is empty, and KMS and Amazon RDS
|
1719
1724
|
# Data API events are logged to your trail. You can exclude management
|
1720
|
-
# event sources only in
|
1725
|
+
# event sources only in Regions that support the event source.
|
1721
1726
|
# @return [Array<String>]
|
1722
1727
|
#
|
1723
1728
|
# @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/EventSelector AWS API Documentation
|
@@ -1761,8 +1766,8 @@ module Aws::CloudTrail
|
|
1761
1766
|
#
|
1762
1767
|
# @!attribute [rw] source_config
|
1763
1768
|
# Provides information about the advanced event selectors configured
|
1764
|
-
# for the channel, and whether the channel applies to all
|
1765
|
-
# single
|
1769
|
+
# for the channel, and whether the channel applies to all Regions or a
|
1770
|
+
# single Region.
|
1766
1771
|
# @return [Types::SourceConfig]
|
1767
1772
|
#
|
1768
1773
|
# @!attribute [rw] destinations
|
@@ -1813,8 +1818,7 @@ module Aws::CloudTrail
|
|
1813
1818
|
# @return [String]
|
1814
1819
|
#
|
1815
1820
|
# @!attribute [rw] status
|
1816
|
-
# The status of an event data store.
|
1817
|
-
# `PENDING_DELETION`.
|
1821
|
+
# The status of an event data store.
|
1818
1822
|
# @return [String]
|
1819
1823
|
#
|
1820
1824
|
# @!attribute [rw] advanced_event_selectors
|
@@ -1824,7 +1828,7 @@ module Aws::CloudTrail
|
|
1824
1828
|
#
|
1825
1829
|
# @!attribute [rw] multi_region_enabled
|
1826
1830
|
# Indicates whether the event data store includes events from all
|
1827
|
-
#
|
1831
|
+
# Regions, or only from the Region in which it was created.
|
1828
1832
|
# @return [Boolean]
|
1829
1833
|
#
|
1830
1834
|
# @!attribute [rw] organization_enabled
|
@@ -2172,7 +2176,7 @@ module Aws::CloudTrail
|
|
2172
2176
|
# @!attribute [rw] name
|
2173
2177
|
# Specifies the name or the CloudTrail ARN of the trail for which you
|
2174
2178
|
# are requesting status. To get the status of a shadow trail (a
|
2175
|
-
# replication of the trail in another
|
2179
|
+
# replication of the trail in another Region), you must specify its
|
2176
2180
|
# ARN. The following is the format of a trail ARN.
|
2177
2181
|
#
|
2178
2182
|
# `arn:aws:cloudtrail:us-east-2:123456789012:trail/MyTrail`
|
@@ -2641,7 +2645,7 @@ module Aws::CloudTrail
|
|
2641
2645
|
class InvalidEventSelectorsException < Aws::EmptyStructure; end
|
2642
2646
|
|
2643
2647
|
# This exception is thrown when an operation is called on a trail from a
|
2644
|
-
#
|
2648
|
+
# Region other than the Region in which the trail was created.
|
2645
2649
|
#
|
2646
2650
|
# @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/InvalidHomeRegionException AWS API Documentation
|
2647
2651
|
#
|
@@ -2802,9 +2806,9 @@ module Aws::CloudTrail
|
|
2802
2806
|
class KmsKeyDisabledException < Aws::EmptyStructure; end
|
2803
2807
|
|
2804
2808
|
# This exception is thrown when the KMS key does not exist, when the S3
|
2805
|
-
# bucket and the KMS key are not in the same
|
2809
|
+
# bucket and the KMS key are not in the same Region, or when the KMS key
|
2806
2810
|
# associated with the Amazon SNS topic either does not exist or is not
|
2807
|
-
# in the same
|
2811
|
+
# in the same Region.
|
2808
2812
|
#
|
2809
2813
|
# @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/KmsKeyNotFoundException AWS API Documentation
|
2810
2814
|
#
|
@@ -2871,7 +2875,7 @@ module Aws::CloudTrail
|
|
2871
2875
|
|
2872
2876
|
# @!attribute [rw] event_data_stores
|
2873
2877
|
# Contains information about event data stores in the account, in the
|
2874
|
-
# current
|
2878
|
+
# current Region.
|
2875
2879
|
# @return [Array<Types::EventDataStore>]
|
2876
2880
|
#
|
2877
2881
|
# @!attribute [rw] next_token
|
@@ -3087,6 +3091,15 @@ module Aws::CloudTrail
|
|
3087
3091
|
# @!attribute [rw] resource_id_list
|
3088
3092
|
# Specifies a list of trail, event data store, or channel ARNs whose
|
3089
3093
|
# tags will be listed. The list has a limit of 20 ARNs.
|
3094
|
+
#
|
3095
|
+
# Example trail ARN format:
|
3096
|
+
# `arn:aws:cloudtrail:us-east-2:123456789012:trail/MyTrail`
|
3097
|
+
#
|
3098
|
+
# Example event data store ARN format:
|
3099
|
+
# `arn:aws:cloudtrail:us-east-2:123456789012:eventdatastore/EXAMPLE-f852-4e8f-8bd1-bcf6cEXAMPLE`
|
3100
|
+
#
|
3101
|
+
# Example channel ARN format:
|
3102
|
+
# `arn:aws:cloudtrail:us-east-2:123456789012:channel/01234567890`
|
3090
3103
|
# @return [Array<String>]
|
3091
3104
|
#
|
3092
3105
|
# @!attribute [rw] next_token
|
@@ -3140,7 +3153,7 @@ module Aws::CloudTrail
|
|
3140
3153
|
end
|
3141
3154
|
|
3142
3155
|
# @!attribute [rw] trails
|
3143
|
-
# Returns the name, ARN, and home
|
3156
|
+
# Returns the name, ARN, and home Region of trails in the current
|
3144
3157
|
# account.
|
3145
3158
|
# @return [Array<Types::TrailInfo>]
|
3146
3159
|
#
|
@@ -3663,7 +3676,7 @@ module Aws::CloudTrail
|
|
3663
3676
|
# `arn:aws:cloudtrail:us-east-2:123456789012:trail/MyTrail`
|
3664
3677
|
#
|
3665
3678
|
# Example event data store ARN format:
|
3666
|
-
# `arn:aws:cloudtrail:us-east-2:
|
3679
|
+
# `arn:aws:cloudtrail:us-east-2:123456789012:eventdatastore/EXAMPLE-f852-4e8f-8bd1-bcf6cEXAMPLE`
|
3667
3680
|
#
|
3668
3681
|
# Example channel ARN format:
|
3669
3682
|
# `arn:aws:cloudtrail:us-east-2:123456789012:channel/01234567890`
|
@@ -3817,7 +3830,7 @@ module Aws::CloudTrail
|
|
3817
3830
|
#
|
3818
3831
|
# @!attribute [rw] multi_region_enabled
|
3819
3832
|
# Indicates whether the event data store is collecting events from all
|
3820
|
-
#
|
3833
|
+
# Regions, or only from the Region in which the event data store was
|
3821
3834
|
# created.
|
3822
3835
|
# @return [Boolean]
|
3823
3836
|
#
|
@@ -3884,7 +3897,7 @@ module Aws::CloudTrail
|
|
3884
3897
|
# @return [String]
|
3885
3898
|
#
|
3886
3899
|
# @!attribute [rw] s3_bucket_region
|
3887
|
-
# The
|
3900
|
+
# The Region associated with the source S3 bucket.
|
3888
3901
|
# @return [String]
|
3889
3902
|
#
|
3890
3903
|
# @!attribute [rw] s3_bucket_access_role_arn
|
@@ -3904,8 +3917,8 @@ module Aws::CloudTrail
|
|
3904
3917
|
# Contains configuration information about the channel.
|
3905
3918
|
#
|
3906
3919
|
# @!attribute [rw] apply_to_all_regions
|
3907
|
-
# Specifies whether the channel applies to a single
|
3908
|
-
#
|
3920
|
+
# Specifies whether the channel applies to a single Region or to all
|
3921
|
+
# Regions.
|
3909
3922
|
# @return [Boolean]
|
3910
3923
|
#
|
3911
3924
|
# @!attribute [rw] advanced_event_selectors
|
@@ -3921,6 +3934,23 @@ module Aws::CloudTrail
|
|
3921
3934
|
include Aws::Structure
|
3922
3935
|
end
|
3923
3936
|
|
3937
|
+
# @!attribute [rw] event_data_store
|
3938
|
+
# The ARN (or ID suffix of the ARN) of the event data store for which
|
3939
|
+
# you want to start ingestion.
|
3940
|
+
# @return [String]
|
3941
|
+
#
|
3942
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/StartEventDataStoreIngestionRequest AWS API Documentation
|
3943
|
+
#
|
3944
|
+
class StartEventDataStoreIngestionRequest < Struct.new(
|
3945
|
+
:event_data_store)
|
3946
|
+
SENSITIVE = []
|
3947
|
+
include Aws::Structure
|
3948
|
+
end
|
3949
|
+
|
3950
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/StartEventDataStoreIngestionResponse AWS API Documentation
|
3951
|
+
#
|
3952
|
+
class StartEventDataStoreIngestionResponse < Aws::EmptyStructure; end
|
3953
|
+
|
3924
3954
|
# @!attribute [rw] destinations
|
3925
3955
|
# The ARN of the destination event data store. Use this parameter for
|
3926
3956
|
# a new import.
|
@@ -4075,6 +4105,23 @@ module Aws::CloudTrail
|
|
4075
4105
|
include Aws::Structure
|
4076
4106
|
end
|
4077
4107
|
|
4108
|
+
# @!attribute [rw] event_data_store
|
4109
|
+
# The ARN (or ID suffix of the ARN) of the event data store for which
|
4110
|
+
# you want to stop ingestion.
|
4111
|
+
# @return [String]
|
4112
|
+
#
|
4113
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/StopEventDataStoreIngestionRequest AWS API Documentation
|
4114
|
+
#
|
4115
|
+
class StopEventDataStoreIngestionRequest < Struct.new(
|
4116
|
+
:event_data_store)
|
4117
|
+
SENSITIVE = []
|
4118
|
+
include Aws::Structure
|
4119
|
+
end
|
4120
|
+
|
4121
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/StopEventDataStoreIngestionResponse AWS API Documentation
|
4122
|
+
#
|
4123
|
+
class StopEventDataStoreIngestionResponse < Aws::EmptyStructure; end
|
4124
|
+
|
4078
4125
|
# @!attribute [rw] import_id
|
4079
4126
|
# The ID of the import.
|
4080
4127
|
# @return [String]
|
@@ -4244,12 +4291,12 @@ module Aws::CloudTrail
|
|
4244
4291
|
# @return [Boolean]
|
4245
4292
|
#
|
4246
4293
|
# @!attribute [rw] is_multi_region_trail
|
4247
|
-
# Specifies whether the trail exists only in one
|
4248
|
-
# all
|
4294
|
+
# Specifies whether the trail exists only in one Region or exists in
|
4295
|
+
# all Regions.
|
4249
4296
|
# @return [Boolean]
|
4250
4297
|
#
|
4251
4298
|
# @!attribute [rw] home_region
|
4252
|
-
# The
|
4299
|
+
# The Region in which the trail was created.
|
4253
4300
|
# @return [String]
|
4254
4301
|
#
|
4255
4302
|
# @!attribute [rw] trail_arn
|
@@ -4324,7 +4371,7 @@ module Aws::CloudTrail
|
|
4324
4371
|
class TrailAlreadyExistsException < Aws::EmptyStructure; end
|
4325
4372
|
|
4326
4373
|
# Information about a CloudTrail trail, including the trail's name,
|
4327
|
-
# home
|
4374
|
+
# home Region, and Amazon Resource Name (ARN).
|
4328
4375
|
#
|
4329
4376
|
# @!attribute [rw] trail_arn
|
4330
4377
|
# The ARN of a trail.
|
@@ -4436,7 +4483,7 @@ module Aws::CloudTrail
|
|
4436
4483
|
#
|
4437
4484
|
# @!attribute [rw] multi_region_enabled
|
4438
4485
|
# Specifies whether an event data store collects events from all
|
4439
|
-
#
|
4486
|
+
# Regions, or only from the Region in which it was created.
|
4440
4487
|
# @return [Boolean]
|
4441
4488
|
#
|
4442
4489
|
# @!attribute [rw] organization_enabled
|
@@ -4511,8 +4558,7 @@ module Aws::CloudTrail
|
|
4511
4558
|
# @return [String]
|
4512
4559
|
#
|
4513
4560
|
# @!attribute [rw] status
|
4514
|
-
# The status of an event data store.
|
4515
|
-
# `PENDING_DELETION`.
|
4561
|
+
# The status of an event data store.
|
4516
4562
|
# @return [String]
|
4517
4563
|
#
|
4518
4564
|
# @!attribute [rw] advanced_event_selectors
|
@@ -4522,7 +4568,7 @@ module Aws::CloudTrail
|
|
4522
4568
|
#
|
4523
4569
|
# @!attribute [rw] multi_region_enabled
|
4524
4570
|
# Indicates whether the event data store includes events from all
|
4525
|
-
#
|
4571
|
+
# Regions, or only from the Region in which it was created.
|
4526
4572
|
# @return [Boolean]
|
4527
4573
|
#
|
4528
4574
|
# @!attribute [rw] organization_enabled
|
@@ -4629,14 +4675,14 @@ module Aws::CloudTrail
|
|
4629
4675
|
# @return [Boolean]
|
4630
4676
|
#
|
4631
4677
|
# @!attribute [rw] is_multi_region_trail
|
4632
|
-
# Specifies whether the trail applies only to the current
|
4633
|
-
# all
|
4634
|
-
# current
|
4635
|
-
# (replications of the trail) will be created in the other
|
4636
|
-
# the trail exists in all
|
4637
|
-
# trail will remain in the
|
4638
|
-
# trails in other
|
4639
|
-
# consider using trails that log events in all
|
4678
|
+
# Specifies whether the trail applies only to the current Region or to
|
4679
|
+
# all Regions. The default is false. If the trail exists only in the
|
4680
|
+
# current Region and this value is set to true, shadow trails
|
4681
|
+
# (replications of the trail) will be created in the other Regions. If
|
4682
|
+
# the trail exists in all Regions and this value is set to false, the
|
4683
|
+
# trail will remain in the Region where it was created, and its shadow
|
4684
|
+
# trails in other Regions will be deleted. As a best practice,
|
4685
|
+
# consider using trails that log events in all Regions.
|
4640
4686
|
# @return [Boolean]
|
4641
4687
|
#
|
4642
4688
|
# @!attribute [rw] enable_log_file_validation
|
@@ -4768,7 +4814,7 @@ module Aws::CloudTrail
|
|
4768
4814
|
# @return [Boolean]
|
4769
4815
|
#
|
4770
4816
|
# @!attribute [rw] is_multi_region_trail
|
4771
|
-
# Specifies whether the trail exists in one
|
4817
|
+
# Specifies whether the trail exists in one Region or in all Regions.
|
4772
4818
|
# @return [Boolean]
|
4773
4819
|
#
|
4774
4820
|
# @!attribute [rw] trail_arn
|
data/lib/aws-sdk-cloudtrail.rb
CHANGED
metadata
CHANGED
@@ -1,14 +1,14 @@
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
2
2
|
name: aws-sdk-cloudtrail
|
3
3
|
version: !ruby/object:Gem::Version
|
4
|
-
version: 1.
|
4
|
+
version: 1.61.0
|
5
5
|
platform: ruby
|
6
6
|
authors:
|
7
7
|
- Amazon Web Services
|
8
8
|
autorequire:
|
9
9
|
bindir: bin
|
10
10
|
cert_chain: []
|
11
|
-
date: 2023-
|
11
|
+
date: 2023-06-02 00:00:00.000000000 Z
|
12
12
|
dependencies:
|
13
13
|
- !ruby/object:Gem::Dependency
|
14
14
|
name: aws-sdk-core
|