aws-sdk-rds 1.263.0 → 1.265.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
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