feat(cloudfront): Add support for flat-rate pricing plans (Free/Pro/Business/Premium)

[ardaputra94]

Describe the feature

AWS launched CloudFront flat-rate pricing plans in November 2025, introducing
four tiers (Free/$0, Pro/$15, Business/$200, Premium/$1,000 per month) that
bundle CloudFront CDN, AWS WAF, DDoS protection, Route 53 DNS, CloudWatch Logs,
and S3 storage credits into a single monthly price with no overage charges.

Currently, CDK has no native support to assign a pricing plan to a CloudFront
distribution. Users must either set it manually via the AWS Console or implement
a Lambda-backed Custom Resource that calls the pricingplanmanager.amazonaws.com
API directly — which adds unnecessary complexity to infrastructure code.

References

• CloudFront flat-rate pricing plans – AWS Docs
• AWS announcement – November 2025
• pricingplanmanager IAM actions

Use Case

AWS launched CloudFront flat-rate pricing plans in November 2025
(Free/$0, Pro/$15, Business/$200, Premium/$1000/month).
Currently there is no CDK L1/L2 support to assign a pricing plan
to a CloudFront distribution. Users must either set it manually
via the console or use a Custom Resource workaround.

Proposed Solution

Proposed API

new cloudfront.Distribution(this, 'MyDistribution', {
  defaultBehavior: {
    origin: origins.S3BucketOrigin.withOriginAccessControl(bucket),
  },
  pricingPlan: cloudfront.DistributionPricingPlan.BUSINESS,
});

Expected behavior

• Add a pricingPlan property to the Distribution L2 construct
• Add a DistributionPricingPlan enum with values: FREE, PRO, BUSINESS, PREMIUM
• CDK automatically calls pricingplanmanager:CreateSubscription during deployment
• On cdk destroy, CDK calls pricingplanmanager:CancelSubscription

Other Information

No response

Acknowledgements

• I may be able to implement this feature request
• This feature might incur a breaking change

AWS CDK Library version (aws-cdk-lib)

2.215.0

AWS CDK CLI version

2.215.0

Environment details (OS name and version, etc.)

Ubuntu 24.04

[pahud]

Hi @ardaputra94,

Thanks for the feature request. The tricky part here is that flat-rate pricing plans use a separate API (pricingplanmanager.amazonaws.com) with no CloudFormation support, and they're account-level rather than distribution-level. This makes a native CDK construct challenging without a Custom Resource.

Before we invest in a CR-based solution, it would be worth checking if CloudFormation native support is planned. I'll flag this for further investigation.