Registry /
aws / aws-cdk-aws-kinesisfirehose-alpha
Install & Compatibility
Where this runs
tested against v2.186.0a0 · pip install
no network on importno background threads
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
724MB installed
● package 724MB
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
CfnDeliveryStream
✓ from aws_cdk.aws_kinesisfirehose import CfnDeliveryStream
✗ from aws_cdk.aws_kinesisfirehose_alpha import CfnDeliveryStream
The alpha module is deprecated; all constructs have moved to the stable `aws_cdk.aws_kinesisfirehose` namespace, which is part of `aws_cdk_lib`.
This quickstart demonstrates how to define a Kinesis Firehose Delivery Stream using the stable `aws_cdk.aws_kinesisfirehose` module. It creates a simple Firehose stream configured to deliver data directly to an S3 bucket, including the necessary IAM role. Ensure your AWS credentials and CDK environment variables (`CDK_DEFAULT_ACCOUNT`, `CDK_DEFAULT_REGION`) are configured.
import os
from aws_cdk import (
Stack,
App,
Environment,
aws_s3 as s3,
aws_iam as iam,
)
from aws_cdk.aws_kinesisfirehose import CfnDeliveryStream
from constructs import Construct
class FirehoseStack(Stack):
def __init__(self, scope: Construct, id: str, **kwargs) -> None:
super().__init__(scope, id, **kwargs)
# S3 bucket for Firehose destination
bucket = s3.Bucket(self, "FirehoseDestinationBucket")
# IAM Role for Firehose
firehose_role = iam.Role(
self, "FirehoseRole",
assumed_by=iam.ServicePrincipal("firehose.amazonaws.com"),
managed_policies=[
iam.ManagedPolicy.from_aws_managed_policy_name("AmazonKinesisFirehoseFullAccess")
]
)
bucket.grant_read_write(firehose_role)
# Kinesis Firehose Delivery Stream to S3
CfnDeliveryStream(
self, "MyDeliveryStream",
delivery_stream_name="MyTestDeliveryStream",
delivery_stream_type="DirectPut", # Or KinesisStreamAsSource
extended_s3_destination_configuration=CfnDeliveryStream.ExtendedS3DestinationConfigurationProperty(
bucket_arn=bucket.bucket_arn,
role_arn=firehose_role.role_arn,
buffering_hints=CfnDeliveryStream.BufferingHintsProperty(
interval_in_seconds=300,
size_in_m_bs=5
),
compression_format="UNCOMPRESSED",
prefix="firehose/data/",
error_output_prefix="firehose/errors/"
)
)
app = App()
FirehoseStack(app, "FirehoseExampleStack",
env=Environment(
account=os.environ.get("CDK_DEFAULT_ACCOUNT"),
region=os.environ.get("CDK_DEFAULT_REGION")
)
)
app.synth()
Debug
Known issues
breakingThe `aws-cdk-aws-kinesisfirehose-alpha` module is deprecated. Its constructs have been moved to the stable `aws_cdk.aws_kinesisfirehose` namespace, which is now part of `aws-cdk-lib`. Continuing to use the alpha package will lead to outdated APIs and potential `ModuleNotFoundError` in future CDK versions.fixMigrate your project to use `aws-cdk-lib` and update all import statements from `aws_cdk.aws_kinesisfirehose_alpha` to `aws_cdk.aws_kinesisfirehose`.
affects: All versions of `aws-cdk-aws-kinesisfirehose-alpha`
gotchaAfter migrating from the alpha module, ensure all import statements are updated from `from aws_cdk.aws_kinesisfirehose_alpha import ...` to `from aws_cdk.aws_kinesisfirehose import ...`.fixSearch and replace import statements in your CDK application code.
affects: All versions
gotchaAlpha modules are subject to breaking changes without notice. When migrating to the stable module, review the API documentation for any subtle differences in construct properties, default behaviors, or methods that might have evolved during the stabilization process.fixConsult the official AWS CDK documentation for `aws_cdk.aws_kinesisfirehose` to understand the current API and adapt your code accordingly.
affects: Migration from alpha to stable
Upgrade
Version history
2.186.0a0latest on PyPI · released Mar 27, 2025
Audit
Dependencies
aws-cdk-librequiredCore AWS CDK library for defining cloud infrastructure.
constructsrequiredUnderlying building blocks for CDK applications.