feat(rds): add support for additional storage volumes in RDS instances by badmintoncryer · Pull Request #36769 · aws/aws-cdk

badmintoncryer · 2026-01-22T11:35:36Z

Issue # (if applicable)

None

Reason for this change

AWS RDS supports additional storage volumes for Oracle and SQL Server instances, allowing up to 256 TiB of total storage across multiple volumes. This feature was not available in the L2 construct.

https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PIOPS.ModifyingExisting.AdditionalVolumes.html

Description of changes

Add additionalStorageVolumes property to DatabaseInstance for RDS Oracle and SQL Server
Add AdditionalStorageVolume interface
Use existing StorageType enum for additional volumes (only GP3 and IO2 are supported, validated at runtime)
Volume names are automatically assigned based on array index:
- rdsdbdata2, rdsdbdata3, rdsdbdata4
Add validation for:
- Engine type (only Oracle and SQL Server supported)
- Maximum 3 additional volumes
- Storage type (only GP3 and IO2 supported)
- Storage size range:
  - Oracle: 200 - 65,536 GiB
  - SQL Server: 20 - 65,536 GiB
- Throughput/IOPS ratio for GP3 (max 0.25)
- Storage throughput only applicable for GP3
Default IOPS behavior:
- GP3: No explicit IOPS set by CDK (AWS provides baseline IOPS automatically)
- IO2: Default 1,000 IOPS if not specified

Describe any new or updated permissions being added

N/A

Description of how you validated changes

Add both unit and integ tests.

Checklist

My code adheres to the CONTRIBUTING GUIDE and DESIGN GUIDELINES

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

- Introduced AdditionalStorageVolume and AdditionalStorageVolumeType enums to define additional storage configurations. - Updated DatabaseInstance to accept additional storage volumes for Oracle and SQL Server engines. - Implemented validation for additional storage volumes, including constraints on IOPS, storage types, and maximum volume limits. - Added integration tests to verify functionality and constraints for additional storage volumes. - Enhanced README documentation to include details on additional storage volumes and usage examples.

github-actions · 2026-01-22T11:37:55Z

⚠️ Experimental Feature: This security report is currently in experimental phase. Results may include false positives and the rules are being actively refined.
This security report is NOT a review blocker. Please try merge from main to avoid findings unrelated to the PR.

	Tests	Passed ✅	Skipped	Failed
Security Guardian Results	96 ran	96 passed

Test	Result
No test annotations available

View Security Guardian Results

github-actions · 2026-01-22T11:37:58Z

⚠️ Experimental Feature: This security report is currently in experimental phase. Results may include false positives and the rules are being actively refined.
This security report is NOT a review blocker. Please try merge from main to avoid findings unrelated to the PR.

	Tests	Passed ✅	Skipped	Failed
Security Guardian Results with resolved templates	96 ran	96 passed

Test	Result
No test annotations available

View Security Guardian Results with resolved templates

Volume names are now consistently rdsdbdata2/3/4 for both engines. For SQL Server, these are automatically mapped to drive letters H:\, I:\, J:\. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

…rageVolumes function

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

- Implemented validation for storage throughput constraints for GP3 based on engine type (Oracle and SQL Server). - Added validation for IOPS constraints for IO2 storage. - Updated unit tests to cover new validation rules for additional storage volumes, including boundary value tests for allocated storage, GP3 IOPS, and throughput.

…e requirements

…al-storage

badmintoncryer · 2026-01-24T08:18:57Z

packages/aws-cdk-lib/aws-rds/lib/instance.ts

+    const volumeStorageType = volume.storageType ?? AdditionalStorageVolumeType.GP3;
+
+    // Validate storageThroughput is only for GP3
+    if (volume.storageThroughput && volumeStorageType !== AdditionalStorageVolumeType.GP3) {


This reguration is described in here.

https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_AdditionalStorageVolume.html

badmintoncryer · 2026-01-24T08:33:02Z

packages/aws-cdk-lib/aws-rds/lib/instance.ts

+    // Oracle: minimum 200 GiB, SQL Server: minimum 20 GiB (same as D: drive limit)
+    if (!volume.allocatedStorage.isUnresolved()) {
+      const allocatedStorageGiB = volume.allocatedStorage.toGibibytes();
+      const minStorage = engineType.startsWith('oracle-') ? 200 : 20;


Minimum storage value is described in here(AllocatedStorage section) and Oracle is 200 GiB.

Maximum storage value is 64TiB.
https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_AdditionalStorageVolume.html

packages/aws-cdk-lib/aws-rds/lib/instance.ts

…al-storage

lpizzinidev

Ty. Some nits.

packages/aws-cdk-lib/aws-rds/lib/instance.ts

aws-cdk-automation · 2026-02-03T00:19:03Z

This PR cannot be merged because it has conflicts. Please resolve them. The PR will be considered stale and closed if it remains in an unmergeable state.

badmintoncryer · 2026-02-03T00:33:43Z

@lpizzinidev Thank you for your review! I'll address your comments later.

…rage volumes

badmintoncryer · 2026-02-03T14:51:45Z

@lpizzinidev Your comments are exactly right. I've addressed all of them. It was great to have you review again after such a long time!

lpizzinidev

Ty. Have been a bit busy recently 🙃

aws-cdk-automation

(This review is outdated)

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

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

badmintoncryer added 2 commits January 21, 2026 15:33

Merge remote-tracking branch 'origin/main' into additional-storage

f84b543

aws-cdk-automation requested a review from a team January 22, 2026 11:35

github-actions bot added p2 distinguished-contributor [Pilot] contributed 50+ PRs to the CDK labels Jan 22, 2026

badmintoncryer marked this pull request as draft January 22, 2026 11:39

badmintoncryer and others added 3 commits January 22, 2026 20:45

fix(rds): use rdsdbdata volume names for both Oracle and SQL Server

7efaea2

Volume names are now consistently rdsdbdata2/3/4 for both engines. For SQL Server, these are automatically mapped to drive letters H:\, I:\, J:\. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

fix(rds): remove unused engineType parameter from renderAdditionalSto…

6543d8b

…rageVolumes function

test(rds): add SQL Server to additional storage volumes integration test

9bb98f3

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

pahud mentioned this pull request Jan 22, 2026

Failed CodeBuild CI - 13 PR(s) pahud/aws-cdk#17

Open

badmintoncryer added 11 commits January 24, 2026 16:29

fix(rds): remove outdated comments regarding additional storage volum…

edfc320

…e requirements

Merge remote-tracking branch 'cryer/additional-storage' into addition…

d2fb636

…al-storage

Merge remote-tracking branch 'cryer/additional-storage' into addition…

da595a6

…al-storage

Merge remote-tracking branch 'cryer/additional-storage' into addition…

f3631e8

…al-storage

Merge remote-tracking branch 'cryer/additional-storage' into addition…

ee33fbf

…al-storage

Merge remote-tracking branch 'cryer/additional-storage' into addition…

9634d19

…al-storage

Merge remote-tracking branch 'cryer/additional-storage' into addition…

7a06cb6

…al-storage

改善: 追加ストレージボリュームのバリデーションエラーメッセージを明確化

132f170

Merge remote-tracking branch 'cryer/additional-storage' into addition…

2129edc

…al-storage

badmintoncryer commented Jan 24, 2026

View reviewed changes

改善: 追加ストレージボリュームのエンジンタイプに基づくストレージ範囲バリデーションを実装

062a41b

badmintoncryer commented Jan 24, 2026

View reviewed changes

badmintoncryer added 2 commits January 25, 2026 01:01

改善: 追加ストレージボリュームのスループットバリデーションを関数化し、テストケースを追加

2a04ba1

改善: 追加ストレージボリュームのバリデーションエラーメッセージを明確化し、テストケースを更新

49c37cf

badmintoncryer commented Jan 25, 2026

View reviewed changes

packages/aws-cdk-lib/aws-rds/lib/instance.ts Outdated Show resolved Hide resolved

Update packages/aws-cdk-lib/aws-rds/lib/instance.ts

fdb6ed1

badmintoncryer added 3 commits January 27, 2026 00:29

Merge branch 'main' into additional-storage

c3f36c9

fix rosetta

847e016

Merge remote-tracking branch 'cryer/additional-storage' into addition…

2be63aa

…al-storage

aws-cdk-automation added the pr/needs-community-review This PR needs a review from a Trusted Community Member or Core Team Member. label Jan 27, 2026

lpizzinidev suggested changes Jan 31, 2026

View reviewed changes

aws-cdk-automation removed the pr/needs-community-review This PR needs a review from a Trusted Community Member or Core Team Member. label Jan 31, 2026

pahud mentioned this pull request Feb 2, 2026

PRs with Conflicts - 7 PR(s) pahud/aws-cdk#13

Open

badmintoncryer added 2 commits February 3, 2026 23:48

validate IOPS configuration for database instances and additional sto…

179d9be

…rage volumes

Merge remote-tracking branch 'origin/main' into additional-storage

04a970a

chore: add .gitignore and project.yml for Serena configuration

87a6fb8

lpizzinidev approved these changes Feb 4, 2026

View reviewed changes

aws-cdk-automation added the pr/needs-maintainer-review This PR needs a review from a Core Team Member label Feb 4, 2026

badmintoncryer temporarily deployed to automation March 18, 2026 02:04 — with GitHub Actions Inactive

badmintoncryer requested a deployment to test-pipeline March 18, 2026 02:04 — with GitHub Actions Waiting

aws-cdk-automation previously requested changes Mar 18, 2026

View reviewed changes

Merge branch 'main' into additional-storage and fix error codes

c8f82ee

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

badmintoncryer force-pushed the additional-storage branch from ed04c0e to c8f82ee Compare March 18, 2026 12:15

badmintoncryer temporarily deployed to automation March 18, 2026 12:15 — with GitHub Actions Inactive

badmintoncryer temporarily deployed to automation March 18, 2026 12:16 — with GitHub Actions Inactive

Merge branch 'main' into additional-storage

dfd9c4b

badmintoncryer temporarily deployed to automation April 2, 2026 03:08 — with GitHub Actions Inactive

Merge branch 'main' into additional-storage

ebac962

badmintoncryer temporarily deployed to automation April 8, 2026 13:01 — with GitHub Actions Inactive

Conversation

badmintoncryer commented Jan 22, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Issue # (if applicable)

Reason for this change

Description of changes

Describe any new or updated permissions being added

Description of how you validated changes

Checklist

Uh oh!

github-actions bot commented Jan 22, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

github-actions bot commented Jan 22, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

badmintoncryer Jan 24, 2026

Choose a reason for hiding this comment

Uh oh!

badmintoncryer Jan 24, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

lpizzinidev left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

aws-cdk-automation commented Feb 3, 2026

Uh oh!

badmintoncryer commented Feb 3, 2026

Uh oh!

badmintoncryer commented Feb 3, 2026

Uh oh!

lpizzinidev left a comment

Choose a reason for hiding this comment

Uh oh!

aws-cdk-automation left a comment • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

badmintoncryer commented Jan 22, 2026 •

edited

Loading

github-actions bot commented Jan 22, 2026 •

edited

Loading

github-actions bot commented Jan 22, 2026 •

edited

Loading

badmintoncryer Jan 24, 2026 •

edited

Loading

aws-cdk-automation left a comment •

edited

Loading