aws-sdk-rds 1.23.0 → 1.24.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -304,6 +304,7 @@ module Aws::RDS
304
304
  # is_modifiable: false,
305
305
  # minimum_engine_version: "String",
306
306
  # apply_method: "immediate", # accepts immediate, pending-reboot
307
+ # supported_engine_modes: ["String"],
307
308
  # },
308
309
  # ],
309
310
  # })
@@ -349,6 +350,7 @@ module Aws::RDS
349
350
  # is_modifiable: false,
350
351
  # minimum_engine_version: "String",
351
352
  # apply_method: "immediate", # accepts immediate, pending-reboot
353
+ # supported_engine_modes: ["String"],
352
354
  # },
353
355
  # ],
354
356
  # })
@@ -621,21 +621,7 @@ module Aws::RDS
621
621
  # true specifies an Internet-facing instance with a publicly resolvable
622
622
  # DNS name, which resolves to a public IP address. A value of false
623
623
  # specifies an internal instance with a DNS name that resolves to a
624
- # private IP address.
625
- #
626
- # Default: The default behavior varies depending on whether a VPC has
627
- # been requested or not. The following list shows the default behavior
628
- # in each case.
629
- #
630
- # * **Default VPC:** true
631
- #
632
- # * **VPC:** false
633
- #
634
- # If no DB subnet group has been specified as part of the request and
635
- # the PubliclyAccessible value has not been set, the DB instance is
636
- # publicly accessible. If a specific DB subnet group has been specified
637
- # as part of the request and the PubliclyAccessible value has not been
638
- # set, the DB instance is private.
624
+ # private IP address. For more information, see CreateDBInstance.
639
625
  # @option options [Boolean] :auto_minor_version_upgrade
640
626
  # Indicates that minor version upgrades are applied automatically to the
641
627
  # DB instance during the maintenance window.
@@ -754,7 +740,14 @@ module Aws::RDS
754
740
  # Default: `false`
755
741
  # @option options [Array<String>] :enable_cloudwatch_logs_exports
756
742
  # The list of logs that the restored DB instance is to export to
757
- # CloudWatch Logs.
743
+ # CloudWatch Logs. The values in the list depend on the DB engine being
744
+ # used. For more information, see [Publishing Database Logs to Amazon
745
+ # CloudWatch Logs ][1] in the *Amazon Relational Database Service User
746
+ # Guide*.
747
+ #
748
+ #
749
+ #
750
+ # [1]: http://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_LogAccess.html#USER_LogAccess.Procedural.UploadtoCloudWatch
758
751
  # @option options [Array<Types::ProcessorFeature>] :processor_features
759
752
  # The number of CPU cores and the number of threads per core for the DB
760
753
  # instance class of the DB instance.
@@ -87,6 +87,12 @@ module Aws::RDS
87
87
  data[:apply_method]
88
88
  end
89
89
 
90
+ # The valid DB engine modes.
91
+ # @return [Array<String>]
92
+ def supported_engine_modes
93
+ data[:supported_engine_modes]
94
+ end
95
+
90
96
  # @!endgroup
91
97
 
92
98
  # @return [Client]
@@ -53,6 +53,13 @@ module Aws::RDS
53
53
  # enable_iam_database_authentication: false,
54
54
  # backtrack_window: 1,
55
55
  # enable_cloudwatch_logs_exports: ["String"],
56
+ # engine_mode: "String",
57
+ # scaling_configuration: {
58
+ # min_capacity: 1,
59
+ # max_capacity: 1,
60
+ # auto_pause: false,
61
+ # seconds_until_auto_pause: 1,
62
+ # },
56
63
  # source_region: "String",
57
64
  # })
58
65
  # @param [Hash] options ({})
@@ -296,7 +303,20 @@ module Aws::RDS
296
303
  # ^
297
304
  # @option options [Array<String>] :enable_cloudwatch_logs_exports
298
305
  # The list of log types that need to be enabled for exporting to
299
- # CloudWatch Logs.
306
+ # CloudWatch Logs. The values in the list depend on the DB engine being
307
+ # used. For more information, see [Publishing Database Logs to Amazon
308
+ # CloudWatch Logs ][1] in the *Amazon Relational Database Service User
309
+ # Guide*.
310
+ #
311
+ #
312
+ #
313
+ # [1]: http://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_LogAccess.html#USER_LogAccess.Procedural.UploadtoCloudWatch
314
+ # @option options [String] :engine_mode
315
+ # The DB engine mode of the DB cluster, either `provisioned` or
316
+ # `serverless`.
317
+ # @option options [Types::ScalingConfiguration] :scaling_configuration
318
+ # For DB clusters in `serverless` DB engine mode, the scaling properties
319
+ # of the DB cluster.
300
320
  # @option options [String] :destination_region
301
321
  # @option options [String] :source_region
302
322
  # The source region of the snapshot. This is only needed when the
@@ -995,19 +1015,26 @@ module Aws::RDS
995
1015
  # specifies an internal instance with a DNS name that resolves to a
996
1016
  # private IP address.
997
1017
  #
998
- # Default: The default behavior varies depending on whether a VPC has
999
- # been requested or not. The following list shows the default behavior
1000
- # in each case.
1018
+ # Default: The default behavior varies depending on whether
1019
+ # `DBSubnetGroupName` is specified.
1020
+ #
1021
+ # If `DBSubnetGroupName` is not specified, and `PubliclyAccessible` is
1022
+ # not specified, the following applies:
1023
+ #
1024
+ # * If the default VPC in the target region doesn’t have an Internet
1025
+ # gateway attached to it, the DB instance is private.
1001
1026
  #
1002
- # * **Default VPC:** true
1027
+ # * If the default VPC in the target region has an Internet gateway
1028
+ # attached to it, the DB instance is public.
1003
1029
  #
1004
- # * **VPC:** false
1030
+ # If `DBSubnetGroupName` is specified, and `PubliclyAccessible` is not
1031
+ # specified, the following applies:
1005
1032
  #
1006
- # If no DB subnet group has been specified as part of the request and
1007
- # the PubliclyAccessible value has not been set, the DB instance is
1008
- # publicly accessible. If a specific DB subnet group has been specified
1009
- # as part of the request and the PubliclyAccessible value has not been
1010
- # set, the DB instance is private.
1033
+ # * If the subnets are part of a VPC that doesn’t have an Internet
1034
+ # gateway attached to it, the DB instance is private.
1035
+ #
1036
+ # * If the subnets are part of a VPC that has an Internet gateway
1037
+ # attached to it, the DB instance is public.
1011
1038
  # @option options [Array<Types::Tag>] :tags
1012
1039
  # A list of tags. For more information, see [Tagging Amazon RDS
1013
1040
  # Resources][1].
@@ -1153,7 +1180,14 @@ module Aws::RDS
1153
1180
  # Valid values are 7 or 731 (2 years).
1154
1181
  # @option options [Array<String>] :enable_cloudwatch_logs_exports
1155
1182
  # The list of log types that need to be enabled for exporting to
1156
- # CloudWatch Logs.
1183
+ # CloudWatch Logs. The values in the list depend on the DB engine being
1184
+ # used. For more information, see [Publishing Database Logs to Amazon
1185
+ # CloudWatch Logs ][1] in the *Amazon Relational Database Service User
1186
+ # Guide*.
1187
+ #
1188
+ #
1189
+ #
1190
+ # [1]: http://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_LogAccess.html#USER_LogAccess.Procedural.UploadtoCloudWatch
1157
1191
  # @option options [Array<Types::ProcessorFeature>] :processor_features
1158
1192
  # The number of CPU cores and the number of threads per core for the DB
1159
1193
  # instance class of the DB instance.
@@ -492,6 +492,16 @@ module Aws::RDS
492
492
  # The configuration setting for the log types to be enabled for export
493
493
  # to CloudWatch Logs for a specific DB instance or DB cluster.
494
494
  #
495
+ # The `EnableLogTypes` and `DisableLogTypes` arrays determine which logs
496
+ # will be exported (or not exported) to CloudWatch Logs. The values
497
+ # within these arrays depend on the DB engine being used. For more
498
+ # information, see [Publishing Database Logs to Amazon CloudWatch Logs
499
+ # ][1] in the *Amazon Relational Database Service User Guide*.
500
+ #
501
+ #
502
+ #
503
+ # [1]: http://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_LogAccess.html#USER_LogAccess.Procedural.UploadtoCloudWatch
504
+ #
495
505
  # @note When making an API call, you may pass CloudwatchLogsExportConfiguration
496
506
  # data as a hash:
497
507
  #
@@ -1195,6 +1205,13 @@ module Aws::RDS
1195
1205
  # enable_iam_database_authentication: false,
1196
1206
  # backtrack_window: 1,
1197
1207
  # enable_cloudwatch_logs_exports: ["String"],
1208
+ # engine_mode: "String",
1209
+ # scaling_configuration: {
1210
+ # min_capacity: 1,
1211
+ # max_capacity: 1,
1212
+ # auto_pause: false,
1213
+ # seconds_until_auto_pause: 1,
1214
+ # },
1198
1215
  # source_region: "String",
1199
1216
  # }
1200
1217
  #
@@ -1485,9 +1502,26 @@ module Aws::RDS
1485
1502
  #
1486
1503
  # @!attribute [rw] enable_cloudwatch_logs_exports
1487
1504
  # The list of log types that need to be enabled for exporting to
1488
- # CloudWatch Logs.
1505
+ # CloudWatch Logs. The values in the list depend on the DB engine
1506
+ # being used. For more information, see [Publishing Database Logs to
1507
+ # Amazon CloudWatch Logs ][1] in the *Amazon Relational Database
1508
+ # Service User Guide*.
1509
+ #
1510
+ #
1511
+ #
1512
+ # [1]: http://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_LogAccess.html#USER_LogAccess.Procedural.UploadtoCloudWatch
1489
1513
  # @return [Array<String>]
1490
1514
  #
1515
+ # @!attribute [rw] engine_mode
1516
+ # The DB engine mode of the DB cluster, either `provisioned` or
1517
+ # `serverless`.
1518
+ # @return [String]
1519
+ #
1520
+ # @!attribute [rw] scaling_configuration
1521
+ # For DB clusters in `serverless` DB engine mode, the scaling
1522
+ # properties of the DB cluster.
1523
+ # @return [Types::ScalingConfiguration]
1524
+ #
1491
1525
  # @!attribute [rw] destination_region
1492
1526
  # @return [String]
1493
1527
  #
@@ -1523,6 +1557,8 @@ module Aws::RDS
1523
1557
  :enable_iam_database_authentication,
1524
1558
  :backtrack_window,
1525
1559
  :enable_cloudwatch_logs_exports,
1560
+ :engine_mode,
1561
+ :scaling_configuration,
1526
1562
  :destination_region,
1527
1563
  :source_region)
1528
1564
  include Aws::Structure
@@ -2371,19 +2407,26 @@ module Aws::RDS
2371
2407
  # of false specifies an internal instance with a DNS name that
2372
2408
  # resolves to a private IP address.
2373
2409
  #
2374
- # Default: The default behavior varies depending on whether a VPC has
2375
- # been requested or not. The following list shows the default behavior
2376
- # in each case.
2410
+ # Default: The default behavior varies depending on whether
2411
+ # `DBSubnetGroupName` is specified.
2412
+ #
2413
+ # If `DBSubnetGroupName` is not specified, and `PubliclyAccessible` is
2414
+ # not specified, the following applies:
2415
+ #
2416
+ # * If the default VPC in the target region doesn’t have an Internet
2417
+ # gateway attached to it, the DB instance is private.
2377
2418
  #
2378
- # * **Default VPC:** true
2419
+ # * If the default VPC in the target region has an Internet gateway
2420
+ # attached to it, the DB instance is public.
2379
2421
  #
2380
- # * **VPC:** false
2422
+ # If `DBSubnetGroupName` is specified, and `PubliclyAccessible` is not
2423
+ # specified, the following applies:
2381
2424
  #
2382
- # If no DB subnet group has been specified as part of the request and
2383
- # the PubliclyAccessible value has not been set, the DB instance is
2384
- # publicly accessible. If a specific DB subnet group has been
2385
- # specified as part of the request and the PubliclyAccessible value
2386
- # has not been set, the DB instance is private.
2425
+ # * If the subnets are part of a VPC that doesn’t have an Internet
2426
+ # gateway attached to it, the DB instance is private.
2427
+ #
2428
+ # * If the subnets are part of a VPC that has an Internet gateway
2429
+ # attached to it, the DB instance is public.
2387
2430
  # @return [Boolean]
2388
2431
  #
2389
2432
  # @!attribute [rw] tags
@@ -2568,7 +2611,14 @@ module Aws::RDS
2568
2611
  #
2569
2612
  # @!attribute [rw] enable_cloudwatch_logs_exports
2570
2613
  # The list of log types that need to be enabled for exporting to
2571
- # CloudWatch Logs.
2614
+ # CloudWatch Logs. The values in the list depend on the DB engine
2615
+ # being used. For more information, see [Publishing Database Logs to
2616
+ # Amazon CloudWatch Logs ][1] in the *Amazon Relational Database
2617
+ # Service User Guide*.
2618
+ #
2619
+ #
2620
+ #
2621
+ # [1]: http://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_LogAccess.html#USER_LogAccess.Procedural.UploadtoCloudWatch
2572
2622
  # @return [Array<String>]
2573
2623
  #
2574
2624
  # @!attribute [rw] processor_features
@@ -2771,21 +2821,8 @@ module Aws::RDS
2771
2821
  # true specifies an Internet-facing instance with a publicly
2772
2822
  # resolvable DNS name, which resolves to a public IP address. A value
2773
2823
  # of false specifies an internal instance with a DNS name that
2774
- # resolves to a private IP address.
2775
- #
2776
- # Default: The default behavior varies depending on whether a VPC has
2777
- # been requested or not. The following list shows the default behavior
2778
- # in each case.
2779
- #
2780
- # * **Default VPC:**true
2781
- #
2782
- # * **VPC:**false
2783
- #
2784
- # If no DB subnet group has been specified as part of the request and
2785
- # the PubliclyAccessible value has not been set, the DB instance is
2786
- # publicly accessible. If a specific DB subnet group has been
2787
- # specified as part of the request and the PubliclyAccessible value
2788
- # has not been set, the DB instance is private.
2824
+ # resolves to a private IP address. For more information, see
2825
+ # CreateDBInstance.
2789
2826
  # @return [Boolean]
2790
2827
  #
2791
2828
  # @!attribute [rw] tags
@@ -2983,7 +3020,13 @@ module Aws::RDS
2983
3020
  #
2984
3021
  # @!attribute [rw] enable_cloudwatch_logs_exports
2985
3022
  # The list of logs that the new DB instance is to export to CloudWatch
2986
- # Logs.
3023
+ # Logs. The values in the list depend on the DB engine being used. For
3024
+ # more information, see [Publishing Database Logs to Amazon CloudWatch
3025
+ # Logs ][1] in the *Amazon Relational Database Service User Guide*.
3026
+ #
3027
+ #
3028
+ #
3029
+ # [1]: http://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_LogAccess.html#USER_LogAccess.Procedural.UploadtoCloudWatch
2987
3030
  # @return [Array<String>]
2988
3031
  #
2989
3032
  # @!attribute [rw] processor_features
@@ -3752,8 +3795,36 @@ module Aws::RDS
3752
3795
  # @!attribute [rw] enabled_cloudwatch_logs_exports
3753
3796
  # A list of log types that this DB cluster is configured to export to
3754
3797
  # CloudWatch Logs.
3798
+ #
3799
+ # Log types vary by DB engine. For information about the log types for
3800
+ # each DB engine, see [Amazon RDS Database Log Files][1] in the
3801
+ # *Amazon RDS User Guide.*
3802
+ #
3803
+ #
3804
+ #
3805
+ # [1]: http://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_LogAccess.html
3755
3806
  # @return [Array<String>]
3756
3807
  #
3808
+ # @!attribute [rw] capacity
3809
+ # @return [Integer]
3810
+ #
3811
+ # @!attribute [rw] engine_mode
3812
+ # The DB engine mode of the DB cluster, either `provisioned` or
3813
+ # `serverless`.
3814
+ # @return [String]
3815
+ #
3816
+ # @!attribute [rw] scaling_configuration_info
3817
+ # Shows the scaling configuration for an Aurora DB cluster in
3818
+ # `serverless` DB engine mode.
3819
+ #
3820
+ # For more information, see [Using Amazon Aurora Serverless][1] in the
3821
+ # *Amazon RDS User Guide*.
3822
+ #
3823
+ #
3824
+ #
3825
+ # [1]: http://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/aurora-serverless.html
3826
+ # @return [Types::ScalingConfigurationInfo]
3827
+ #
3757
3828
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DBCluster AWS API Documentation
3758
3829
  #
3759
3830
  class DBCluster < Struct.new(
@@ -3795,7 +3866,10 @@ module Aws::RDS
3795
3866
  :earliest_backtrack_time,
3796
3867
  :backtrack_window,
3797
3868
  :backtrack_consumed_change_records,
3798
- :enabled_cloudwatch_logs_exports)
3869
+ :enabled_cloudwatch_logs_exports,
3870
+ :capacity,
3871
+ :engine_mode,
3872
+ :scaling_configuration_info)
3799
3873
  include Aws::Structure
3800
3874
  end
3801
3875
 
@@ -3872,6 +3946,41 @@ module Aws::RDS
3872
3946
  include Aws::Structure
3873
3947
  end
3874
3948
 
3949
+ # @!attribute [rw] db_cluster_identifier
3950
+ # A user-supplied DB cluster identifier. This identifier is the unique
3951
+ # key that identifies a DB cluster.
3952
+ # @return [String]
3953
+ #
3954
+ # @!attribute [rw] pending_capacity
3955
+ # A value that specifies the capacity that the DB cluster scales to
3956
+ # next.
3957
+ # @return [Integer]
3958
+ #
3959
+ # @!attribute [rw] current_capacity
3960
+ # The current capacity of the DB cluster.
3961
+ # @return [Integer]
3962
+ #
3963
+ # @!attribute [rw] seconds_before_timeout
3964
+ # The number of seconds before a call to
3965
+ # `ModifyCurrentDBClusterCapacity` times out.
3966
+ # @return [Integer]
3967
+ #
3968
+ # @!attribute [rw] timeout_action
3969
+ # The timeout action of a call to `ModifyCurrentDBClusterCapacity`,
3970
+ # either `ForceApplyCapacityChange` or `RollbackCapacityChange`.
3971
+ # @return [String]
3972
+ #
3973
+ # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DBClusterCapacityInfo AWS API Documentation
3974
+ #
3975
+ class DBClusterCapacityInfo < Struct.new(
3976
+ :db_cluster_identifier,
3977
+ :pending_capacity,
3978
+ :current_capacity,
3979
+ :seconds_before_timeout,
3980
+ :timeout_action)
3981
+ include Aws::Structure
3982
+ end
3983
+
3875
3984
  # Contains information about an instance that is part of a DB cluster.
3876
3985
  #
3877
3986
  # @!attribute [rw] db_instance_identifier
@@ -4067,11 +4176,15 @@ module Aws::RDS
4067
4176
  # access other AWS services on your behalf.
4068
4177
  # @return [String]
4069
4178
  #
4179
+ # @!attribute [rw] feature_name
4180
+ # @return [String]
4181
+ #
4070
4182
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DBClusterRole AWS API Documentation
4071
4183
  #
4072
4184
  class DBClusterRole < Struct.new(
4073
4185
  :role_arn,
4074
- :status)
4186
+ :status,
4187
+ :feature_name)
4075
4188
  include Aws::Structure
4076
4189
  end
4077
4190
 
@@ -4337,6 +4450,10 @@ module Aws::RDS
4337
4450
  # replicas.
4338
4451
  # @return [Boolean]
4339
4452
  #
4453
+ # @!attribute [rw] supported_engine_modes
4454
+ # A list of the supported DB engine modes.
4455
+ # @return [Array<String>]
4456
+ #
4340
4457
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DBEngineVersion AWS API Documentation
4341
4458
  #
4342
4459
  class DBEngineVersion < Struct.new(
@@ -4351,7 +4468,8 @@ module Aws::RDS
4351
4468
  :supported_timezones,
4352
4469
  :exportable_log_types,
4353
4470
  :supports_log_exports_to_cloudwatch_logs,
4354
- :supports_read_replica)
4471
+ :supports_read_replica,
4472
+ :supported_engine_modes)
4355
4473
  include Aws::Structure
4356
4474
  end
4357
4475
 
@@ -4547,20 +4665,6 @@ module Aws::RDS
4547
4665
  # resolvable DNS name, which resolves to a public IP address. A value
4548
4666
  # of false specifies an internal instance with a DNS name that
4549
4667
  # resolves to a private IP address.
4550
- #
4551
- # Default: The default behavior varies depending on whether a VPC has
4552
- # been requested or not. The following list shows the default behavior
4553
- # in each case.
4554
- #
4555
- # * **Default VPC:**true
4556
- #
4557
- # * **VPC:**false
4558
- #
4559
- # If no DB subnet group has been specified as part of the request and
4560
- # the PubliclyAccessible value has not been set, the DB instance is
4561
- # publicly accessible. If a specific DB subnet group has been
4562
- # specified as part of the request and the PubliclyAccessible value
4563
- # has not been set, the DB instance is private.
4564
4668
  # @return [Boolean]
4565
4669
  #
4566
4670
  # @!attribute [rw] status_infos
@@ -4688,6 +4792,14 @@ module Aws::RDS
4688
4792
  # @!attribute [rw] enabled_cloudwatch_logs_exports
4689
4793
  # A list of log types that this DB instance is configured to export to
4690
4794
  # CloudWatch Logs.
4795
+ #
4796
+ # Log types vary by DB engine. For information about the log types for
4797
+ # each DB engine, see [Amazon RDS Database Log Files][1] in the
4798
+ # *Amazon RDS User Guide.*
4799
+ #
4800
+ #
4801
+ #
4802
+ # [1]: http://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_LogAccess.html
4691
4803
  # @return [Array<String>]
4692
4804
  #
4693
4805
  # @!attribute [rw] processor_features
@@ -4789,7 +4901,8 @@ module Aws::RDS
4789
4901
  #
4790
4902
  # @!attribute [rw] status
4791
4903
  # Status of the DB instance. For a StatusType of read replica, the
4792
- # values can be replicating, error, stopped, or terminated.
4904
+ # values can be replicating, replication stop point set, replication
4905
+ # stop point reached, error, stopped, or terminated.
4793
4906
  # @return [String]
4794
4907
  #
4795
4908
  # @!attribute [rw] message
@@ -8371,6 +8484,69 @@ module Aws::RDS
8371
8484
  include Aws::Structure
8372
8485
  end
8373
8486
 
8487
+ # @note When making an API call, you may pass ModifyCurrentDBClusterCapacityMessage
8488
+ # data as a hash:
8489
+ #
8490
+ # {
8491
+ # db_cluster_identifier: "String", # required
8492
+ # capacity: 1,
8493
+ # seconds_before_timeout: 1,
8494
+ # timeout_action: "String",
8495
+ # }
8496
+ #
8497
+ # @!attribute [rw] db_cluster_identifier
8498
+ # The DB cluster identifier for the cluster being modified. This
8499
+ # parameter is not case-sensitive.
8500
+ #
8501
+ # Constraints:
8502
+ #
8503
+ # * Must match the identifier of an existing DB cluster.
8504
+ #
8505
+ # ^
8506
+ # @return [String]
8507
+ #
8508
+ # @!attribute [rw] capacity
8509
+ # The DB cluster capacity.
8510
+ #
8511
+ # Constraints:
8512
+ #
8513
+ # * Value must be `2`, `4`, `8`, `16`, `32`, `64`, `128`, or `256`.
8514
+ #
8515
+ # ^
8516
+ # @return [Integer]
8517
+ #
8518
+ # @!attribute [rw] seconds_before_timeout
8519
+ # The amount of time, in seconds, that Aurora Serverless tries to find
8520
+ # a scaling point to perform seamless scaling before enforcing the
8521
+ # timeout action. The default is 300.
8522
+ #
8523
+ # * Value must be from 10 through 600.
8524
+ #
8525
+ # ^
8526
+ # @return [Integer]
8527
+ #
8528
+ # @!attribute [rw] timeout_action
8529
+ # The action to take when the timeout is reached, either
8530
+ # `ForceApplyCapacityChange` or `RollbackCapacityChange`.
8531
+ #
8532
+ # `ForceApplyCapacityChange`, the default, drops connections to the DB
8533
+ # cluster and sets the capacity to the specified value as soon as
8534
+ # possible.
8535
+ #
8536
+ # `RollbackCapacityChange` ignores the capacity change if a scaling
8537
+ # point is not found in the timeout period.
8538
+ # @return [String]
8539
+ #
8540
+ # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/ModifyCurrentDBClusterCapacityMessage AWS API Documentation
8541
+ #
8542
+ class ModifyCurrentDBClusterCapacityMessage < Struct.new(
8543
+ :db_cluster_identifier,
8544
+ :capacity,
8545
+ :seconds_before_timeout,
8546
+ :timeout_action)
8547
+ include Aws::Structure
8548
+ end
8549
+
8374
8550
  # @note When making an API call, you may pass ModifyDBClusterMessage
8375
8551
  # data as a hash:
8376
8552
  #
@@ -8393,6 +8569,12 @@ module Aws::RDS
8393
8569
  # disable_log_types: ["String"],
8394
8570
  # },
8395
8571
  # engine_version: "String",
8572
+ # scaling_configuration: {
8573
+ # min_capacity: 1,
8574
+ # max_capacity: 1,
8575
+ # auto_pause: false,
8576
+ # seconds_until_auto_pause: 1,
8577
+ # },
8396
8578
  # }
8397
8579
  #
8398
8580
  # @!attribute [rw] db_cluster_identifier
@@ -8573,6 +8755,11 @@ module Aws::RDS
8573
8755
  # DescribeDBEngineVersions.
8574
8756
  # @return [String]
8575
8757
  #
8758
+ # @!attribute [rw] scaling_configuration
8759
+ # The scaling properties of the DB cluster. You can only modify
8760
+ # scaling properties for DB clusters in `serverless` DB engine mode.
8761
+ # @return [Types::ScalingConfiguration]
8762
+ #
8576
8763
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/ModifyDBClusterMessage AWS API Documentation
8577
8764
  #
8578
8765
  class ModifyDBClusterMessage < Struct.new(
@@ -8590,7 +8777,8 @@ module Aws::RDS
8590
8777
  :enable_iam_database_authentication,
8591
8778
  :backtrack_window,
8592
8779
  :cloudwatch_logs_export_configuration,
8593
- :engine_version)
8780
+ :engine_version,
8781
+ :scaling_configuration)
8594
8782
  include Aws::Structure
8595
8783
  end
8596
8784
 
@@ -8611,6 +8799,7 @@ module Aws::RDS
8611
8799
  # is_modifiable: false,
8612
8800
  # minimum_engine_version: "String",
8613
8801
  # apply_method: "immediate", # accepts immediate, pending-reboot
8802
+ # supported_engine_modes: ["String"],
8614
8803
  # },
8615
8804
  # ],
8616
8805
  # }
@@ -9447,6 +9636,7 @@ module Aws::RDS
9447
9636
  # is_modifiable: false,
9448
9637
  # minimum_engine_version: "String",
9449
9638
  # apply_method: "immediate", # accepts immediate, pending-reboot
9639
+ # supported_engine_modes: ["String"],
9450
9640
  # },
9451
9641
  # ],
9452
9642
  # }
@@ -10384,6 +10574,10 @@ module Aws::RDS
10384
10574
  # of a DB instance.
10385
10575
  # @return [Array<Types::AvailableProcessorFeature>]
10386
10576
  #
10577
+ # @!attribute [rw] supported_engine_modes
10578
+ # A list of the supported DB engine modes.
10579
+ # @return [Array<String>]
10580
+ #
10387
10581
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/OrderableDBInstanceOption AWS API Documentation
10388
10582
  #
10389
10583
  class OrderableDBInstanceOption < Struct.new(
@@ -10407,7 +10601,8 @@ module Aws::RDS
10407
10601
  :max_iops_per_db_instance,
10408
10602
  :min_iops_per_gib,
10409
10603
  :max_iops_per_gib,
10410
- :available_processor_features)
10604
+ :available_processor_features,
10605
+ :supported_engine_modes)
10411
10606
  include Aws::Structure
10412
10607
  end
10413
10608
 
@@ -10454,6 +10649,7 @@ module Aws::RDS
10454
10649
  # is_modifiable: false,
10455
10650
  # minimum_engine_version: "String",
10456
10651
  # apply_method: "immediate", # accepts immediate, pending-reboot
10652
+ # supported_engine_modes: ["String"],
10457
10653
  # }
10458
10654
  #
10459
10655
  # @!attribute [rw] parameter_name
@@ -10498,6 +10694,10 @@ module Aws::RDS
10498
10694
  # Indicates when to apply parameter updates.
10499
10695
  # @return [String]
10500
10696
  #
10697
+ # @!attribute [rw] supported_engine_modes
10698
+ # The valid DB engine modes.
10699
+ # @return [Array<String>]
10700
+ #
10501
10701
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/Parameter AWS API Documentation
10502
10702
  #
10503
10703
  class Parameter < Struct.new(
@@ -10510,7 +10710,8 @@ module Aws::RDS
10510
10710
  :allowed_values,
10511
10711
  :is_modifiable,
10512
10712
  :minimum_engine_version,
10513
- :apply_method)
10713
+ :apply_method,
10714
+ :supported_engine_modes)
10514
10715
  include Aws::Structure
10515
10716
  end
10516
10717
 
@@ -11355,6 +11556,7 @@ module Aws::RDS
11355
11556
  # is_modifiable: false,
11356
11557
  # minimum_engine_version: "String",
11357
11558
  # apply_method: "immediate", # accepts immediate, pending-reboot
11559
+ # supported_engine_modes: ["String"],
11358
11560
  # },
11359
11561
  # ],
11360
11562
  # }
@@ -11403,6 +11605,7 @@ module Aws::RDS
11403
11605
  # is_modifiable: false,
11404
11606
  # minimum_engine_version: "String",
11405
11607
  # apply_method: "immediate", # accepts immediate, pending-reboot
11608
+ # supported_engine_modes: ["String"],
11406
11609
  # },
11407
11610
  # ],
11408
11611
  # }
@@ -11771,7 +11974,14 @@ module Aws::RDS
11771
11974
  #
11772
11975
  # @!attribute [rw] enable_cloudwatch_logs_exports
11773
11976
  # The list of logs that the restored DB cluster is to export to
11774
- # CloudWatch Logs.
11977
+ # CloudWatch Logs. The values in the list depend on the DB engine
11978
+ # being used. For more information, see [Publishing Database Logs to
11979
+ # Amazon CloudWatch Logs ][1] in the *Amazon Relational Database
11980
+ # Service User Guide*.
11981
+ #
11982
+ #
11983
+ #
11984
+ # [1]: http://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_LogAccess.html#USER_LogAccess.Procedural.UploadtoCloudWatch
11775
11985
  # @return [Array<String>]
11776
11986
  #
11777
11987
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/RestoreDBClusterFromS3Message AWS API Documentation
@@ -11845,6 +12055,13 @@ module Aws::RDS
11845
12055
  # enable_iam_database_authentication: false,
11846
12056
  # backtrack_window: 1,
11847
12057
  # enable_cloudwatch_logs_exports: ["String"],
12058
+ # engine_mode: "String",
12059
+ # scaling_configuration: {
12060
+ # min_capacity: 1,
12061
+ # max_capacity: 1,
12062
+ # auto_pause: false,
12063
+ # seconds_until_auto_pause: 1,
12064
+ # },
11848
12065
  # }
11849
12066
  #
11850
12067
  # @!attribute [rw] availability_zones
@@ -11973,9 +12190,26 @@ module Aws::RDS
11973
12190
  #
11974
12191
  # @!attribute [rw] enable_cloudwatch_logs_exports
11975
12192
  # The list of logs that the restored DB cluster is to export to
11976
- # CloudWatch Logs.
12193
+ # CloudWatch Logs. The values in the list depend on the DB engine
12194
+ # being used. For more information, see [Publishing Database Logs to
12195
+ # Amazon CloudWatch Logs ][1] in the *Amazon Relational Database
12196
+ # Service User Guide*.
12197
+ #
12198
+ #
12199
+ #
12200
+ # [1]: http://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_LogAccess.html#USER_LogAccess.Procedural.UploadtoCloudWatch
11977
12201
  # @return [Array<String>]
11978
12202
  #
12203
+ # @!attribute [rw] engine_mode
12204
+ # The DB engine mode of the DB cluster, either `provisioned` or
12205
+ # `serverless`.
12206
+ # @return [String]
12207
+ #
12208
+ # @!attribute [rw] scaling_configuration
12209
+ # For DB clusters in `serverless` DB engine mode, the scaling
12210
+ # properties of the DB cluster.
12211
+ # @return [Types::ScalingConfiguration]
12212
+ #
11979
12213
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/RestoreDBClusterFromSnapshotMessage AWS API Documentation
11980
12214
  #
11981
12215
  class RestoreDBClusterFromSnapshotMessage < Struct.new(
@@ -11993,7 +12227,9 @@ module Aws::RDS
11993
12227
  :kms_key_id,
11994
12228
  :enable_iam_database_authentication,
11995
12229
  :backtrack_window,
11996
- :enable_cloudwatch_logs_exports)
12230
+ :enable_cloudwatch_logs_exports,
12231
+ :engine_mode,
12232
+ :scaling_configuration)
11997
12233
  include Aws::Structure
11998
12234
  end
11999
12235
 
@@ -12191,7 +12427,14 @@ module Aws::RDS
12191
12427
  #
12192
12428
  # @!attribute [rw] enable_cloudwatch_logs_exports
12193
12429
  # The list of logs that the restored DB cluster is to export to
12194
- # CloudWatch Logs.
12430
+ # CloudWatch Logs. The values in the list depend on the DB engine
12431
+ # being used. For more information, see [Publishing Database Logs to
12432
+ # Amazon CloudWatch Logs ][1] in the *Amazon Relational Database
12433
+ # Service User Guide*.
12434
+ #
12435
+ #
12436
+ #
12437
+ # [1]: http://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_LogAccess.html#USER_LogAccess.Procedural.UploadtoCloudWatch
12195
12438
  # @return [Array<String>]
12196
12439
  #
12197
12440
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/RestoreDBClusterToPointInTimeMessage AWS API Documentation
@@ -12349,21 +12592,8 @@ module Aws::RDS
12349
12592
  # true specifies an Internet-facing instance with a publicly
12350
12593
  # resolvable DNS name, which resolves to a public IP address. A value
12351
12594
  # of false specifies an internal instance with a DNS name that
12352
- # resolves to a private IP address.
12353
- #
12354
- # Default: The default behavior varies depending on whether a VPC has
12355
- # been requested or not. The following list shows the default behavior
12356
- # in each case.
12357
- #
12358
- # * **Default VPC:** true
12359
- #
12360
- # * **VPC:** false
12361
- #
12362
- # If no DB subnet group has been specified as part of the request and
12363
- # the PubliclyAccessible value has not been set, the DB instance is
12364
- # publicly accessible. If a specific DB subnet group has been
12365
- # specified as part of the request and the PubliclyAccessible value
12366
- # has not been set, the DB instance is private.
12595
+ # resolves to a private IP address. For more information, see
12596
+ # CreateDBInstance.
12367
12597
  # @return [Boolean]
12368
12598
  #
12369
12599
  # @!attribute [rw] auto_minor_version_upgrade
@@ -12513,7 +12743,14 @@ module Aws::RDS
12513
12743
  #
12514
12744
  # @!attribute [rw] enable_cloudwatch_logs_exports
12515
12745
  # The list of logs that the restored DB instance is to export to
12516
- # CloudWatch Logs.
12746
+ # CloudWatch Logs. The values in the list depend on the DB engine
12747
+ # being used. For more information, see [Publishing Database Logs to
12748
+ # Amazon CloudWatch Logs ][1] in the *Amazon Relational Database
12749
+ # Service User Guide*.
12750
+ #
12751
+ #
12752
+ #
12753
+ # [1]: http://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_LogAccess.html#USER_LogAccess.Procedural.UploadtoCloudWatch
12517
12754
  # @return [Array<String>]
12518
12755
  #
12519
12756
  # @!attribute [rw] processor_features
@@ -12841,8 +13078,12 @@ module Aws::RDS
12841
13078
  # @return [String]
12842
13079
  #
12843
13080
  # @!attribute [rw] publicly_accessible
12844
- # Specifies whether the DB instance is publicly accessible or not. For
12845
- # more information, see CreateDBInstance.
13081
+ # Specifies the accessibility options for the DB instance. A value of
13082
+ # true specifies an Internet-facing instance with a publicly
13083
+ # resolvable DNS name, which resolves to a public IP address. A value
13084
+ # of false specifies an internal instance with a DNS name that
13085
+ # resolves to a private IP address. For more information, see
13086
+ # CreateDBInstance.
12846
13087
  # @return [Boolean]
12847
13088
  #
12848
13089
  # @!attribute [rw] tags
@@ -12979,7 +13220,14 @@ module Aws::RDS
12979
13220
  #
12980
13221
  # @!attribute [rw] enable_cloudwatch_logs_exports
12981
13222
  # The list of logs that the restored DB instance is to export to
12982
- # CloudWatch Logs.
13223
+ # CloudWatch Logs. The values in the list depend on the DB engine
13224
+ # being used. For more information, see [Publishing Database Logs to
13225
+ # Amazon CloudWatch Logs ][1] in the *Amazon Relational Database
13226
+ # Service User Guide*.
13227
+ #
13228
+ #
13229
+ #
13230
+ # [1]: http://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_LogAccess.html#USER_LogAccess.Procedural.UploadtoCloudWatch
12983
13231
  # @return [Array<String>]
12984
13232
  #
12985
13233
  # @!attribute [rw] processor_features
@@ -13198,21 +13446,8 @@ module Aws::RDS
13198
13446
  # true specifies an Internet-facing instance with a publicly
13199
13447
  # resolvable DNS name, which resolves to a public IP address. A value
13200
13448
  # of false specifies an internal instance with a DNS name that
13201
- # resolves to a private IP address.
13202
- #
13203
- # Default: The default behavior varies depending on whether a VPC has
13204
- # been requested or not. The following list shows the default behavior
13205
- # in each case.
13206
- #
13207
- # * **Default VPC:**true
13208
- #
13209
- # * **VPC:**false
13210
- #
13211
- # If no DB subnet group has been specified as part of the request and
13212
- # the PubliclyAccessible value has not been set, the DB instance is
13213
- # publicly accessible. If a specific DB subnet group has been
13214
- # specified as part of the request and the PubliclyAccessible value
13215
- # has not been set, the DB instance is private.
13449
+ # resolves to a private IP address. For more information, see
13450
+ # CreateDBInstance.
13216
13451
  # @return [Boolean]
13217
13452
  #
13218
13453
  # @!attribute [rw] auto_minor_version_upgrade
@@ -13352,7 +13587,14 @@ module Aws::RDS
13352
13587
  #
13353
13588
  # @!attribute [rw] enable_cloudwatch_logs_exports
13354
13589
  # The list of logs that the restored DB instance is to export to
13355
- # CloudWatch Logs.
13590
+ # CloudWatch Logs. The values in the list depend on the DB engine
13591
+ # being used. For more information, see [Publishing Database Logs to
13592
+ # Amazon CloudWatch Logs ][1] in the *Amazon Relational Database
13593
+ # Service User Guide*.
13594
+ #
13595
+ #
13596
+ #
13597
+ # [1]: http://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_LogAccess.html#USER_LogAccess.Procedural.UploadtoCloudWatch
13356
13598
  # @return [Array<String>]
13357
13599
  #
13358
13600
  # @!attribute [rw] processor_features
@@ -13481,6 +13723,115 @@ module Aws::RDS
13481
13723
  include Aws::Structure
13482
13724
  end
13483
13725
 
13726
+ # Contains the scaling configuration of an Aurora Serverless DB cluster.
13727
+ #
13728
+ # For more information, see [Using Amazon Aurora Serverless][1] in the
13729
+ # *Amazon RDS User Guide*.
13730
+ #
13731
+ #
13732
+ #
13733
+ # [1]: http://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/aurora-serverless.html
13734
+ #
13735
+ # @note When making an API call, you may pass ScalingConfiguration
13736
+ # data as a hash:
13737
+ #
13738
+ # {
13739
+ # min_capacity: 1,
13740
+ # max_capacity: 1,
13741
+ # auto_pause: false,
13742
+ # seconds_until_auto_pause: 1,
13743
+ # }
13744
+ #
13745
+ # @!attribute [rw] min_capacity
13746
+ # The minimum capacity for an Aurora DB cluster in `serverless` DB
13747
+ # engine mode.
13748
+ #
13749
+ # Valid capacity values are `2`, `4`, `8`, `16`, `32`, `64`, `128`,
13750
+ # and `256`.
13751
+ #
13752
+ # The minimum capacity must be less than or equal to the maximum
13753
+ # capacity.
13754
+ # @return [Integer]
13755
+ #
13756
+ # @!attribute [rw] max_capacity
13757
+ # The maximum capacity for an Aurora DB cluster in `serverless` DB
13758
+ # engine mode.
13759
+ #
13760
+ # Valid capacity values are `2`, `4`, `8`, `16`, `32`, `64`, `128`,
13761
+ # and `256`.
13762
+ #
13763
+ # The maximum capacity must be greater than or equal to the minimum
13764
+ # capacity.
13765
+ # @return [Integer]
13766
+ #
13767
+ # @!attribute [rw] auto_pause
13768
+ # A value that specifies whether to allow or disallow automatic pause
13769
+ # for an Aurora DB cluster in `serverless` DB engine mode. A DB
13770
+ # cluster can be paused only when it's idle (it has no connections).
13771
+ #
13772
+ # <note markdown="1"> If a DB cluster is paused for more than seven days, the DB cluster
13773
+ # might be backed up with a snapshot. In this case, the DB cluster is
13774
+ # restored when there is a request to connect to it.
13775
+ #
13776
+ # </note>
13777
+ # @return [Boolean]
13778
+ #
13779
+ # @!attribute [rw] seconds_until_auto_pause
13780
+ # The time, in seconds, before an Aurora DB cluster in `serverless`
13781
+ # mode is paused.
13782
+ # @return [Integer]
13783
+ #
13784
+ # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/ScalingConfiguration AWS API Documentation
13785
+ #
13786
+ class ScalingConfiguration < Struct.new(
13787
+ :min_capacity,
13788
+ :max_capacity,
13789
+ :auto_pause,
13790
+ :seconds_until_auto_pause)
13791
+ include Aws::Structure
13792
+ end
13793
+
13794
+ # Shows the scaling configuration for an Aurora DB cluster in
13795
+ # `serverless` DB engine mode.
13796
+ #
13797
+ # For more information, see [Using Amazon Aurora Serverless][1] in the
13798
+ # *Amazon RDS User Guide*.
13799
+ #
13800
+ #
13801
+ #
13802
+ # [1]: http://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/aurora-serverless.html
13803
+ #
13804
+ # @!attribute [rw] min_capacity
13805
+ # The maximum capacity for the Aurora DB cluster in `serverless` DB
13806
+ # engine mode.
13807
+ # @return [Integer]
13808
+ #
13809
+ # @!attribute [rw] max_capacity
13810
+ # The maximum capacity for an Aurora DB cluster in `serverless` DB
13811
+ # engine mode.
13812
+ # @return [Integer]
13813
+ #
13814
+ # @!attribute [rw] auto_pause
13815
+ # A value that indicates whether automatic pause is allowed for the
13816
+ # Aurora DB cluster in `serverless` DB engine mode.
13817
+ # @return [Boolean]
13818
+ #
13819
+ # @!attribute [rw] seconds_until_auto_pause
13820
+ # The remaining amount of time, in seconds, before the Aurora DB
13821
+ # cluster in `serverless` mode is paused. A DB cluster can be paused
13822
+ # only when it's idle (it has no connections).
13823
+ # @return [Integer]
13824
+ #
13825
+ # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/ScalingConfigurationInfo AWS API Documentation
13826
+ #
13827
+ class ScalingConfigurationInfo < Struct.new(
13828
+ :min_capacity,
13829
+ :max_capacity,
13830
+ :auto_pause,
13831
+ :seconds_until_auto_pause)
13832
+ include Aws::Structure
13833
+ end
13834
+
13484
13835
  # Contains an AWS Region name as the result of a successful call to the
13485
13836
  # DescribeSourceRegions action.
13486
13837
  #