aws-sdk-rds 1.263.0 → 1.265.0

Sign up to get free protection for your applications and to get access to all the features.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 40019a1aa7048c3319a7012ef6c8d90fce1f46dacfb340142928aad300266ddc
4
- data.tar.gz: ad66aaae68786b6e32cd75b1863cdc5adaa40ded74b2ce4c4cda37eac4c16ba2
3
+ metadata.gz: 9693dc6d78f2721f5a246bcd293c7e8e25c6a5fb46f2983d0ce08009f8e13439
4
+ data.tar.gz: ae99f4f55a3848074f3c25fd65a3e0935a2780467de70b12c271dfd8dc6eb77f
5
5
  SHA512:
6
- metadata.gz: 5acfdd6ff51698a02e5658a4dd53a4d9284db2bfee5c2ceea2f5fb1ceeb6ff93ad7359a778e60418add6d751dbb783d054a0ed6762bba1f358de6254466d6c60
7
- data.tar.gz: bfa97a9b4cb06c4a911386968c7dd13ba14dd53311aea680448711ef26f4884cc1f9313f5ff1ea5c5ba9340f228e0d5c4408b1067c0cd3cd948761b2b4b7fb87
6
+ metadata.gz: 0a6f61299da09c603afc8bb67b67a754bf986ca4a6804be90d4d4fa5b3dfc2049c23a63bbd4df4c8427f7a351457fa7cbe30fa38a947f0c759cee26df5bf9e26
7
+ data.tar.gz: 368804d5476bb77ce35ab54a4b9f36391c3fb32785d045d1d9ec495c2a9e292e537a56d0c380d4cd940a3cc96def41c9b0752e52761c43b7fc40f1bb9b03181c
data/CHANGELOG.md CHANGED
@@ -1,6 +1,16 @@
1
1
  Unreleased Changes
2
2
  ------------------
3
3
 
4
+ 1.265.0 (2025-01-08)
5
+ ------------------
6
+
7
+ * Feature - Updates Amazon RDS documentation to clarify the RestoreDBClusterToPointInTime description.
8
+
9
+ 1.264.0 (2024-12-27)
10
+ ------------------
11
+
12
+ * Feature - Updates Amazon RDS documentation to correct various descriptions.
13
+
4
14
  1.263.0 (2024-12-16)
5
15
  ------------------
6
16
 
data/VERSION CHANGED
@@ -1 +1 @@
1
- 1.263.0
1
+ 1.265.0
@@ -3137,12 +3137,6 @@ module Aws::RDS
3137
3137
  # also query your database from inside the RDS console with the RDS
3138
3138
  # query editor.
3139
3139
  #
3140
- # RDS Data API is supported with the following DB clusters:
3141
- #
3142
- # * Aurora PostgreSQL Serverless v2 and provisioned
3143
- #
3144
- # * Aurora PostgreSQL and Aurora MySQL Serverless v1
3145
- #
3146
3140
  # For more information, see [Using RDS Data API][1] in the *Amazon
3147
3141
  # Aurora User Guide*.
3148
3142
  #
@@ -3324,7 +3318,7 @@ module Aws::RDS
3324
3318
  # the DB cluster during the maintenance window. By default, minor engine
3325
3319
  # upgrades are applied automatically.
3326
3320
  #
3327
- # Valid for Cluster Type: Multi-AZ DB clusters only
3321
+ # Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB cluster
3328
3322
  #
3329
3323
  # @option params [Integer] :monitoring_interval
3330
3324
  # The interval, in seconds, between points when Enhanced Monitoring
@@ -3334,7 +3328,7 @@ module Aws::RDS
3334
3328
  # If `MonitoringRoleArn` is specified, also set `MonitoringInterval` to
3335
3329
  # a value other than `0`.
3336
3330
  #
3337
- # Valid for Cluster Type: Multi-AZ DB clusters only
3331
+ # Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB clusters
3338
3332
  #
3339
3333
  # Valid Values: `0 | 1 | 5 | 10 | 15 | 30 | 60`
3340
3334
  #
@@ -3350,14 +3344,20 @@ module Aws::RDS
3350
3344
  # If `MonitoringInterval` is set to a value other than `0`, supply a
3351
3345
  # `MonitoringRoleArn` value.
3352
3346
  #
3353
- # Valid for Cluster Type: Multi-AZ DB clusters only
3347
+ # Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB clusters
3354
3348
  #
3355
3349
  #
3356
3350
  #
3357
3351
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Monitoring.OS.html#USER_Monitoring.OS.Enabling
3358
3352
  #
3359
3353
  # @option params [String] :database_insights_mode
3360
- # Specifies the mode of Database Insights to enable for the cluster.
3354
+ # The mode of Database Insights to enable for the DB cluster.
3355
+ #
3356
+ # If you set this value to `advanced`, you must also set the
3357
+ # `PerformanceInsightsEnabled` parameter to `true` and the
3358
+ # `PerformanceInsightsRetentionPeriod` parameter to 465.
3359
+ #
3360
+ # Valid for Cluster Type: Aurora DB clusters only
3361
3361
  #
3362
3362
  # @option params [Boolean] :enable_performance_insights
3363
3363
  # Specifies whether to turn on Performance Insights for the DB cluster.
@@ -3365,7 +3365,7 @@ module Aws::RDS
3365
3365
  # For more information, see [ Using Amazon Performance Insights][1] in
3366
3366
  # the *Amazon RDS User Guide*.
3367
3367
  #
3368
- # Valid for Cluster Type: Multi-AZ DB clusters only
3368
+ # Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB clusters
3369
3369
  #
3370
3370
  #
3371
3371
  #
@@ -3383,12 +3383,12 @@ module Aws::RDS
3383
3383
  # your Amazon Web Services account. Your Amazon Web Services account has
3384
3384
  # a different default KMS key for each Amazon Web Services Region.
3385
3385
  #
3386
- # Valid for Cluster Type: Multi-AZ DB clusters only
3386
+ # Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB clusters
3387
3387
  #
3388
3388
  # @option params [Integer] :performance_insights_retention_period
3389
3389
  # The number of days to retain Performance Insights data.
3390
3390
  #
3391
- # Valid for Cluster Type: Multi-AZ DB clusters only
3391
+ # Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB clusters
3392
3392
  #
3393
3393
  # Valid Values:
3394
3394
  #
@@ -5359,7 +5359,14 @@ module Aws::RDS
5359
5359
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/UsingWithRDS.IAMDBAuth.html
5360
5360
  #
5361
5361
  # @option params [String] :database_insights_mode
5362
- # Specifies the mode of Database Insights to enable for the instance.
5362
+ # The mode of Database Insights to enable for the DB instance.
5363
+ #
5364
+ # This setting only applies to Amazon Aurora DB instances.
5365
+ #
5366
+ # <note markdown="1"> Currently, this value is inherited from the DB cluster and can't be
5367
+ # changed.
5368
+ #
5369
+ # </note>
5363
5370
  #
5364
5371
  # @option params [Boolean] :enable_performance_insights
5365
5372
  # Specifies whether to enable Performance Insights for the DB instance.
@@ -6427,7 +6434,11 @@ module Aws::RDS
6427
6434
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/UsingWithRDS.IAMDBAuth.html
6428
6435
  #
6429
6436
  # @option params [String] :database_insights_mode
6430
- # Specifies the mode of Database Insights.
6437
+ # The mode of Database Insights to enable for the read replica.
6438
+ #
6439
+ # <note markdown="1"> Currently, this setting is not supported.
6440
+ #
6441
+ # </note>
6431
6442
  #
6432
6443
  # @option params [Boolean] :enable_performance_insights
6433
6444
  # Specifies whether to enable Performance Insights for the read replica.
@@ -6686,6 +6697,8 @@ module Aws::RDS
6686
6697
  # read replica. Follow the allocation rules specified in
6687
6698
  # `CreateDBInstance`.
6688
6699
  #
6700
+ # This setting isn't valid for RDS for SQL Server.
6701
+ #
6689
6702
  # <note markdown="1"> Be sure to allocate enough storage for your read replica so that the
6690
6703
  # create operation can succeed. You can also allocate additional storage
6691
6704
  # for future growth.
@@ -11970,14 +11983,17 @@ module Aws::RDS
11970
11983
  #
11971
11984
  # Valid Values:
11972
11985
  #
11973
- # * `customer`
11986
+ # * `engine-default`
11974
11987
  #
11975
- # * `engine`
11988
+ # * `system`
11976
11989
  #
11977
- # * `service`
11990
+ # * `user`
11978
11991
  #
11979
11992
  # @option params [Array<Types::Filter>] :filters
11980
- # This parameter isn't currently supported.
11993
+ # A filter that specifies one or more DB cluster parameters to describe.
11994
+ #
11995
+ # The only supported filter is `parameter-name`. The results list only
11996
+ # includes information about the DB cluster parameters with these names.
11981
11997
  #
11982
11998
  # @option params [Integer] :max_records
11983
11999
  # The maximum number of records to include in the response. If more
@@ -13769,7 +13785,10 @@ module Aws::RDS
13769
13785
  # Valid Values: `user | system | engine-default`
13770
13786
  #
13771
13787
  # @option params [Array<Types::Filter>] :filters
13772
- # This parameter isn't currently supported.
13788
+ # A filter that specifies one or more DB parameters to describe.
13789
+ #
13790
+ # The only supported filter is `parameter-name`. The results list only
13791
+ # includes information about the DB parameters with these names.
13773
13792
  #
13774
13793
  # @option params [Integer] :max_records
13775
13794
  # The maximum number of records to include in the response. If more
@@ -15373,7 +15392,10 @@ module Aws::RDS
15373
15392
  # * `sqlserver-web-15.0`
15374
15393
  #
15375
15394
  # @option params [Array<Types::Filter>] :filters
15376
- # This parameter isn't currently supported.
15395
+ # A filter that specifies one or more parameters to describe.
15396
+ #
15397
+ # The only supported filter is `parameter-name`. The results list only
15398
+ # includes information about the parameters with these names.
15377
15399
  #
15378
15400
  # @option params [Integer] :max_records
15379
15401
  # The maximum number of records to include in the response. If more
@@ -19226,7 +19248,7 @@ module Aws::RDS
19226
19248
  # the DB cluster during the maintenance window. By default, minor engine
19227
19249
  # upgrades are applied automatically.
19228
19250
  #
19229
- # Valid for Cluster Type: Multi-AZ DB clusters only
19251
+ # Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB clusters
19230
19252
  #
19231
19253
  # @option params [Integer] :monitoring_interval
19232
19254
  # The interval, in seconds, between points when Enhanced Monitoring
@@ -19259,7 +19281,16 @@ module Aws::RDS
19259
19281
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Monitoring.html#USER_Monitoring.OS.IAMRole
19260
19282
  #
19261
19283
  # @option params [String] :database_insights_mode
19262
- # Specifies the mode of Database Insights to enable for the cluster.
19284
+ # Specifies the mode of Database Insights to enable for the DB cluster.
19285
+ #
19286
+ # If you change the value from `standard` to `advanced`, you must set
19287
+ # the `PerformanceInsightsEnabled` parameter to `true` and the
19288
+ # `PerformanceInsightsRetentionPeriod` parameter to 465.
19289
+ #
19290
+ # If you change the value from `advanced` to `standard`, you must set
19291
+ # the `PerformanceInsightsEnabled` parameter to `false`.
19292
+ #
19293
+ # Valid for Cluster Type: Aurora DB clusters only
19263
19294
  #
19264
19295
  # @option params [Boolean] :enable_performance_insights
19265
19296
  # Specifies whether to turn on Performance Insights for the DB cluster.
@@ -19285,12 +19316,12 @@ module Aws::RDS
19285
19316
  # your Amazon Web Services account. Your Amazon Web Services account has
19286
19317
  # a different default KMS key for each Amazon Web Services Region.
19287
19318
  #
19288
- # Valid for Cluster Type: Multi-AZ DB clusters only
19319
+ # Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB clusters
19289
19320
  #
19290
19321
  # @option params [Integer] :performance_insights_retention_period
19291
19322
  # The number of days to retain Performance Insights data.
19292
19323
  #
19293
- # Valid for Cluster Type: Multi-AZ DB clusters only
19324
+ # Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB clusters
19294
19325
  #
19295
19326
  # Valid Values:
19296
19327
  #
@@ -20547,10 +20578,10 @@ module Aws::RDS
20547
20578
  # type to take effect.
20548
20579
  #
20549
20580
  # If you choose to migrate your DB instance from using standard storage
20550
- # to using Provisioned IOPS, or from using Provisioned IOPS to using
20551
- # standard storage, the process can take time. The duration of the
20552
- # migration depends on several factors such as database load, storage
20553
- # size, storage type (standard or Provisioned IOPS), amount of IOPS
20581
+ # to Provisioned IOPS (io1), or from Provisioned IOPS to standard
20582
+ # storage, the process can take time. The duration of the migration
20583
+ # depends on several factors such as database load, storage size,
20584
+ # storage type (standard or Provisioned IOPS), amount of IOPS
20554
20585
  # provisioned (if any), and the number of prior scale storage
20555
20586
  # operations. Typical migration times are under 24 hours, but the
20556
20587
  # process can take up to several days in some cases. During the
@@ -20561,6 +20592,8 @@ module Aws::RDS
20561
20592
  # rebooting the instance, deleting the instance, creating a read replica
20562
20593
  # for the instance, and creating a DB snapshot of the instance.
20563
20594
  #
20595
+ #
20596
+ #
20564
20597
  # Constraints:
20565
20598
  #
20566
20599
  # * For RDS for MariaDB, RDS for MySQL, RDS for Oracle, and RDS for
@@ -20620,13 +20653,13 @@ module Aws::RDS
20620
20653
  # for the `Iops` parameter.
20621
20654
  #
20622
20655
  # If you choose to migrate your DB instance from using standard storage
20623
- # to using Provisioned IOPS, or from using Provisioned IOPS to using
20624
- # standard storage, the process can take time. The duration of the
20625
- # migration depends on several factors such as database load, storage
20626
- # size, storage type (standard or Provisioned IOPS), amount of IOPS
20627
- # provisioned (if any), and the number of prior scale storage
20628
- # operations. Typical migration times are under 24 hours, but the
20629
- # process can take up to several days in some cases. During the
20656
+ # to gp2 (General Purpose SSD), gp3, or Provisioned IOPS (io1), or from
20657
+ # these storage types to standard storage, the process can take time.
20658
+ # The duration of the migration depends on several factors such as
20659
+ # database load, storage size, storage type (standard or Provisioned
20660
+ # IOPS), amount of IOPS provisioned (if any), and the number of prior
20661
+ # scale storage operations. Typical migration times are under 24 hours,
20662
+ # but the process can take up to several days in some cases. During the
20630
20663
  # migration, the DB instance is available for use, but might experience
20631
20664
  # performance degradation. While the migration takes place, nightly
20632
20665
  # backups for the instance are suspended. No other Amazon RDS operations
@@ -20871,7 +20904,14 @@ module Aws::RDS
20871
20904
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/UsingWithRDS.IAMDBAuth.html
20872
20905
  #
20873
20906
  # @option params [String] :database_insights_mode
20874
- # Specifies the mode of Database Insights to enable for the instance.
20907
+ # Specifies the mode of Database Insights to enable for the DB instance.
20908
+ #
20909
+ # This setting only applies to Amazon Aurora DB instances.
20910
+ #
20911
+ # <note markdown="1"> Currently, this value is inherited from the DB cluster and can't be
20912
+ # changed.
20913
+ #
20914
+ # </note>
20875
20915
  #
20876
20916
  # @option params [Boolean] :enable_performance_insights
20877
20917
  # Specifies whether to enable Performance Insights for the DB instance.
@@ -20929,6 +20969,29 @@ module Aws::RDS
20929
20969
  #
20930
20970
  # This setting doesn't apply to RDS Custom DB instances.
20931
20971
  #
20972
+ # The following values are valid for each DB engine:
20973
+ #
20974
+ # * Aurora MySQL - `audit | error | general | slowquery`
20975
+ #
20976
+ # * Aurora PostgreSQL - `postgresql`
20977
+ #
20978
+ # * RDS for MySQL - `error | general | slowquery`
20979
+ #
20980
+ # * RDS for PostgreSQL - `postgresql | upgrade`
20981
+ #
20982
+ # For more information about exporting CloudWatch Logs for Amazon RDS,
20983
+ # see [ Publishing Database Logs to Amazon CloudWatch Logs][1] in the
20984
+ # *Amazon RDS User Guide*.
20985
+ #
20986
+ # For more information about exporting CloudWatch Logs for Amazon
20987
+ # Aurora, see [Publishing Database Logs to Amazon CloudWatch Logs][2] in
20988
+ # the *Amazon Aurora User Guide*.
20989
+ #
20990
+ #
20991
+ #
20992
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_LogAccess.html#USER_LogAccess.Procedural.UploadtoCloudWatch
20993
+ # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_LogAccess.html#USER_LogAccess.Procedural.UploadtoCloudWatch
20994
+ #
20932
20995
  # @option params [Array<Types::ProcessorFeature>] :processor_features
20933
20996
  # The number of CPU cores and the number of threads per core for the DB
20934
20997
  # instance class of the DB instance.
@@ -26545,7 +26608,8 @@ module Aws::RDS
26545
26608
  # cluster, or a provisioned clone from an Aurora Serverless v1 cluster.
26546
26609
  # To create a clone that is an Aurora Serverless v1 cluster, the
26547
26610
  # original cluster must be an Aurora Serverless v1 cluster or an
26548
- # encrypted provisioned cluster.
26611
+ # encrypted provisioned cluster. To create a full copy that is an Aurora
26612
+ # Serverless v1 cluster, specify the engine mode `serverless`.
26549
26613
  #
26550
26614
  # Valid for: Aurora DB clusters only
26551
26615
  #
@@ -27601,6 +27665,8 @@ module Aws::RDS
27601
27665
  # The amount of storage (in gibibytes) to allocate initially for the DB
27602
27666
  # instance. Follow the allocation rules specified in CreateDBInstance.
27603
27667
  #
27668
+ # This setting isn't valid for RDS for SQL Server.
27669
+ #
27604
27670
  # <note markdown="1"> Be sure to allocate enough storage for your new DB instance so that
27605
27671
  # the restore operation can succeed. You can also allocate additional
27606
27672
  # storage for future growth.
@@ -27968,6 +28034,8 @@ module Aws::RDS
27968
28034
  # The amount of storage (in gibibytes) to allocate initially for the DB
27969
28035
  # instance. Follow the allocation rules specified in `CreateDBInstance`.
27970
28036
  #
28037
+ # This setting isn't valid for RDS for SQL Server.
28038
+ #
27971
28039
  # <note markdown="1"> Be sure to allocate enough storage for your new DB instance so that
27972
28040
  # the restore operation can succeed. You can also allocate additional
27973
28041
  # storage for future growth.
@@ -28285,7 +28353,14 @@ module Aws::RDS
28285
28353
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/MySQL.Procedural.Importing.html#MySQL.Procedural.Importing.Enabling.IAM
28286
28354
  #
28287
28355
  # @option params [String] :database_insights_mode
28288
- # Specifies the mode of Database Insights to enable for the instance.
28356
+ # Specifies the mode of Database Insights to enable for the DB instance.
28357
+ #
28358
+ # This setting only applies to Amazon Aurora DB instances.
28359
+ #
28360
+ # <note markdown="1"> Currently, this value is inherited from the DB cluster and can't be
28361
+ # changed.
28362
+ #
28363
+ # </note>
28289
28364
  #
28290
28365
  # @option params [Boolean] :enable_performance_insights
28291
28366
  # Specifies whether to enable Performance Insights for the DB instance.
@@ -29299,6 +29374,8 @@ module Aws::RDS
29299
29374
  # The amount of storage (in gibibytes) to allocate initially for the DB
29300
29375
  # instance. Follow the allocation rules specified in `CreateDBInstance`.
29301
29376
  #
29377
+ # This setting isn't valid for RDS for SQL Server.
29378
+ #
29302
29379
  # <note markdown="1"> Be sure to allocate enough storage for your new DB instance so that
29303
29380
  # the restore operation can succeed. You can also allocate additional
29304
29381
  # storage for future growth.
@@ -31794,7 +31871,7 @@ module Aws::RDS
31794
31871
  tracer: tracer
31795
31872
  )
31796
31873
  context[:gem_name] = 'aws-sdk-rds'
31797
- context[:gem_version] = '1.263.0'
31874
+ context[:gem_version] = '1.265.0'
31798
31875
  Seahorse::Client::Request.new(handlers, context)
31799
31876
  end
31800
31877
 
@@ -541,7 +541,7 @@ module Aws::RDS
541
541
 
542
542
  # Indicates whether minor version patches are applied automatically.
543
543
  #
544
- # This setting is only for non-Aurora Multi-AZ DB clusters.
544
+ # This setting is for Aurora DB clusters and Multi-AZ DB clusters.
545
545
  # @return [Boolean]
546
546
  def auto_minor_version_upgrade
547
547
  data[:auto_minor_version_upgrade]
@@ -550,7 +550,7 @@ module Aws::RDS
550
550
  # The interval, in seconds, between points when Enhanced Monitoring
551
551
  # metrics are collected for the DB cluster.
552
552
  #
553
- # This setting is only for non-Aurora Multi-AZ DB clusters.
553
+ # This setting is only for -Aurora DB clusters and Multi-AZ DB clusters.
554
554
  # @return [Integer]
555
555
  def monitoring_interval
556
556
  data[:monitoring_interval]
@@ -559,13 +559,13 @@ module Aws::RDS
559
559
  # The ARN for the IAM role that permits RDS to send Enhanced Monitoring
560
560
  # metrics to Amazon CloudWatch Logs.
561
561
  #
562
- # This setting is only for non-Aurora Multi-AZ DB clusters.
562
+ # This setting is only for Aurora DB clusters and Multi-AZ DB clusters.
563
563
  # @return [String]
564
564
  def monitoring_role_arn
565
565
  data[:monitoring_role_arn]
566
566
  end
567
567
 
568
- # The mode of Database Insights that is enabled for the cluster.
568
+ # The mode of Database Insights that is enabled for the DB cluster.
569
569
  # @return [String]
570
570
  def database_insights_mode
571
571
  data[:database_insights_mode]
@@ -573,7 +573,7 @@ module Aws::RDS
573
573
 
574
574
  # Indicates whether Performance Insights is enabled for the DB cluster.
575
575
  #
576
- # This setting is only for non-Aurora Multi-AZ DB clusters.
576
+ # This setting is only for Aurora DB clusters and Multi-AZ DB clusters.
577
577
  # @return [Boolean]
578
578
  def performance_insights_enabled
579
579
  data[:performance_insights_enabled]
@@ -585,7 +585,7 @@ module Aws::RDS
585
585
  # The Amazon Web Services KMS key identifier is the key ARN, key ID,
586
586
  # alias ARN, or alias name for the KMS key.
587
587
  #
588
- # This setting is only for non-Aurora Multi-AZ DB clusters.
588
+ # This setting is only for Aurora DB clusters and Multi-AZ DB clusters.
589
589
  # @return [String]
590
590
  def performance_insights_kms_key_id
591
591
  data[:performance_insights_kms_key_id]
@@ -593,7 +593,7 @@ module Aws::RDS
593
593
 
594
594
  # The number of days to retain Performance Insights data.
595
595
  #
596
- # This setting is only for non-Aurora Multi-AZ DB clusters.
596
+ # This setting is only for Aurora DB clusters and Multi-AZ DB clusters.
597
597
  #
598
598
  # Valid Values:
599
599
  #
@@ -1397,12 +1397,6 @@ module Aws::RDS
1397
1397
  # also query your database from inside the RDS console with the RDS
1398
1398
  # query editor.
1399
1399
  #
1400
- # RDS Data API is supported with the following DB clusters:
1401
- #
1402
- # * Aurora PostgreSQL Serverless v2 and provisioned
1403
- #
1404
- # * Aurora PostgreSQL and Aurora MySQL Serverless v1
1405
- #
1406
1400
  # For more information, see [Using RDS Data API][1] in the *Amazon
1407
1401
  # Aurora User Guide*.
1408
1402
  #
@@ -1574,7 +1568,7 @@ module Aws::RDS
1574
1568
  # the DB cluster during the maintenance window. By default, minor engine
1575
1569
  # upgrades are applied automatically.
1576
1570
  #
1577
- # Valid for Cluster Type: Multi-AZ DB clusters only
1571
+ # Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB cluster
1578
1572
  # @option options [Integer] :monitoring_interval
1579
1573
  # The interval, in seconds, between points when Enhanced Monitoring
1580
1574
  # metrics are collected for the DB cluster. To turn off collecting
@@ -1583,7 +1577,7 @@ module Aws::RDS
1583
1577
  # If `MonitoringRoleArn` is specified, also set `MonitoringInterval` to
1584
1578
  # a value other than `0`.
1585
1579
  #
1586
- # Valid for Cluster Type: Multi-AZ DB clusters only
1580
+ # Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB clusters
1587
1581
  #
1588
1582
  # Valid Values: `0 | 1 | 5 | 10 | 15 | 30 | 60`
1589
1583
  #
@@ -1598,20 +1592,26 @@ module Aws::RDS
1598
1592
  # If `MonitoringInterval` is set to a value other than `0`, supply a
1599
1593
  # `MonitoringRoleArn` value.
1600
1594
  #
1601
- # Valid for Cluster Type: Multi-AZ DB clusters only
1595
+ # Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB clusters
1602
1596
  #
1603
1597
  #
1604
1598
  #
1605
1599
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Monitoring.OS.html#USER_Monitoring.OS.Enabling
1606
1600
  # @option options [String] :database_insights_mode
1607
- # Specifies the mode of Database Insights to enable for the cluster.
1601
+ # The mode of Database Insights to enable for the DB cluster.
1602
+ #
1603
+ # If you set this value to `advanced`, you must also set the
1604
+ # `PerformanceInsightsEnabled` parameter to `true` and the
1605
+ # `PerformanceInsightsRetentionPeriod` parameter to 465.
1606
+ #
1607
+ # Valid for Cluster Type: Aurora DB clusters only
1608
1608
  # @option options [Boolean] :enable_performance_insights
1609
1609
  # Specifies whether to turn on Performance Insights for the DB cluster.
1610
1610
  #
1611
1611
  # For more information, see [ Using Amazon Performance Insights][1] in
1612
1612
  # the *Amazon RDS User Guide*.
1613
1613
  #
1614
- # Valid for Cluster Type: Multi-AZ DB clusters only
1614
+ # Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB clusters
1615
1615
  #
1616
1616
  #
1617
1617
  #
@@ -1628,11 +1628,11 @@ module Aws::RDS
1628
1628
  # your Amazon Web Services account. Your Amazon Web Services account has
1629
1629
  # a different default KMS key for each Amazon Web Services Region.
1630
1630
  #
1631
- # Valid for Cluster Type: Multi-AZ DB clusters only
1631
+ # Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB clusters
1632
1632
  # @option options [Integer] :performance_insights_retention_period
1633
1633
  # The number of days to retain Performance Insights data.
1634
1634
  #
1635
- # Valid for Cluster Type: Multi-AZ DB clusters only
1635
+ # Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB clusters
1636
1636
  #
1637
1637
  # Valid Values:
1638
1638
  #
@@ -2400,7 +2400,7 @@ module Aws::RDS
2400
2400
  # the DB cluster during the maintenance window. By default, minor engine
2401
2401
  # upgrades are applied automatically.
2402
2402
  #
2403
- # Valid for Cluster Type: Multi-AZ DB clusters only
2403
+ # Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB clusters
2404
2404
  # @option options [Integer] :monitoring_interval
2405
2405
  # The interval, in seconds, between points when Enhanced Monitoring
2406
2406
  # metrics are collected for the DB cluster. To turn off collecting
@@ -2430,7 +2430,16 @@ module Aws::RDS
2430
2430
  #
2431
2431
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Monitoring.html#USER_Monitoring.OS.IAMRole
2432
2432
  # @option options [String] :database_insights_mode
2433
- # Specifies the mode of Database Insights to enable for the cluster.
2433
+ # Specifies the mode of Database Insights to enable for the DB cluster.
2434
+ #
2435
+ # If you change the value from `standard` to `advanced`, you must set
2436
+ # the `PerformanceInsightsEnabled` parameter to `true` and the
2437
+ # `PerformanceInsightsRetentionPeriod` parameter to 465.
2438
+ #
2439
+ # If you change the value from `advanced` to `standard`, you must set
2440
+ # the `PerformanceInsightsEnabled` parameter to `false`.
2441
+ #
2442
+ # Valid for Cluster Type: Aurora DB clusters only
2434
2443
  # @option options [Boolean] :enable_performance_insights
2435
2444
  # Specifies whether to turn on Performance Insights for the DB cluster.
2436
2445
  #
@@ -2454,11 +2463,11 @@ module Aws::RDS
2454
2463
  # your Amazon Web Services account. Your Amazon Web Services account has
2455
2464
  # a different default KMS key for each Amazon Web Services Region.
2456
2465
  #
2457
- # Valid for Cluster Type: Multi-AZ DB clusters only
2466
+ # Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB clusters
2458
2467
  # @option options [Integer] :performance_insights_retention_period
2459
2468
  # The number of days to retain Performance Insights data.
2460
2469
  #
2461
- # Valid for Cluster Type: Multi-AZ DB clusters only
2470
+ # Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB clusters
2462
2471
  #
2463
2472
  # Valid Values:
2464
2473
  #
@@ -2968,7 +2977,8 @@ module Aws::RDS
2968
2977
  # cluster, or a provisioned clone from an Aurora Serverless v1 cluster.
2969
2978
  # To create a clone that is an Aurora Serverless v1 cluster, the
2970
2979
  # original cluster must be an Aurora Serverless v1 cluster or an
2971
- # encrypted provisioned cluster.
2980
+ # encrypted provisioned cluster. To create a full copy that is an Aurora
2981
+ # Serverless v1 cluster, specify the engine mode `serverless`.
2972
2982
  #
2973
2983
  # Valid for: Aurora DB clusters only
2974
2984
  # @option options [String] :db_cluster_instance_class
@@ -1943,7 +1943,14 @@ module Aws::RDS
1943
1943
  #
1944
1944
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/UsingWithRDS.IAMDBAuth.html
1945
1945
  # @option options [String] :database_insights_mode
1946
- # Specifies the mode of Database Insights to enable for the instance.
1946
+ # The mode of Database Insights to enable for the DB instance.
1947
+ #
1948
+ # This setting only applies to Amazon Aurora DB instances.
1949
+ #
1950
+ # <note markdown="1"> Currently, this value is inherited from the DB cluster and can't be
1951
+ # changed.
1952
+ #
1953
+ # </note>
1947
1954
  # @option options [Boolean] :enable_performance_insights
1948
1955
  # Specifies whether to enable Performance Insights for the DB instance.
1949
1956
  # For more information, see [Using Amazon Performance Insights][1] in
@@ -2616,7 +2623,11 @@ module Aws::RDS
2616
2623
  #
2617
2624
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/UsingWithRDS.IAMDBAuth.html
2618
2625
  # @option options [String] :database_insights_mode
2619
- # Specifies the mode of Database Insights.
2626
+ # The mode of Database Insights to enable for the read replica.
2627
+ #
2628
+ # <note markdown="1"> Currently, this setting is not supported.
2629
+ #
2630
+ # </note>
2620
2631
  # @option options [Boolean] :enable_performance_insights
2621
2632
  # Specifies whether to enable Performance Insights for the read replica.
2622
2633
  #
@@ -2855,6 +2866,8 @@ module Aws::RDS
2855
2866
  # read replica. Follow the allocation rules specified in
2856
2867
  # `CreateDBInstance`.
2857
2868
  #
2869
+ # This setting isn't valid for RDS for SQL Server.
2870
+ #
2858
2871
  # <note markdown="1"> Be sure to allocate enough storage for your read replica so that the
2859
2872
  # create operation can succeed. You can also allocate additional storage
2860
2873
  # for future growth.
@@ -3483,10 +3496,10 @@ module Aws::RDS
3483
3496
  # type to take effect.
3484
3497
  #
3485
3498
  # If you choose to migrate your DB instance from using standard storage
3486
- # to using Provisioned IOPS, or from using Provisioned IOPS to using
3487
- # standard storage, the process can take time. The duration of the
3488
- # migration depends on several factors such as database load, storage
3489
- # size, storage type (standard or Provisioned IOPS), amount of IOPS
3499
+ # to Provisioned IOPS (io1), or from Provisioned IOPS to standard
3500
+ # storage, the process can take time. The duration of the migration
3501
+ # depends on several factors such as database load, storage size,
3502
+ # storage type (standard or Provisioned IOPS), amount of IOPS
3490
3503
  # provisioned (if any), and the number of prior scale storage
3491
3504
  # operations. Typical migration times are under 24 hours, but the
3492
3505
  # process can take up to several days in some cases. During the
@@ -3497,6 +3510,8 @@ module Aws::RDS
3497
3510
  # rebooting the instance, deleting the instance, creating a read replica
3498
3511
  # for the instance, and creating a DB snapshot of the instance.
3499
3512
  #
3513
+ #
3514
+ #
3500
3515
  # Constraints:
3501
3516
  #
3502
3517
  # * For RDS for MariaDB, RDS for MySQL, RDS for Oracle, and RDS for
@@ -3553,13 +3568,13 @@ module Aws::RDS
3553
3568
  # for the `Iops` parameter.
3554
3569
  #
3555
3570
  # If you choose to migrate your DB instance from using standard storage
3556
- # to using Provisioned IOPS, or from using Provisioned IOPS to using
3557
- # standard storage, the process can take time. The duration of the
3558
- # migration depends on several factors such as database load, storage
3559
- # size, storage type (standard or Provisioned IOPS), amount of IOPS
3560
- # provisioned (if any), and the number of prior scale storage
3561
- # operations. Typical migration times are under 24 hours, but the
3562
- # process can take up to several days in some cases. During the
3571
+ # to gp2 (General Purpose SSD), gp3, or Provisioned IOPS (io1), or from
3572
+ # these storage types to standard storage, the process can take time.
3573
+ # The duration of the migration depends on several factors such as
3574
+ # database load, storage size, storage type (standard or Provisioned
3575
+ # IOPS), amount of IOPS provisioned (if any), and the number of prior
3576
+ # scale storage operations. Typical migration times are under 24 hours,
3577
+ # but the process can take up to several days in some cases. During the
3563
3578
  # migration, the DB instance is available for use, but might experience
3564
3579
  # performance degradation. While the migration takes place, nightly
3565
3580
  # backups for the instance are suspended. No other Amazon RDS operations
@@ -3786,7 +3801,14 @@ module Aws::RDS
3786
3801
  #
3787
3802
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/UsingWithRDS.IAMDBAuth.html
3788
3803
  # @option options [String] :database_insights_mode
3789
- # Specifies the mode of Database Insights to enable for the instance.
3804
+ # Specifies the mode of Database Insights to enable for the DB instance.
3805
+ #
3806
+ # This setting only applies to Amazon Aurora DB instances.
3807
+ #
3808
+ # <note markdown="1"> Currently, this value is inherited from the DB cluster and can't be
3809
+ # changed.
3810
+ #
3811
+ # </note>
3790
3812
  # @option options [Boolean] :enable_performance_insights
3791
3813
  # Specifies whether to enable Performance Insights for the DB instance.
3792
3814
  #
@@ -3839,6 +3861,29 @@ module Aws::RDS
3839
3861
  # `ApplyImmediately` parameter has no effect.
3840
3862
  #
3841
3863
  # This setting doesn't apply to RDS Custom DB instances.
3864
+ #
3865
+ # The following values are valid for each DB engine:
3866
+ #
3867
+ # * Aurora MySQL - `audit | error | general | slowquery`
3868
+ #
3869
+ # * Aurora PostgreSQL - `postgresql`
3870
+ #
3871
+ # * RDS for MySQL - `error | general | slowquery`
3872
+ #
3873
+ # * RDS for PostgreSQL - `postgresql | upgrade`
3874
+ #
3875
+ # For more information about exporting CloudWatch Logs for Amazon RDS,
3876
+ # see [ Publishing Database Logs to Amazon CloudWatch Logs][1] in the
3877
+ # *Amazon RDS User Guide*.
3878
+ #
3879
+ # For more information about exporting CloudWatch Logs for Amazon
3880
+ # Aurora, see [Publishing Database Logs to Amazon CloudWatch Logs][2] in
3881
+ # the *Amazon Aurora User Guide*.
3882
+ #
3883
+ #
3884
+ #
3885
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_LogAccess.html#USER_LogAccess.Procedural.UploadtoCloudWatch
3886
+ # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_LogAccess.html#USER_LogAccess.Procedural.UploadtoCloudWatch
3842
3887
  # @option options [Array<Types::ProcessorFeature>] :processor_features
3843
3888
  # The number of CPU cores and the number of threads per core for the DB
3844
3889
  # instance class of the DB instance.
@@ -4764,6 +4809,8 @@ module Aws::RDS
4764
4809
  # The amount of storage (in gibibytes) to allocate initially for the DB
4765
4810
  # instance. Follow the allocation rules specified in `CreateDBInstance`.
4766
4811
  #
4812
+ # This setting isn't valid for RDS for SQL Server.
4813
+ #
4767
4814
  # <note markdown="1"> Be sure to allocate enough storage for your new DB instance so that
4768
4815
  # the restore operation can succeed. You can also allocate additional
4769
4816
  # storage for future growth.
@@ -602,7 +602,10 @@ module Aws::RDS
602
602
  #
603
603
  # Valid Values: `user | system | engine-default`
604
604
  # @option options [Array<Types::Filter>] :filters
605
- # This parameter isn't currently supported.
605
+ # A filter that specifies one or more DB parameters to describe.
606
+ #
607
+ # The only supported filter is `parameter-name`. The results list only
608
+ # includes information about the DB parameters with these names.
606
609
  # @return [Parameter::Collection]
607
610
  def parameters(options = {})
608
611
  batches = Enumerator.new do |y|
@@ -224,7 +224,10 @@ module Aws::RDS
224
224
  # })
225
225
  # @param [Hash] options ({})
226
226
  # @option options [Array<Types::Filter>] :filters
227
- # This parameter isn't currently supported.
227
+ # A filter that specifies one or more parameters to describe.
228
+ #
229
+ # The only supported filter is `parameter-name`. The results list only
230
+ # includes information about the parameters with these names.
228
231
  # @return [Parameter::Collection]
229
232
  def engine_default_parameters(options = {})
230
233
  batches = Enumerator.new do |y|
@@ -1190,6 +1190,8 @@ module Aws::RDS
1190
1190
  # The amount of storage (in gibibytes) to allocate initially for the DB
1191
1191
  # instance. Follow the allocation rules specified in CreateDBInstance.
1192
1192
  #
1193
+ # This setting isn't valid for RDS for SQL Server.
1194
+ #
1193
1195
  # <note markdown="1"> Be sure to allocate enough storage for your new DB instance so that
1194
1196
  # the restore operation can succeed. You can also allocate additional
1195
1197
  # storage for future growth.
@@ -571,12 +571,6 @@ module Aws::RDS
571
571
  # also query your database from inside the RDS console with the RDS
572
572
  # query editor.
573
573
  #
574
- # RDS Data API is supported with the following DB clusters:
575
- #
576
- # * Aurora PostgreSQL Serverless v2 and provisioned
577
- #
578
- # * Aurora PostgreSQL and Aurora MySQL Serverless v1
579
- #
580
574
  # For more information, see [Using RDS Data API][1] in the *Amazon
581
575
  # Aurora User Guide*.
582
576
  #
@@ -748,7 +742,7 @@ module Aws::RDS
748
742
  # the DB cluster during the maintenance window. By default, minor engine
749
743
  # upgrades are applied automatically.
750
744
  #
751
- # Valid for Cluster Type: Multi-AZ DB clusters only
745
+ # Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB cluster
752
746
  # @option options [Integer] :monitoring_interval
753
747
  # The interval, in seconds, between points when Enhanced Monitoring
754
748
  # metrics are collected for the DB cluster. To turn off collecting
@@ -757,7 +751,7 @@ module Aws::RDS
757
751
  # If `MonitoringRoleArn` is specified, also set `MonitoringInterval` to
758
752
  # a value other than `0`.
759
753
  #
760
- # Valid for Cluster Type: Multi-AZ DB clusters only
754
+ # Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB clusters
761
755
  #
762
756
  # Valid Values: `0 | 1 | 5 | 10 | 15 | 30 | 60`
763
757
  #
@@ -772,20 +766,26 @@ module Aws::RDS
772
766
  # If `MonitoringInterval` is set to a value other than `0`, supply a
773
767
  # `MonitoringRoleArn` value.
774
768
  #
775
- # Valid for Cluster Type: Multi-AZ DB clusters only
769
+ # Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB clusters
776
770
  #
777
771
  #
778
772
  #
779
773
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Monitoring.OS.html#USER_Monitoring.OS.Enabling
780
774
  # @option options [String] :database_insights_mode
781
- # Specifies the mode of Database Insights to enable for the cluster.
775
+ # The mode of Database Insights to enable for the DB cluster.
776
+ #
777
+ # If you set this value to `advanced`, you must also set the
778
+ # `PerformanceInsightsEnabled` parameter to `true` and the
779
+ # `PerformanceInsightsRetentionPeriod` parameter to 465.
780
+ #
781
+ # Valid for Cluster Type: Aurora DB clusters only
782
782
  # @option options [Boolean] :enable_performance_insights
783
783
  # Specifies whether to turn on Performance Insights for the DB cluster.
784
784
  #
785
785
  # For more information, see [ Using Amazon Performance Insights][1] in
786
786
  # the *Amazon RDS User Guide*.
787
787
  #
788
- # Valid for Cluster Type: Multi-AZ DB clusters only
788
+ # Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB clusters
789
789
  #
790
790
  #
791
791
  #
@@ -802,11 +802,11 @@ module Aws::RDS
802
802
  # your Amazon Web Services account. Your Amazon Web Services account has
803
803
  # a different default KMS key for each Amazon Web Services Region.
804
804
  #
805
- # Valid for Cluster Type: Multi-AZ DB clusters only
805
+ # Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB clusters
806
806
  # @option options [Integer] :performance_insights_retention_period
807
807
  # The number of days to retain Performance Insights data.
808
808
  #
809
- # Valid for Cluster Type: Multi-AZ DB clusters only
809
+ # Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB clusters
810
810
  #
811
811
  # Valid Values:
812
812
  #
@@ -2091,7 +2091,14 @@ module Aws::RDS
2091
2091
  #
2092
2092
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/UsingWithRDS.IAMDBAuth.html
2093
2093
  # @option options [String] :database_insights_mode
2094
- # Specifies the mode of Database Insights to enable for the instance.
2094
+ # The mode of Database Insights to enable for the DB instance.
2095
+ #
2096
+ # This setting only applies to Amazon Aurora DB instances.
2097
+ #
2098
+ # <note markdown="1"> Currently, this value is inherited from the DB cluster and can't be
2099
+ # changed.
2100
+ #
2101
+ # </note>
2095
2102
  # @option options [Boolean] :enable_performance_insights
2096
2103
  # Specifies whether to enable Performance Insights for the DB instance.
2097
2104
  # For more information, see [Using Amazon Performance Insights][1] in
@@ -894,10 +894,30 @@ module Aws::RDS
894
894
  #
895
895
  # @!attribute [rw] enable_log_types
896
896
  # The list of log types to enable.
897
+ #
898
+ # The following values are valid for each DB engine:
899
+ #
900
+ # * Aurora MySQL - `audit | error | general | slowquery`
901
+ #
902
+ # * Aurora PostgreSQL - `postgresql`
903
+ #
904
+ # * RDS for MySQL - `error | general | slowquery`
905
+ #
906
+ # * RDS for PostgreSQL - `postgresql | upgrade`
897
907
  # @return [Array<String>]
898
908
  #
899
909
  # @!attribute [rw] disable_log_types
900
910
  # The list of log types to disable.
911
+ #
912
+ # The following values are valid for each DB engine:
913
+ #
914
+ # * Aurora MySQL - `audit | error | general | slowquery`
915
+ #
916
+ # * Aurora PostgreSQL - `postgresql`
917
+ #
918
+ # * RDS for MySQL - `error | general | slowquery`
919
+ #
920
+ # * RDS for PostgreSQL - `postgresql | upgrade`
901
921
  # @return [Array<String>]
902
922
  #
903
923
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/CloudwatchLogsExportConfiguration AWS API Documentation
@@ -2654,12 +2674,6 @@ module Aws::RDS
2654
2674
  # cluster. You can also query your database from inside the RDS
2655
2675
  # console with the RDS query editor.
2656
2676
  #
2657
- # RDS Data API is supported with the following DB clusters:
2658
- #
2659
- # * Aurora PostgreSQL Serverless v2 and provisioned
2660
- #
2661
- # * Aurora PostgreSQL and Aurora MySQL Serverless v1
2662
- #
2663
2677
  # For more information, see [Using RDS Data API][1] in the *Amazon
2664
2678
  # Aurora User Guide*.
2665
2679
  #
@@ -2851,7 +2865,7 @@ module Aws::RDS
2851
2865
  # the DB cluster during the maintenance window. By default, minor
2852
2866
  # engine upgrades are applied automatically.
2853
2867
  #
2854
- # Valid for Cluster Type: Multi-AZ DB clusters only
2868
+ # Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB cluster
2855
2869
  # @return [Boolean]
2856
2870
  #
2857
2871
  # @!attribute [rw] monitoring_interval
@@ -2862,7 +2876,7 @@ module Aws::RDS
2862
2876
  # If `MonitoringRoleArn` is specified, also set `MonitoringInterval`
2863
2877
  # to a value other than `0`.
2864
2878
  #
2865
- # Valid for Cluster Type: Multi-AZ DB clusters only
2879
+ # Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB clusters
2866
2880
  #
2867
2881
  # Valid Values: `0 | 1 | 5 | 10 | 15 | 30 | 60`
2868
2882
  #
@@ -2879,7 +2893,7 @@ module Aws::RDS
2879
2893
  # If `MonitoringInterval` is set to a value other than `0`, supply a
2880
2894
  # `MonitoringRoleArn` value.
2881
2895
  #
2882
- # Valid for Cluster Type: Multi-AZ DB clusters only
2896
+ # Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB clusters
2883
2897
  #
2884
2898
  #
2885
2899
  #
@@ -2887,7 +2901,13 @@ module Aws::RDS
2887
2901
  # @return [String]
2888
2902
  #
2889
2903
  # @!attribute [rw] database_insights_mode
2890
- # Specifies the mode of Database Insights to enable for the cluster.
2904
+ # The mode of Database Insights to enable for the DB cluster.
2905
+ #
2906
+ # If you set this value to `advanced`, you must also set the
2907
+ # `PerformanceInsightsEnabled` parameter to `true` and the
2908
+ # `PerformanceInsightsRetentionPeriod` parameter to 465.
2909
+ #
2910
+ # Valid for Cluster Type: Aurora DB clusters only
2891
2911
  # @return [String]
2892
2912
  #
2893
2913
  # @!attribute [rw] enable_performance_insights
@@ -2897,7 +2917,7 @@ module Aws::RDS
2897
2917
  # For more information, see [ Using Amazon Performance Insights][1] in
2898
2918
  # the *Amazon RDS User Guide*.
2899
2919
  #
2900
- # Valid for Cluster Type: Multi-AZ DB clusters only
2920
+ # Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB clusters
2901
2921
  #
2902
2922
  #
2903
2923
  #
@@ -2917,13 +2937,13 @@ module Aws::RDS
2917
2937
  # account has a different default KMS key for each Amazon Web Services
2918
2938
  # Region.
2919
2939
  #
2920
- # Valid for Cluster Type: Multi-AZ DB clusters only
2940
+ # Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB clusters
2921
2941
  # @return [String]
2922
2942
  #
2923
2943
  # @!attribute [rw] performance_insights_retention_period
2924
2944
  # The number of days to retain Performance Insights data.
2925
2945
  #
2926
- # Valid for Cluster Type: Multi-AZ DB clusters only
2946
+ # Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB clusters
2927
2947
  #
2928
2948
  # Valid Values:
2929
2949
  #
@@ -4409,7 +4429,14 @@ module Aws::RDS
4409
4429
  # @return [Boolean]
4410
4430
  #
4411
4431
  # @!attribute [rw] database_insights_mode
4412
- # Specifies the mode of Database Insights to enable for the instance.
4432
+ # The mode of Database Insights to enable for the DB instance.
4433
+ #
4434
+ # This setting only applies to Amazon Aurora DB instances.
4435
+ #
4436
+ # <note markdown="1"> Currently, this value is inherited from the DB cluster and can't be
4437
+ # changed.
4438
+ #
4439
+ # </note>
4413
4440
  # @return [String]
4414
4441
  #
4415
4442
  # @!attribute [rw] enable_performance_insights
@@ -5208,7 +5235,11 @@ module Aws::RDS
5208
5235
  # @return [Boolean]
5209
5236
  #
5210
5237
  # @!attribute [rw] database_insights_mode
5211
- # Specifies the mode of Database Insights.
5238
+ # The mode of Database Insights to enable for the read replica.
5239
+ #
5240
+ # <note markdown="1"> Currently, this setting is not supported.
5241
+ #
5242
+ # </note>
5212
5243
  # @return [String]
5213
5244
  #
5214
5245
  # @!attribute [rw] enable_performance_insights
@@ -5492,6 +5523,8 @@ module Aws::RDS
5492
5523
  # read replica. Follow the allocation rules specified in
5493
5524
  # `CreateDBInstance`.
5494
5525
  #
5526
+ # This setting isn't valid for RDS for SQL Server.
5527
+ #
5495
5528
  # <note markdown="1"> Be sure to allocate enough storage for your read replica so that the
5496
5529
  # create operation can succeed. You can also allocate additional
5497
5530
  # storage for future growth.
@@ -7161,32 +7194,35 @@ module Aws::RDS
7161
7194
  # @!attribute [rw] auto_minor_version_upgrade
7162
7195
  # Indicates whether minor version patches are applied automatically.
7163
7196
  #
7164
- # This setting is only for non-Aurora Multi-AZ DB clusters.
7197
+ # This setting is for Aurora DB clusters and Multi-AZ DB clusters.
7165
7198
  # @return [Boolean]
7166
7199
  #
7167
7200
  # @!attribute [rw] monitoring_interval
7168
7201
  # The interval, in seconds, between points when Enhanced Monitoring
7169
7202
  # metrics are collected for the DB cluster.
7170
7203
  #
7171
- # This setting is only for non-Aurora Multi-AZ DB clusters.
7204
+ # This setting is only for -Aurora DB clusters and Multi-AZ DB
7205
+ # clusters.
7172
7206
  # @return [Integer]
7173
7207
  #
7174
7208
  # @!attribute [rw] monitoring_role_arn
7175
7209
  # The ARN for the IAM role that permits RDS to send Enhanced
7176
7210
  # Monitoring metrics to Amazon CloudWatch Logs.
7177
7211
  #
7178
- # This setting is only for non-Aurora Multi-AZ DB clusters.
7212
+ # This setting is only for Aurora DB clusters and Multi-AZ DB
7213
+ # clusters.
7179
7214
  # @return [String]
7180
7215
  #
7181
7216
  # @!attribute [rw] database_insights_mode
7182
- # The mode of Database Insights that is enabled for the cluster.
7217
+ # The mode of Database Insights that is enabled for the DB cluster.
7183
7218
  # @return [String]
7184
7219
  #
7185
7220
  # @!attribute [rw] performance_insights_enabled
7186
7221
  # Indicates whether Performance Insights is enabled for the DB
7187
7222
  # cluster.
7188
7223
  #
7189
- # This setting is only for non-Aurora Multi-AZ DB clusters.
7224
+ # This setting is only for Aurora DB clusters and Multi-AZ DB
7225
+ # clusters.
7190
7226
  # @return [Boolean]
7191
7227
  #
7192
7228
  # @!attribute [rw] performance_insights_kms_key_id
@@ -7196,13 +7232,15 @@ module Aws::RDS
7196
7232
  # The Amazon Web Services KMS key identifier is the key ARN, key ID,
7197
7233
  # alias ARN, or alias name for the KMS key.
7198
7234
  #
7199
- # This setting is only for non-Aurora Multi-AZ DB clusters.
7235
+ # This setting is only for Aurora DB clusters and Multi-AZ DB
7236
+ # clusters.
7200
7237
  # @return [String]
7201
7238
  #
7202
7239
  # @!attribute [rw] performance_insights_retention_period
7203
7240
  # The number of days to retain Performance Insights data.
7204
7241
  #
7205
- # This setting is only for non-Aurora Multi-AZ DB clusters.
7242
+ # This setting is only for Aurora DB clusters and Multi-AZ DB
7243
+ # clusters.
7206
7244
  #
7207
7245
  # Valid Values:
7208
7246
  #
@@ -12510,15 +12548,20 @@ module Aws::RDS
12510
12548
  #
12511
12549
  # Valid Values:
12512
12550
  #
12513
- # * `customer`
12551
+ # * `engine-default`
12514
12552
  #
12515
- # * `engine`
12553
+ # * `system`
12516
12554
  #
12517
- # * `service`
12555
+ # * `user`
12518
12556
  # @return [String]
12519
12557
  #
12520
12558
  # @!attribute [rw] filters
12521
- # This parameter isn't currently supported.
12559
+ # A filter that specifies one or more DB cluster parameters to
12560
+ # describe.
12561
+ #
12562
+ # The only supported filter is `parameter-name`. The results list only
12563
+ # includes information about the DB cluster parameters with these
12564
+ # names.
12522
12565
  # @return [Array<Types::Filter>]
12523
12566
  #
12524
12567
  # @!attribute [rw] max_records
@@ -13263,7 +13306,10 @@ module Aws::RDS
13263
13306
  # @return [String]
13264
13307
  #
13265
13308
  # @!attribute [rw] filters
13266
- # This parameter isn't currently supported.
13309
+ # A filter that specifies one or more DB parameters to describe.
13310
+ #
13311
+ # The only supported filter is `parameter-name`. The results list only
13312
+ # includes information about the DB parameters with these names.
13267
13313
  # @return [Array<Types::Filter>]
13268
13314
  #
13269
13315
  # @!attribute [rw] max_records
@@ -14233,7 +14279,10 @@ module Aws::RDS
14233
14279
  # @return [String]
14234
14280
  #
14235
14281
  # @!attribute [rw] filters
14236
- # This parameter isn't currently supported.
14282
+ # A filter that specifies one or more parameters to describe.
14283
+ #
14284
+ # The only supported filter is `parameter-name`. The results list only
14285
+ # includes information about the parameters with these names.
14237
14286
  # @return [Array<Types::Filter>]
14238
14287
  #
14239
14288
  # @!attribute [rw] max_records
@@ -17730,7 +17779,7 @@ module Aws::RDS
17730
17779
  # the DB cluster during the maintenance window. By default, minor
17731
17780
  # engine upgrades are applied automatically.
17732
17781
  #
17733
- # Valid for Cluster Type: Multi-AZ DB clusters only
17782
+ # Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB clusters
17734
17783
  # @return [Boolean]
17735
17784
  #
17736
17785
  # @!attribute [rw] monitoring_interval
@@ -17766,7 +17815,17 @@ module Aws::RDS
17766
17815
  # @return [String]
17767
17816
  #
17768
17817
  # @!attribute [rw] database_insights_mode
17769
- # Specifies the mode of Database Insights to enable for the cluster.
17818
+ # Specifies the mode of Database Insights to enable for the DB
17819
+ # cluster.
17820
+ #
17821
+ # If you change the value from `standard` to `advanced`, you must set
17822
+ # the `PerformanceInsightsEnabled` parameter to `true` and the
17823
+ # `PerformanceInsightsRetentionPeriod` parameter to 465.
17824
+ #
17825
+ # If you change the value from `advanced` to `standard`, you must set
17826
+ # the `PerformanceInsightsEnabled` parameter to `false`.
17827
+ #
17828
+ # Valid for Cluster Type: Aurora DB clusters only
17770
17829
  # @return [String]
17771
17830
  #
17772
17831
  # @!attribute [rw] enable_performance_insights
@@ -17796,13 +17855,13 @@ module Aws::RDS
17796
17855
  # account has a different default KMS key for each Amazon Web Services
17797
17856
  # Region.
17798
17857
  #
17799
- # Valid for Cluster Type: Multi-AZ DB clusters only
17858
+ # Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB clusters
17800
17859
  # @return [String]
17801
17860
  #
17802
17861
  # @!attribute [rw] performance_insights_retention_period
17803
17862
  # The number of days to retain Performance Insights data.
17804
17863
  #
17805
- # Valid for Cluster Type: Multi-AZ DB clusters only
17864
+ # Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB clusters
17806
17865
  #
17807
17866
  # Valid Values:
17808
17867
  #
@@ -18642,11 +18701,11 @@ module Aws::RDS
18642
18701
  # storage type to take effect.
18643
18702
  #
18644
18703
  # If you choose to migrate your DB instance from using standard
18645
- # storage to using Provisioned IOPS, or from using Provisioned IOPS to
18646
- # using standard storage, the process can take time. The duration of
18647
- # the migration depends on several factors such as database load,
18648
- # storage size, storage type (standard or Provisioned IOPS), amount of
18649
- # IOPS provisioned (if any), and the number of prior scale storage
18704
+ # storage to Provisioned IOPS (io1), or from Provisioned IOPS to
18705
+ # standard storage, the process can take time. The duration of the
18706
+ # migration depends on several factors such as database load, storage
18707
+ # size, storage type (standard or Provisioned IOPS), amount of IOPS
18708
+ # provisioned (if any), and the number of prior scale storage
18650
18709
  # operations. Typical migration times are under 24 hours, but the
18651
18710
  # process can take up to several days in some cases. During the
18652
18711
  # migration, the DB instance is available for use, but might
@@ -18657,6 +18716,8 @@ module Aws::RDS
18657
18716
  # read replica for the instance, and creating a DB snapshot of the
18658
18717
  # instance.
18659
18718
  #
18719
+ #
18720
+ #
18660
18721
  # Constraints:
18661
18722
  #
18662
18723
  # * For RDS for MariaDB, RDS for MySQL, RDS for Oracle, and RDS for
@@ -18719,20 +18780,20 @@ module Aws::RDS
18719
18780
  # for the `Iops` parameter.
18720
18781
  #
18721
18782
  # If you choose to migrate your DB instance from using standard
18722
- # storage to using Provisioned IOPS, or from using Provisioned IOPS to
18723
- # using standard storage, the process can take time. The duration of
18724
- # the migration depends on several factors such as database load,
18725
- # storage size, storage type (standard or Provisioned IOPS), amount of
18726
- # IOPS provisioned (if any), and the number of prior scale storage
18727
- # operations. Typical migration times are under 24 hours, but the
18728
- # process can take up to several days in some cases. During the
18729
- # migration, the DB instance is available for use, but might
18730
- # experience performance degradation. While the migration takes place,
18731
- # nightly backups for the instance are suspended. No other Amazon RDS
18732
- # operations can take place for the instance, including modifying the
18733
- # instance, rebooting the instance, deleting the instance, creating a
18734
- # read replica for the instance, and creating a DB snapshot of the
18735
- # instance.
18783
+ # storage to gp2 (General Purpose SSD), gp3, or Provisioned IOPS
18784
+ # (io1), or from these storage types to standard storage, the process
18785
+ # can take time. The duration of the migration depends on several
18786
+ # factors such as database load, storage size, storage type (standard
18787
+ # or Provisioned IOPS), amount of IOPS provisioned (if any), and the
18788
+ # number of prior scale storage operations. Typical migration times
18789
+ # are under 24 hours, but the process can take up to several days in
18790
+ # some cases. During the migration, the DB instance is available for
18791
+ # use, but might experience performance degradation. While the
18792
+ # migration takes place, nightly backups for the instance are
18793
+ # suspended. No other Amazon RDS operations can take place for the
18794
+ # instance, including modifying the instance, rebooting the instance,
18795
+ # deleting the instance, creating a read replica for the instance, and
18796
+ # creating a DB snapshot of the instance.
18736
18797
  #
18737
18798
  # Valid Values: `gp2 | gp3 | io1 | io2 | standard`
18738
18799
  #
@@ -18992,7 +19053,15 @@ module Aws::RDS
18992
19053
  # @return [Boolean]
18993
19054
  #
18994
19055
  # @!attribute [rw] database_insights_mode
18995
- # Specifies the mode of Database Insights to enable for the instance.
19056
+ # Specifies the mode of Database Insights to enable for the DB
19057
+ # instance.
19058
+ #
19059
+ # This setting only applies to Amazon Aurora DB instances.
19060
+ #
19061
+ # <note markdown="1"> Currently, this value is inherited from the DB cluster and can't be
19062
+ # changed.
19063
+ #
19064
+ # </note>
18996
19065
  # @return [String]
18997
19066
  #
18998
19067
  # @!attribute [rw] enable_performance_insights
@@ -19055,6 +19124,29 @@ module Aws::RDS
19055
19124
  # `ApplyImmediately` parameter has no effect.
19056
19125
  #
19057
19126
  # This setting doesn't apply to RDS Custom DB instances.
19127
+ #
19128
+ # The following values are valid for each DB engine:
19129
+ #
19130
+ # * Aurora MySQL - `audit | error | general | slowquery`
19131
+ #
19132
+ # * Aurora PostgreSQL - `postgresql`
19133
+ #
19134
+ # * RDS for MySQL - `error | general | slowquery`
19135
+ #
19136
+ # * RDS for PostgreSQL - `postgresql | upgrade`
19137
+ #
19138
+ # For more information about exporting CloudWatch Logs for Amazon RDS,
19139
+ # see [ Publishing Database Logs to Amazon CloudWatch Logs][1] in the
19140
+ # *Amazon RDS User Guide*.
19141
+ #
19142
+ # For more information about exporting CloudWatch Logs for Amazon
19143
+ # Aurora, see [Publishing Database Logs to Amazon CloudWatch Logs][2]
19144
+ # in the *Amazon Aurora User Guide*.
19145
+ #
19146
+ #
19147
+ #
19148
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_LogAccess.html#USER_LogAccess.Procedural.UploadtoCloudWatch
19149
+ # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_LogAccess.html#USER_LogAccess.Procedural.UploadtoCloudWatch
19058
19150
  # @return [Types::CloudwatchLogsExportConfiguration]
19059
19151
  #
19060
19152
  # @!attribute [rw] processor_features
@@ -24086,7 +24178,8 @@ module Aws::RDS
24086
24178
  # cluster, or a provisioned clone from an Aurora Serverless v1
24087
24179
  # cluster. To create a clone that is an Aurora Serverless v1 cluster,
24088
24180
  # the original cluster must be an Aurora Serverless v1 cluster or an
24089
- # encrypted provisioned cluster.
24181
+ # encrypted provisioned cluster. To create a full copy that is an
24182
+ # Aurora Serverless v1 cluster, specify the engine mode `serverless`.
24090
24183
  #
24091
24184
  # Valid for: Aurora DB clusters only
24092
24185
  # @return [String]
@@ -24967,6 +25060,8 @@ module Aws::RDS
24967
25060
  # DB instance. Follow the allocation rules specified in
24968
25061
  # CreateDBInstance.
24969
25062
  #
25063
+ # This setting isn't valid for RDS for SQL Server.
25064
+ #
24970
25065
  # <note markdown="1"> Be sure to allocate enough storage for your new DB instance so that
24971
25066
  # the restore operation can succeed. You can also allocate additional
24972
25067
  # storage for future growth.
@@ -25125,6 +25220,8 @@ module Aws::RDS
25125
25220
  # DB instance. Follow the allocation rules specified in
25126
25221
  # `CreateDBInstance`.
25127
25222
  #
25223
+ # This setting isn't valid for RDS for SQL Server.
25224
+ #
25128
25225
  # <note markdown="1"> Be sure to allocate enough storage for your new DB instance so that
25129
25226
  # the restore operation can succeed. You can also allocate additional
25130
25227
  # storage for future growth.
@@ -25480,7 +25577,15 @@ module Aws::RDS
25480
25577
  # @return [String]
25481
25578
  #
25482
25579
  # @!attribute [rw] database_insights_mode
25483
- # Specifies the mode of Database Insights to enable for the instance.
25580
+ # Specifies the mode of Database Insights to enable for the DB
25581
+ # instance.
25582
+ #
25583
+ # This setting only applies to Amazon Aurora DB instances.
25584
+ #
25585
+ # <note markdown="1"> Currently, this value is inherited from the DB cluster and can't be
25586
+ # changed.
25587
+ #
25588
+ # </note>
25484
25589
  # @return [String]
25485
25590
  #
25486
25591
  # @!attribute [rw] enable_performance_insights
@@ -26377,6 +26482,8 @@ module Aws::RDS
26377
26482
  # DB instance. Follow the allocation rules specified in
26378
26483
  # `CreateDBInstance`.
26379
26484
  #
26485
+ # This setting isn't valid for RDS for SQL Server.
26486
+ #
26380
26487
  # <note markdown="1"> Be sure to allocate enough storage for your new DB instance so that
26381
26488
  # the restore operation can succeed. You can also allocate additional
26382
26489
  # storage for future growth.
data/lib/aws-sdk-rds.rb CHANGED
@@ -80,7 +80,7 @@ module Aws::RDS
80
80
  autoload :ReservedDBInstancesOffering, 'aws-sdk-rds/reserved_db_instances_offering'
81
81
  autoload :ResourcePendingMaintenanceActionList, 'aws-sdk-rds/resource_pending_maintenance_action_list'
82
82
 
83
- GEM_VERSION = '1.263.0'
83
+ GEM_VERSION = '1.265.0'
84
84
 
85
85
  end
86
86
 
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: aws-sdk-rds
3
3
  version: !ruby/object:Gem::Version
4
- version: 1.263.0
4
+ version: 1.265.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: 2024-12-16 00:00:00.000000000 Z
11
+ date: 2025-01-08 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: aws-sdk-core