aws-sdk-cloudtrail 1.60.0 → 1.61.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 +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
|