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

# aws-cdk.aws-kinesis — The CDK Construct Library for AWS::Kinesis

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

## What it is and what it does

This package provides CDK constructs to define Amazon Kinesis data streams as part of your infrastructure-as-code stack. It wraps the AWS Kinesis API, allowing you to create streams with configurable shard counts and retention periods, set up server-side encryption with KMS keys, grant IAM permissions to principals, and emit CloudWatch metrics—all declaratively in Python.

However, this is AWS CDK v1, which reached end-of-support on 2023-06-01 and is no longer receiving updates. The package remains functional but unmaintained; AWS recommends migrating to AWS CDK v2 for ongoing support and new features. If you are starting a new project or maintaining an existing one, you should plan to upgrade rather than adopt v1.

Use it for:

- Define Kinesis streams in a CDK stack with custom shard counts and retention periods for real-time data ingestion.
- Set up encryption on streams using AWS-managed or customer-managed KMS keys via CDK constructs.
- Grant read, write, or read-write permissions to Lambda functions, IAM roles, or other principals that need to access streams.
- Import and reference existing Kinesis streams created outside the CDK stack by ARN or attributes.
- Create CloudWatch metrics and alarms for stream performance monitoring from within your CDK application.

## Worth the install?

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

Defines AWS Kinesis data streams as infrastructure-as-code constructs for the AWS CDK, enabling you to provision, configure, and manage stream resources, encryption, permissions, and metrics programmatically.

No, unless you are maintaining an existing AWS CDK v1 project. This package is end-of-support as of 2023-06-01 and no longer receives updates. For new projects, use AWS CDK v2 instead. For existing v1 projects, plan a migration to v2 to maintain support and access to new features.

## Install

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

## Installing aws-cdk.aws-kinesis

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 instead.

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

Quickstart:

pip install aws-cdk.aws-kinesis

from aws_cdk import aws_kinesis as kinesis
from aws_cdk import core

class MyStack(core.Stack):
    def __init__(self, scope: core.Construct, id: str, **kwargs):
        super().__init__(scope, id, **kwargs)
        stream = kinesis.Stream(self, "MyStream", stream_name="my-stream")

Requires AWS CDK v1 core library and associated AWS construct dependencies; v1 is end-of-support as of 2023-06-01.

Verify before relying:

- Whether migration tooling or documentation from v1 to v2 is readily available and straightforward for existing projects.
- Performance characteristics or throughput limits when managing streams with high shard counts or retention periods.

## Package facts

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

## Tags

AWS CDK Kinesis streams, infrastructure as code kinesis, AWS stream provisioning CDK, kinesis construct library, CDK stream encryption and permissions, aws-cdk, end-of-support, infrastructure-as-code

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