Registry / devops / aws-cdk-aws-kinesisfirehose

aws-cdk-aws-kinesisfirehose

library1.204.0pypypi✓ verified 84d ago

The CDK Construct Library for AWS::KinesisFirehose. Provides L1 (low-level) CloudFormation resources and L2 constructs for Amazon Kinesis Data Firehose delivery streams. Current version 1.204.0 targets AWS CDK v1 (v1.x) and Python ~=3.7. Release cadence: weekly, alongside CDK v1 releases.

devops

pip install aws-cdk-aws-kinesisfirehose==1.204.0

github ↗homepage ↗

INSTALL

IMPORT

SIG · AWS-CDK-AWS-KINESI

aws-cdk-aws-kinesisfirehose

devopspythonv1.204.0

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

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 import DeliveryStream

CDK v1 uses Cfn prefix for L1 resources; aws-cdk-aws-kinesisfirehose only provides L1

Creates a Kinesis Firehose delivery stream with S3 destination using L1 construct.

import aws_cdk as cdk from aws_cdk.aws_kinesisfirehose import CfnDeliveryStream app = cdk.App() stack = cdk.Stack(app, "FirehoseStack") # S3 destination configuration dest = CfnDeliveryStream.ExtendedS3DestinationConfigurationProperty( bucket_arn="arn:aws:s3:::example-bucket", role_arn="arn:aws:iam::123456789012:role/firehose-role", prefix="raw/" ) stream = CfnDeliveryStream(stack, "MyStream", delivery_stream_name="my-firehose-stream", extended_s3_destination_configuration=dest ) app.synth()

Debug

Known issues

deprecatedaws-cdk-aws-kinesisfirehose is part of AWS CDK v1, which entered maintenance mode on June 1, 2022 and will reach end-of-life on June 1, 2024. No new features or bug fixes are planned. Upgrade to CDK v2 using aws-cdk-lib.

fix

Migrate to CDK v2: use aws-cdk-lib instead. Replace imports with from aws_cdk.aws_kinesisfirehose import ... (same submodule name).

affects: >=1.0.0 <=1.204.0

breakingCDK v2 removed the Cfn prefix from many imports; however, aws-cdk-lib still exports CfnDeliveryStream. Be careful: in v2, the package name changes from aws-cdk-aws-kinesisfirehose to aws-cdk-lib, and the import path remains aws_cdk.aws_kinesisfirehose.

fix

Change pip dependency from aws-cdk-aws-kinesisfirehose to aws-cdk-lib in your requirements files. Update imports from aws_cdk.aws_kinesisfirehose (works in both v1 and v2 if using aws-cdk-lib).

affects: v1.x -> v2.x

gotchaCfnDeliveryStream does not auto-create required IAM roles. You must supply an existing role ARN for S3/Destination. Missing role causes deployment failure with 'Access denied'.

fix

Create an IAM role with proper trust policy and permissions before creating the stream, and pass the role ARN to destination configuration.

affects: all

Errors

Common errors & fixes

ModuleNotFoundError: No module named 'aws_cdk.aws_kinesisfirehose'

Installed aws-cdk-aws-kinesisfirehose but using CDK v2 pattern (which expects aws-cdk-lib). In v1, this module provides the namespace. In v2, the same namespace is part of aws-cdk-lib.

fix

For CDK v1, ensure pip install aws-cdk-aws-kinesisfirehose; for CDK v2, use aws-cdk-lib.

Resource handler returned message: "Access Denied" (Service: Firehose, Status Code: 400)

The IAM role specified does not have sufficient permissions to write to the destination (S3 bucket, Redshift, etc.) or the trust policy does not allow firehose.amazonaws.com.

fix

Attach a policy that allows s3:PutObject, s3:GetBucketLocation, etc. and set trust policy with 'Service': 'firehose.amazonaws.com'.

InvalidArgumentException: Delivery stream name is not valid.

Delivery stream name must be between 1 and 64 characters, only contain alphanumeric, hyphens, and underscores.

fix

Check the delivery_stream_name property: ensure it matches the pattern [a-zA-Z0-9_-]+ and length constraints.

Upgrade

Version history

1.204.0latest on PyPI · released Jun 19, 2023

Audit

Dependencies

aws-cdk-librequiredCore CDK library required

constructsrequiredConstruct programming model

Agent activity

13 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/aws/aws-cdk.git ↗

homepagehttps://github.com/aws/aws-cdk ↗