{"id":9519,"library":"aws-cdk-aws-kinesisfirehose-alpha","title":"AWS CDK Kinesis Firehose (Alpha)","description":"This AWS Cloud Development Kit (CDK) module provides constructs for provisioning AWS Kinesis Firehose resources. Currently at version 2.186.0a0, this `alpha` module is deprecated. All its constructs have been moved to the stable `aws-cdk-aws-kinesisfirehose` module, which is part of `aws-cdk-lib`. CDK follows a rapid release cadence for patch versions and regular minor version updates.","status":"deprecated","version":"2.186.0a0","language":"en","source_language":"en","source_url":"https://github.com/aws/aws-cdk.git","tags":["aws","cdk","kinesis","firehose","cloud","infrastructure-as-code","deprecated"],"install":[{"cmd":"pip install aws-cdk-lib aws-cdk.aws-kinesisfirehose constructs","lang":"bash","label":"Recommended: Install stable module"},{"cmd":"pip install aws-cdk-aws-kinesisfirehose-alpha","lang":"bash","label":"Deprecated: Install alpha module (not recommended)"}],"dependencies":[{"reason":"Core AWS CDK library for defining cloud infrastructure.","package":"aws-cdk-lib"},{"reason":"Underlying building blocks for CDK applications.","package":"constructs"}],"imports":[{"note":"The alpha module is deprecated; all constructs have moved to the stable `aws_cdk.aws_kinesisfirehose` namespace, which is part of `aws_cdk_lib`.","wrong":"from aws_cdk.aws_kinesisfirehose_alpha import CfnDeliveryStream","symbol":"CfnDeliveryStream","correct":"from aws_cdk.aws_kinesisfirehose import CfnDeliveryStream"}],"quickstart":{"code":"import os\nfrom aws_cdk import (\n    Stack,\n    App,\n    Environment,\n    aws_s3 as s3,\n    aws_iam as iam,\n)\nfrom aws_cdk.aws_kinesisfirehose import CfnDeliveryStream\nfrom constructs import Construct\n\nclass FirehoseStack(Stack):\n    def __init__(self, scope: Construct, id: str, **kwargs) -> None:\n        super().__init__(scope, id, **kwargs)\n\n        # S3 bucket for Firehose destination\n        bucket = s3.Bucket(self, \"FirehoseDestinationBucket\")\n\n        # IAM Role for Firehose\n        firehose_role = iam.Role(\n            self, \"FirehoseRole\",\n            assumed_by=iam.ServicePrincipal(\"firehose.amazonaws.com\"),\n            managed_policies=[\n                iam.ManagedPolicy.from_aws_managed_policy_name(\"AmazonKinesisFirehoseFullAccess\")\n            ]\n        )\n        bucket.grant_read_write(firehose_role)\n\n        # Kinesis Firehose Delivery Stream to S3\n        CfnDeliveryStream(\n            self, \"MyDeliveryStream\",\n            delivery_stream_name=\"MyTestDeliveryStream\",\n            delivery_stream_type=\"DirectPut\", # Or KinesisStreamAsSource\n            extended_s3_destination_configuration=CfnDeliveryStream.ExtendedS3DestinationConfigurationProperty(\n                bucket_arn=bucket.bucket_arn,\n                role_arn=firehose_role.role_arn,\n                buffering_hints=CfnDeliveryStream.BufferingHintsProperty(\n                    interval_in_seconds=300,\n                    size_in_m_bs=5\n                ),\n                compression_format=\"UNCOMPRESSED\",\n                prefix=\"firehose/data/\",\n                error_output_prefix=\"firehose/errors/\"\n            )\n        )\n\napp = App()\nFirehoseStack(app, \"FirehoseExampleStack\",\n    env=Environment(\n        account=os.environ.get(\"CDK_DEFAULT_ACCOUNT\"),\n        region=os.environ.get(\"CDK_DEFAULT_REGION\")\n    )\n)\napp.synth()","lang":"python","description":"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."},"warnings":[{"fix":"Migrate your project to use `aws-cdk-lib` and update all import statements from `aws_cdk.aws_kinesisfirehose_alpha` to `aws_cdk.aws_kinesisfirehose`.","message":"The `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.","severity":"breaking","affected_versions":"All versions of `aws-cdk-aws-kinesisfirehose-alpha`"},{"fix":"Search and replace import statements in your CDK application code.","message":"After 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 ...`.","severity":"gotcha","affected_versions":"All versions"},{"fix":"Consult the official AWS CDK documentation for `aws_cdk.aws_kinesisfirehose` to understand the current API and adapt your code accordingly.","message":"Alpha 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.","severity":"gotcha","affected_versions":"Migration from alpha to stable"}],"env_vars":null,"last_verified":"2026-04-17T00:00:00.000Z","next_check":"2026-07-16T00:00:00.000Z","problems":[{"fix":"Install `aws-cdk-lib` and `constructs` using `pip install aws-cdk-lib constructs`. Then, update your import statements to `from aws_cdk.aws_kinesisfirehose import ...`.","cause":"The `aws-cdk-aws-kinesisfirehose-alpha` package is not installed, or you are trying to import from it after it has been deprecated and its functionality moved.","error":"ModuleNotFoundError: No module named 'aws_cdk.aws_kinesisfirehose_alpha'"},{"fix":"Migrate to the stable `aws_cdk.aws_kinesisfirehose` module (part of `aws-cdk-lib`) and refer to its current documentation for accurate construct names and properties.","cause":"You are using an outdated version of the alpha module, or the specific construct you are looking for has been moved, renamed, or removed during the alpha phase or in the migration to the stable module.","error":"AttributeError: module 'aws_cdk.aws_kinesisfirehose_alpha' has no attribute 'CfnDeliveryStream'"}]}