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 CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: b16eb92345b21353f92bc9fdda43ec15b2cad387f0b887c225936c6e50e00ffd
4
- data.tar.gz: ddd9b3d1a468c27487a11e8a4e7016b7fd289ebd4b92ce7cb2260fd626b28d91
3
+ metadata.gz: 552835fa9020cb2d845ab5481ac3f5af7e7ca56e948f52fa8fa528197bdd97d4
4
+ data.tar.gz: 59b0f1f716909d88d66027ee4e7dc9327bf4734a5e767305b79a987a8ab574b6
5
5
  SHA512:
6
- metadata.gz: a17f8d9093861fd6f02c62bb8648f366d8f112cb626ee5ecf407d120c4fe4c49c821cb6ad90d49acd89d4f3997f995eb718e1ef827f44c11444105f129f75885
7
- data.tar.gz: 598ce91b01060b113e50152e77eb95a316c6a63fbd1386ec7c84359bf2857cbffe3423e1ca869d64fbfc7760469ddb3eb3be352ad6ab29287ea424395fe56471
6
+ metadata.gz: 3bcb544e6d7feb0e1bfd113c898ab21526fc81913ff25fc21e6d4f202446ff18f409d24b8af686712ae12ee57a64b5301560e062bc6ef3efe297e0bcb42e035e
7
+ data.tar.gz: 07c077d084804f3c62c7203e20c076982b72f188482ab68375c842aff70be01c220f6bfc31c41c7bdc0dd1d89df830e60308ca1eae131bc8954ebe4026262eff
data/CHANGELOG.md CHANGED
@@ -1,6 +1,11 @@
1
1
  Unreleased Changes
2
2
  ------------------
3
3
 
4
+ 1.61.0 (2023-06-02)
5
+ ------------------
6
+
7
+ * Feature - This feature allows users to start and stop event ingestion on a CloudTrail Lake event data store.
8
+
4
9
  1.60.0 (2023-05-31)
5
10
  ------------------
6
11
 
data/VERSION CHANGED
@@ -1 +1 @@
1
- 1.60.0
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 region).
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:12345678910:eventdatastore/EXAMPLE-f852-4e8f-8bd1-bcf6cEXAMPLE`
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
- # regions, or only from the region in which the event data store is
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 region or in all
770
- # regions. The default is false, which creates a trail only in the
771
- # region where you are signed in. As a best practice, consider creating
772
- # trails that log events in all regions.
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 region in
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 regions) of a trail that is
986
- # enabled in all regions.
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
- # region for your account.
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 region is returned.
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 region is returned.
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 region and any
1104
- # associated shadow trails in other regions is returned.
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
- # region and current account. To return information about a trail in
1109
- # another region, you must specify its trail ARN.
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 region of a trail that was created in a
1116
- # different region, or in the case of an organization trail, the
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
- # region replication trails will not be returned. The default is true.
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 region. To return
1631
- # trail status from all regions, you must call the operation on each
1632
- # region.
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 region), you must specify its ARN.
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 region.
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 region.
1903
- # Each digest file is signed with a private key unique to its region.
1904
- # When you validate a digest file from a specific region, you must look
1905
- # in the same region for its corresponding public key.
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 trail, event data store, or channel in the
2021
- # current region.
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 region within the last 90 days. Lookup supports the following
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 region. If this limit is exceeded, a throttling error occurs.
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 region in
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:12345678910:eventdatastore/EXAMPLE-f852-4e8f-8bd1-bcf6cEXAMPLE`
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 regions, this
2755
- # operation must be called from the region in which the trail was
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 regions) of a trail that is enabled in all
2758
- # regions.
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 regions, this operation must be called from the region
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 regions) of a trail enabled in all
2878
- # regions.
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
- # regions, or only from the region in which it was created.
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 region in which the trail was
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 region or to
3165
- # all regions. The default is false. If the trail exists only in the
3166
- # current region and this value is set to true, shadow trails
3167
- # (replications of the trail) will be created in the other regions. If
3168
- # the trail exists in all regions and this value is set to false, the
3169
- # trail will remain in the region where it was created, and its shadow
3170
- # trails in other regions will be deleted. As a best practice, consider
3171
- # using trails that log events in all regions.
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.60.0'
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:12345678910:eventdatastore/EXAMPLE-f852-4e8f-8bd1-bcf6cEXAMPLE`
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:12345678910:eventdatastore/EXAMPLE-f852-4e8f-8bd1-bcf6cEXAMPLE`
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 region.
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
- # regions, or only from the region in which the event data store is
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
- # regions, or only from the region in which it was created.
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 region or in
867
- # all regions. The default is false, which creates a trail only in the
868
- # region where you are signed in. As a best practice, consider
869
- # creating trails that log events in all regions.
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 region or in all regions.
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 region is returned.
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 region is returned.
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 region and
1406
- # any associated shadow trails in other regions is returned.
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 region and current account. To return information about a
1411
- # trail in another region, you must specify its trail ARN.
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 region of a trail that was created in
1419
- # a different region, or in the case of an organization trail, the
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 region replication trails will not be returned. The default is
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. Values are `ENABLED` and
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
- # regions, or only from the region in which it was created.
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 region. For more information about
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 regions that support the event source.
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 regions or a
1765
- # single region.
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. Values can be `ENABLED` and
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
- # regions, or only from the region in which it was created.
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 region), you must specify its
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
- # region other than the region in which the trail was created.
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 region, or when the KMS key
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 region.
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 region.
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 region of trails in the current
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:12345678910:eventdatastore/EXAMPLE-f852-4e8f-8bd1-bcf6cEXAMPLE`
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
- # regions, or only from the region in which the event data store was
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 region associated with the source S3 bucket.
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 region or to all
3908
- # regions.
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 region or exists in
4248
- # all regions.
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 region in which the trail was created.
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 region, and Amazon Resource Name (ARN).
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
- # regions, or only from the region in which it was created.
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. Values can be `ENABLED` and
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
- # regions, or only from the region in which it was created.
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 region or to
4633
- # all regions. The default is false. If the trail exists only in the
4634
- # current region and this value is set to true, shadow trails
4635
- # (replications of the trail) will be created in the other regions. If
4636
- # the trail exists in all regions and this value is set to false, the
4637
- # trail will remain in the region where it was created, and its shadow
4638
- # trails in other regions will be deleted. As a best practice,
4639
- # consider using trails that log events in all regions.
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 region or in all regions.
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
@@ -52,6 +52,6 @@ require_relative 'aws-sdk-cloudtrail/customizations'
52
52
  # @!group service
53
53
  module Aws::CloudTrail
54
54
 
55
- GEM_VERSION = '1.60.0'
55
+ GEM_VERSION = '1.61.0'
56
56
 
57
57
  end
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.60.0
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-05-31 00:00:00.000000000 Z
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