aws-sdk-cloudtrail 1.59.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: 91008a974e6b25be4a7e3d19899a3f68aa46e4d81e34615d935d34593c587a60
4
- data.tar.gz: 1f89fb0da80a4f41caa95933ce9e803445857e0724762f7ccda50d3a06656b25
3
+ metadata.gz: 552835fa9020cb2d845ab5481ac3f5af7e7ca56e948f52fa8fa528197bdd97d4
4
+ data.tar.gz: 59b0f1f716909d88d66027ee4e7dc9327bf4734a5e767305b79a987a8ab574b6
5
5
  SHA512:
6
- metadata.gz: e43c850ed7cb2f27e74f63211f5ab72ed5a8f2dc9dc33cd2151b6ee49e48196ea760f81b77c9a35b5a792474ad82394f29714d570a223ca11a4ca6b30cc33127
7
- data.tar.gz: a6b091b701364f02209ca14bcea90783a56f09b2a87beadbfd2d36d4c87fa8930ad1d420c762f0e08bec9aa7d50a297e928e6ec8c9ef4af2a3fc6504fcdb59b9
6
+ metadata.gz: 3bcb544e6d7feb0e1bfd113c898ab21526fc81913ff25fc21e6d4f202446ff18f409d24b8af686712ae12ee57a64b5301560e062bc6ef3efe297e0bcb42e035e
7
+ data.tar.gz: 07c077d084804f3c62c7203e20c076982b72f188482ab68375c842aff70be01c220f6bfc31c41c7bdc0dd1d89df830e60308ca1eae131bc8954ebe4026262eff
data/CHANGELOG.md CHANGED
@@ -1,6 +1,16 @@
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
+
9
+ 1.60.0 (2023-05-31)
10
+ ------------------
11
+
12
+ * Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
13
+
4
14
  1.59.0 (2023-05-18)
5
15
  ------------------
6
16
 
data/VERSION CHANGED
@@ -1 +1 @@
1
- 1.59.0
1
+ 1.61.0
@@ -275,6 +275,11 @@ module Aws::CloudTrail
275
275
  # in the future.
276
276
  #
277
277
  #
278
+ # @option options [String] :sdk_ua_app_id
279
+ # A unique and opaque application ID that is appended to the
280
+ # User-Agent header as app/<sdk_ua_app_id>. It should have a
281
+ # maximum length of 50.
282
+ #
278
283
  # @option options [String] :secret_access_key
279
284
  #
280
285
  # @option options [String] :session_token
@@ -386,7 +391,7 @@ module Aws::CloudTrail
386
391
  # specified key and a value of null. You can tag a trail or event data
387
392
  # store that applies to all Amazon Web Services Regions only from the
388
393
  # Region in which the trail or event data store was created (also known
389
- # as its home region).
394
+ # as its home Region).
390
395
  #
391
396
  # @option params [required, String] :resource_id
392
397
  # Specifies the ARN of the trail, event data store, or channel to which
@@ -396,7 +401,7 @@ module Aws::CloudTrail
396
401
  # `arn:aws:cloudtrail:us-east-2:123456789012:trail/MyTrail`
397
402
  #
398
403
  # The format of an event data store ARN is:
399
- # `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`
400
405
  #
401
406
  # The format of a channel ARN is:
402
407
  # `arn:aws:cloudtrail:us-east-2:123456789012:channel/01234567890`
@@ -575,7 +580,7 @@ module Aws::CloudTrail
575
580
  #
576
581
  # @option params [Boolean] :multi_region_enabled
577
582
  # Specifies whether the event data store includes events from all
578
- # 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
579
584
  # created.
580
585
  #
581
586
  # @option params [Boolean] :organization_enabled
@@ -626,6 +631,10 @@ module Aws::CloudTrail
626
631
  #
627
632
  # [1]: https://docs.aws.amazon.com/kms/latest/developerguide/multi-region-keys-overview.html
628
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
+ #
629
638
  # @return [Types::CreateEventDataStoreResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
630
639
  #
631
640
  # * {Types::CreateEventDataStoreResponse#event_data_store_arn #event_data_store_arn} => String
@@ -672,13 +681,14 @@ module Aws::CloudTrail
672
681
  # },
673
682
  # ],
674
683
  # kms_key_id: "EventDataStoreKmsKeyId",
684
+ # start_ingestion: false,
675
685
  # })
676
686
  #
677
687
  # @example Response structure
678
688
  #
679
689
  # resp.event_data_store_arn #=> String
680
690
  # resp.name #=> String
681
- # 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"
682
692
  # resp.advanced_event_selectors #=> Array
683
693
  # resp.advanced_event_selectors[0].name #=> String
684
694
  # resp.advanced_event_selectors[0].field_selectors #=> Array
@@ -761,10 +771,10 @@ module Aws::CloudTrail
761
771
  # such as IAM to the log files.
762
772
  #
763
773
  # @option params [Boolean] :is_multi_region_trail
764
- # Specifies whether the trail is created in the current region or in all
765
- # regions. The default is false, which creates a trail only in the
766
- # region where you are signed in. As a best practice, consider creating
767
- # 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.
768
778
  #
769
779
  # @option params [Boolean] :enable_log_file_validation
770
780
  # Specifies whether log file integrity validation is enabled. The
@@ -975,10 +985,10 @@ module Aws::CloudTrail
975
985
  req.send_request(options)
976
986
  end
977
987
 
978
- # 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
979
989
  # which the trail was created. `DeleteTrail` cannot be called on the
980
- # shadow trails (replicated trails in other regions) of a trail that is
981
- # enabled in all regions.
990
+ # shadow trails (replicated trails in other Regions) of a trail that is
991
+ # enabled in all Regions.
982
992
  #
983
993
  # @option params [required, String] :name
984
994
  # Specifies the name or the CloudTrail ARN of the trail to be deleted.
@@ -1080,7 +1090,7 @@ module Aws::CloudTrail
1080
1090
  end
1081
1091
 
1082
1092
  # Retrieves settings for one or more trails associated with the current
1083
- # region for your account.
1093
+ # Region for your account.
1084
1094
  #
1085
1095
  # @option params [Array<String>] :trail_name_list
1086
1096
  # Specifies a list of trail names, trail ARNs, or both, of the trails to
@@ -1089,29 +1099,29 @@ module Aws::CloudTrail
1089
1099
  # `arn:aws:cloudtrail:us-east-2:123456789012:trail/MyTrail`
1090
1100
  #
1091
1101
  # If an empty list is specified, information for the trail in the
1092
- # current region is returned.
1102
+ # current Region is returned.
1093
1103
  #
1094
1104
  # * If an empty list is specified and `IncludeShadowTrails` is false,
1095
- # then information for all trails in the current region is returned.
1105
+ # then information for all trails in the current Region is returned.
1096
1106
  #
1097
1107
  # * If an empty list is specified and IncludeShadowTrails is null or
1098
- # true, then information for all trails in the current region and any
1099
- # 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.
1100
1110
  #
1101
1111
  # <note markdown="1"> If one or more trail names are specified, information is returned only
1102
1112
  # if the names match the names of trails belonging only to the current
1103
- # region and current account. To return information about a trail in
1104
- # 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.
1105
1115
  #
1106
1116
  # </note>
1107
1117
  #
1108
1118
  # @option params [Boolean] :include_shadow_trails
1109
1119
  # Specifies whether to include shadow trails in the response. A shadow
1110
- # trail is the replication in a region of a trail that was created in a
1111
- # 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
1112
1122
  # replication of an organization trail in member accounts. If you do not
1113
1123
  # include shadow trails, organization trails in a member account and
1114
- # region replication trails will not be returned. The default is true.
1124
+ # Region replication trails will not be returned. The default is true.
1115
1125
  #
1116
1126
  # @return [Types::DescribeTrailsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1117
1127
  #
@@ -1244,7 +1254,7 @@ module Aws::CloudTrail
1244
1254
  #
1245
1255
  # resp.event_data_store_arn #=> String
1246
1256
  # resp.name #=> String
1247
- # 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"
1248
1258
  # resp.advanced_event_selectors #=> Array
1249
1259
  # resp.advanced_event_selectors[0].name #=> String
1250
1260
  # resp.advanced_event_selectors[0].field_selectors #=> Array
@@ -1622,14 +1632,14 @@ module Aws::CloudTrail
1622
1632
  # Returns a JSON-formatted list of information about the specified
1623
1633
  # trail. Fields include information on delivery errors, Amazon SNS and
1624
1634
  # Amazon S3 errors, and start and stop logging times for each trail.
1625
- # This operation returns trail status from a single region. To return
1626
- # trail status from all regions, you must call the operation on each
1627
- # 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.
1628
1638
  #
1629
1639
  # @option params [required, String] :name
1630
1640
  # Specifies the name or the CloudTrail ARN of the trail for which you
1631
1641
  # are requesting status. To get the status of a shadow trail (a
1632
- # 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.
1633
1643
  # The following is the format of a trail ARN.
1634
1644
  #
1635
1645
  # `arn:aws:cloudtrail:us-east-2:123456789012:trail/MyTrail`
@@ -1732,7 +1742,7 @@ module Aws::CloudTrail
1732
1742
  end
1733
1743
 
1734
1744
  # Returns information about all event data stores in the account, in the
1735
- # current region.
1745
+ # current Region.
1736
1746
  #
1737
1747
  # @option params [String] :next_token
1738
1748
  # A token you can use to get the next page of event data store results.
@@ -1760,7 +1770,7 @@ module Aws::CloudTrail
1760
1770
  # resp.event_data_stores[0].event_data_store_arn #=> String
1761
1771
  # resp.event_data_stores[0].name #=> String
1762
1772
  # resp.event_data_stores[0].termination_protection_enabled #=> Boolean
1763
- # 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"
1764
1774
  # resp.event_data_stores[0].advanced_event_selectors #=> Array
1765
1775
  # resp.event_data_stores[0].advanced_event_selectors[0].name #=> String
1766
1776
  # resp.event_data_stores[0].advanced_event_selectors[0].field_selectors #=> Array
@@ -1894,10 +1904,10 @@ module Aws::CloudTrail
1894
1904
  # to validate digest files that were signed with its corresponding
1895
1905
  # private key.
1896
1906
  #
1897
- # <note markdown="1"> CloudTrail uses different private and public key pairs per region.
1898
- # Each digest file is signed with a private key unique to its region.
1899
- # When you validate a digest file from a specific region, you must look
1900
- # 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.
1901
1911
  #
1902
1912
  # </note>
1903
1913
  #
@@ -2012,13 +2022,22 @@ module Aws::CloudTrail
2012
2022
  req.send_request(options)
2013
2023
  end
2014
2024
 
2015
- # Lists the tags for the trail, event data store, or channel in the
2016
- # current region.
2025
+ # Lists the tags for the specified trails, event data stores, or
2026
+ # channels in the current Region.
2017
2027
  #
2018
2028
  # @option params [required, Array<String>] :resource_id_list
2019
2029
  # Specifies a list of trail, event data store, or channel ARNs whose
2020
2030
  # tags will be listed. The list has a limit of 20 ARNs.
2021
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
+ #
2022
2041
  # @option params [String] :next_token
2023
2042
  # Reserved for future use.
2024
2043
  #
@@ -2095,7 +2114,7 @@ module Aws::CloudTrail
2095
2114
 
2096
2115
  # Looks up [management events][1] or [CloudTrail Insights events][2]
2097
2116
  # that are captured by CloudTrail. You can look up events that occurred
2098
- # 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
2099
2118
  # attributes for management events:
2100
2119
  #
2101
2120
  # * Amazon Web Services access key
@@ -2127,7 +2146,7 @@ module Aws::CloudTrail
2127
2146
  # you can use to get the next page of results.
2128
2147
  #
2129
2148
  # The rate of lookup requests is limited to two per second, per account,
2130
- # per region. If this limit is exceeded, a throttling error occurs.
2149
+ # per Region. If this limit is exceeded, a throttling error occurs.
2131
2150
  #
2132
2151
  #
2133
2152
  #
@@ -2247,7 +2266,7 @@ module Aws::CloudTrail
2247
2266
  # 5. The `GetConsoleOutput` is a read-only event that doesn't match
2248
2267
  # your event selector. The trail doesn't log the event.
2249
2268
  #
2250
- # The `PutEventSelectors` operation must be called from the region in
2269
+ # The `PutEventSelectors` operation must be called from the Region in
2251
2270
  # which the trail was created; otherwise, an
2252
2271
  # `InvalidHomeRegionException` exception is thrown.
2253
2272
  #
@@ -2540,7 +2559,7 @@ module Aws::CloudTrail
2540
2559
  # `arn:aws:cloudtrail:us-east-2:123456789012:trail/MyTrail`
2541
2560
  #
2542
2561
  # Example event data store ARN format:
2543
- # `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`
2544
2563
  #
2545
2564
  # Example channel ARN format:
2546
2565
  # `arn:aws:cloudtrail:us-east-2:123456789012:channel/01234567890`
@@ -2605,7 +2624,7 @@ module Aws::CloudTrail
2605
2624
  #
2606
2625
  # resp.event_data_store_arn #=> String
2607
2626
  # resp.name #=> String
2608
- # 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"
2609
2628
  # resp.advanced_event_selectors #=> Array
2610
2629
  # resp.advanced_event_selectors[0].name #=> String
2611
2630
  # resp.advanced_event_selectors[0].field_selectors #=> Array
@@ -2639,6 +2658,32 @@ module Aws::CloudTrail
2639
2658
  req.send_request(options)
2640
2659
  end
2641
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
+
2642
2687
  # Starts an import of logged trail events from a source S3 bucket to a
2643
2688
  # destination event data store. By default, CloudTrail only imports
2644
2689
  # events contained in the S3 bucket's `CloudTrail` prefix and the
@@ -2746,11 +2791,11 @@ module Aws::CloudTrail
2746
2791
  end
2747
2792
 
2748
2793
  # Starts the recording of Amazon Web Services API calls and log file
2749
- # delivery for a trail. For a trail that is enabled in all regions, this
2750
- # 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
2751
2796
  # created. This operation cannot be called on the shadow trails
2752
- # (replicated trails in other regions) of a trail that is enabled in all
2753
- # regions.
2797
+ # (replicated trails in other Regions) of a trail that is enabled in all
2798
+ # Regions.
2754
2799
  #
2755
2800
  # @option params [required, String] :name
2756
2801
  # Specifies the name or the CloudTrail ARN of the trail for which
@@ -2811,6 +2856,32 @@ module Aws::CloudTrail
2811
2856
  req.send_request(options)
2812
2857
  end
2813
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
+
2814
2885
  # Stops a specified import.
2815
2886
  #
2816
2887
  # @option params [required, String] :import_id
@@ -2866,11 +2937,11 @@ module Aws::CloudTrail
2866
2937
  # delivery for the specified trail. Under most circumstances, there is
2867
2938
  # no need to use this action. You can update a trail without stopping it
2868
2939
  # first. This action is the only way to stop recording. For a trail
2869
- # 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
2870
2941
  # in which the trail was created, or an `InvalidHomeRegionException`
2871
2942
  # will occur. This operation cannot be called on the shadow trails
2872
- # (replicated trails in other regions) of a trail enabled in all
2873
- # regions.
2943
+ # (replicated trails in other Regions) of a trail enabled in all
2944
+ # Regions.
2874
2945
  #
2875
2946
  # @option params [required, String] :name
2876
2947
  # Specifies the name or the CloudTrail ARN of the trail for which
@@ -2976,7 +3047,7 @@ module Aws::CloudTrail
2976
3047
  #
2977
3048
  # @option params [Boolean] :multi_region_enabled
2978
3049
  # Specifies whether an event data store collects events from all
2979
- # regions, or only from the region in which it was created.
3050
+ # Regions, or only from the Region in which it was created.
2980
3051
  #
2981
3052
  # @option params [Boolean] :organization_enabled
2982
3053
  # Specifies whether an event data store collects events logged for an
@@ -3067,7 +3138,7 @@ module Aws::CloudTrail
3067
3138
  #
3068
3139
  # resp.event_data_store_arn #=> String
3069
3140
  # resp.name #=> String
3070
- # 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"
3071
3142
  # resp.advanced_event_selectors #=> Array
3072
3143
  # resp.advanced_event_selectors[0].name #=> String
3073
3144
  # resp.advanced_event_selectors[0].field_selectors #=> Array
@@ -3106,7 +3177,7 @@ module Aws::CloudTrail
3106
3177
  # the CloudTrail service. Use this action to designate an existing
3107
3178
  # bucket for log delivery. If the existing bucket has previously been a
3108
3179
  # target for CloudTrail log files, an IAM policy exists for the bucket.
3109
- # `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
3110
3181
  # created; otherwise, an `InvalidHomeRegionException` is thrown.
3111
3182
  #
3112
3183
  # @option params [required, String] :name
@@ -3156,14 +3227,14 @@ module Aws::CloudTrail
3156
3227
  # such as IAM to the log files.
3157
3228
  #
3158
3229
  # @option params [Boolean] :is_multi_region_trail
3159
- # Specifies whether the trail applies only to the current region or to
3160
- # all regions. The default is false. If the trail exists only in the
3161
- # current region and this value is set to true, shadow trails
3162
- # (replications of the trail) will be created in the other regions. If
3163
- # the trail exists in all regions and this value is set to false, the
3164
- # trail will remain in the region where it was created, and its shadow
3165
- # trails in other regions will be deleted. As a best practice, consider
3166
- # 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.
3167
3238
  #
3168
3239
  # @option params [Boolean] :enable_log_file_validation
3169
3240
  # Specifies whether log file validation is enabled. The default is
@@ -3301,7 +3372,7 @@ module Aws::CloudTrail
3301
3372
  params: params,
3302
3373
  config: config)
3303
3374
  context[:gem_name] = 'aws-sdk-cloudtrail'
3304
- context[:gem_version] = '1.59.0'
3375
+ context[:gem_version] = '1.61.0'
3305
3376
  Seahorse::Client::Request.new(handlers, context)
3306
3377
  end
3307
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.59.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.59.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-18 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
@@ -19,7 +19,7 @@ dependencies:
19
19
  version: '3'
20
20
  - - ">="
21
21
  - !ruby/object:Gem::Version
22
- version: 3.165.0
22
+ version: 3.174.0
23
23
  type: :runtime
24
24
  prerelease: false
25
25
  version_requirements: !ruby/object:Gem::Requirement
@@ -29,7 +29,7 @@ dependencies:
29
29
  version: '3'
30
30
  - - ">="
31
31
  - !ruby/object:Gem::Version
32
- version: 3.165.0
32
+ version: 3.174.0
33
33
  - !ruby/object:Gem::Dependency
34
34
  name: aws-sigv4
35
35
  requirement: !ruby/object:Gem::Requirement