# CfnStreamProps

Properties for defining a `CfnStream`.

Extends: CfnStreamProps
Used as props by: CfnStream

- Source: Generated code
- Type last changed: v2.268.0 · 2 Sep 2026

## Example

```ts
// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
import { aws_iot as iot } from 'aws-cdk-lib';
const cfnStreamProps: iot.CfnStreamProps = {
  files: [{
    fileId: 123,
    s3Location: {
      bucket: 'bucket',
      key: 'key',
      version: 'version',
    },
  }],
  roleArn: 'roleArn',
  streamId: 'streamId',

  // the properties below are optional
  description: 'description',
  tags: [{
    key: 'key',
    value: 'value',
  }],
};
```

## Properties

- `description`: string — The description of the stream.

- `files`: [IResolvable](/cdk/api/v2/docs/aws-cdk-lib.IResolvable.html) | [IResolvable](/cdk/api/v2/docs/aws-cdk-lib.IResolvable.html) | [CfnStream.StreamFileProperty](/cdk/api/v2/docs/aws-cdk-lib.aws_iot.CfnStream.StreamFileProperty.html)[] (required) — The files to stream.

- `roleArn`: string (required) — An IAM role that allows the IoT service principal to access your S3 files.

- `streamId`: string (required) — The stream ID.

- `tags`: [CfnTag](/cdk/api/v2/docs/aws-cdk-lib.CfnTag.html)[] — Metadata which can be used to manage streams.