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 +4 -4
- data/CHANGELOG.md +5 -0
- data/VERSION +1 -1
- data/lib/aws-sdk-cloudtrail/client.rb +86 -5
- data/lib/aws-sdk-cloudtrail/client_api.rb +7 -0
- data/lib/aws-sdk-cloudtrail/types.rb +103 -11
- data/lib/aws-sdk-cloudtrail.rb +1 -1
- metadata +2 -2
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA256:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: 05c2e2236239fc3f96708d5e6b3eb9def2976cc03d206e330744db0de62f043b
|
4
|
+
data.tar.gz: 6f456dda1b142c0f5eb882c869419c300d4b500bfe7bc4350374c4aa24084815
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
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.
|
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.
|
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
|
3157
|
-
#
|
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.
|
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.
|
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.
|
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
|
1745
|
-
#
|
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.
|
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
|
data/lib/aws-sdk-cloudtrail.rb
CHANGED
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.
|
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-
|
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
|