aws-sdk-cloudtrail 1.70.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: 0c4a3833b686aa7351ba9a3ee53728b877fdc1b9e3601df0629e628bbcbc19dc
4
- data.tar.gz: 3b5962fc934cd48772c6a8c79f995d876665dd640a0a24dcf38b7de07f75ab03
3
+ metadata.gz: 05c2e2236239fc3f96708d5e6b3eb9def2976cc03d206e330744db0de62f043b
4
+ data.tar.gz: 6f456dda1b142c0f5eb882c869419c300d4b500bfe7bc4350374c4aa24084815
5
5
  SHA512:
6
- metadata.gz: 8e2d1328bbeb257cdac10c82ff6e548eaa4791c32723c91d9a482fe06ebf248187f18f232234148e8e103f93167a1f3f459e920ddb17e96873bef824a5c6ac9a
7
- data.tar.gz: 2fd3bd68bee11f68b97f29812ec5afcb172fa4505fb94574aed2453869c4d58d6062b02c5b00d7376cd827e84f42d10d5fc324ee067a753d561ba86e65015e30
6
+ metadata.gz: 75a0dfc065eca3804c4698e945e93062cdd44701b086273c91ff720614af254be1377980b66bbb04df7f4d748e8e434a46530f623a7b1ee508f259352ccb739e
7
+ data.tar.gz: 1283b44089ba4d85f1cdbb08e077449757b81715cebe8ff62d62cd3b1e8f2d075d8dea25222161f1e007cd3867a0885cb1a0452eed3bcdf7e9956a617219097e
data/CHANGELOG.md CHANGED
@@ -1,6 +1,11 @@
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
+
4
9
  1.70.0 (2023-11-09)
5
10
  ------------------
6
11
 
data/VERSION CHANGED
@@ -1 +1 @@
1
- 1.70.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
  #
@@ -1284,6 +1318,7 @@ module Aws::CloudTrail
1284
1318
  # * {Types::GetEventDataStoreResponse#created_timestamp #created_timestamp} => Time
1285
1319
  # * {Types::GetEventDataStoreResponse#updated_timestamp #updated_timestamp} => Time
1286
1320
  # * {Types::GetEventDataStoreResponse#kms_key_id #kms_key_id} => String
1321
+ # * {Types::GetEventDataStoreResponse#billing_mode #billing_mode} => String
1287
1322
  #
1288
1323
  # @example Request syntax with placeholder values
1289
1324
  #
@@ -1319,6 +1354,7 @@ module Aws::CloudTrail
1319
1354
  # resp.created_timestamp #=> Time
1320
1355
  # resp.updated_timestamp #=> Time
1321
1356
  # resp.kms_key_id #=> String
1357
+ # resp.billing_mode #=> String, one of "EXTENDABLE_RETENTION_PRICING", "FIXED_RETENTION_PRICING"
1322
1358
  #
1323
1359
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/GetEventDataStore AWS API Documentation
1324
1360
  #
@@ -2732,6 +2768,7 @@ module Aws::CloudTrail
2732
2768
  # * {Types::RestoreEventDataStoreResponse#created_timestamp #created_timestamp} => Time
2733
2769
  # * {Types::RestoreEventDataStoreResponse#updated_timestamp #updated_timestamp} => Time
2734
2770
  # * {Types::RestoreEventDataStoreResponse#kms_key_id #kms_key_id} => String
2771
+ # * {Types::RestoreEventDataStoreResponse#billing_mode #billing_mode} => String
2735
2772
  #
2736
2773
  # @example Request syntax with placeholder values
2737
2774
  #
@@ -2767,6 +2804,7 @@ module Aws::CloudTrail
2767
2804
  # resp.created_timestamp #=> Time
2768
2805
  # resp.updated_timestamp #=> Time
2769
2806
  # resp.kms_key_id #=> String
2807
+ # resp.billing_mode #=> String, one of "EXTENDABLE_RETENTION_PRICING", "FIXED_RETENTION_PRICING"
2770
2808
  #
2771
2809
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/RestoreEventDataStore AWS API Documentation
2772
2810
  #
@@ -3153,8 +3191,10 @@ module Aws::CloudTrail
3153
3191
  # ARN or the ID portion of the ARN. Other parameters are optional, but
3154
3192
  # at least one optional parameter must be specified, or CloudTrail
3155
3193
  # throws an error. `RetentionPeriod` is in days, and valid values are
3156
- # integers between 90 and 2557. By default, `TerminationProtection` is
3157
- # 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.
3158
3198
  #
3159
3199
  # For event data stores for CloudTrail events, `AdvancedEventSelectors`
3160
3200
  # includes or excludes management, data, or Insights events in your
@@ -3197,8 +3237,12 @@ module Aws::CloudTrail
3197
3237
  # </note>
3198
3238
  #
3199
3239
  # @option params [Integer] :retention_period
3200
- # 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
3201
3244
  # retention period of up to 2557 days, the equivalent of seven years.
3245
+ #
3202
3246
  # CloudTrail Lake determines whether to retain an event by checking if
3203
3247
  # the `eventTime` of the event is within the specified retention period.
3204
3248
  # For example, if you set a retention period of 90 days, CloudTrail will
@@ -3248,6 +3292,40 @@ module Aws::CloudTrail
3248
3292
  #
3249
3293
  # [1]: https://docs.aws.amazon.com/kms/latest/developerguide/multi-region-keys-overview.html
3250
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
+ #
3251
3329
  # @return [Types::UpdateEventDataStoreResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
3252
3330
  #
3253
3331
  # * {Types::UpdateEventDataStoreResponse#event_data_store_arn #event_data_store_arn} => String
@@ -3261,6 +3339,7 @@ module Aws::CloudTrail
3261
3339
  # * {Types::UpdateEventDataStoreResponse#created_timestamp #created_timestamp} => Time
3262
3340
  # * {Types::UpdateEventDataStoreResponse#updated_timestamp #updated_timestamp} => Time
3263
3341
  # * {Types::UpdateEventDataStoreResponse#kms_key_id #kms_key_id} => String
3342
+ # * {Types::UpdateEventDataStoreResponse#billing_mode #billing_mode} => String
3264
3343
  #
3265
3344
  # @example Request syntax with placeholder values
3266
3345
  #
@@ -3288,6 +3367,7 @@ module Aws::CloudTrail
3288
3367
  # retention_period: 1,
3289
3368
  # termination_protection_enabled: false,
3290
3369
  # kms_key_id: "EventDataStoreKmsKeyId",
3370
+ # billing_mode: "EXTENDABLE_RETENTION_PRICING", # accepts EXTENDABLE_RETENTION_PRICING, FIXED_RETENTION_PRICING
3291
3371
  # })
3292
3372
  #
3293
3373
  # @example Response structure
@@ -3318,6 +3398,7 @@ module Aws::CloudTrail
3318
3398
  # resp.created_timestamp #=> Time
3319
3399
  # resp.updated_timestamp #=> Time
3320
3400
  # resp.kms_key_id #=> String
3401
+ # resp.billing_mode #=> String, one of "EXTENDABLE_RETENTION_PRICING", "FIXED_RETENTION_PRICING"
3321
3402
  #
3322
3403
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/UpdateEventDataStore AWS API Documentation
3323
3404
  #
@@ -3538,7 +3619,7 @@ module Aws::CloudTrail
3538
3619
  params: params,
3539
3620
  config: config)
3540
3621
  context[:gem_name] = 'aws-sdk-cloudtrail'
3541
- context[:gem_version] = '1.70.0'
3622
+ context[:gem_version] = '1.71.0'
3542
3623
  Seahorse::Client::Request.new(handlers, context)
3543
3624
  end
3544
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"))
@@ -984,6 +988,7 @@ module Aws::CloudTrail
984
988
  RestoreEventDataStoreResponse.add_member(:created_timestamp, Shapes::ShapeRef.new(shape: Date, location_name: "CreatedTimestamp"))
985
989
  RestoreEventDataStoreResponse.add_member(:updated_timestamp, Shapes::ShapeRef.new(shape: Date, location_name: "UpdatedTimestamp"))
986
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"))
987
992
  RestoreEventDataStoreResponse.struct_class = Types::RestoreEventDataStoreResponse
988
993
 
989
994
  S3BucketDoesNotExistException.struct_class = Types::S3BucketDoesNotExistException
@@ -1123,6 +1128,7 @@ module Aws::CloudTrail
1123
1128
  UpdateEventDataStoreRequest.add_member(:retention_period, Shapes::ShapeRef.new(shape: RetentionPeriod, location_name: "RetentionPeriod"))
1124
1129
  UpdateEventDataStoreRequest.add_member(:termination_protection_enabled, Shapes::ShapeRef.new(shape: TerminationProtectionEnabled, location_name: "TerminationProtectionEnabled"))
1125
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"))
1126
1132
  UpdateEventDataStoreRequest.struct_class = Types::UpdateEventDataStoreRequest
1127
1133
 
1128
1134
  UpdateEventDataStoreResponse.add_member(:event_data_store_arn, Shapes::ShapeRef.new(shape: EventDataStoreArn, location_name: "EventDataStoreArn"))
@@ -1136,6 +1142,7 @@ module Aws::CloudTrail
1136
1142
  UpdateEventDataStoreResponse.add_member(:created_timestamp, Shapes::ShapeRef.new(shape: Date, location_name: "CreatedTimestamp"))
1137
1143
  UpdateEventDataStoreResponse.add_member(:updated_timestamp, Shapes::ShapeRef.new(shape: Date, location_name: "UpdatedTimestamp"))
1138
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"))
1139
1146
  UpdateEventDataStoreResponse.struct_class = Types::UpdateEventDataStoreResponse
1140
1147
 
1141
1148
  UpdateTrailRequest.add_member(:name, Shapes::ShapeRef.new(shape: String, required: true, location_name: "Name"))
@@ -814,8 +814,12 @@ module Aws::CloudTrail
814
814
  # @return [Boolean]
815
815
  #
816
816
  # @!attribute [rw] retention_period
817
- # The retention period of the event data store, in days. You can set a
817
+ # The retention period of the event data store, in days. If
818
+ # `BillingMode` is set to `EXTENDABLE_RETENTION_PRICING`, you can set
819
+ # a retention period of up to 3653 days, the equivalent of 10 years.
820
+ # If `BillingMode` is set to `FIXED_RETENTION_PRICING`, you can set a
818
821
  # retention period of up to 2557 days, the equivalent of seven years.
822
+ #
819
823
  # CloudTrail Lake determines whether to retain an event by checking if
820
824
  # the `eventTime` of the event is within the specified retention
821
825
  # period. For example, if you set a retention period of 90 days,
@@ -881,6 +885,34 @@ module Aws::CloudTrail
881
885
  # events. The default is true.
882
886
  # @return [Boolean]
883
887
  #
888
+ # @!attribute [rw] billing_mode
889
+ # The billing mode for the event data store determines the cost for
890
+ # ingesting events and the default and maximum retention period for
891
+ # the event data store.
892
+ #
893
+ # The following are the possible values:
894
+ #
895
+ # * `EXTENDABLE_RETENTION_PRICING` - This billing mode is generally
896
+ # recommended if you want a flexible retention period of up to 3653
897
+ # days (about 10 years). The default retention period for this
898
+ # billing mode is 366 days.
899
+ #
900
+ # * `FIXED_RETENTION_PRICING` - This billing mode is recommended if
901
+ # you expect to ingest more than 25 TB of event data per month and
902
+ # need a retention period of up to 2557 days (about 7 years). The
903
+ # default retention period for this billing mode is 2557 days.
904
+ #
905
+ # The default value is `EXTENDABLE_RETENTION_PRICING`.
906
+ #
907
+ # For more information about CloudTrail pricing, see [CloudTrail
908
+ # Pricing][1] and [Managing CloudTrail Lake costs][2].
909
+ #
910
+ #
911
+ #
912
+ # [1]: http://aws.amazon.com/cloudtrail/pricing/
913
+ # [2]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-lake-manage-costs.html
914
+ # @return [String]
915
+ #
884
916
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/CreateEventDataStoreRequest AWS API Documentation
885
917
  #
886
918
  class CreateEventDataStoreRequest < Struct.new(
@@ -892,7 +924,8 @@ module Aws::CloudTrail
892
924
  :termination_protection_enabled,
893
925
  :tags_list,
894
926
  :kms_key_id,
895
- :start_ingestion)
927
+ :start_ingestion,
928
+ :billing_mode)
896
929
  SENSITIVE = []
897
930
  include Aws::Structure
898
931
  end
@@ -955,6 +988,10 @@ module Aws::CloudTrail
955
988
  # `arn:aws:kms:us-east-2:123456789012:key/12345678-1234-1234-1234-123456789012`
956
989
  # @return [String]
957
990
  #
991
+ # @!attribute [rw] billing_mode
992
+ # The billing mode for the event data store.
993
+ # @return [String]
994
+ #
958
995
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/CreateEventDataStoreResponse AWS API Documentation
959
996
  #
960
997
  class CreateEventDataStoreResponse < Struct.new(
@@ -969,7 +1006,8 @@ module Aws::CloudTrail
969
1006
  :tags_list,
970
1007
  :created_timestamp,
971
1008
  :updated_timestamp,
972
- :kms_key_id)
1009
+ :kms_key_id,
1010
+ :billing_mode)
973
1011
  SENSITIVE = []
974
1012
  include Aws::Structure
975
1013
  end
@@ -1741,9 +1779,8 @@ module Aws::CloudTrail
1741
1779
 
1742
1780
  # A storage lake of event data against which you can run complex
1743
1781
  # SQL-based queries. An event data store can include events that you
1744
- # have logged on your account from the last 90 to 2557 days (about three
1745
- # months to up to seven years). To select events for an event data
1746
- # store, use [advanced event selectors][1].
1782
+ # have logged on your account. To select events for an event data store,
1783
+ # use [advanced event selectors][1].
1747
1784
  #
1748
1785
  #
1749
1786
  #
@@ -2059,6 +2096,10 @@ module Aws::CloudTrail
2059
2096
  # `arn:aws:kms:us-east-2:123456789012:key/12345678-1234-1234-1234-123456789012`
2060
2097
  # @return [String]
2061
2098
  #
2099
+ # @!attribute [rw] billing_mode
2100
+ # The billing mode for the event data store.
2101
+ # @return [String]
2102
+ #
2062
2103
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/GetEventDataStoreResponse AWS API Documentation
2063
2104
  #
2064
2105
  class GetEventDataStoreResponse < Struct.new(
@@ -2072,7 +2113,8 @@ module Aws::CloudTrail
2072
2113
  :termination_protection_enabled,
2073
2114
  :created_timestamp,
2074
2115
  :updated_timestamp,
2075
- :kms_key_id)
2116
+ :kms_key_id,
2117
+ :billing_mode)
2076
2118
  SENSITIVE = []
2077
2119
  include Aws::Structure
2078
2120
  end
@@ -4135,6 +4177,10 @@ module Aws::CloudTrail
4135
4177
  # `arn:aws:kms:us-east-2:123456789012:key/12345678-1234-1234-1234-123456789012`
4136
4178
  # @return [String]
4137
4179
  #
4180
+ # @!attribute [rw] billing_mode
4181
+ # The billing mode for the event data store.
4182
+ # @return [String]
4183
+ #
4138
4184
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/RestoreEventDataStoreResponse AWS API Documentation
4139
4185
  #
4140
4186
  class RestoreEventDataStoreResponse < Struct.new(
@@ -4148,7 +4194,8 @@ module Aws::CloudTrail
4148
4194
  :termination_protection_enabled,
4149
4195
  :created_timestamp,
4150
4196
  :updated_timestamp,
4151
- :kms_key_id)
4197
+ :kms_key_id,
4198
+ :billing_mode)
4152
4199
  SENSITIVE = []
4153
4200
  include Aws::Structure
4154
4201
  end
@@ -4784,8 +4831,12 @@ module Aws::CloudTrail
4784
4831
  # @return [Boolean]
4785
4832
  #
4786
4833
  # @!attribute [rw] retention_period
4787
- # The retention period of the event data store, in days. You can set a
4834
+ # The retention period of the event data store, in days. If
4835
+ # `BillingMode` is set to `EXTENDABLE_RETENTION_PRICING`, you can set
4836
+ # a retention period of up to 3653 days, the equivalent of 10 years.
4837
+ # If `BillingMode` is set to `FIXED_RETENTION_PRICING`, you can set a
4788
4838
  # retention period of up to 2557 days, the equivalent of seven years.
4839
+ #
4789
4840
  # CloudTrail Lake determines whether to retain an event by checking if
4790
4841
  # the `eventTime` of the event is within the specified retention
4791
4842
  # period. For example, if you set a retention period of 90 days,
@@ -4840,6 +4891,41 @@ module Aws::CloudTrail
4840
4891
  # [1]: https://docs.aws.amazon.com/kms/latest/developerguide/multi-region-keys-overview.html
4841
4892
  # @return [String]
4842
4893
  #
4894
+ # @!attribute [rw] billing_mode
4895
+ # <note markdown="1"> You can't change the billing mode from
4896
+ # `EXTENDABLE_RETENTION_PRICING` to `FIXED_RETENTION_PRICING`. If
4897
+ # `BillingMode` is set to `EXTENDABLE_RETENTION_PRICING` and you want
4898
+ # to use `FIXED_RETENTION_PRICING` instead, you'll need to stop
4899
+ # ingestion on the event data store and create a new event data store
4900
+ # that uses `FIXED_RETENTION_PRICING`.
4901
+ #
4902
+ # </note>
4903
+ #
4904
+ # The billing mode for the event data store determines the cost for
4905
+ # ingesting events and the default and maximum retention period for
4906
+ # the event data store.
4907
+ #
4908
+ # The following are the possible values:
4909
+ #
4910
+ # * `EXTENDABLE_RETENTION_PRICING` - This billing mode is generally
4911
+ # recommended if you want a flexible retention period of up to 3653
4912
+ # days (about 10 years). The default retention period for this
4913
+ # billing mode is 366 days.
4914
+ #
4915
+ # * `FIXED_RETENTION_PRICING` - This billing mode is recommended if
4916
+ # you expect to ingest more than 25 TB of event data per month and
4917
+ # need a retention period of up to 2557 days (about 7 years). The
4918
+ # default retention period for this billing mode is 2557 days.
4919
+ #
4920
+ # For more information about CloudTrail pricing, see [CloudTrail
4921
+ # Pricing][1] and [Managing CloudTrail Lake costs][2].
4922
+ #
4923
+ #
4924
+ #
4925
+ # [1]: http://aws.amazon.com/cloudtrail/pricing/
4926
+ # [2]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-lake-manage-costs.html
4927
+ # @return [String]
4928
+ #
4843
4929
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/UpdateEventDataStoreRequest AWS API Documentation
4844
4930
  #
4845
4931
  class UpdateEventDataStoreRequest < Struct.new(
@@ -4850,7 +4936,8 @@ module Aws::CloudTrail
4850
4936
  :organization_enabled,
4851
4937
  :retention_period,
4852
4938
  :termination_protection_enabled,
4853
- :kms_key_id)
4939
+ :kms_key_id,
4940
+ :billing_mode)
4854
4941
  SENSITIVE = []
4855
4942
  include Aws::Structure
4856
4943
  end
@@ -4909,6 +4996,10 @@ module Aws::CloudTrail
4909
4996
  # `arn:aws:kms:us-east-2:123456789012:key/12345678-1234-1234-1234-123456789012`
4910
4997
  # @return [String]
4911
4998
  #
4999
+ # @!attribute [rw] billing_mode
5000
+ # The billing mode for the event data store.
5001
+ # @return [String]
5002
+ #
4912
5003
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01/UpdateEventDataStoreResponse AWS API Documentation
4913
5004
  #
4914
5005
  class UpdateEventDataStoreResponse < Struct.new(
@@ -4922,7 +5013,8 @@ module Aws::CloudTrail
4922
5013
  :termination_protection_enabled,
4923
5014
  :created_timestamp,
4924
5015
  :updated_timestamp,
4925
- :kms_key_id)
5016
+ :kms_key_id,
5017
+ :billing_mode)
4926
5018
  SENSITIVE = []
4927
5019
  include Aws::Structure
4928
5020
  end
@@ -52,6 +52,6 @@ require_relative 'aws-sdk-cloudtrail/customizations'
52
52
  # @!group service
53
53
  module Aws::CloudTrail
54
54
 
55
- GEM_VERSION = '1.70.0'
55
+ GEM_VERSION = '1.71.0'
56
56
 
57
57
  end
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: aws-sdk-cloudtrail
3
3
  version: !ruby/object:Gem::Version
4
- version: 1.70.0
4
+ version: 1.71.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Amazon Web Services
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2023-11-09 00:00:00.000000000 Z
11
+ date: 2023-11-15 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: aws-sdk-core