aws-sdk-rds 1.252.0 → 1.262.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -285,8 +285,25 @@ module Aws::RDS
285
285
  # @!attribute [rw] apply_action
286
286
  # The pending maintenance action to apply to this resource.
287
287
  #
288
- # Valid Values: `system-update`, `db-upgrade`, `hardware-maintenance`,
289
- # `ca-certificate-rotation`
288
+ # Valid Values:
289
+ #
290
+ # * `ca-certificate-rotation`
291
+ #
292
+ # * `db-upgrade`
293
+ #
294
+ # * `hardware-maintenance`
295
+ #
296
+ # * `os-upgrade`
297
+ #
298
+ # * `system-update`
299
+ #
300
+ # For more information about these actions, see [Maintenance actions
301
+ # for Amazon Aurora][1] or [Maintenance actions for Amazon RDS][2].
302
+ #
303
+ #
304
+ #
305
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_UpgradeDBInstance.Maintenance.html#maintenance-actions-aurora
306
+ # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_UpgradeDBInstance.Maintenance.html#maintenance-actions-rds
290
307
  # @return [String]
291
308
  #
292
309
  # @!attribute [rw] opt_in_type
@@ -1843,6 +1860,43 @@ module Aws::RDS
1843
1860
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PIOPS.StorageTypes.html#USER_PIOPS.UpgradeFileSystem
1844
1861
  # @return [Boolean]
1845
1862
  #
1863
+ # @!attribute [rw] target_iops
1864
+ # The amount of Provisioned IOPS (input/output operations per second)
1865
+ # to allocate for the green DB instance. For information about valid
1866
+ # IOPS values, see [Amazon RDS DB instance storage][1] in the *Amazon
1867
+ # RDS User Guide*.
1868
+ #
1869
+ # This setting doesn't apply to Amazon Aurora blue/green deployments.
1870
+ #
1871
+ #
1872
+ #
1873
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_Storage.html
1874
+ # @return [Integer]
1875
+ #
1876
+ # @!attribute [rw] target_storage_type
1877
+ # The storage type to associate with the green DB instance.
1878
+ #
1879
+ # Valid Values: `gp2 | gp3 | io1 | io2`
1880
+ #
1881
+ # This setting doesn't apply to Amazon Aurora blue/green deployments.
1882
+ # @return [String]
1883
+ #
1884
+ # @!attribute [rw] target_allocated_storage
1885
+ # The amount of storage in gibibytes (GiB) to allocate for the green
1886
+ # DB instance. You can choose to increase or decrease the allocated
1887
+ # storage on the green DB instance.
1888
+ #
1889
+ # This setting doesn't apply to Amazon Aurora blue/green deployments.
1890
+ # @return [Integer]
1891
+ #
1892
+ # @!attribute [rw] target_storage_throughput
1893
+ # The storage throughput value for the green DB instance.
1894
+ #
1895
+ # This setting applies only to the `gp3` storage type.
1896
+ #
1897
+ # This setting doesn't apply to Amazon Aurora blue/green deployments.
1898
+ # @return [Integer]
1899
+ #
1846
1900
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/CreateBlueGreenDeploymentRequest AWS API Documentation
1847
1901
  #
1848
1902
  class CreateBlueGreenDeploymentRequest < Struct.new(
@@ -1853,7 +1907,11 @@ module Aws::RDS
1853
1907
  :target_db_cluster_parameter_group_name,
1854
1908
  :tags,
1855
1909
  :target_db_instance_class,
1856
- :upgrade_target_storage_config)
1910
+ :upgrade_target_storage_config,
1911
+ :target_iops,
1912
+ :target_storage_type,
1913
+ :target_allocated_storage,
1914
+ :target_storage_throughput)
1857
1915
  SENSITIVE = []
1858
1916
  include Aws::Structure
1859
1917
  end
@@ -2480,13 +2538,15 @@ module Aws::RDS
2480
2538
  # default, mapping isn't enabled.
2481
2539
  #
2482
2540
  # For more information, see [ IAM Database Authentication][1] in the
2483
- # *Amazon Aurora User Guide*.
2541
+ # *Amazon Aurora User Guide* or [IAM database authentication for
2542
+ # MariaDB, MySQL, and PostgreSQL][2] in the *Amazon RDS User Guide*.
2484
2543
  #
2485
- # Valid for Cluster Type: Aurora DB clusters only
2544
+ # Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB clusters
2486
2545
  #
2487
2546
  #
2488
2547
  #
2489
2548
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/UsingWithRDS.IAMDBAuth.html
2549
+ # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/UsingWithRDS.IAMDBAuth.html
2490
2550
  # @return [Boolean]
2491
2551
  #
2492
2552
  # @!attribute [rw] backtrack_window
@@ -2826,6 +2886,10 @@ module Aws::RDS
2826
2886
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Monitoring.OS.html#USER_Monitoring.OS.Enabling
2827
2887
  # @return [String]
2828
2888
  #
2889
+ # @!attribute [rw] database_insights_mode
2890
+ # Specifies the mode of Database Insights to enable for the cluster.
2891
+ # @return [String]
2892
+ #
2829
2893
  # @!attribute [rw] enable_performance_insights
2830
2894
  # Specifies whether to turn on Performance Insights for the DB
2831
2895
  # cluster.
@@ -2882,6 +2946,11 @@ module Aws::RDS
2882
2946
  # enable Aurora Limitless Database to create a DB shard group.
2883
2947
  #
2884
2948
  # Valid for: Aurora DB clusters only
2949
+ #
2950
+ # <note markdown="1"> This setting is no longer used. Instead use the
2951
+ # `ClusterScalabilityType` setting.
2952
+ #
2953
+ # </note>
2885
2954
  # @return [Boolean]
2886
2955
  #
2887
2956
  # @!attribute [rw] serverless_v2_scaling_configuration
@@ -3023,8 +3092,8 @@ module Aws::RDS
3023
3092
  # standard support for that engine version. For more information, see
3024
3093
  # the following sections:
3025
3094
  #
3026
- # * Amazon Aurora (PostgreSQL only) - [Using Amazon RDS Extended
3027
- # Support][1] in the *Amazon Aurora User Guide*
3095
+ # * Amazon Aurora - [Using Amazon RDS Extended Support][1] in the
3096
+ # *Amazon Aurora User Guide*
3028
3097
  #
3029
3098
  # * Amazon RDS - [Using Amazon RDS Extended Support][2] in the *Amazon
3030
3099
  # RDS User Guide*
@@ -3092,6 +3161,7 @@ module Aws::RDS
3092
3161
  :auto_minor_version_upgrade,
3093
3162
  :monitoring_interval,
3094
3163
  :monitoring_role_arn,
3164
+ :database_insights_mode,
3095
3165
  :enable_performance_insights,
3096
3166
  :performance_insights_kms_key_id,
3097
3167
  :performance_insights_retention_period,
@@ -3320,6 +3390,9 @@ module Aws::RDS
3320
3390
  #
3321
3391
  # * Must contain 1 to 64 alphanumeric characters.
3322
3392
  #
3393
+ # * Must begin with a letter. Subsequent characters can be letters,
3394
+ # underscores, or digits (0-9).
3395
+ #
3323
3396
  # * Can't be a word reserved by the database engine.
3324
3397
  #
3325
3398
  # Amazon Aurora PostgreSQL
@@ -3556,7 +3629,6 @@ module Aws::RDS
3556
3629
  # to 16384.
3557
3630
  #
3558
3631
  # * Web and Express editions: Must be an integer from 20 to 16384.
3559
- #
3560
3632
  # * Provisioned IOPS storage (io1, io2):
3561
3633
  #
3562
3634
  # * Enterprise and Standard editions: Must be an integer from 100
@@ -3564,7 +3636,6 @@ module Aws::RDS
3564
3636
  #
3565
3637
  # * Web and Express editions: Must be an integer from 100 to
3566
3638
  # 16384.
3567
- #
3568
3639
  # * Magnetic storage (standard):
3569
3640
  #
3570
3641
  # * Enterprise and Standard editions: Must be an integer from 20
@@ -4337,6 +4408,10 @@ module Aws::RDS
4337
4408
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/UsingWithRDS.IAMDBAuth.html
4338
4409
  # @return [Boolean]
4339
4410
  #
4411
+ # @!attribute [rw] database_insights_mode
4412
+ # Specifies the mode of Database Insights to enable for the instance.
4413
+ # @return [String]
4414
+ #
4340
4415
  # @!attribute [rw] enable_performance_insights
4341
4416
  # Specifies whether to enable Performance Insights for the DB
4342
4417
  # instance. For more information, see [Using Amazon Performance
@@ -4725,6 +4800,7 @@ module Aws::RDS
4725
4800
  :promotion_tier,
4726
4801
  :timezone,
4727
4802
  :enable_iam_database_authentication,
4803
+ :database_insights_mode,
4728
4804
  :enable_performance_insights,
4729
4805
  :performance_insights_kms_key_id,
4730
4806
  :performance_insights_retention_period,
@@ -5131,6 +5207,10 @@ module Aws::RDS
5131
5207
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/UsingWithRDS.IAMDBAuth.html
5132
5208
  # @return [Boolean]
5133
5209
  #
5210
+ # @!attribute [rw] database_insights_mode
5211
+ # Specifies the mode of Database Insights.
5212
+ # @return [String]
5213
+ #
5134
5214
  # @!attribute [rw] enable_performance_insights
5135
5215
  # Specifies whether to enable Performance Insights for the read
5136
5216
  # replica.
@@ -5496,6 +5576,7 @@ module Aws::RDS
5496
5576
  :kms_key_id,
5497
5577
  :pre_signed_url,
5498
5578
  :enable_iam_database_authentication,
5579
+ :database_insights_mode,
5499
5580
  :enable_performance_insights,
5500
5581
  :performance_insights_kms_key_id,
5501
5582
  :performance_insights_retention_period,
@@ -7097,6 +7178,10 @@ module Aws::RDS
7097
7178
  # This setting is only for non-Aurora Multi-AZ DB clusters.
7098
7179
  # @return [String]
7099
7180
  #
7181
+ # @!attribute [rw] database_insights_mode
7182
+ # The mode of Database Insights that is enabled for the cluster.
7183
+ # @return [String]
7184
+ #
7100
7185
  # @!attribute [rw] performance_insights_enabled
7101
7186
  # Indicates whether Performance Insights is enabled for the DB
7102
7187
  # cluster.
@@ -7307,6 +7392,7 @@ module Aws::RDS
7307
7392
  :auto_minor_version_upgrade,
7308
7393
  :monitoring_interval,
7309
7394
  :monitoring_role_arn,
7395
+ :database_insights_mode,
7310
7396
  :performance_insights_enabled,
7311
7397
  :performance_insights_kms_key_id,
7312
7398
  :performance_insights_retention_period,
@@ -8554,6 +8640,16 @@ module Aws::RDS
8554
8640
  # integrations with Amazon Redshift.
8555
8641
  # @return [Boolean]
8556
8642
  #
8643
+ # @!attribute [rw] serverless_v2_features_support
8644
+ # Specifies any Aurora Serverless v2 properties or limits that differ
8645
+ # between Aurora engine versions. You can test the values of this
8646
+ # attribute when deciding which Aurora version to use in a new or
8647
+ # upgraded DB cluster. You can also retrieve the version of an
8648
+ # existing DB cluster and check whether that version supports certain
8649
+ # Aurora Serverless v2 features before you attempt to use those
8650
+ # features.
8651
+ # @return [Types::ServerlessV2FeaturesSupport]
8652
+ #
8557
8653
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DBEngineVersion AWS API Documentation
8558
8654
  #
8559
8655
  class DBEngineVersion < Struct.new(
@@ -8590,7 +8686,8 @@ module Aws::RDS
8590
8686
  :supports_certificate_rotation_without_restart,
8591
8687
  :supported_ca_certificate_identifiers,
8592
8688
  :supports_local_write_forwarding,
8593
- :supports_integrations)
8689
+ :supports_integrations,
8690
+ :serverless_v2_features_support)
8594
8691
  SENSITIVE = []
8595
8692
  include Aws::Structure
8596
8693
  end
@@ -8959,6 +9056,10 @@ module Aws::RDS
8959
9056
  # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/Concepts.Aurora_Fea_Regions_DB-eng.Feature.IAMdbauth.html
8960
9057
  # @return [Boolean]
8961
9058
  #
9059
+ # @!attribute [rw] database_insights_mode
9060
+ # The mode of Database Insights that is enabled for the instance.
9061
+ # @return [String]
9062
+ #
8962
9063
  # @!attribute [rw] performance_insights_enabled
8963
9064
  # Indicates whether Performance Insights is enabled for the DB
8964
9065
  # instance.
@@ -9286,6 +9387,7 @@ module Aws::RDS
9286
9387
  :db_instance_arn,
9287
9388
  :timezone,
9288
9389
  :iam_database_authentication_enabled,
9390
+ :database_insights_mode,
9289
9391
  :performance_insights_enabled,
9290
9392
  :performance_insights_kms_key_id,
9291
9393
  :performance_insights_retention_period,
@@ -9611,6 +9713,13 @@ module Aws::RDS
9611
9713
  #
9612
9714
  class DBInstanceNotFoundFault < Aws::EmptyStructure; end
9613
9715
 
9716
+ # An attempt to download or examine log files didn't succeed because an
9717
+ # Aurora Serverless v2 instance was paused.
9718
+ #
9719
+ # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DBInstanceNotReadyFault AWS API Documentation
9720
+ #
9721
+ class DBInstanceNotReadyFault < Aws::EmptyStructure; end
9722
+
9614
9723
  # Information about an Amazon Web Services Identity and Access
9615
9724
  # Management (IAM) role that is associated with a DB instance.
9616
9725
  #
@@ -10580,6 +10689,8 @@ module Aws::RDS
10580
10689
  #
10581
10690
  class DBSecurityGroupQuotaExceededFault < Aws::EmptyStructure; end
10582
10691
 
10692
+ # Contains the details for an Amazon RDS DB shard group.
10693
+ #
10583
10694
  # @!attribute [rw] db_shard_group_resource_id
10584
10695
  # The Amazon Web Services Region-unique, immutable identifier for the
10585
10696
  # DB shard group.
@@ -11768,7 +11879,7 @@ module Aws::RDS
11768
11879
  end
11769
11880
 
11770
11881
  # @!attribute [rw] db_shard_group_identifier
11771
- # Teh name of the DB shard group to delete.
11882
+ # The name of the DB shard group to delete.
11772
11883
  # @return [String]
11773
11884
  #
11774
11885
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DeleteDBShardGroupMessage AWS API Documentation
@@ -12157,7 +12268,6 @@ module Aws::RDS
12157
12268
  # backup replication is stopped.
12158
12269
  #
12159
12270
  # ^
12160
- #
12161
12271
  # * `db-cluster-id` - Accepts DB cluster identifiers and Amazon
12162
12272
  # Resource Names (ARNs). The results list includes only information
12163
12273
  # about the DB cluster automated backups identified by these ARNs.
@@ -12248,7 +12358,6 @@ module Aws::RDS
12248
12358
  # * `failed`
12249
12359
  #
12250
12360
  # * `pending`
12251
- #
12252
12361
  # The results list includes information about only the backtracks
12253
12362
  # identified by these values.
12254
12363
  # @return [Array<Types::Filter>]
@@ -12767,7 +12876,6 @@ module Aws::RDS
12767
12876
  # * `provisioned`
12768
12877
  #
12769
12878
  # * `serverless`
12770
- #
12771
12879
  # * `engine-version` - Accepts engine versions. The results list only
12772
12880
  # includes information about the DB engine versions for these engine
12773
12881
  # versions.
@@ -12877,7 +12985,6 @@ module Aws::RDS
12877
12985
  #
12878
12986
  # * `retained` - Automated backups for deleted instances and after
12879
12987
  # backup replication is stopped.
12880
- #
12881
12988
  # * `db-instance-id` - Accepts DB instance identifiers and Amazon
12882
12989
  # Resource Names (ARNs). The results list includes only information
12883
12990
  # about the DB instance automated backups identified by these ARNs.
@@ -13494,7 +13601,6 @@ module Aws::RDS
13494
13601
  # * `resolved` - The recommendations which are completed.
13495
13602
  #
13496
13603
  # * `dismissed` - The recommendations that you dismissed.
13497
- #
13498
13604
  # The results list only includes the recommendations whose status is
13499
13605
  # one of the specified filter values.
13500
13606
  #
@@ -13511,7 +13617,6 @@ module Aws::RDS
13511
13617
  # * `low`
13512
13618
  #
13513
13619
  # * `informational`
13514
- #
13515
13620
  # * `type-id` - Accepts a list of recommendation type identifiers. The
13516
13621
  # results list only includes the recommendations whose type is one
13517
13622
  # of the specified filter values.
@@ -13598,10 +13703,9 @@ module Aws::RDS
13598
13703
  end
13599
13704
 
13600
13705
  # @!attribute [rw] db_shard_group_identifier
13601
- # The user-supplied DB shard group identifier or the Amazon Resource
13602
- # Name (ARN) of the DB shard group. If this parameter is specified,
13603
- # information for only the specific DB shard group is returned. This
13604
- # parameter isn't case-sensitive.
13706
+ # The user-supplied DB shard group identifier. If this parameter is
13707
+ # specified, information for only the specific DB shard group is
13708
+ # returned. This parameter isn't case-sensitive.
13605
13709
  #
13606
13710
  # Constraints:
13607
13711
  #
@@ -16151,6 +16255,12 @@ module Aws::RDS
16151
16255
  # database cluster.
16152
16256
  # @return [Array<Types::GlobalClusterMember>]
16153
16257
  #
16258
+ # @!attribute [rw] endpoint
16259
+ # The writer endpoint for the new global database cluster. This
16260
+ # endpoint always points to the writer DB instance in the current
16261
+ # primary cluster.
16262
+ # @return [String]
16263
+ #
16154
16264
  # @!attribute [rw] failover_state
16155
16265
  # A data object containing all properties for the current state of an
16156
16266
  # in-process or pending switchover or failover process for this global
@@ -16186,15 +16296,16 @@ module Aws::RDS
16186
16296
  :storage_encrypted,
16187
16297
  :deletion_protection,
16188
16298
  :global_cluster_members,
16299
+ :endpoint,
16189
16300
  :failover_state,
16190
16301
  :tag_list)
16191
16302
  SENSITIVE = []
16192
16303
  include Aws::Structure
16193
16304
  end
16194
16305
 
16195
- # The `GlobalClusterIdentifier` already exists. Choose a new global
16306
+ # The `GlobalClusterIdentifier` already exists. Specify a new global
16196
16307
  # database identifier (unique name) to create a new global database
16197
- # cluster.
16308
+ # cluster or to rename an existing one.
16198
16309
  #
16199
16310
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/GlobalClusterAlreadyExistsFault AWS API Documentation
16200
16311
  #
@@ -17181,11 +17292,11 @@ module Aws::RDS
17181
17292
  # @return [String]
17182
17293
  #
17183
17294
  # @!attribute [rw] apply_immediately
17184
- # Specifies whether the modifications in this request and any pending
17185
- # modifications are asynchronously applied as soon as possible,
17186
- # regardless of the `PreferredMaintenanceWindow` setting for the DB
17187
- # cluster. If this parameter is disabled, changes to the DB cluster
17188
- # are applied during the next maintenance window.
17295
+ # Specifies whether the modifications in this request are
17296
+ # asynchronously applied as soon as possible, regardless of the
17297
+ # `PreferredMaintenanceWindow` setting for the DB cluster. If this
17298
+ # parameter is disabled, changes to the DB cluster are applied during
17299
+ # the next maintenance window.
17189
17300
  #
17190
17301
  # Most modifications can be applied immediately or during the next
17191
17302
  # scheduled maintenance window. Some modifications, such as turning on
@@ -17317,13 +17428,15 @@ module Aws::RDS
17317
17428
  # default, mapping isn't enabled.
17318
17429
  #
17319
17430
  # For more information, see [ IAM Database Authentication][1] in the
17320
- # *Amazon Aurora User Guide*.
17431
+ # *Amazon Aurora User Guide* or [IAM database authentication for
17432
+ # MariaDB, MySQL, and PostgreSQL][2] in the *Amazon RDS User Guide*.
17321
17433
  #
17322
- # Valid for Cluster Type: Aurora DB clusters only
17434
+ # Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB clusters
17323
17435
  #
17324
17436
  #
17325
17437
  #
17326
17438
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/UsingWithRDS.IAMDBAuth.html
17439
+ # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/UsingWithRDS.IAMDBAuth.html
17327
17440
  # @return [Boolean]
17328
17441
  #
17329
17442
  # @!attribute [rw] backtrack_window
@@ -17499,9 +17612,9 @@ module Aws::RDS
17499
17612
  # Aurora User Guide*.
17500
17613
  #
17501
17614
  # <note markdown="1"> This parameter applies only to Aurora Serverless v1 DB clusters. To
17502
- # enable or disable the HTTP endpoint for an Aurora PostgreSQL
17503
- # Serverless v2 or provisioned DB cluster, use the
17504
- # `EnableHttpEndpoint` and `DisableHttpEndpoint` operations.
17615
+ # enable or disable the HTTP endpoint for an Aurora Serverless v2 or
17616
+ # provisioned DB cluster, use the `EnableHttpEndpoint` and
17617
+ # `DisableHttpEndpoint` operations.
17505
17618
  #
17506
17619
  # </note>
17507
17620
  #
@@ -17652,6 +17765,10 @@ module Aws::RDS
17652
17765
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Monitoring.html#USER_Monitoring.OS.IAMRole
17653
17766
  # @return [String]
17654
17767
  #
17768
+ # @!attribute [rw] database_insights_mode
17769
+ # Specifies the mode of Database Insights to enable for the cluster.
17770
+ # @return [String]
17771
+ #
17655
17772
  # @!attribute [rw] enable_performance_insights
17656
17773
  # Specifies whether to turn on Performance Insights for the DB
17657
17774
  # cluster.
@@ -17659,7 +17776,7 @@ module Aws::RDS
17659
17776
  # For more information, see [ Using Amazon Performance Insights][1] in
17660
17777
  # the *Amazon RDS User Guide*.
17661
17778
  #
17662
- # Valid for Cluster Type: Multi-AZ DB clusters only
17779
+ # Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB clusters
17663
17780
  #
17664
17781
  #
17665
17782
  #
@@ -17878,6 +17995,12 @@ module Aws::RDS
17878
17995
  # enable Aurora Limitless Database to create a DB shard group.
17879
17996
  #
17880
17997
  # Valid for: Aurora DB clusters only
17998
+ #
17999
+ # <note markdown="1"> This setting is no longer used. Instead use the
18000
+ # `ClusterScalabilityType` setting when you create your Aurora
18001
+ # Limitless Database DB cluster.
18002
+ #
18003
+ # </note>
17881
18004
  # @return [Boolean]
17882
18005
  #
17883
18006
  # @!attribute [rw] ca_certificate_identifier
@@ -17928,6 +18051,7 @@ module Aws::RDS
17928
18051
  :auto_minor_version_upgrade,
17929
18052
  :monitoring_interval,
17930
18053
  :monitoring_role_arn,
18054
+ :database_insights_mode,
17931
18055
  :enable_performance_insights,
17932
18056
  :performance_insights_kms_key_id,
17933
18057
  :performance_insights_retention_period,
@@ -18867,6 +18991,10 @@ module Aws::RDS
18867
18991
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/UsingWithRDS.IAMDBAuth.html
18868
18992
  # @return [Boolean]
18869
18993
  #
18994
+ # @!attribute [rw] database_insights_mode
18995
+ # Specifies the mode of Database Insights to enable for the instance.
18996
+ # @return [String]
18997
+ #
18870
18998
  # @!attribute [rw] enable_performance_insights
18871
18999
  # Specifies whether to enable Performance Insights for the DB
18872
19000
  # instance.
@@ -19287,6 +19415,7 @@ module Aws::RDS
19287
19415
  :disable_domain,
19288
19416
  :promotion_tier,
19289
19417
  :enable_iam_database_authentication,
19418
+ :database_insights_mode,
19290
19419
  :enable_performance_insights,
19291
19420
  :performance_insights_kms_key_id,
19292
19421
  :performance_insights_retention_period,
@@ -20999,12 +21128,26 @@ module Aws::RDS
20999
21128
  # For more information about maintenance actions, see [Maintaining a
21000
21129
  # DB instance][1].
21001
21130
  #
21002
- # Valid Values:` system-update | db-upgrade | hardware-maintenance |
21003
- # ca-certificate-rotation`
21131
+ # Valid Values:
21132
+ #
21133
+ # * `ca-certificate-rotation`
21134
+ #
21135
+ # * `db-upgrade`
21136
+ #
21137
+ # * `hardware-maintenance`
21138
+ #
21139
+ # * `os-upgrade`
21140
+ #
21141
+ # * `system-update`
21142
+ #
21143
+ # For more information about these actions, see [Maintenance actions
21144
+ # for Amazon Aurora][2] or [Maintenance actions for Amazon RDS][3].
21004
21145
  #
21005
21146
  #
21006
21147
  #
21007
21148
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_UpgradeDBInstance.Maintenance.html
21149
+ # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_UpgradeDBInstance.Maintenance.html#maintenance-actions-aurora
21150
+ # [3]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_UpgradeDBInstance.Maintenance.html#maintenance-actions-rds
21008
21151
  # @return [String]
21009
21152
  #
21010
21153
  # @!attribute [rw] auto_applied_after_date
@@ -22907,8 +23050,8 @@ module Aws::RDS
22907
23050
  # standard support for that engine version. For more information, see
22908
23051
  # the following sections:
22909
23052
  #
22910
- # * Amazon Aurora (PostgreSQL only) - [Using Amazon RDS Extended
22911
- # Support][1] in the *Amazon Aurora User Guide*
23053
+ # * Amazon Aurora - [Using Amazon RDS Extended Support][1] in the
23054
+ # *Amazon Aurora User Guide*
22912
23055
  #
22913
23056
  # * Amazon RDS - [Using Amazon RDS Extended Support][2] in the *Amazon
22914
23057
  # RDS User Guide*
@@ -23194,13 +23337,15 @@ module Aws::RDS
23194
23337
  # default, mapping isn't enabled.
23195
23338
  #
23196
23339
  # For more information, see [ IAM Database Authentication][1] in the
23197
- # *Amazon Aurora User Guide*.
23340
+ # *Amazon Aurora User Guide* or [ IAM database authentication for
23341
+ # MariaDB, MySQL, and PostgreSQL][2] in the *Amazon RDS User Guide*.
23198
23342
  #
23199
- # Valid for: Aurora DB clusters only
23343
+ # Valid for: Aurora DB clusters and Multi-AZ DB clusters
23200
23344
  #
23201
23345
  #
23202
23346
  #
23203
23347
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/UsingWithRDS.IAMDBAuth.html
23348
+ # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/UsingWithRDS.IAMDBAuth.html
23204
23349
  # @return [Boolean]
23205
23350
  #
23206
23351
  # @!attribute [rw] backtrack_window
@@ -23463,6 +23608,66 @@ module Aws::RDS
23463
23608
  # Reserved for future use.
23464
23609
  # @return [Types::RdsCustomClusterConfiguration]
23465
23610
  #
23611
+ # @!attribute [rw] monitoring_interval
23612
+ # The interval, in seconds, between points when Enhanced Monitoring
23613
+ # metrics are collected for the DB cluster. To turn off collecting
23614
+ # Enhanced Monitoring metrics, specify `0`.
23615
+ #
23616
+ # If `MonitoringRoleArn` is specified, also set `MonitoringInterval`
23617
+ # to a value other than `0`.
23618
+ #
23619
+ # Valid Values: `0 | 1 | 5 | 10 | 15 | 30 | 60`
23620
+ #
23621
+ # Default: `0`
23622
+ # @return [Integer]
23623
+ #
23624
+ # @!attribute [rw] monitoring_role_arn
23625
+ # The Amazon Resource Name (ARN) for the IAM role that permits RDS to
23626
+ # send Enhanced Monitoring metrics to Amazon CloudWatch Logs. An
23627
+ # example is `arn:aws:iam:123456789012:role/emaccess`.
23628
+ #
23629
+ # If `MonitoringInterval` is set to a value other than `0`, supply a
23630
+ # `MonitoringRoleArn` value.
23631
+ # @return [String]
23632
+ #
23633
+ # @!attribute [rw] enable_performance_insights
23634
+ # Specifies whether to turn on Performance Insights for the DB
23635
+ # cluster.
23636
+ # @return [Boolean]
23637
+ #
23638
+ # @!attribute [rw] performance_insights_kms_key_id
23639
+ # The Amazon Web Services KMS key identifier for encryption of
23640
+ # Performance Insights data.
23641
+ #
23642
+ # The Amazon Web Services KMS key identifier is the key ARN, key ID,
23643
+ # alias ARN, or alias name for the KMS key.
23644
+ #
23645
+ # If you don't specify a value for `PerformanceInsightsKMSKeyId`,
23646
+ # then Amazon RDS uses your default KMS key. There is a default KMS
23647
+ # key for your Amazon Web Services account. Your Amazon Web Services
23648
+ # account has a different default KMS key for each Amazon Web Services
23649
+ # Region.
23650
+ # @return [String]
23651
+ #
23652
+ # @!attribute [rw] performance_insights_retention_period
23653
+ # The number of days to retain Performance Insights data.
23654
+ #
23655
+ # Valid Values:
23656
+ #
23657
+ # * `7`
23658
+ #
23659
+ # * *month* * 31, where *month* is a number of months from 1-23.
23660
+ # Examples: `93` (3 months * 31), `341` (11 months * 31), `589`
23661
+ # (19 months * 31)
23662
+ #
23663
+ # * `731`
23664
+ #
23665
+ # Default: `7` days
23666
+ #
23667
+ # If you specify a retention period that isn't valid, such as `94`,
23668
+ # Amazon RDS issues an error.
23669
+ # @return [Integer]
23670
+ #
23466
23671
  # @!attribute [rw] engine_lifecycle_support
23467
23672
  # The life cycle type for this DB cluster.
23468
23673
  #
@@ -23483,8 +23688,8 @@ module Aws::RDS
23483
23688
  # standard support for that engine version. For more information, see
23484
23689
  # the following sections:
23485
23690
  #
23486
- # * Amazon Aurora (PostgreSQL only) - [Using Amazon RDS Extended
23487
- # Support][1] in the *Amazon Aurora User Guide*
23691
+ # * Amazon Aurora - [Using Amazon RDS Extended Support][1] in the
23692
+ # *Amazon Aurora User Guide*
23488
23693
  #
23489
23694
  # * Amazon RDS - [Using Amazon RDS Extended Support][2] in the *Amazon
23490
23695
  # RDS User Guide*
@@ -23534,6 +23739,11 @@ module Aws::RDS
23534
23739
  :serverless_v2_scaling_configuration,
23535
23740
  :network_type,
23536
23741
  :rds_custom_cluster_configuration,
23742
+ :monitoring_interval,
23743
+ :monitoring_role_arn,
23744
+ :enable_performance_insights,
23745
+ :performance_insights_kms_key_id,
23746
+ :performance_insights_retention_period,
23537
23747
  :engine_lifecycle_support)
23538
23748
  SENSITIVE = []
23539
23749
  include Aws::Structure
@@ -23738,13 +23948,15 @@ module Aws::RDS
23738
23948
  # default, mapping isn't enabled.
23739
23949
  #
23740
23950
  # For more information, see [ IAM Database Authentication][1] in the
23741
- # *Amazon Aurora User Guide*.
23951
+ # *Amazon Aurora User Guide* or [ IAM database authentication for
23952
+ # MariaDB, MySQL, and PostgreSQL][2] in the *Amazon RDS User Guide*.
23742
23953
  #
23743
- # Valid for: Aurora DB clusters only
23954
+ # Valid for: Aurora DB clusters and Multi-AZ DB clusters
23744
23955
  #
23745
23956
  #
23746
23957
  #
23747
23958
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/UsingWithRDS.IAMDBAuth.html
23959
+ # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/UsingWithRDS.IAMDBAuth.html
23748
23960
  # @return [Boolean]
23749
23961
  #
23750
23962
  # @!attribute [rw] backtrack_window
@@ -24008,6 +24220,66 @@ module Aws::RDS
24008
24220
  # Reserved for future use.
24009
24221
  # @return [Types::RdsCustomClusterConfiguration]
24010
24222
  #
24223
+ # @!attribute [rw] monitoring_interval
24224
+ # The interval, in seconds, between points when Enhanced Monitoring
24225
+ # metrics are collected for the DB cluster. To turn off collecting
24226
+ # Enhanced Monitoring metrics, specify `0`.
24227
+ #
24228
+ # If `MonitoringRoleArn` is specified, also set `MonitoringInterval`
24229
+ # to a value other than `0`.
24230
+ #
24231
+ # Valid Values: `0 | 1 | 5 | 10 | 15 | 30 | 60`
24232
+ #
24233
+ # Default: `0`
24234
+ # @return [Integer]
24235
+ #
24236
+ # @!attribute [rw] monitoring_role_arn
24237
+ # The Amazon Resource Name (ARN) for the IAM role that permits RDS to
24238
+ # send Enhanced Monitoring metrics to Amazon CloudWatch Logs. An
24239
+ # example is `arn:aws:iam:123456789012:role/emaccess`.
24240
+ #
24241
+ # If `MonitoringInterval` is set to a value other than `0`, supply a
24242
+ # `MonitoringRoleArn` value.
24243
+ # @return [String]
24244
+ #
24245
+ # @!attribute [rw] enable_performance_insights
24246
+ # Specifies whether to turn on Performance Insights for the DB
24247
+ # cluster.
24248
+ # @return [Boolean]
24249
+ #
24250
+ # @!attribute [rw] performance_insights_kms_key_id
24251
+ # The Amazon Web Services KMS key identifier for encryption of
24252
+ # Performance Insights data.
24253
+ #
24254
+ # The Amazon Web Services KMS key identifier is the key ARN, key ID,
24255
+ # alias ARN, or alias name for the KMS key.
24256
+ #
24257
+ # If you don't specify a value for `PerformanceInsightsKMSKeyId`,
24258
+ # then Amazon RDS uses your default KMS key. There is a default KMS
24259
+ # key for your Amazon Web Services account. Your Amazon Web Services
24260
+ # account has a different default KMS key for each Amazon Web Services
24261
+ # Region.
24262
+ # @return [String]
24263
+ #
24264
+ # @!attribute [rw] performance_insights_retention_period
24265
+ # The number of days to retain Performance Insights data.
24266
+ #
24267
+ # Valid Values:
24268
+ #
24269
+ # * `7`
24270
+ #
24271
+ # * *month* * 31, where *month* is a number of months from 1-23.
24272
+ # Examples: `93` (3 months * 31), `341` (11 months * 31), `589`
24273
+ # (19 months * 31)
24274
+ #
24275
+ # * `731`
24276
+ #
24277
+ # Default: `7` days
24278
+ #
24279
+ # If you specify a retention period that isn't valid, such as `94`,
24280
+ # Amazon RDS issues an error.
24281
+ # @return [Integer]
24282
+ #
24011
24283
  # @!attribute [rw] engine_lifecycle_support
24012
24284
  # The life cycle type for this DB cluster.
24013
24285
  #
@@ -24028,8 +24300,8 @@ module Aws::RDS
24028
24300
  # standard support for that engine version. For more information, see
24029
24301
  # the following sections:
24030
24302
  #
24031
- # * Amazon Aurora (PostgreSQL only) - [Using Amazon RDS Extended
24032
- # Support][1] in the *Amazon Aurora User Guide*
24303
+ # * Amazon Aurora - [Using Amazon RDS Extended Support][1] in the
24304
+ # *Amazon Aurora User Guide*
24033
24305
  #
24034
24306
  # * Amazon RDS - [Using Amazon RDS Extended Support][2] in the *Amazon
24035
24307
  # RDS User Guide*
@@ -24079,6 +24351,11 @@ module Aws::RDS
24079
24351
  :network_type,
24080
24352
  :source_db_cluster_resource_id,
24081
24353
  :rds_custom_cluster_configuration,
24354
+ :monitoring_interval,
24355
+ :monitoring_role_arn,
24356
+ :enable_performance_insights,
24357
+ :performance_insights_kms_key_id,
24358
+ :performance_insights_retention_period,
24082
24359
  :engine_lifecycle_support)
24083
24360
  SENSITIVE = []
24084
24361
  include Aws::Structure
@@ -25202,6 +25479,10 @@ module Aws::RDS
25202
25479
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/MySQL.Procedural.Importing.html#MySQL.Procedural.Importing.Enabling.IAM
25203
25480
  # @return [String]
25204
25481
  #
25482
+ # @!attribute [rw] database_insights_mode
25483
+ # Specifies the mode of Database Insights to enable for the instance.
25484
+ # @return [String]
25485
+ #
25205
25486
  # @!attribute [rw] enable_performance_insights
25206
25487
  # Specifies whether to enable Performance Insights for the DB
25207
25488
  # instance.
@@ -25463,6 +25744,7 @@ module Aws::RDS
25463
25744
  :s3_bucket_name,
25464
25745
  :s3_prefix,
25465
25746
  :s3_ingestion_role_arn,
25747
+ :database_insights_mode,
25466
25748
  :enable_performance_insights,
25467
25749
  :performance_insights_kms_key_id,
25468
25750
  :performance_insights_retention_period,
@@ -26508,6 +26790,34 @@ module Aws::RDS
26508
26790
  include Aws::Structure
26509
26791
  end
26510
26792
 
26793
+ # Specifies any Aurora Serverless v2 properties or limits that differ
26794
+ # between Aurora engine versions. You can test the values of this
26795
+ # attribute when deciding which Aurora version to use in a new or
26796
+ # upgraded DB cluster. You can also retrieve the version of an existing
26797
+ # DB cluster and check whether that version supports certain Aurora
26798
+ # Serverless v2 features before you attempt to use those features.
26799
+ #
26800
+ # @!attribute [rw] min_capacity
26801
+ # If the minimum capacity is 0 ACUs, the engine version supports the
26802
+ # automatic pause/resume feature of Aurora Serverless v2.
26803
+ # @return [Float]
26804
+ #
26805
+ # @!attribute [rw] max_capacity
26806
+ # Specifies the upper Aurora Serverless v2 capacity limit for a
26807
+ # particular engine version. Depending on the engine version, the
26808
+ # maximum capacity for an Aurora Serverless v2 cluster might be `256`
26809
+ # or `128`.
26810
+ # @return [Float]
26811
+ #
26812
+ # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/ServerlessV2FeaturesSupport AWS API Documentation
26813
+ #
26814
+ class ServerlessV2FeaturesSupport < Struct.new(
26815
+ :min_capacity,
26816
+ :max_capacity)
26817
+ SENSITIVE = []
26818
+ include Aws::Structure
26819
+ end
26820
+
26511
26821
  # Contains the scaling configuration of an Aurora Serverless v2 DB
26512
26822
  # cluster.
26513
26823
  #
@@ -26521,22 +26831,35 @@ module Aws::RDS
26521
26831
  # @!attribute [rw] min_capacity
26522
26832
  # The minimum number of Aurora capacity units (ACUs) for a DB instance
26523
26833
  # in an Aurora Serverless v2 cluster. You can specify ACU values in
26524
- # half-step increments, such as 8, 8.5, 9, and so on. The smallest
26525
- # value that you can use is 0.5.
26834
+ # half-step increments, such as 8, 8.5, 9, and so on. For Aurora
26835
+ # versions that support the Aurora Serverless v2 auto-pause feature,
26836
+ # the smallest value that you can use is 0. For versions that don't
26837
+ # support Aurora Serverless v2 auto-pause, the smallest value that you
26838
+ # can use is 0.5.
26526
26839
  # @return [Float]
26527
26840
  #
26528
26841
  # @!attribute [rw] max_capacity
26529
26842
  # The maximum number of Aurora capacity units (ACUs) for a DB instance
26530
26843
  # in an Aurora Serverless v2 cluster. You can specify ACU values in
26531
- # half-step increments, such as 40, 40.5, 41, and so on. The largest
26532
- # value that you can use is 128.
26844
+ # half-step increments, such as 32, 32.5, 33, and so on. The largest
26845
+ # value that you can use is 256 for recent Aurora versions, or 128 for
26846
+ # older versions.
26533
26847
  # @return [Float]
26534
26848
  #
26849
+ # @!attribute [rw] seconds_until_auto_pause
26850
+ # Specifies the number of seconds an Aurora Serverless v2 DB instance
26851
+ # must be idle before Aurora attempts to automatically pause it.
26852
+ #
26853
+ # Specify a value between 300 seconds (five minutes) and 86,400
26854
+ # seconds (one day). The default is 300 seconds.
26855
+ # @return [Integer]
26856
+ #
26535
26857
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/ServerlessV2ScalingConfiguration AWS API Documentation
26536
26858
  #
26537
26859
  class ServerlessV2ScalingConfiguration < Struct.new(
26538
26860
  :min_capacity,
26539
- :max_capacity)
26861
+ :max_capacity,
26862
+ :seconds_until_auto_pause)
26540
26863
  SENSITIVE = []
26541
26864
  include Aws::Structure
26542
26865
  end
@@ -26553,22 +26876,40 @@ module Aws::RDS
26553
26876
  # @!attribute [rw] min_capacity
26554
26877
  # The minimum number of Aurora capacity units (ACUs) for a DB instance
26555
26878
  # in an Aurora Serverless v2 cluster. You can specify ACU values in
26556
- # half-step increments, such as 8, 8.5, 9, and so on. The smallest
26557
- # value that you can use is 0.5.
26879
+ # half-step increments, such as 8, 8.5, 9, and so on. For Aurora
26880
+ # versions that support the Aurora Serverless v2 auto-pause feature,
26881
+ # the smallest value that you can use is 0. For versions that don't
26882
+ # support Aurora Serverless v2 auto-pause, the smallest value that you
26883
+ # can use is 0.5.
26558
26884
  # @return [Float]
26559
26885
  #
26560
26886
  # @!attribute [rw] max_capacity
26561
26887
  # The maximum number of Aurora capacity units (ACUs) for a DB instance
26562
26888
  # in an Aurora Serverless v2 cluster. You can specify ACU values in
26563
- # half-step increments, such as 40, 40.5, 41, and so on. The largest
26564
- # value that you can use is 128.
26889
+ # half-step increments, such as 32, 32.5, 33, and so on. The largest
26890
+ # value that you can use is 256 for recent Aurora versions, or 128 for
26891
+ # older versions.
26565
26892
  # @return [Float]
26566
26893
  #
26894
+ # @!attribute [rw] seconds_until_auto_pause
26895
+ # The number of seconds an Aurora Serverless v2 DB instance must be
26896
+ # idle before Aurora attempts to automatically pause it. This property
26897
+ # is only shown when the minimum capacity for the cluster is set to 0
26898
+ # ACUs. Changing the minimum capacity to a nonzero value removes this
26899
+ # property. If you later change the minimum capacity back to 0 ACUs,
26900
+ # this property is reset to its default value unless you specify it
26901
+ # again.
26902
+ #
26903
+ # This value ranges between 300 seconds (five minutes) and 86,400
26904
+ # seconds (one day). The default is 300 seconds.
26905
+ # @return [Integer]
26906
+ #
26567
26907
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/ServerlessV2ScalingConfigurationInfo AWS API Documentation
26568
26908
  #
26569
26909
  class ServerlessV2ScalingConfigurationInfo < Struct.new(
26570
26910
  :min_capacity,
26571
- :max_capacity)
26911
+ :max_capacity,
26912
+ :seconds_until_auto_pause)
26572
26913
  SENSITIVE = []
26573
26914
  include Aws::Structure
26574
26915
  end
@@ -27274,11 +27615,11 @@ module Aws::RDS
27274
27615
  class SubscriptionNotFoundFault < Aws::EmptyStructure; end
27275
27616
 
27276
27617
  # @!attribute [rw] blue_green_deployment_identifier
27277
- # The unique identifier of the blue/green deployment.
27618
+ # The resource ID of the blue/green deployment.
27278
27619
  #
27279
27620
  # Constraints:
27280
27621
  #
27281
- # * Must match an existing blue/green deployment identifier.
27622
+ # * Must match an existing blue/green deployment resource ID.
27282
27623
  #
27283
27624
  # ^
27284
27625
  # @return [String]
@@ -27475,7 +27816,7 @@ module Aws::RDS
27475
27816
  # `aws:` or `rds:`. The string can only contain only the set of
27476
27817
  # Unicode letters, digits, white-space, '\_', '.', ':', '/',
27477
27818
  # '=', '+', '-', '@' (Java regex:
27478
- # "^(\[\\\\p\\\{L\\}\\\\p\\\{Z\\}\\\\p\\\{N\\}\_.:/=+\\\\-@\]*)$").
27819
+ # "^(\[\\\\p\{L}\\\\p\{Z}\\\\p\{N}\_.:/=+\\\\-@\]*)$").
27479
27820
  # @return [String]
27480
27821
  #
27481
27822
  # @!attribute [rw] value
@@ -27484,7 +27825,7 @@ module Aws::RDS
27484
27825
  # with `aws:` or `rds:`. The string can only contain only the set of
27485
27826
  # Unicode letters, digits, white-space, '\_', '.', ':', '/',
27486
27827
  # '=', '+', '-', '@' (Java regex:
27487
- # "^(\[\\\\p\\\{L\\}\\\\p\\\{Z\\}\\\\p\\\{N\\}\_.:/=+\\\\-@\]*)$").
27828
+ # "^(\[\\\\p\{L}\\\\p\{Z}\\\\p\{N}\_.:/=+\\\\-@\]*)$").
27488
27829
  # @return [String]
27489
27830
  #
27490
27831
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/Tag AWS API Documentation