Skip to content

fix(rds): mark deprecated versions and add new engine versions#36937

Merged
mergify[bot] merged 2 commits intomainfrom
rds-deprecate-engine-versions
Feb 17, 2026
Merged

fix(rds): mark deprecated versions and add new engine versions#36937
mergify[bot] merged 2 commits intomainfrom
rds-deprecate-engine-versions

Conversation

@aemada-aws
Copy link
Copy Markdown
Collaborator

@aemada-aws aemada-aws commented Feb 10, 2026 •
edited
Loading

Issue # (if applicable)

Closes #.

Reason for this change

RDS engine versions are regularly deprecated by AWS as new versions are released. The CDK version enums need to be kept up-to-date with @deprecated tags to guide users away from versions that are no longer available for creating new database instances.

Description of changes

Updated RDS engine version classes to mark deprecated versions with @deprecated JSDoc tags based on current AWS RDS availability (as of February 2026):

Approach:

  • Queried AWS RDS API using describe-db-engine-versions to get currently available versions for each engine type
  • Compared CDK version enums against available versions
  • Added @deprecated tags to versions not returned by the API (indicating they cannot be used for new instances)
  • Added missing versions that are currently available

API Queries Used:

# Get all available MySQL versions
aws rds describe-db-engine-versions --engine mysql --region us-east-1 --query "DBEngineVersions[*].[EngineVersion,Status]" --output table

# Get all available PostgreSQL versions
aws rds describe-db-engine-versions --engine postgres --region us-east-1 --query "DBEngineVersions[*].[EngineVersion,Status]" --output table

# Get all available Aurora MySQL versions
aws rds describe-db-engine-versions --engine aurora-mysql --region us-east-1 --query "DBEngineVersions[*].[EngineVersion,Status]" --output table

# Get all available Aurora PostgreSQL versions
aws rds describe-db-engine-versions --engine aurora-postgresql --region us-east-1 --query "DBEngineVersions[*].[EngineVersion,Status]" --output table

API Query Results (February 2026):

MySQL versions 
--------------------------------------
|      DescribeDBEngineVersions      |
+----------------------+-------------+
|  5.7.44-rds.20240408 |  available  |
|  5.7.44-rds.20240529 |  available  |
|  5.7.44-rds.20240808 |  available  |
|  5.7.44-rds.20250103 |  available  |
|  5.7.44-rds.20250213 |  available  |
|  5.7.44-rds.20250508 |  available  |
|  5.7.44-rds.20250818 |  available  |
|  5.7.44-rds.20251212 |  available  |
|  8.0.40              |  available  |
|  8.0.41              |  available  |
|  8.0.42              |  available  |
|  8.0.43              |  available  |
|  8.0.44              |  available  |
|  8.0.45              |  available  |
|  8.4.3               |  available  |
|  8.4.4               |  available  |
|  8.4.5               |  available  |
|  8.4.6               |  available  |
|  8.4.7               |  available  |
|  8.4.8               |  available  |
+----------------------+-------------+
PostgreSQL versions 
-------------------------------------
|     DescribeDBEngineVersions      |
+---------------------+-------------+
|  11.22-rds.20241121 |  available  |
|  11.22-rds.20250220 |  available  |
|  11.22-rds.20250508 |  available  |
|  11.22-rds.20250814 |  available  |
|  11.22-rds.20251114 |  available  |
|  12.22              |  available  |
|  12.22-rds.20250220 |  available  |
|  12.22-rds.20250508 |  available  |
|  12.22-rds.20250814 |  available  |
|  12.22-rds.20251114 |  available  |
|  13.15              |  available  |
|  13.16              |  available  |
|  13.18              |  available  |
|  13.20              |  available  |
|  13.21              |  available  |
|  13.22              |  available  |
|  13.23              |  available  |
|  14.12              |  available  |
|  14.13              |  available  |
|  14.15              |  available  |
|  14.17              |  available  |
|  14.18              |  available  |
|  14.19              |  available  |
|  14.20              |  available  |
|  15.7               |  available  |
|  15.8               |  available  |
|  15.10              |  available  |
|  15.12              |  available  |
|  15.13              |  available  |
|  15.14              |  available  |
|  15.15              |  available  |
|  16.3               |  available  |
|  16.4               |  available  |
|  16.6               |  available  |
|  16.8               |  available  |
|  16.9               |  available  |
|  16.10              |  available  |
|  16.11              |  available  |
|  17.2               |  available  |
|  17.4               |  available  |
|  17.5               |  available  |
|  17.6               |  available  |
|  17.7               |  available  |
|  18.1               |  available  |
+---------------------+-------------+
Aurora MySQL versions 
------------------------------------------
|        DescribeDBEngineVersions        |
+--------------------------+-------------+
|  5.7.mysql_aurora.2.11.1 |  available  |
|  5.7.mysql_aurora.2.11.2 |  available  |
|  5.7.mysql_aurora.2.11.3 |  available  |
|  5.7.mysql_aurora.2.11.4 |  available  |
|  5.7.mysql_aurora.2.11.5 |  available  |
|  5.7.mysql_aurora.2.11.6 |  available  |
|  5.7.mysql_aurora.2.12.0 |  available  |
|  5.7.mysql_aurora.2.12.1 |  available  |
|  5.7.mysql_aurora.2.12.2 |  available  |
|  5.7.mysql_aurora.2.12.3 |  available  |
|  5.7.mysql_aurora.2.12.4 |  available  |
|  5.7.mysql_aurora.2.12.5 |  available  |
|  8.0.mysql_aurora.3.04.0 |  available  |
|  8.0.mysql_aurora.3.04.1 |  available  |
|  8.0.mysql_aurora.3.04.2 |  available  |
|  8.0.mysql_aurora.3.04.3 |  available  |
|  8.0.mysql_aurora.3.04.4 |  available  |
|  8.0.mysql_aurora.3.04.6 |  available  |
|  8.0.mysql_aurora.3.08.0 |  available  |
|  8.0.mysql_aurora.3.08.1 |  available  |
|  8.0.mysql_aurora.3.08.2 |  available  |
|  8.0.mysql_aurora.3.09.0 |  available  |
|  8.0.mysql_aurora.3.10.0 |  available  |
|  8.0.mysql_aurora.3.10.1 |  available  |
|  8.0.mysql_aurora.3.10.2 |  available  |
|  8.0.mysql_aurora.3.10.3 |  available  |
|  8.0.mysql_aurora.3.11.0 |  available  |
|  8.0.mysql_aurora.3.11.1 |  available  |
+--------------------------+-------------+
Aurora PostgreSQL versions 
---------------------------------
|   DescribeDBEngineVersions    |
+-----------------+-------------+
|  11.9           |  available  |
|  11.21          |  available  |
|  12.9           |  available  |
|  12.22          |  available  |
|  13.9           |  available  |
|  13.16          |  available  |
|  13.18          |  available  |
|  13.20          |  available  |
|  13.21          |  available  |
|  13.22          |  available  |
|  13.23          |  available  |
|  14.6           |  available  |
|  14.13          |  available  |
|  14.15          |  available  |
|  14.17          |  available  |
|  14.18          |  available  |
|  14.19          |  available  |
|  14.20          |  available  |
|  15.8           |  available  |
|  15.10          |  available  |
|  15.12          |  available  |
|  15.13          |  available  |
|  15.14          |  available  |
|  15.15          |  available  |
|  16.4           |  available  |
|  16.4-limitless |  available  |
|  16.6           |  available  |
|  16.6-limitless |  available  |
|  16.8           |  available  |
|  16.8-limitless |  available  |
|  16.9           |  available  |
|  16.9-limitless |  available  |
|  16.10          |  available  |
|  16.11          |  available  |
|  17.4           |  available  |
|  17.5           |  available  |
|  17.6           |  available  |
|  17.7           |  available  |
+-----------------+-------------+

Changes by engine:

  1. Aurora MySQL (AuroraMysqlEngineVersion):

    • Added missing versions: VER_3_04_6, VER_3_10_3
    • Marked as deprecated: All 5.7 versions below 2.11.1, and 8.0 versions 3.01.0-3.03.3, 3.05.0-3.07.1

  2. Aurora PostgreSQL (AuroraPostgresEngineVersion):

    • Marked as deprecated: 13.14-13.22, 14.11-14.20, 15.6-15.14, 16.1-16.11, 17.1-17.6
    • Kept available: 11.9, 11.21, 12.9, 12.22, 13.23, 14.6, 15.15, 17.7

  3. MySQL (MysqlEngineVersion):

    • Added missing versions: VER_5_7_44_RDS_20251212, VER_8_0_45, VER_8_4_8
    • Marked as deprecated: 8.0.37, 8.0.39

  4. PostgreSQL (PostgresEngineVersion):

    • Added missing version: VER_11_22_RDS_20251114, VER_12_22_RDS_20251114
    • Marked as deprecated: Older RDS-dated versions (11.22-rds.20240808 through 20250814, 12.22-rds.20250220 through 20250814), and various minor versions across 13.x-17.x series

Describe any new or updated permissions being added

No new permissions required.

Description of how you validated changes

  • Validated against AWS RDS API responses from describe-db-engine-versions in us-east-1 region
  • Verified that all versions marked as available in AWS API are NOT marked as deprecated in CDK
  • Verified that versions not returned by AWS API are marked as deprecated

Checklist

By submitting this pull request, I confirm that my contribution is made under the terms of the Apache-2.0 license

@aemada-aws
feat(rds): mark deprecated engine versions with @deprecated tag
c67ddd1 
- Mark RDS engine versions no longer available for new instances as deprecated
- Add missing versions currently available in AWS RDS
- Based on describe-db-engine-versions API query results from February 2026
@github-actions github-actions Bot added the p2 label Feb 10, 2026
@aws-cdk-automation aws-cdk-automation requested a review from a team February 10, 2026 21:00
@mergify mergify Bot added the contribution/core This is a PR that came from AWS. label Feb 10, 2026
aws-cdk-automation
aws-cdk-automation previously requested changes Feb 10, 2026
View reviewed changes
Copy link
Copy Markdown
Collaborator

@aws-cdk-automation aws-cdk-automation left a comment •
edited
Loading

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

(This review is outdated)

@aemada-aws aemada-aws marked this pull request as ready for review February 10, 2026 21:05
@aemada-aws aemada-aws marked this pull request as draft February 10, 2026 21:05
@aemada-aws aemada-aws changed the title feat(rds): mark deprecated engine versions with @deprecated tag fix(rds): mark deprecated engine versions with @deprecated tag Feb 10, 2026
@aemada-aws aemada-aws marked this pull request as ready for review February 11, 2026 09:55
@aemada-aws aemada-aws changed the title fix(rds): mark deprecated engine versions with @deprecated tag fix(rds): mark deprecated engine versions Feb 11, 2026
@Abogical Abogical self-assigned this Feb 16, 2026
@Abogical Abogical changed the title fix(rds): mark deprecated engine versions docs(rds): mark deprecated engine versions Feb 16, 2026
@Abogical Abogical changed the title docs(rds): mark deprecated engine versions fix(rds): mark deprecated engine versions Feb 16, 2026
@Abogical Abogical added pr-linter/exempt-test The PR linter will not require test changes pr-linter/exempt-integ-test The PR linter will not require integ test changes labels Feb 16, 2026
@aws-cdk-automation aws-cdk-automation dismissed their stale review February 16, 2026 13:37

✅ Updated pull request passes all PRLinter validations. Dismissing previous PRLinter review.

@Abogical Abogical changed the title fix(rds): mark deprecated engine versions feat(rds): mark deprecated and add new engine versions Feb 16, 2026
@aws-cdk-automation aws-cdk-automation added the pr/needs-maintainer-review This PR needs a review from a Core Team Member label Feb 16, 2026
aws-cdk-automation
aws-cdk-automation previously requested changes Feb 16, 2026
View reviewed changes
Copy link
Copy Markdown
Collaborator

@aws-cdk-automation aws-cdk-automation left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The pull request linter fails with the following errors:

❌ Features must contain a change to a README file.

If you believe this pull request should receive an exemption, please comment and provide a justification. A comment requesting an exemption should contain the text Exemption Request. Additionally, if clarification is needed, add Clarification Request to a comment.

@aws-cdk-automation aws-cdk-automation removed the pr/needs-maintainer-review This PR needs a review from a Core Team Member label Feb 16, 2026
Abogical
Abogical requested changes Feb 16, 2026
View reviewed changes
Comment thread packages/aws-cdk-lib/aws-rds/lib/cluster-engine.ts
Comment on lines +1193 to 1197
/**
* Version "13.15".
* @deprecated Version 13.15 is no longer supported by Amazon RDS.
*/
public static readonly VER_13_15 = AuroraPostgresEngineVersion.of('13.15', '13', { s3Import: true, s3Export: true });
Copy link
Copy Markdown
Member

@Abogical Abogical Feb 16, 2026 •
edited
Loading

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

But version 13.15 and above is available per the PR description, are you sure this is correct?

Copy link
Copy Markdown
Collaborator Author

@aemada-aws aemada-aws Feb 16, 2026 •
edited
Loading

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It is not available for aurora postgresql but available for postgresql

aws rds describe-db-engine-versions --engine aurora-postgresql --region us-east-1 --query "DBEngineVersions[*].[EngineVersion,Status]" --output table

| DescribeDBEngineVersions |
+------------------+-------------+
| 11.9 | available |
| 11.21 | available |
| 12.9 | available |
| 12.22 | available |
| 13.9 | available |
| 13.16 | available |
| 13.18 | available |
| 13.20 | available |
| 13.21 | available |
| 13.22 | available |
| 13.23 | available |
| 14.6 | available |
| 14.13 | available |
| 14.15 | available |
| 14.17 | available |
| 14.18 | available |
| 14.19 | available |
| 14.20 | available |
| 15.8 | available |
| 15.10 | available |
| 15.12 | available |
| 15.13 | available |
| 15.14 | available |
| 15.15 | available |
| 16.4 | available |
| 16.4-limitless | available |
| 16.6 | available |
| 16.6-limitless | available |
| 16.8 | available |
| 16.8-limitless | available |
| 16.9 | available |
| 16.9-limitless | available |
| 16.10 | available |
| 16.10-limitless | available |
| 16.11 | available |
| 16.11-limitless | available |
| 17.4 | available |
| 17.5 | available |
| 17.6 | available |
| 17.7 | available |
+------------------+-------------+

@aemada-aws aemada-aws changed the title feat(rds): mark deprecated and add new engine versions fix(rds): mark deprecated versions and add new engine versions Feb 17, 2026
@aemada-aws aemada-aws added the pr-linter/exempt-readme The PR linter will not require README changes label Feb 17, 2026
@mergify
Copy link
Copy Markdown
Contributor

mergify Bot commented Feb 17, 2026

Thank you for contributing! Your pull request will be updated from main and then merged automatically (do not update manually, and be sure to allow changes to be pushed to your fork).

@mergify
Copy link
Copy Markdown
Contributor

mergify Bot commented Feb 17, 2026 •
edited
Loading

Merge Queue Status

Rule: default-squash

  • ✅ Entered queue — 2026-02-17 16:35 UTC
  • ✅ Checks passed · in-place
  • ✅ Merged — 2026-02-17 17:17 UTC · at c67ddd1e00450eaeb7ef106beaf153bb2d5635b8

This pull request spent 42 minutes 20 seconds in the queue, including 42 minutes 7 seconds running CI.

Required conditions to merge

@mergify
Copy link
Copy Markdown
Contributor

mergify Bot commented Feb 17, 2026

Thank you for contributing! Your pull request will be updated from main and then merged automatically (do not update manually, and be sure to allow changes to be pushed to your fork).

@mergify mergify Bot merged commit 6e061d0 into main Feb 17, 2026
17 of 18 checks passed
@mergify mergify Bot deleted the rds-deprecate-engine-versions branch February 17, 2026 17:17
@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented Feb 17, 2026

Comments on closed issues and PRs are hard for our team to see.
If you need help, please open a new issue that references this one.

@github-actions github-actions Bot locked as resolved and limited conversation to collaborators Feb 17, 2026
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Reviewers

@Abogical Abogical Abogical approved these changes

@aws-cdk-automation aws-cdk-automation aws-cdk-automation left review comments

Assignees

@Abogical Abogical

Labels

contribution/core This is a PR that came from AWS. p2 pr-linter/exempt-integ-test The PR linter will not require integ test changes pr-linter/exempt-readme The PR linter will not require README changes pr-linter/exempt-test The PR linter will not require test changes

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

3 participants

@aemada-aws @Abogical @aws-cdk-automation