Commit 6e061d0
authored
fix(rds): mark deprecated versions and add new engine versions (#36937)
### Issue # (if applicable)
Closes #<issue number here>.
### 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:**
```bash
# 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):**
<details>
<summary>MySQL versions</summary>
```
--------------------------------------
| 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 |
+----------------------+-------------+
```
</details>
<details>
<summary>PostgreSQL versions</summary>
```
-------------------------------------
| 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 |
+---------------------+-------------+
```
</details>
<details>
<summary>Aurora MySQL versions</summary>
```
------------------------------------------
| 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 |
+--------------------------+-------------+
```
</details>
<details>
<summary>Aurora PostgreSQL versions</summary>
```
---------------------------------
| 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 |
+-----------------+-------------+
```
</details>
**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
- [x] My code adheres to the [CONTRIBUTING GUIDE](https://github.com/aws/aws-cdk/blob/main/CONTRIBUTING.md) and [DESIGN GUIDELINES](https://github.com/aws/aws-cdk/blob/main/docs/DESIGN_GUIDELINES.md)
----
*By submitting this pull request, I confirm that my contribution is made under the terms of the Apache-2.0 license*1 parent ced8115 commit 6e061d0
File tree
2 files changed
+297
-67
lines changed- packages/aws-cdk-lib/aws-rds/lib
2 files changed
+297
-67
lines changed| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
665 | 665 | | |
666 | 666 | | |
667 | 667 | | |
| 668 | + | |
| 669 | + | |
| 670 | + | |
| 671 | + | |
| 672 | + | |
668 | 673 | | |
669 | 674 | | |
670 | 675 | | |
| |||
714 | 719 | | |
715 | 720 | | |
716 | 721 | | |
| 722 | + | |
| 723 | + | |
| 724 | + | |
| 725 | + | |
| 726 | + | |
717 | 727 | | |
718 | 728 | | |
719 | 729 | | |
| |||
1175 | 1185 | | |
1176 | 1186 | | |
1177 | 1187 | | |
1178 | | - | |
| 1188 | + | |
| 1189 | + | |
| 1190 | + | |
| 1191 | + | |
1179 | 1192 | | |
1180 | | - | |
| 1193 | + | |
| 1194 | + | |
| 1195 | + | |
| 1196 | + | |
1181 | 1197 | | |
1182 | | - | |
| 1198 | + | |
| 1199 | + | |
| 1200 | + | |
| 1201 | + | |
1183 | 1202 | | |
1184 | 1203 | | |
1185 | 1204 | | |
1186 | 1205 | | |
1187 | 1206 | | |
1188 | 1207 | | |
1189 | | - | |
| 1208 | + | |
| 1209 | + | |
| 1210 | + | |
| 1211 | + | |
1190 | 1212 | | |
1191 | | - | |
| 1213 | + | |
| 1214 | + | |
| 1215 | + | |
| 1216 | + | |
1192 | 1217 | | |
1193 | | - | |
| 1218 | + | |
| 1219 | + | |
| 1220 | + | |
| 1221 | + | |
1194 | 1222 | | |
1195 | | - | |
| 1223 | + | |
| 1224 | + | |
| 1225 | + | |
| 1226 | + | |
1196 | 1227 | | |
| 1228 | + | |
| 1229 | + | |
1197 | 1230 | | |
1198 | 1231 | | |
1199 | 1232 | | |
| |||
1232 | 1265 | | |
1233 | 1266 | | |
1234 | 1267 | | |
1235 | | - | |
| 1268 | + | |
| 1269 | + | |
| 1270 | + | |
| 1271 | + | |
1236 | 1272 | | |
1237 | | - | |
| 1273 | + | |
| 1274 | + | |
| 1275 | + | |
| 1276 | + | |
1238 | 1277 | | |
1239 | | - | |
| 1278 | + | |
| 1279 | + | |
| 1280 | + | |
| 1281 | + | |
1240 | 1282 | | |
1241 | 1283 | | |
1242 | 1284 | | |
1243 | 1285 | | |
1244 | 1286 | | |
1245 | 1287 | | |
1246 | | - | |
| 1288 | + | |
| 1289 | + | |
| 1290 | + | |
| 1291 | + | |
1247 | 1292 | | |
1248 | | - | |
| 1293 | + | |
| 1294 | + | |
| 1295 | + | |
| 1296 | + | |
1249 | 1297 | | |
1250 | | - | |
| 1298 | + | |
| 1299 | + | |
| 1300 | + | |
| 1301 | + | |
1251 | 1302 | | |
1252 | | - | |
| 1303 | + | |
| 1304 | + | |
| 1305 | + | |
| 1306 | + | |
1253 | 1307 | | |
1254 | | - | |
| 1308 | + | |
| 1309 | + | |
| 1310 | + | |
| 1311 | + | |
1255 | 1312 | | |
1256 | 1313 | | |
1257 | 1314 | | |
| |||
1274 | 1331 | | |
1275 | 1332 | | |
1276 | 1333 | | |
1277 | | - | |
| 1334 | + | |
| 1335 | + | |
| 1336 | + | |
| 1337 | + | |
1278 | 1338 | | |
1279 | | - | |
| 1339 | + | |
| 1340 | + | |
| 1341 | + | |
| 1342 | + | |
1280 | 1343 | | |
1281 | | - | |
| 1344 | + | |
| 1345 | + | |
| 1346 | + | |
| 1347 | + | |
1282 | 1348 | | |
1283 | 1349 | | |
1284 | 1350 | | |
1285 | 1351 | | |
1286 | 1352 | | |
1287 | 1353 | | |
1288 | | - | |
| 1354 | + | |
| 1355 | + | |
| 1356 | + | |
| 1357 | + | |
1289 | 1358 | | |
1290 | | - | |
| 1359 | + | |
| 1360 | + | |
| 1361 | + | |
| 1362 | + | |
1291 | 1363 | | |
1292 | | - | |
| 1364 | + | |
| 1365 | + | |
| 1366 | + | |
| 1367 | + | |
1293 | 1368 | | |
1294 | | - | |
| 1369 | + | |
| 1370 | + | |
| 1371 | + | |
| 1372 | + | |
1295 | 1373 | | |
| 1374 | + | |
| 1375 | + | |
1296 | 1376 | | |
1297 | 1377 | | |
1298 | 1378 | | |
1299 | 1379 | | |
1300 | 1380 | | |
1301 | 1381 | | |
1302 | | - | |
| 1382 | + | |
| 1383 | + | |
| 1384 | + | |
| 1385 | + | |
1303 | 1386 | | |
1304 | | - | |
| 1387 | + | |
| 1388 | + | |
| 1389 | + | |
| 1390 | + | |
1305 | 1391 | | |
1306 | | - | |
| 1392 | + | |
| 1393 | + | |
| 1394 | + | |
| 1395 | + | |
1307 | 1396 | | |
1308 | | - | |
| 1397 | + | |
| 1398 | + | |
| 1399 | + | |
| 1400 | + | |
1309 | 1401 | | |
1310 | | - | |
| 1402 | + | |
| 1403 | + | |
| 1404 | + | |
| 1405 | + | |
1311 | 1406 | | |
1312 | 1407 | | |
1313 | 1408 | | |
1314 | 1409 | | |
1315 | 1410 | | |
1316 | 1411 | | |
1317 | | - | |
| 1412 | + | |
| 1413 | + | |
| 1414 | + | |
| 1415 | + | |
1318 | 1416 | | |
1319 | | - | |
| 1417 | + | |
| 1418 | + | |
| 1419 | + | |
| 1420 | + | |
1320 | 1421 | | |
1321 | | - | |
| 1422 | + | |
| 1423 | + | |
| 1424 | + | |
| 1425 | + | |
1322 | 1426 | | |
1323 | | - | |
| 1427 | + | |
| 1428 | + | |
| 1429 | + | |
| 1430 | + | |
1324 | 1431 | | |
1325 | | - | |
| 1432 | + | |
| 1433 | + | |
| 1434 | + | |
| 1435 | + | |
1326 | 1436 | | |
1327 | | - | |
| 1437 | + | |
| 1438 | + | |
| 1439 | + | |
| 1440 | + | |
1328 | 1441 | | |
1329 | | - | |
| 1442 | + | |
| 1443 | + | |
| 1444 | + | |
| 1445 | + | |
1330 | 1446 | | |
1331 | | - | |
| 1447 | + | |
| 1448 | + | |
| 1449 | + | |
| 1450 | + | |
1332 | 1451 | | |
1333 | 1452 | | |
1334 | 1453 | | |
| |||
1341 | 1460 | | |
1342 | 1461 | | |
1343 | 1462 | | |
1344 | | - | |
| 1463 | + | |
| 1464 | + | |
| 1465 | + | |
| 1466 | + | |
1345 | 1467 | | |
1346 | | - | |
| 1468 | + | |
| 1469 | + | |
| 1470 | + | |
| 1471 | + | |
1347 | 1472 | | |
1348 | | - | |
| 1473 | + | |
| 1474 | + | |
| 1475 | + | |
| 1476 | + | |
1349 | 1477 | | |
| 1478 | + | |
| 1479 | + | |
1350 | 1480 | | |
1351 | 1481 | | |
1352 | 1482 | | |
| |||
0 commit comments