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 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