aws-sdk-cloudtrail 1.69.0 → 1.71.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: 4b24cb672b25c72e3db7577e21748e2fda21e947e97d28e877288f3fb3920fa3
4
- data.tar.gz: 589f160ef8f987c1e04b30bc8ecebe6b748003908c6eddba386e55922d004fbd
3
+ metadata.gz: 05c2e2236239fc3f96708d5e6b3eb9def2976cc03d206e330744db0de62f043b
4
+ data.tar.gz: 6f456dda1b142c0f5eb882c869419c300d4b500bfe7bc4350374c4aa24084815
5
5
  SHA512:
6
- metadata.gz: 2eb1970c37645e3e7afbabbf4b4d4cd09ccecad94853f8c6b1f08dcb36f41bfe4982d15a3f155ad9e3a0119d3214a3ee809bc2bc68de7c6f0cd2907fef06c1f1
7
- data.tar.gz: 5a24aa6853d60a7d6db173a6e902dda48216e049369ca2f12c2bd2e418f430232514a3561ce279c3ac857fd95f8a59c3c3d88501e55ee92aa53b44314c0aecad
6
+ metadata.gz: 75a0dfc065eca3804c4698e945e93062cdd44701b086273c91ff720614af254be1377980b66bbb04df7f4d748e8e434a46530f623a7b1ee508f259352ccb739e
7
+ data.tar.gz: 1283b44089ba4d85f1cdbb08e077449757b81715cebe8ff62d62cd3b1e8f2d075d8dea25222161f1e007cd3867a0885cb1a0452eed3bcdf7e9956a617219097e
data/CHANGELOG.md CHANGED
@@ -1,6 +1,16 @@
1
1
  Unreleased Changes
2
2
  ------------------
3
3
 
4
+ 1.71.0 (2023-11-15)
5
+ ------------------
6
+
7
+ * Feature - The Lake Repricing feature lets customers configure a BillingMode for an event data store. The BillingMode determines the cost for ingesting and storing events and the default and maximum retention period for the event data store.
8
+
9
+ 1.70.0 (2023-11-09)
10
+ ------------------
11
+
12
+ * Feature - The Insights in Lake feature lets customers enable CloudTrail Insights on a source CloudTrail Lake event data store and create a destination event data store to collect Insights events based on unusual management event activity in the source event data store.
13
+
4
14
  1.69.0 (2023-09-27)
5
15
  ------------------
6
16
 
data/VERSION CHANGED
@@ -1 +1 @@
1
- 1.69.0
1
+ 1.71.0
@@ -603,8 +603,12 @@ module Aws::CloudTrail
603
603
  # organization in Organizations.
604
604
  #
605
605
  # @option params [Integer] :retention_period
606
- # The retention period of the event data store, in days. You can set a
606
+ # The retention period of the event data store, in days. If
607
+ # `BillingMode` is set to `EXTENDABLE_RETENTION_PRICING`, you can set a
608
+ # retention period of up to 3653 days, the equivalent of 10 years. If
609
+ # `BillingMode` is set to `FIXED_RETENTION_PRICING`, you can set a
607
610
  # retention period of up to 2557 days, the equivalent of seven years.
611
+ #
608
612
  # CloudTrail Lake determines whether to retain an event by checking if
609
613
  # the `eventTime` of the event is within the specified retention period.
610
614
  # For example, if you set a retention period of 90 days, CloudTrail will
@@ -663,6 +667,33 @@ module Aws::CloudTrail
663
667
  # Specifies whether the event data store should start ingesting live
664
668
  # events. The default is true.
665
669
  #
670
+ # @option params [String] :billing_mode
671
+ # The billing mode for the event data store determines the cost for
672
+ # ingesting events and the default and maximum retention period for the
673
+ # event data store.
674
+ #
675
+ # The following are the possible values:
676
+ #
677
+ # * `EXTENDABLE_RETENTION_PRICING` - This billing mode is generally
678
+ # recommended if you want a flexible retention period of up to 3653
679
+ # days (about 10 years). The default retention period for this billing
680
+ # mode is 366 days.
681
+ #
682
+ # * `FIXED_RETENTION_PRICING` - This billing mode is recommended if you
683
+ # expect to ingest more than 25 TB of event data per month and need a
684
+ # retention period of up to 2557 days (about 7 years). The default
685
+ # retention period for this billing mode is 2557 days.
686
+ #
687
+ # The default value is `EXTENDABLE_RETENTION_PRICING`.
688
+ #
689
+ # For more information about CloudTrail pricing, see [CloudTrail
690
+ # Pricing][1] and [Managing CloudTrail Lake costs][2].
691
+ #
692
+ #
693
+ #
694
+ # [1]: http://aws.amazon.com/cloudtrail/pricing/
695
+ # [2]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-lake-manage-costs.html
696
+ #
666
697
  # @return [Types::CreateEventDataStoreResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
667
698
  #
668
699
  # * {Types::CreateEventDataStoreResponse#event_data_store_arn #event_data_store_arn} => String
@@ -677,6 +708,7 @@ module Aws::CloudTrail
677
708
  # * {Types::CreateEventDataStoreResponse#created_timestamp #created_timestamp} => Time
678
709
  # * {Types::CreateEventDataStoreResponse#updated_timestamp #updated_timestamp} => Time
679
710
  # * {Types::CreateEventDataStoreResponse#kms_key_id #kms_key_id} => String
711
+ # * {Types::CreateEventDataStoreResponse#billing_mode #billing_mode} => String
680
712
  #
681
713
  # @example Request syntax with placeholder values
682
714
  #
@@ -710,6 +742,7 @@ module Aws::CloudTrail
710
742
  # ],
711
743
  # kms_key_id: "EventDataStoreKmsKeyId",
712
744
  # start_ingestion: false,
745
+ # billing_mode: "EXTENDABLE_RETENTION_PRICING", # accepts EXTENDABLE_RETENTION_PRICING, FIXED_RETENTION_PRICING
713
746
  # })
714
747
  #
715
748
  # @example Response structure
@@ -743,6 +776,7 @@ module Aws::CloudTrail
743
776
  # resp.created_timestamp #=> Time
744
777
  # resp.updated_timestamp #=> Time
745
778
  # resp.kms_key_id #=> String
779
+ # resp.billing_mode #=> String, one of "EXTENDABLE_RETENTION_PRICING", "FIXED_RETENTION_PRICING"
746
780
  #
747
781
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/CreateEventDataStore AWS API Documentation
748
782
  #
@@ -828,6 +862,11 @@ module Aws::CloudTrail
828
862
  #
829
863
  # Not required unless you specify `CloudWatchLogsRoleArn`.
830
864
  #
865
+ # <note markdown="1"> Only the management account can configure a CloudWatch Logs log group
866
+ # for an organization trail.
867
+ #
868
+ # </note>
869
+ #
831
870
  # @option params [String] :cloud_watch_logs_role_arn
832
871
  # Specifies the role for the CloudWatch Logs endpoint to assume to write
833
872
  # to a user's log group. You must use a role that exists in your
@@ -1279,6 +1318,7 @@ module Aws::CloudTrail
1279
1318
  # * {Types::GetEventDataStoreResponse#created_timestamp #created_timestamp} => Time
1280
1319
  # * {Types::GetEventDataStoreResponse#updated_timestamp #updated_timestamp} => Time
1281
1320
  # * {Types::GetEventDataStoreResponse#kms_key_id #kms_key_id} => String
1321
+ # * {Types::GetEventDataStoreResponse#billing_mode #billing_mode} => String
1282
1322
  #
1283
1323
  # @example Request syntax with placeholder values
1284
1324
  #
@@ -1314,6 +1354,7 @@ module Aws::CloudTrail
1314
1354
  # resp.created_timestamp #=> Time
1315
1355
  # resp.updated_timestamp #=> Time
1316
1356
  # resp.kms_key_id #=> String
1357
+ # resp.billing_mode #=> String, one of "EXTENDABLE_RETENTION_PRICING", "FIXED_RETENTION_PRICING"
1317
1358
  #
1318
1359
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/GetEventDataStore AWS API Documentation
1319
1360
  #
@@ -1471,20 +1512,26 @@ module Aws::CloudTrail
1471
1512
  end
1472
1513
 
1473
1514
  # Describes the settings for the Insights event selectors that you
1474
- # configured for your trail. `GetInsightSelectors` shows if CloudTrail
1475
- # Insights event logging is enabled on the trail, and if it is, which
1476
- # insight types are enabled. If you run `GetInsightSelectors` on a trail
1477
- # that does not have Insights events enabled, the operation throws the
1478
- # exception `InsightNotEnabledException`
1515
+ # configured for your trail or event data store. `GetInsightSelectors`
1516
+ # shows if CloudTrail Insights event logging is enabled on the trail or
1517
+ # event data store, and if it is, which Insights types are enabled. If
1518
+ # you run `GetInsightSelectors` on a trail or event data store that does
1519
+ # not have Insights events enabled, the operation throws the exception
1520
+ # `InsightNotEnabledException`
1521
+ #
1522
+ # Specify either the `EventDataStore` parameter to get Insights event
1523
+ # selectors for an event data store, or the `TrailName` parameter to the
1524
+ # get Insights event selectors for a trail. You cannot specify these
1525
+ # parameters together.
1479
1526
  #
1480
- # For more information, see [Logging CloudTrail Insights Events for
1481
- # Trails ][1] in the *CloudTrail User Guide*.
1527
+ # For more information, see [Logging CloudTrail Insights events][1] in
1528
+ # the *CloudTrail User Guide*.
1482
1529
  #
1483
1530
  #
1484
1531
  #
1485
1532
  # [1]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-insights-events-with-cloudtrail.html
1486
1533
  #
1487
- # @option params [required, String] :trail_name
1534
+ # @option params [String] :trail_name
1488
1535
  # Specifies the name of the trail or trail ARN. If you specify a trail
1489
1536
  # name, the string must meet the following requirements:
1490
1537
  #
@@ -1504,15 +1551,26 @@ module Aws::CloudTrail
1504
1551
  #
1505
1552
  # `arn:aws:cloudtrail:us-east-2:123456789012:trail/MyTrail`
1506
1553
  #
1554
+ # You cannot use this parameter with the `EventDataStore` parameter.
1555
+ #
1556
+ # @option params [String] :event_data_store
1557
+ # Specifies the ARN (or ID suffix of the ARN) of the event data store
1558
+ # for which you want to get Insights selectors.
1559
+ #
1560
+ # You cannot use this parameter with the `TrailName` parameter.
1561
+ #
1507
1562
  # @return [Types::GetInsightSelectorsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1508
1563
  #
1509
1564
  # * {Types::GetInsightSelectorsResponse#trail_arn #trail_arn} => String
1510
1565
  # * {Types::GetInsightSelectorsResponse#insight_selectors #insight_selectors} => Array&lt;Types::InsightSelector&gt;
1566
+ # * {Types::GetInsightSelectorsResponse#event_data_store_arn #event_data_store_arn} => String
1567
+ # * {Types::GetInsightSelectorsResponse#insights_destination #insights_destination} => String
1511
1568
  #
1512
1569
  # @example Request syntax with placeholder values
1513
1570
  #
1514
1571
  # resp = client.get_insight_selectors({
1515
- # trail_name: "String", # required
1572
+ # trail_name: "String",
1573
+ # event_data_store: "EventDataStoreArn",
1516
1574
  # })
1517
1575
  #
1518
1576
  # @example Response structure
@@ -1520,6 +1578,8 @@ module Aws::CloudTrail
1520
1578
  # resp.trail_arn #=> String
1521
1579
  # resp.insight_selectors #=> Array
1522
1580
  # resp.insight_selectors[0].insight_type #=> String, one of "ApiCallRateInsight", "ApiErrorRateInsight"
1581
+ # resp.event_data_store_arn #=> String
1582
+ # resp.insights_destination #=> String
1523
1583
  #
1524
1584
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/GetInsightSelectors AWS API Documentation
1525
1585
  #
@@ -2149,8 +2209,16 @@ module Aws::CloudTrail
2149
2209
 
2150
2210
  # Looks up [management events][1] or [CloudTrail Insights events][2]
2151
2211
  # that are captured by CloudTrail. You can look up events that occurred
2152
- # in a Region within the last 90 days. Lookup supports the following
2153
- # attributes for management events:
2212
+ # in a Region within the last 90 days.
2213
+ #
2214
+ # <note markdown="1"> `LookupEvents` returns recent Insights events for trails that enable
2215
+ # Insights. To view Insights events for an event data store, you can run
2216
+ # queries on your Insights event data store, and you can also view the
2217
+ # Lake dashboard for Insights.
2218
+ #
2219
+ # </note>
2220
+ #
2221
+ # Lookup supports the following attributes for management events:
2154
2222
  #
2155
2223
  # * Amazon Web Services access key
2156
2224
  #
@@ -2446,25 +2514,51 @@ module Aws::CloudTrail
2446
2514
  end
2447
2515
 
2448
2516
  # Lets you enable Insights event logging by specifying the Insights
2449
- # selectors that you want to enable on an existing trail. You also use
2450
- # `PutInsightSelectors` to turn off Insights event logging, by passing
2451
- # an empty list of insight types. The valid Insights event types in this
2452
- # release are `ApiErrorRateInsight` and `ApiCallRateInsight`.
2517
+ # selectors that you want to enable on an existing trail or event data
2518
+ # store. You also use `PutInsightSelectors` to turn off Insights event
2519
+ # logging, by passing an empty list of Insights types. The valid
2520
+ # Insights event types are `ApiErrorRateInsight` and
2521
+ # `ApiCallRateInsight`.
2522
+ #
2523
+ # To enable Insights on an event data store, you must specify the ARNs
2524
+ # (or ID suffix of the ARNs) for the source event data store
2525
+ # (`EventDataStore`) and the destination event data store
2526
+ # (`InsightsDestination`). The source event data store logs management
2527
+ # events and enables Insights. The destination event data store logs
2528
+ # Insights events based upon the management event activity of the source
2529
+ # event data store. The source and destination event data stores must
2530
+ # belong to the same Amazon Web Services account.
2531
+ #
2532
+ # To log Insights events for a trail, you must specify the name
2533
+ # (`TrailName`) of the CloudTrail trail for which you want to change or
2534
+ # add Insights selectors.
2535
+ #
2536
+ # To log CloudTrail Insights events on API call volume, the trail or
2537
+ # event data store must log `write` management events. To log CloudTrail
2538
+ # Insights events on API error rate, the trail or event data store must
2539
+ # log `read` or `write` management events. You can call
2540
+ # `GetEventSelectors` on a trail to check whether the trail logs
2541
+ # management events. You can call `GetEventDataStore` on an event data
2542
+ # store to check whether the event data store logs management events.
2543
+ #
2544
+ # For more information, see [Logging CloudTrail Insights events][1] in
2545
+ # the *CloudTrail User Guide*.
2453
2546
  #
2454
- # To log CloudTrail Insights events on API call volume, the trail must
2455
- # log `write` management events. To log CloudTrail Insights events on
2456
- # API error rate, the trail must log `read` or `write` management
2457
- # events. You can call `GetEventSelectors` on a trail to check whether
2458
- # the trail logs management events.
2459
2547
  #
2460
- # @option params [required, String] :trail_name
2548
+ #
2549
+ # [1]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-insights-events-with-cloudtrail.html
2550
+ #
2551
+ # @option params [String] :trail_name
2461
2552
  # The name of the CloudTrail trail for which you want to change or add
2462
2553
  # Insights selectors.
2463
2554
  #
2555
+ # You cannot use this parameter with the `EventDataStore` and
2556
+ # `InsightsDestination` parameters.
2557
+ #
2464
2558
  # @option params [required, Array<Types::InsightSelector>] :insight_selectors
2465
- # A JSON string that contains the insight types you want to log on a
2466
- # trail. `ApiCallRateInsight` and `ApiErrorRateInsight` are valid
2467
- # Insight types.
2559
+ # A JSON string that contains the Insights types you want to log on a
2560
+ # trail or event data store. `ApiCallRateInsight` and
2561
+ # `ApiErrorRateInsight` are valid Insight types.
2468
2562
  #
2469
2563
  # The `ApiCallRateInsight` Insights type analyzes write-only management
2470
2564
  # API calls that are aggregated per minute against a baseline API call
@@ -2474,20 +2568,40 @@ module Aws::CloudTrail
2474
2568
  # that result in error codes. The error is shown if the API call is
2475
2569
  # unsuccessful.
2476
2570
  #
2571
+ # @option params [String] :event_data_store
2572
+ # The ARN (or ID suffix of the ARN) of the source event data store for
2573
+ # which you want to change or add Insights selectors. To enable Insights
2574
+ # on an event data store, you must provide both the `EventDataStore` and
2575
+ # `InsightsDestination` parameters.
2576
+ #
2577
+ # You cannot use this parameter with the `TrailName` parameter.
2578
+ #
2579
+ # @option params [String] :insights_destination
2580
+ # The ARN (or ID suffix of the ARN) of the destination event data store
2581
+ # that logs Insights events. To enable Insights on an event data store,
2582
+ # you must provide both the `EventDataStore` and `InsightsDestination`
2583
+ # parameters.
2584
+ #
2585
+ # You cannot use this parameter with the `TrailName` parameter.
2586
+ #
2477
2587
  # @return [Types::PutInsightSelectorsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2478
2588
  #
2479
2589
  # * {Types::PutInsightSelectorsResponse#trail_arn #trail_arn} => String
2480
2590
  # * {Types::PutInsightSelectorsResponse#insight_selectors #insight_selectors} => Array&lt;Types::InsightSelector&gt;
2591
+ # * {Types::PutInsightSelectorsResponse#event_data_store_arn #event_data_store_arn} => String
2592
+ # * {Types::PutInsightSelectorsResponse#insights_destination #insights_destination} => String
2481
2593
  #
2482
2594
  # @example Request syntax with placeholder values
2483
2595
  #
2484
2596
  # resp = client.put_insight_selectors({
2485
- # trail_name: "String", # required
2597
+ # trail_name: "String",
2486
2598
  # insight_selectors: [ # required
2487
2599
  # {
2488
2600
  # insight_type: "ApiCallRateInsight", # accepts ApiCallRateInsight, ApiErrorRateInsight
2489
2601
  # },
2490
2602
  # ],
2603
+ # event_data_store: "EventDataStoreArn",
2604
+ # insights_destination: "EventDataStoreArn",
2491
2605
  # })
2492
2606
  #
2493
2607
  # @example Response structure
@@ -2495,6 +2609,8 @@ module Aws::CloudTrail
2495
2609
  # resp.trail_arn #=> String
2496
2610
  # resp.insight_selectors #=> Array
2497
2611
  # resp.insight_selectors[0].insight_type #=> String, one of "ApiCallRateInsight", "ApiErrorRateInsight"
2612
+ # resp.event_data_store_arn #=> String
2613
+ # resp.insights_destination #=> String
2498
2614
  #
2499
2615
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/PutInsightSelectors AWS API Documentation
2500
2616
  #
@@ -2560,8 +2676,12 @@ module Aws::CloudTrail
2560
2676
  req.send_request(options)
2561
2677
  end
2562
2678
 
2563
- # Registers an organization’s member account as the CloudTrail delegated
2564
- # administrator.
2679
+ # Registers an organization’s member account as the CloudTrail
2680
+ # [delegated administrator][1].
2681
+ #
2682
+ #
2683
+ #
2684
+ # [1]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-delegated-administrator.html
2565
2685
  #
2566
2686
  # @option params [required, String] :member_account_id
2567
2687
  # An organization member account ID that you want to designate as a
@@ -2648,6 +2768,7 @@ module Aws::CloudTrail
2648
2768
  # * {Types::RestoreEventDataStoreResponse#created_timestamp #created_timestamp} => Time
2649
2769
  # * {Types::RestoreEventDataStoreResponse#updated_timestamp #updated_timestamp} => Time
2650
2770
  # * {Types::RestoreEventDataStoreResponse#kms_key_id #kms_key_id} => String
2771
+ # * {Types::RestoreEventDataStoreResponse#billing_mode #billing_mode} => String
2651
2772
  #
2652
2773
  # @example Request syntax with placeholder values
2653
2774
  #
@@ -2683,6 +2804,7 @@ module Aws::CloudTrail
2683
2804
  # resp.created_timestamp #=> Time
2684
2805
  # resp.updated_timestamp #=> Time
2685
2806
  # resp.kms_key_id #=> String
2807
+ # resp.billing_mode #=> String, one of "EXTENDABLE_RETENTION_PRICING", "FIXED_RETENTION_PRICING"
2686
2808
  #
2687
2809
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/RestoreEventDataStore AWS API Documentation
2688
2810
  #
@@ -3069,13 +3191,15 @@ module Aws::CloudTrail
3069
3191
  # ARN or the ID portion of the ARN. Other parameters are optional, but
3070
3192
  # at least one optional parameter must be specified, or CloudTrail
3071
3193
  # throws an error. `RetentionPeriod` is in days, and valid values are
3072
- # integers between 90 and 2557. By default, `TerminationProtection` is
3073
- # enabled.
3194
+ # integers between 7 and 3653 if the `BillingMode` is set to
3195
+ # `EXTENDABLE_RETENTION_PRICING`, or between 7 and 2557 if `BillingMode`
3196
+ # is set to `FIXED_RETENTION_PRICING`. By default,
3197
+ # `TerminationProtection` is enabled.
3074
3198
  #
3075
3199
  # For event data stores for CloudTrail events, `AdvancedEventSelectors`
3076
- # includes or excludes management and data events in your event data
3077
- # store. For more information about `AdvancedEventSelectors`, see
3078
- # [AdvancedEventSelectors][1].
3200
+ # includes or excludes management, data, or Insights events in your
3201
+ # event data store. For more information about `AdvancedEventSelectors`,
3202
+ # see [AdvancedEventSelectors][1].
3079
3203
  #
3080
3204
  # For event data stores for Config configuration items, Audit Manager
3081
3205
  # evidence, or non-Amazon Web Services events, `AdvancedEventSelectors`
@@ -3105,9 +3229,20 @@ module Aws::CloudTrail
3105
3229
  # Specifies whether an event data store collects events logged for an
3106
3230
  # organization in Organizations.
3107
3231
  #
3232
+ # <note markdown="1"> Only the management account for the organization can convert an
3233
+ # organization event data store to a non-organization event data store,
3234
+ # or convert a non-organization event data store to an organization
3235
+ # event data store.
3236
+ #
3237
+ # </note>
3238
+ #
3108
3239
  # @option params [Integer] :retention_period
3109
- # The retention period of the event data store, in days. You can set a
3240
+ # The retention period of the event data store, in days. If
3241
+ # `BillingMode` is set to `EXTENDABLE_RETENTION_PRICING`, you can set a
3242
+ # retention period of up to 3653 days, the equivalent of 10 years. If
3243
+ # `BillingMode` is set to `FIXED_RETENTION_PRICING`, you can set a
3110
3244
  # retention period of up to 2557 days, the equivalent of seven years.
3245
+ #
3111
3246
  # CloudTrail Lake determines whether to retain an event by checking if
3112
3247
  # the `eventTime` of the event is within the specified retention period.
3113
3248
  # For example, if you set a retention period of 90 days, CloudTrail will
@@ -3157,6 +3292,40 @@ module Aws::CloudTrail
3157
3292
  #
3158
3293
  # [1]: https://docs.aws.amazon.com/kms/latest/developerguide/multi-region-keys-overview.html
3159
3294
  #
3295
+ # @option params [String] :billing_mode
3296
+ # <note markdown="1"> You can't change the billing mode from `EXTENDABLE_RETENTION_PRICING`
3297
+ # to `FIXED_RETENTION_PRICING`. If `BillingMode` is set to
3298
+ # `EXTENDABLE_RETENTION_PRICING` and you want to use
3299
+ # `FIXED_RETENTION_PRICING` instead, you'll need to stop ingestion on
3300
+ # the event data store and create a new event data store that uses
3301
+ # `FIXED_RETENTION_PRICING`.
3302
+ #
3303
+ # </note>
3304
+ #
3305
+ # The billing mode for the event data store determines the cost for
3306
+ # ingesting events and the default and maximum retention period for the
3307
+ # event data store.
3308
+ #
3309
+ # The following are the possible values:
3310
+ #
3311
+ # * `EXTENDABLE_RETENTION_PRICING` - This billing mode is generally
3312
+ # recommended if you want a flexible retention period of up to 3653
3313
+ # days (about 10 years). The default retention period for this billing
3314
+ # mode is 366 days.
3315
+ #
3316
+ # * `FIXED_RETENTION_PRICING` - This billing mode is recommended if you
3317
+ # expect to ingest more than 25 TB of event data per month and need a
3318
+ # retention period of up to 2557 days (about 7 years). The default
3319
+ # retention period for this billing mode is 2557 days.
3320
+ #
3321
+ # For more information about CloudTrail pricing, see [CloudTrail
3322
+ # Pricing][1] and [Managing CloudTrail Lake costs][2].
3323
+ #
3324
+ #
3325
+ #
3326
+ # [1]: http://aws.amazon.com/cloudtrail/pricing/
3327
+ # [2]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-lake-manage-costs.html
3328
+ #
3160
3329
  # @return [Types::UpdateEventDataStoreResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
3161
3330
  #
3162
3331
  # * {Types::UpdateEventDataStoreResponse#event_data_store_arn #event_data_store_arn} => String
@@ -3170,6 +3339,7 @@ module Aws::CloudTrail
3170
3339
  # * {Types::UpdateEventDataStoreResponse#created_timestamp #created_timestamp} => Time
3171
3340
  # * {Types::UpdateEventDataStoreResponse#updated_timestamp #updated_timestamp} => Time
3172
3341
  # * {Types::UpdateEventDataStoreResponse#kms_key_id #kms_key_id} => String
3342
+ # * {Types::UpdateEventDataStoreResponse#billing_mode #billing_mode} => String
3173
3343
  #
3174
3344
  # @example Request syntax with placeholder values
3175
3345
  #
@@ -3197,6 +3367,7 @@ module Aws::CloudTrail
3197
3367
  # retention_period: 1,
3198
3368
  # termination_protection_enabled: false,
3199
3369
  # kms_key_id: "EventDataStoreKmsKeyId",
3370
+ # billing_mode: "EXTENDABLE_RETENTION_PRICING", # accepts EXTENDABLE_RETENTION_PRICING, FIXED_RETENTION_PRICING
3200
3371
  # })
3201
3372
  #
3202
3373
  # @example Response structure
@@ -3227,6 +3398,7 @@ module Aws::CloudTrail
3227
3398
  # resp.created_timestamp #=> Time
3228
3399
  # resp.updated_timestamp #=> Time
3229
3400
  # resp.kms_key_id #=> String
3401
+ # resp.billing_mode #=> String, one of "EXTENDABLE_RETENTION_PRICING", "FIXED_RETENTION_PRICING"
3230
3402
  #
3231
3403
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/UpdateEventDataStore AWS API Documentation
3232
3404
  #
@@ -3325,6 +3497,11 @@ module Aws::CloudTrail
3325
3497
  #
3326
3498
  # Not required unless you specify `CloudWatchLogsRoleArn`.
3327
3499
  #
3500
+ # <note markdown="1"> Only the management account can configure a CloudWatch Logs log group
3501
+ # for an organization trail.
3502
+ #
3503
+ # </note>
3504
+ #
3328
3505
  # @option params [String] :cloud_watch_logs_role_arn
3329
3506
  # Specifies the role for the CloudWatch Logs endpoint to assume to write
3330
3507
  # to a user's log group. You must use a role that exists in your
@@ -3359,13 +3536,18 @@ module Aws::CloudTrail
3359
3536
  # organization in Organizations, or only for the current Amazon Web
3360
3537
  # Services account. The default is false, and cannot be true unless the
3361
3538
  # call is made on behalf of an Amazon Web Services account that is the
3362
- # management account or delegated administrator account for an
3363
- # organization in Organizations. If the trail is not an organization
3364
- # trail and this is set to `true`, the trail will be created in all
3365
- # Amazon Web Services accounts that belong to the organization. If the
3366
- # trail is an organization trail and this is set to `false`, the trail
3367
- # will remain in the current Amazon Web Services account but be deleted
3368
- # from all member accounts in the organization.
3539
+ # management account for an organization in Organizations. If the trail
3540
+ # is not an organization trail and this is set to `true`, the trail will
3541
+ # be created in all Amazon Web Services accounts that belong to the
3542
+ # organization. If the trail is an organization trail and this is set to
3543
+ # `false`, the trail will remain in the current Amazon Web Services
3544
+ # account but be deleted from all member accounts in the organization.
3545
+ #
3546
+ # <note markdown="1"> Only the management account for the organization can convert an
3547
+ # organization trail to a non-organization trail, or convert a
3548
+ # non-organization trail to an organization trail.
3549
+ #
3550
+ # </note>
3369
3551
  #
3370
3552
  # @return [Types::UpdateTrailResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
3371
3553
  #
@@ -3437,7 +3619,7 @@ module Aws::CloudTrail
3437
3619
  params: params,
3438
3620
  config: config)
3439
3621
  context[:gem_name] = 'aws-sdk-cloudtrail'
3440
- context[:gem_version] = '1.69.0'
3622
+ context[:gem_version] = '1.71.0'
3441
3623
  Seahorse::Client::Request.new(handlers, context)
3442
3624
  end
3443
3625
 
@@ -24,6 +24,7 @@ module Aws::CloudTrail
24
24
  AdvancedEventSelectors = Shapes::ListShape.new(name: 'AdvancedEventSelectors')
25
25
  AdvancedFieldSelector = Shapes::StructureShape.new(name: 'AdvancedFieldSelector')
26
26
  AdvancedFieldSelectors = Shapes::ListShape.new(name: 'AdvancedFieldSelectors')
27
+ BillingMode = Shapes::StringShape.new(name: 'BillingMode')
27
28
  Boolean = Shapes::BooleanShape.new(name: 'Boolean')
28
29
  ByteBuffer = Shapes::BlobShape.new(name: 'ByteBuffer')
29
30
  CancelQueryRequest = Shapes::StructureShape.new(name: 'CancelQueryRequest')
@@ -381,6 +382,7 @@ module Aws::CloudTrail
381
382
  CreateEventDataStoreRequest.add_member(:tags_list, Shapes::ShapeRef.new(shape: TagsList, location_name: "TagsList"))
382
383
  CreateEventDataStoreRequest.add_member(:kms_key_id, Shapes::ShapeRef.new(shape: EventDataStoreKmsKeyId, location_name: "KmsKeyId"))
383
384
  CreateEventDataStoreRequest.add_member(:start_ingestion, Shapes::ShapeRef.new(shape: Boolean, location_name: "StartIngestion"))
385
+ CreateEventDataStoreRequest.add_member(:billing_mode, Shapes::ShapeRef.new(shape: BillingMode, location_name: "BillingMode"))
384
386
  CreateEventDataStoreRequest.struct_class = Types::CreateEventDataStoreRequest
385
387
 
386
388
  CreateEventDataStoreResponse.add_member(:event_data_store_arn, Shapes::ShapeRef.new(shape: EventDataStoreArn, location_name: "EventDataStoreArn"))
@@ -395,6 +397,7 @@ module Aws::CloudTrail
395
397
  CreateEventDataStoreResponse.add_member(:created_timestamp, Shapes::ShapeRef.new(shape: Date, location_name: "CreatedTimestamp"))
396
398
  CreateEventDataStoreResponse.add_member(:updated_timestamp, Shapes::ShapeRef.new(shape: Date, location_name: "UpdatedTimestamp"))
397
399
  CreateEventDataStoreResponse.add_member(:kms_key_id, Shapes::ShapeRef.new(shape: EventDataStoreKmsKeyId, location_name: "KmsKeyId"))
400
+ CreateEventDataStoreResponse.add_member(:billing_mode, Shapes::ShapeRef.new(shape: BillingMode, location_name: "BillingMode"))
398
401
  CreateEventDataStoreResponse.struct_class = Types::CreateEventDataStoreResponse
399
402
 
400
403
  CreateTrailRequest.add_member(:name, Shapes::ShapeRef.new(shape: String, required: true, location_name: "Name"))
@@ -562,6 +565,7 @@ module Aws::CloudTrail
562
565
  GetEventDataStoreResponse.add_member(:created_timestamp, Shapes::ShapeRef.new(shape: Date, location_name: "CreatedTimestamp"))
563
566
  GetEventDataStoreResponse.add_member(:updated_timestamp, Shapes::ShapeRef.new(shape: Date, location_name: "UpdatedTimestamp"))
564
567
  GetEventDataStoreResponse.add_member(:kms_key_id, Shapes::ShapeRef.new(shape: EventDataStoreKmsKeyId, location_name: "KmsKeyId"))
568
+ GetEventDataStoreResponse.add_member(:billing_mode, Shapes::ShapeRef.new(shape: BillingMode, location_name: "BillingMode"))
565
569
  GetEventDataStoreResponse.struct_class = Types::GetEventDataStoreResponse
566
570
 
567
571
  GetEventSelectorsRequest.add_member(:trail_name, Shapes::ShapeRef.new(shape: String, required: true, location_name: "TrailName"))
@@ -586,11 +590,14 @@ module Aws::CloudTrail
586
590
  GetImportResponse.add_member(:import_statistics, Shapes::ShapeRef.new(shape: ImportStatistics, location_name: "ImportStatistics"))
587
591
  GetImportResponse.struct_class = Types::GetImportResponse
588
592
 
589
- GetInsightSelectorsRequest.add_member(:trail_name, Shapes::ShapeRef.new(shape: String, required: true, location_name: "TrailName"))
593
+ GetInsightSelectorsRequest.add_member(:trail_name, Shapes::ShapeRef.new(shape: String, location_name: "TrailName"))
594
+ GetInsightSelectorsRequest.add_member(:event_data_store, Shapes::ShapeRef.new(shape: EventDataStoreArn, location_name: "EventDataStore"))
590
595
  GetInsightSelectorsRequest.struct_class = Types::GetInsightSelectorsRequest
591
596
 
592
597
  GetInsightSelectorsResponse.add_member(:trail_arn, Shapes::ShapeRef.new(shape: String, location_name: "TrailARN"))
593
598
  GetInsightSelectorsResponse.add_member(:insight_selectors, Shapes::ShapeRef.new(shape: InsightSelectors, location_name: "InsightSelectors"))
599
+ GetInsightSelectorsResponse.add_member(:event_data_store_arn, Shapes::ShapeRef.new(shape: EventDataStoreArn, location_name: "EventDataStoreArn"))
600
+ GetInsightSelectorsResponse.add_member(:insights_destination, Shapes::ShapeRef.new(shape: EventDataStoreArn, location_name: "InsightsDestination"))
594
601
  GetInsightSelectorsResponse.struct_class = Types::GetInsightSelectorsResponse
595
602
 
596
603
  GetQueryResultsRequest.add_member(:event_data_store, Shapes::ShapeRef.new(shape: EventDataStoreArn, deprecated: true, location_name: "EventDataStore", metadata: {"deprecatedMessage"=>"EventDataStore is no longer required by GetQueryResultsRequest"}))
@@ -882,12 +889,16 @@ module Aws::CloudTrail
882
889
  PutEventSelectorsResponse.add_member(:advanced_event_selectors, Shapes::ShapeRef.new(shape: AdvancedEventSelectors, location_name: "AdvancedEventSelectors"))
883
890
  PutEventSelectorsResponse.struct_class = Types::PutEventSelectorsResponse
884
891
 
885
- PutInsightSelectorsRequest.add_member(:trail_name, Shapes::ShapeRef.new(shape: String, required: true, location_name: "TrailName"))
892
+ PutInsightSelectorsRequest.add_member(:trail_name, Shapes::ShapeRef.new(shape: String, location_name: "TrailName"))
886
893
  PutInsightSelectorsRequest.add_member(:insight_selectors, Shapes::ShapeRef.new(shape: InsightSelectors, required: true, location_name: "InsightSelectors"))
894
+ PutInsightSelectorsRequest.add_member(:event_data_store, Shapes::ShapeRef.new(shape: EventDataStoreArn, location_name: "EventDataStore"))
895
+ PutInsightSelectorsRequest.add_member(:insights_destination, Shapes::ShapeRef.new(shape: EventDataStoreArn, location_name: "InsightsDestination"))
887
896
  PutInsightSelectorsRequest.struct_class = Types::PutInsightSelectorsRequest
888
897
 
889
898
  PutInsightSelectorsResponse.add_member(:trail_arn, Shapes::ShapeRef.new(shape: String, location_name: "TrailARN"))
890
899
  PutInsightSelectorsResponse.add_member(:insight_selectors, Shapes::ShapeRef.new(shape: InsightSelectors, location_name: "InsightSelectors"))
900
+ PutInsightSelectorsResponse.add_member(:event_data_store_arn, Shapes::ShapeRef.new(shape: EventDataStoreArn, location_name: "EventDataStoreArn"))
901
+ PutInsightSelectorsResponse.add_member(:insights_destination, Shapes::ShapeRef.new(shape: EventDataStoreArn, location_name: "InsightsDestination"))
891
902
  PutInsightSelectorsResponse.struct_class = Types::PutInsightSelectorsResponse
892
903
 
893
904
  PutResourcePolicyRequest.add_member(:resource_arn, Shapes::ShapeRef.new(shape: ResourceArn, required: true, location_name: "ResourceArn"))
@@ -977,6 +988,7 @@ module Aws::CloudTrail
977
988
  RestoreEventDataStoreResponse.add_member(:created_timestamp, Shapes::ShapeRef.new(shape: Date, location_name: "CreatedTimestamp"))
978
989
  RestoreEventDataStoreResponse.add_member(:updated_timestamp, Shapes::ShapeRef.new(shape: Date, location_name: "UpdatedTimestamp"))
979
990
  RestoreEventDataStoreResponse.add_member(:kms_key_id, Shapes::ShapeRef.new(shape: EventDataStoreKmsKeyId, location_name: "KmsKeyId"))
991
+ RestoreEventDataStoreResponse.add_member(:billing_mode, Shapes::ShapeRef.new(shape: BillingMode, location_name: "BillingMode"))
980
992
  RestoreEventDataStoreResponse.struct_class = Types::RestoreEventDataStoreResponse
981
993
 
982
994
  S3BucketDoesNotExistException.struct_class = Types::S3BucketDoesNotExistException
@@ -1116,6 +1128,7 @@ module Aws::CloudTrail
1116
1128
  UpdateEventDataStoreRequest.add_member(:retention_period, Shapes::ShapeRef.new(shape: RetentionPeriod, location_name: "RetentionPeriod"))
1117
1129
  UpdateEventDataStoreRequest.add_member(:termination_protection_enabled, Shapes::ShapeRef.new(shape: TerminationProtectionEnabled, location_name: "TerminationProtectionEnabled"))
1118
1130
  UpdateEventDataStoreRequest.add_member(:kms_key_id, Shapes::ShapeRef.new(shape: EventDataStoreKmsKeyId, location_name: "KmsKeyId"))
1131
+ UpdateEventDataStoreRequest.add_member(:billing_mode, Shapes::ShapeRef.new(shape: BillingMode, location_name: "BillingMode"))
1119
1132
  UpdateEventDataStoreRequest.struct_class = Types::UpdateEventDataStoreRequest
1120
1133
 
1121
1134
  UpdateEventDataStoreResponse.add_member(:event_data_store_arn, Shapes::ShapeRef.new(shape: EventDataStoreArn, location_name: "EventDataStoreArn"))
@@ -1129,6 +1142,7 @@ module Aws::CloudTrail
1129
1142
  UpdateEventDataStoreResponse.add_member(:created_timestamp, Shapes::ShapeRef.new(shape: Date, location_name: "CreatedTimestamp"))
1130
1143
  UpdateEventDataStoreResponse.add_member(:updated_timestamp, Shapes::ShapeRef.new(shape: Date, location_name: "UpdatedTimestamp"))
1131
1144
  UpdateEventDataStoreResponse.add_member(:kms_key_id, Shapes::ShapeRef.new(shape: EventDataStoreKmsKeyId, location_name: "KmsKeyId"))
1145
+ UpdateEventDataStoreResponse.add_member(:billing_mode, Shapes::ShapeRef.new(shape: BillingMode, location_name: "BillingMode"))
1132
1146
  UpdateEventDataStoreResponse.struct_class = Types::UpdateEventDataStoreResponse
1133
1147
 
1134
1148
  UpdateTrailRequest.add_member(:name, Shapes::ShapeRef.new(shape: String, required: true, location_name: "Name"))
@@ -1476,6 +1490,8 @@ module Aws::CloudTrail
1476
1490
  o.http_request_uri = "/"
1477
1491
  o.input = Shapes::ShapeRef.new(shape: GetInsightSelectorsRequest)
1478
1492
  o.output = Shapes::ShapeRef.new(shape: GetInsightSelectorsResponse)
1493
+ o.errors << Shapes::ShapeRef.new(shape: InvalidParameterException)
1494
+ o.errors << Shapes::ShapeRef.new(shape: InvalidParameterCombinationException)
1479
1495
  o.errors << Shapes::ShapeRef.new(shape: TrailNotFoundException)
1480
1496
  o.errors << Shapes::ShapeRef.new(shape: InvalidTrailNameException)
1481
1497
  o.errors << Shapes::ShapeRef.new(shape: CloudTrailARNInvalidException)
@@ -1751,6 +1767,8 @@ module Aws::CloudTrail
1751
1767
  o.http_request_uri = "/"
1752
1768
  o.input = Shapes::ShapeRef.new(shape: PutInsightSelectorsRequest)
1753
1769
  o.output = Shapes::ShapeRef.new(shape: PutInsightSelectorsResponse)
1770
+ o.errors << Shapes::ShapeRef.new(shape: InvalidParameterException)
1771
+ o.errors << Shapes::ShapeRef.new(shape: InvalidParameterCombinationException)
1754
1772
  o.errors << Shapes::ShapeRef.new(shape: TrailNotFoundException)
1755
1773
  o.errors << Shapes::ShapeRef.new(shape: InvalidTrailNameException)
1756
1774
  o.errors << Shapes::ShapeRef.new(shape: CloudTrailARNInvalidException)
@@ -2003,6 +2021,7 @@ module Aws::CloudTrail
2003
2021
  o.errors << Shapes::ShapeRef.new(shape: EventDataStoreARNInvalidException)
2004
2022
  o.errors << Shapes::ShapeRef.new(shape: EventDataStoreNotFoundException)
2005
2023
  o.errors << Shapes::ShapeRef.new(shape: InvalidEventSelectorsException)
2024
+ o.errors << Shapes::ShapeRef.new(shape: InvalidInsightSelectorsException)
2006
2025
  o.errors << Shapes::ShapeRef.new(shape: EventDataStoreHasOngoingImportException)
2007
2026
  o.errors << Shapes::ShapeRef.new(shape: InactiveEventDataStoreException)
2008
2027
  o.errors << Shapes::ShapeRef.new(shape: InvalidParameterException)
@@ -32,7 +32,7 @@ module Aws::CloudTrail
32
32
  raise ArgumentError, "FIPS and DualStack are enabled, but this partition does not support one or both"
33
33
  end
34
34
  if Aws::Endpoints::Matchers.boolean_equals?(use_fips, true)
35
- if Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsFIPS"))
35
+ if Aws::Endpoints::Matchers.boolean_equals?(Aws::Endpoints::Matchers.attr(partition_result, "supportsFIPS"), true)
36
36
  if Aws::Endpoints::Matchers.string_equals?(region, "us-gov-east-1")
37
37
  return Aws::Endpoints::Endpoint.new(url: "https://cloudtrail.us-gov-east-1.amazonaws.com", headers: {}, properties: {})
38
38
  end