aws-sdk-cloudtrail 1.69.0 → 1.71.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: 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