---
id: aws-cdk-aws-cloudfront
version: "1.204.0"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# aws-cdk.aws-cloudfront — The CDK Construct Library for AWS::CloudFront

License: permissive · Maintenance: active · Downloads: 156.8K/mo

## What it is and what it does

This package provides AWS CDK constructs for defining CloudFront distributions declaratively in Python. It wraps CloudFront's API to let you configure content delivery from S3 buckets, load balancers, or custom HTTP origins, set up domain names and SSL certificates, define multiple behaviors with different routing rules, and manage cache settings—all as infrastructure-as-code rather than through the AWS console.

The package depends on 14 other AWS CDK modules (IAM, S3, Lambda, KMS, EC2, and others) plus core CDK infrastructure libraries. It is actively maintained in the AWS CDK repository but is part of CDK v1, which reached end-of-support on 2023-06-01. AWS recommends migrating to CDK v2 for new projects.

Use it for:

- Define a CloudFront distribution backed by an S3 bucket in a CDK stack, with automatic origin access identity setup for private buckets.
- Configure multiple behaviors with different URL path patterns to route requests to different origins or apply different caching policies.
- Set up a custom domain name and ACM certificate for a distribution to serve content over HTTPS with your own domain.
- Programmatically manage HTTP methods, viewer protocol policies, and query string forwarding rules for cache behaviors.
- Integrate CloudFront with ELBv2 load balancers as origins for dynamic content delivery through a CDK stack.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Defines AWS CloudFront distributions and behaviors as code using the AWS CDK, enabling programmatic configuration of content delivery networks with S3, load balancers, or HTTP origins.

Yes, if you are maintaining or extending an existing AWS CDK v1 codebase. No, if you are starting a new project—use AWS CDK v2 instead. The package is stable and well-maintained within the active CDK repository, but v1 itself is end-of-support and will not receive updates; migration to v2 is the recommended path forward.

## Install

pip install aws-cdk-aws-cloudfront
uv add aws-cdk-aws-cloudfront
poetry add aws-cdk-aws-cloudfront

## Installing aws-cdk.aws-cloudfront

Before you install: Low install friction with a pure-Python wheel. However, this is AWS CDK v1, which reached end-of-support on 2023-06-01 and is no longer being updated; users should migrate to AWS CDK v2.

License in practice: Licensed under Apache-2.0 (permissive), allowing free use, modification, and distribution with minimal restrictions.

Quickstart:

from aws_cdk import aws_cloudfront as cloudfront
from aws_cdk import aws_s3 as s3
from aws_cdk import aws_cloudfront_origins as origins

my_bucket = s3.Bucket(self, "myBucket")
cloudfront.Distribution(self, "myDist",
    default_behavior=cloudfront.BehaviorOptions(origin=origins.S3Origin(my_bucket))
)

Requires AWS CDK v1 runtime and constructs library; v1 is end-of-support as of 2023-06-01.

Verify before relying:

- Whether existing v1 code will continue to work in production or if migration to v2 is mandatory for new projects.
- Availability and completeness of migration tooling or automated upgrade paths from v1 to v2.

## Package facts

- License: Apache-2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 156.8K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

cloudfront cdn infrastructure as code, aws cdk cloudfront distribution, content delivery network construct, cloudfront origin behavior configuration, cdk s3 cloudfront integration, aws edge location routing, cloudfront domain certificate setup, infrastructure-as-code, aws-cdk, end-of-support

[View on SkillFed](https://skillfed.io/packages/aws-cdk-aws-cloudfront) · [View on PyPI](https://pypi.org/project/aws-cdk-aws-cloudfront/)