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

# aws-cdk.aws-s3 — The CDK Construct Library for AWS::S3

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

## What it is and what it does

aws-cdk.aws-s3 is the AWS CDK v1 construct library for defining Amazon S3 buckets and related infrastructure as Python code. It provides a high-level abstraction over CloudFormation S3 resources, letting you create, configure, and manage buckets programmatically within a CDK stack. The library supports encryption (KMS and managed), bucket policies, permissions grants, event notifications, and importing existing buckets.

However, this package is no longer maintained. AWS CDK v1 reached end-of-support on 2023-06-01, and AWS recommends migrating to AWS CDK v2. While the package remains installable and functional, it will not receive security updates, bug fixes, or new features. Existing projects using it should plan a migration path to v2.

Use it for:

- Define S3 buckets with encryption and access policies as part of a CDK infrastructure stack.
- Set up bucket notifications to trigger Lambda functions or SNS topics on object creation or deletion events.
- Grant read/write permissions to other AWS resources (Lambda, EC2 roles, IAM users) via bucket grant methods.
- Import and reference existing S3 buckets into a CDK application for cross-stack resource sharing.
- Configure bucket-level security settings such as SSL enforcement and KMS encryption in code.

## Worth the install?

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

Defines AWS S3 buckets and related resources as code using the AWS CDK v1 construct library, allowing programmatic creation and configuration of S3 storage infrastructure.

No, unless you are maintaining an existing AWS CDK v1 project. The package is end-of-support as of 2023-06-01 and will not receive updates. New projects should use AWS CDK v2 instead. If you are already on v1, plan a migration to v2 to ensure ongoing security and feature support.

## Install

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

## Installing aws-cdk.aws-s3

Before you install: Low install friction with 9 runtime dependencies, all from the AWS CDK ecosystem. However, the package is no longer maintained—AWS CDK v1 reached end-of-support on 2023-06-01 and users are directed to migrate to AWS CDK v2.

License in practice: Licensed under Apache-2.0 (permissive), which allows commercial use, modification, and distribution with minimal restrictions, provided the license and copyright notice are retained.

Quickstart:

pip install aws-cdk.aws-s3

from aws_cdk import aws_s3 as s3
from aws_cdk import core as cdk

class MyStack(cdk.Stack):
    def __init__(self, scope: cdk.Construct, id: str, **kwargs):
        super().__init__(scope, id, **kwargs)
        bucket = s3.Bucket(self, "MyBucket")

Requires AWS CDK v1 core library and Python 3.7 or later; AWS CDK v1 is end-of-support as of 2023-06-01.

Verify before relying:

- Whether existing CDK v1 projects can safely remain on this package long-term or if security/compatibility issues will emerge post-support.
- Migration effort and breaking changes when upgrading to AWS CDK v2 for projects currently using this package.

## Package facts

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

## Tags

AWS S3 bucket infrastructure as code, CDK S3 construct library, define S3 buckets programmatically, AWS CDK storage constructs, S3 encryption and permissions, bucket notifications and events, S3 resource management CDK, infrastructure-as-code, aws-cdk, end-of-life

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