aws-sdk-cloudtrail 1.60.0 → 1.62.0

Sign up to get free protection for your applications and to get access to all the features.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: b16eb92345b21353f92bc9fdda43ec15b2cad387f0b887c225936c6e50e00ffd
4
- data.tar.gz: ddd9b3d1a468c27487a11e8a4e7016b7fd289ebd4b92ce7cb2260fd626b28d91
3
+ metadata.gz: 6240f69b330164bda213408a5ce5ed3d7ba9582b60572b3afa82d109a498cdc6
4
+ data.tar.gz: 0fa14ff83c8ea9aa7c3951825cd20457eb66c566395582805bce412010fd1c2b
5
5
  SHA512:
6
- metadata.gz: a17f8d9093861fd6f02c62bb8648f366d8f112cb626ee5ecf407d120c4fe4c49c821cb6ad90d49acd89d4f3997f995eb718e1ef827f44c11444105f129f75885
7
- data.tar.gz: 598ce91b01060b113e50152e77eb95a316c6a63fbd1386ec7c84359bf2857cbffe3423e1ca869d64fbfc7760469ddb3eb3be352ad6ab29287ea424395fe56471
6
+ metadata.gz: 14045e4930af4b1da780abf31e71d24de607291873435443ed3f4b1c433d34f9ec2745cfae562e5af354d73d579b1dbf05fedba3654274c090612aa423f9833b
7
+ data.tar.gz: 113a4d05421a25631fed6d0cfab5250a51c65f346796418dbd34ba1ec387fb3539ce973e909058a3a3653b4d802fa406ce57d5328e1cbc858d3dee5b4069a482
data/CHANGELOG.md CHANGED
@@ -1,6 +1,16 @@
1
1
  Unreleased Changes
2
2
  ------------------
3
3
 
4
+ 1.62.0 (2023-06-13)
5
+ ------------------
6
+
7
+ * Feature - This feature allows users to view dashboards for CloudTrail Lake event data stores.
8
+
9
+ 1.61.0 (2023-06-02)
10
+ ------------------
11
+
12
+ * Feature - This feature allows users to start and stop event ingestion on a CloudTrail Lake event data store.
13
+
4
14
  1.60.0 (2023-05-31)
5
15
  ------------------
6
16
 
data/VERSION CHANGED
@@ -1 +1 @@
1
- 1.60.0
1
+ 1.62.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.
@@ -1034,16 +1039,23 @@ module Aws::CloudTrail
1034
1039
 
1035
1040
  # Returns metadata about a query, including query run time in
1036
1041
  # milliseconds, number of events scanned and matched, and query status.
1037
- # You must specify an ARN for `EventDataStore`, and a value for
1038
- # `QueryID`.
1042
+ # If the query results were delivered to an S3 bucket, the response also
1043
+ # provides the S3 URI and the delivery status.
1044
+ #
1045
+ # You must specify either a `QueryID` or a `QueryAlias`. Specifying the
1046
+ # `QueryAlias` parameter returns information about the last query run
1047
+ # for the alias.
1039
1048
  #
1040
1049
  # @option params [String] :event_data_store
1041
1050
  # The ARN (or the ID suffix of the ARN) of an event data store on which
1042
1051
  # the specified query was run.
1043
1052
  #
1044
- # @option params [required, String] :query_id
1053
+ # @option params [String] :query_id
1045
1054
  # The query ID.
1046
1055
  #
1056
+ # @option params [String] :query_alias
1057
+ # The alias that identifies a query template.
1058
+ #
1047
1059
  # @return [Types::DescribeQueryResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1048
1060
  #
1049
1061
  # * {Types::DescribeQueryResponse#query_id #query_id} => String
@@ -1058,7 +1070,8 @@ module Aws::CloudTrail
1058
1070
  #
1059
1071
  # resp = client.describe_query({
1060
1072
  # event_data_store: "EventDataStoreArn",
1061
- # query_id: "UUID", # required
1073
+ # query_id: "UUID",
1074
+ # query_alias: "QueryAlias",
1062
1075
  # })
1063
1076
  #
1064
1077
  # @example Response structure
@@ -1085,7 +1098,7 @@ module Aws::CloudTrail
1085
1098
  end
1086
1099
 
1087
1100
  # Retrieves settings for one or more trails associated with the current
1088
- # region for your account.
1101
+ # Region for your account.
1089
1102
  #
1090
1103
  # @option params [Array<String>] :trail_name_list
1091
1104
  # Specifies a list of trail names, trail ARNs, or both, of the trails to
@@ -1094,29 +1107,29 @@ module Aws::CloudTrail
1094
1107
  # `arn:aws:cloudtrail:us-east-2:123456789012:trail/MyTrail`
1095
1108
  #
1096
1109
  # If an empty list is specified, information for the trail in the
1097
- # current region is returned.
1110
+ # current Region is returned.
1098
1111
  #
1099
1112
  # * If an empty list is specified and `IncludeShadowTrails` is false,
1100
- # then information for all trails in the current region is returned.
1113
+ # then information for all trails in the current Region is returned.
1101
1114
  #
1102
1115
  # * 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.
1116
+ # true, then information for all trails in the current Region and any
1117
+ # associated shadow trails in other Regions is returned.
1105
1118
  #
1106
1119
  # <note markdown="1"> If one or more trail names are specified, information is returned only
1107
1120
  # 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.
1121
+ # Region and current account. To return information about a trail in
1122
+ # another Region, you must specify its trail ARN.
1110
1123
  #
1111
1124
  # </note>
1112
1125
  #
1113
1126
  # @option params [Boolean] :include_shadow_trails
1114
1127
  # 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
1128
+ # trail is the replication in a Region of a trail that was created in a
1129
+ # different Region, or in the case of an organization trail, the
1117
1130
  # replication of an organization trail in member accounts. If you do not
1118
1131
  # include shadow trails, organization trails in a member account and
1119
- # region replication trails will not be returned. The default is true.
1132
+ # Region replication trails will not be returned. The default is true.
1120
1133
  #
1121
1134
  # @return [Types::DescribeTrailsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1122
1135
  #
@@ -1249,7 +1262,7 @@ module Aws::CloudTrail
1249
1262
  #
1250
1263
  # resp.event_data_store_arn #=> String
1251
1264
  # resp.name #=> String
1252
- # resp.status #=> String, one of "CREATED", "ENABLED", "PENDING_DELETION"
1265
+ # resp.status #=> String, one of "CREATED", "ENABLED", "PENDING_DELETION", "STARTING_INGESTION", "STOPPING_INGESTION", "STOPPED_INGESTION"
1253
1266
  # resp.advanced_event_selectors #=> Array
1254
1267
  # resp.advanced_event_selectors[0].name #=> String
1255
1268
  # resp.advanced_event_selectors[0].field_selectors #=> Array
@@ -1490,8 +1503,7 @@ module Aws::CloudTrail
1490
1503
  end
1491
1504
 
1492
1505
  # Gets event data results of a query. You must specify the `QueryID`
1493
- # value returned by the `StartQuery` operation, and an ARN for
1494
- # `EventDataStore`.
1506
+ # value returned by the `StartQuery` operation.
1495
1507
  #
1496
1508
  # @option params [String] :event_data_store
1497
1509
  # The ARN (or ID suffix of the ARN) of the event data store against
@@ -1627,14 +1639,14 @@ module Aws::CloudTrail
1627
1639
  # Returns a JSON-formatted list of information about the specified
1628
1640
  # trail. Fields include information on delivery errors, Amazon SNS and
1629
1641
  # 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.
1642
+ # This operation returns trail status from a single Region. To return
1643
+ # trail status from all Regions, you must call the operation on each
1644
+ # Region.
1633
1645
  #
1634
1646
  # @option params [required, String] :name
1635
1647
  # Specifies the name or the CloudTrail ARN of the trail for which you
1636
1648
  # 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.
1649
+ # replication of the trail in another Region), you must specify its ARN.
1638
1650
  # The following is the format of a trail ARN.
1639
1651
  #
1640
1652
  # `arn:aws:cloudtrail:us-east-2:123456789012:trail/MyTrail`
@@ -1737,7 +1749,7 @@ module Aws::CloudTrail
1737
1749
  end
1738
1750
 
1739
1751
  # Returns information about all event data stores in the account, in the
1740
- # current region.
1752
+ # current Region.
1741
1753
  #
1742
1754
  # @option params [String] :next_token
1743
1755
  # A token you can use to get the next page of event data store results.
@@ -1765,7 +1777,7 @@ module Aws::CloudTrail
1765
1777
  # resp.event_data_stores[0].event_data_store_arn #=> String
1766
1778
  # resp.event_data_stores[0].name #=> String
1767
1779
  # resp.event_data_stores[0].termination_protection_enabled #=> Boolean
1768
- # resp.event_data_stores[0].status #=> String, one of "CREATED", "ENABLED", "PENDING_DELETION"
1780
+ # resp.event_data_stores[0].status #=> String, one of "CREATED", "ENABLED", "PENDING_DELETION", "STARTING_INGESTION", "STOPPING_INGESTION", "STOPPED_INGESTION"
1769
1781
  # resp.event_data_stores[0].advanced_event_selectors #=> Array
1770
1782
  # resp.event_data_stores[0].advanced_event_selectors[0].name #=> String
1771
1783
  # resp.event_data_stores[0].advanced_event_selectors[0].field_selectors #=> Array
@@ -1899,10 +1911,10 @@ module Aws::CloudTrail
1899
1911
  # to validate digest files that were signed with its corresponding
1900
1912
  # private key.
1901
1913
  #
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.
1914
+ # <note markdown="1"> CloudTrail uses different private and public key pairs per Region.
1915
+ # Each digest file is signed with a private key unique to its Region.
1916
+ # When you validate a digest file from a specific Region, you must look
1917
+ # in the same Region for its corresponding public key.
1906
1918
  #
1907
1919
  # </note>
1908
1920
  #
@@ -2017,13 +2029,22 @@ module Aws::CloudTrail
2017
2029
  req.send_request(options)
2018
2030
  end
2019
2031
 
2020
- # Lists the tags for the trail, event data store, or channel in the
2021
- # current region.
2032
+ # Lists the tags for the specified trails, event data stores, or
2033
+ # channels in the current Region.
2022
2034
  #
2023
2035
  # @option params [required, Array<String>] :resource_id_list
2024
2036
  # Specifies a list of trail, event data store, or channel ARNs whose
2025
2037
  # tags will be listed. The list has a limit of 20 ARNs.
2026
2038
  #
2039
+ # Example trail ARN format:
2040
+ # `arn:aws:cloudtrail:us-east-2:123456789012:trail/MyTrail`
2041
+ #
2042
+ # Example event data store ARN format:
2043
+ # `arn:aws:cloudtrail:us-east-2:123456789012:eventdatastore/EXAMPLE-f852-4e8f-8bd1-bcf6cEXAMPLE`
2044
+ #
2045
+ # Example channel ARN format:
2046
+ # `arn:aws:cloudtrail:us-east-2:123456789012:channel/01234567890`
2047
+ #
2027
2048
  # @option params [String] :next_token
2028
2049
  # Reserved for future use.
2029
2050
  #
@@ -2100,7 +2121,7 @@ module Aws::CloudTrail
2100
2121
 
2101
2122
  # Looks up [management events][1] or [CloudTrail Insights events][2]
2102
2123
  # 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
2124
+ # in a Region within the last 90 days. Lookup supports the following
2104
2125
  # attributes for management events:
2105
2126
  #
2106
2127
  # * Amazon Web Services access key
@@ -2132,7 +2153,7 @@ module Aws::CloudTrail
2132
2153
  # you can use to get the next page of results.
2133
2154
  #
2134
2155
  # 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.
2156
+ # per Region. If this limit is exceeded, a throttling error occurs.
2136
2157
  #
2137
2158
  #
2138
2159
  #
@@ -2252,7 +2273,7 @@ module Aws::CloudTrail
2252
2273
  # 5. The `GetConsoleOutput` is a read-only event that doesn't match
2253
2274
  # your event selector. The trail doesn't log the event.
2254
2275
  #
2255
- # The `PutEventSelectors` operation must be called from the region in
2276
+ # The `PutEventSelectors` operation must be called from the Region in
2256
2277
  # which the trail was created; otherwise, an
2257
2278
  # `InvalidHomeRegionException` exception is thrown.
2258
2279
  #
@@ -2545,7 +2566,7 @@ module Aws::CloudTrail
2545
2566
  # `arn:aws:cloudtrail:us-east-2:123456789012:trail/MyTrail`
2546
2567
  #
2547
2568
  # Example event data store ARN format:
2548
- # `arn:aws:cloudtrail:us-east-2:12345678910:eventdatastore/EXAMPLE-f852-4e8f-8bd1-bcf6cEXAMPLE`
2569
+ # `arn:aws:cloudtrail:us-east-2:123456789012:eventdatastore/EXAMPLE-f852-4e8f-8bd1-bcf6cEXAMPLE`
2549
2570
  #
2550
2571
  # Example channel ARN format:
2551
2572
  # `arn:aws:cloudtrail:us-east-2:123456789012:channel/01234567890`
@@ -2610,7 +2631,7 @@ module Aws::CloudTrail
2610
2631
  #
2611
2632
  # resp.event_data_store_arn #=> String
2612
2633
  # resp.name #=> String
2613
- # resp.status #=> String, one of "CREATED", "ENABLED", "PENDING_DELETION"
2634
+ # resp.status #=> String, one of "CREATED", "ENABLED", "PENDING_DELETION", "STARTING_INGESTION", "STOPPING_INGESTION", "STOPPED_INGESTION"
2614
2635
  # resp.advanced_event_selectors #=> Array
2615
2636
  # resp.advanced_event_selectors[0].name #=> String
2616
2637
  # resp.advanced_event_selectors[0].field_selectors #=> Array
@@ -2644,6 +2665,32 @@ module Aws::CloudTrail
2644
2665
  req.send_request(options)
2645
2666
  end
2646
2667
 
2668
+ # Starts the ingestion of live events on an event data store specified
2669
+ # as either an ARN or the ID portion of the ARN. To start ingestion, the
2670
+ # event data store `Status` must be `STOPPED_INGESTION` and the
2671
+ # `eventCategory` must be `Management`, `Data`, or `ConfigurationItem`.
2672
+ #
2673
+ # @option params [required, String] :event_data_store
2674
+ # The ARN (or ID suffix of the ARN) of the event data store for which
2675
+ # you want to start ingestion.
2676
+ #
2677
+ # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
2678
+ #
2679
+ # @example Request syntax with placeholder values
2680
+ #
2681
+ # resp = client.start_event_data_store_ingestion({
2682
+ # event_data_store: "EventDataStoreArn", # required
2683
+ # })
2684
+ #
2685
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/StartEventDataStoreIngestion AWS API Documentation
2686
+ #
2687
+ # @overload start_event_data_store_ingestion(params = {})
2688
+ # @param [Hash] params ({})
2689
+ def start_event_data_store_ingestion(params = {}, options = {})
2690
+ req = build_request(:start_event_data_store_ingestion, params)
2691
+ req.send_request(options)
2692
+ end
2693
+
2647
2694
  # Starts an import of logged trail events from a source S3 bucket to a
2648
2695
  # destination event data store. By default, CloudTrail only imports
2649
2696
  # events contained in the S3 bucket's `CloudTrail` prefix and the
@@ -2751,11 +2798,11 @@ module Aws::CloudTrail
2751
2798
  end
2752
2799
 
2753
2800
  # 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
2801
+ # delivery for a trail. For a trail that is enabled in all Regions, this
2802
+ # operation must be called from the Region in which the trail was
2756
2803
  # 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.
2804
+ # (replicated trails in other Regions) of a trail that is enabled in all
2805
+ # Regions.
2759
2806
  #
2760
2807
  # @option params [required, String] :name
2761
2808
  # Specifies the name or the CloudTrail ARN of the trail for which
@@ -2781,17 +2828,28 @@ module Aws::CloudTrail
2781
2828
  req.send_request(options)
2782
2829
  end
2783
2830
 
2784
- # Starts a CloudTrail Lake query. The required `QueryStatement`
2785
- # parameter provides your SQL query, enclosed in single quotation marks.
2786
- # Use the optional `DeliveryS3Uri` parameter to deliver the query
2787
- # results to an S3 bucket.
2831
+ # Starts a CloudTrail Lake query. Use the `QueryStatement` parameter to
2832
+ # provide your SQL query, enclosed in single quotation marks. Use the
2833
+ # optional `DeliveryS3Uri` parameter to deliver the query results to an
2834
+ # S3 bucket.
2788
2835
  #
2789
- # @option params [required, String] :query_statement
2836
+ # `StartQuery` requires you specify either the `QueryStatement`
2837
+ # parameter, or a `QueryAlias` and any `QueryParameters`. In the current
2838
+ # release, the `QueryAlias` and `QueryParameters` parameters are used
2839
+ # only for the queries that populate the CloudTrail Lake dashboards.
2840
+ #
2841
+ # @option params [String] :query_statement
2790
2842
  # The SQL code of your query.
2791
2843
  #
2792
2844
  # @option params [String] :delivery_s3_uri
2793
2845
  # The URI for the S3 bucket where CloudTrail delivers the query results.
2794
2846
  #
2847
+ # @option params [String] :query_alias
2848
+ # The alias that identifies a query template.
2849
+ #
2850
+ # @option params [Array<String>] :query_parameters
2851
+ # The query parameters for the specified `QueryAlias`.
2852
+ #
2795
2853
  # @return [Types::StartQueryResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2796
2854
  #
2797
2855
  # * {Types::StartQueryResponse#query_id #query_id} => String
@@ -2799,8 +2857,10 @@ module Aws::CloudTrail
2799
2857
  # @example Request syntax with placeholder values
2800
2858
  #
2801
2859
  # resp = client.start_query({
2802
- # query_statement: "QueryStatement", # required
2860
+ # query_statement: "QueryStatement",
2803
2861
  # delivery_s3_uri: "DeliveryS3Uri",
2862
+ # query_alias: "QueryAlias",
2863
+ # query_parameters: ["QueryParameter"],
2804
2864
  # })
2805
2865
  #
2806
2866
  # @example Response structure
@@ -2816,6 +2876,32 @@ module Aws::CloudTrail
2816
2876
  req.send_request(options)
2817
2877
  end
2818
2878
 
2879
+ # Stops the ingestion of live events on an event data store specified as
2880
+ # either an ARN or the ID portion of the ARN. To stop ingestion, the
2881
+ # event data store `Status` must be `ENABLED` and the `eventCategory`
2882
+ # must be `Management`, `Data`, or `ConfigurationItem`.
2883
+ #
2884
+ # @option params [required, String] :event_data_store
2885
+ # The ARN (or ID suffix of the ARN) of the event data store for which
2886
+ # you want to stop ingestion.
2887
+ #
2888
+ # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
2889
+ #
2890
+ # @example Request syntax with placeholder values
2891
+ #
2892
+ # resp = client.stop_event_data_store_ingestion({
2893
+ # event_data_store: "EventDataStoreArn", # required
2894
+ # })
2895
+ #
2896
+ # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/StopEventDataStoreIngestion AWS API Documentation
2897
+ #
2898
+ # @overload stop_event_data_store_ingestion(params = {})
2899
+ # @param [Hash] params ({})
2900
+ def stop_event_data_store_ingestion(params = {}, options = {})
2901
+ req = build_request(:stop_event_data_store_ingestion, params)
2902
+ req.send_request(options)
2903
+ end
2904
+
2819
2905
  # Stops a specified import.
2820
2906
  #
2821
2907
  # @option params [required, String] :import_id
@@ -2871,11 +2957,11 @@ module Aws::CloudTrail
2871
2957
  # delivery for the specified trail. Under most circumstances, there is
2872
2958
  # no need to use this action. You can update a trail without stopping it
2873
2959
  # 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
2960
+ # enabled in all Regions, this operation must be called from the Region
2875
2961
  # in which the trail was created, or an `InvalidHomeRegionException`
2876
2962
  # 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.
2963
+ # (replicated trails in other Regions) of a trail enabled in all
2964
+ # Regions.
2879
2965
  #
2880
2966
  # @option params [required, String] :name
2881
2967
  # Specifies the name or the CloudTrail ARN of the trail for which
@@ -2961,12 +3047,16 @@ module Aws::CloudTrail
2961
3047
  # For event data stores for CloudTrail events, `AdvancedEventSelectors`
2962
3048
  # includes or excludes management and data events in your event data
2963
3049
  # store. For more information about `AdvancedEventSelectors`, see
2964
- # PutEventSelectorsRequest$AdvancedEventSelectors.
3050
+ # [AdvancedEventSelectors][1].
2965
3051
  #
2966
3052
  # For event data stores for Config configuration items, Audit Manager
2967
3053
  # evidence, or non-Amazon Web Services events, `AdvancedEventSelectors`
2968
3054
  # includes events of that type in your event data store.
2969
3055
  #
3056
+ #
3057
+ #
3058
+ # [1]: https://docs.aws.amazon.com/awscloudtrail/latest/APIReference/API_AdvancedEventSelector.html
3059
+ #
2970
3060
  # @option params [required, String] :event_data_store
2971
3061
  # The ARN (or the ID suffix of the ARN) of the event data store that you
2972
3062
  # want to update.
@@ -2981,7 +3071,7 @@ module Aws::CloudTrail
2981
3071
  #
2982
3072
  # @option params [Boolean] :multi_region_enabled
2983
3073
  # Specifies whether an event data store collects events from all
2984
- # regions, or only from the region in which it was created.
3074
+ # Regions, or only from the Region in which it was created.
2985
3075
  #
2986
3076
  # @option params [Boolean] :organization_enabled
2987
3077
  # Specifies whether an event data store collects events logged for an
@@ -3072,7 +3162,7 @@ module Aws::CloudTrail
3072
3162
  #
3073
3163
  # resp.event_data_store_arn #=> String
3074
3164
  # resp.name #=> String
3075
- # resp.status #=> String, one of "CREATED", "ENABLED", "PENDING_DELETION"
3165
+ # resp.status #=> String, one of "CREATED", "ENABLED", "PENDING_DELETION", "STARTING_INGESTION", "STOPPING_INGESTION", "STOPPED_INGESTION"
3076
3166
  # resp.advanced_event_selectors #=> Array
3077
3167
  # resp.advanced_event_selectors[0].name #=> String
3078
3168
  # resp.advanced_event_selectors[0].field_selectors #=> Array
@@ -3111,7 +3201,7 @@ module Aws::CloudTrail
3111
3201
  # the CloudTrail service. Use this action to designate an existing
3112
3202
  # bucket for log delivery. If the existing bucket has previously been a
3113
3203
  # 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
3204
+ # `UpdateTrail` must be called from the Region in which the trail was
3115
3205
  # created; otherwise, an `InvalidHomeRegionException` is thrown.
3116
3206
  #
3117
3207
  # @option params [required, String] :name
@@ -3161,14 +3251,14 @@ module Aws::CloudTrail
3161
3251
  # such as IAM to the log files.
3162
3252
  #
3163
3253
  # @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.
3254
+ # Specifies whether the trail applies only to the current Region or to
3255
+ # all Regions. The default is false. If the trail exists only in the
3256
+ # current Region and this value is set to true, shadow trails
3257
+ # (replications of the trail) will be created in the other Regions. If
3258
+ # the trail exists in all Regions and this value is set to false, the
3259
+ # trail will remain in the Region where it was created, and its shadow
3260
+ # trails in other Regions will be deleted. As a best practice, consider
3261
+ # using trails that log events in all Regions.
3172
3262
  #
3173
3263
  # @option params [Boolean] :enable_log_file_validation
3174
3264
  # Specifies whether log file validation is enabled. The default is
@@ -3306,7 +3396,7 @@ module Aws::CloudTrail
3306
3396
  params: params,
3307
3397
  config: config)
3308
3398
  context[:gem_name] = 'aws-sdk-cloudtrail'
3309
- context[:gem_version] = '1.60.0'
3399
+ context[:gem_version] = '1.62.0'
3310
3400
  Seahorse::Client::Request.new(handlers, context)
3311
3401
  end
3312
3402