# StreamSpecificationProperty

Represents the DynamoDB Streams configuration for a table in DynamoDB.

- 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_dynamodb as dynamodb } from 'aws-cdk-lib';

declare const policyDocument: any;
const streamSpecificationProperty: dynamodb.CfnTable.StreamSpecificationProperty = {
  streamViewType: 'streamViewType',

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

## Properties

- `resourcePolicy`: [IResolvable](/cdk/api/v2/docs/aws-cdk-lib.IResolvable.html) | [CfnTable.ResourcePolicyProperty](/cdk/api/v2/docs/aws-cdk-lib.aws_dynamodb.CfnTable.ResourcePolicyProperty.html) — Creates or updates a resource-based policy document that contains the permissions for DynamoDB resources, such as a table's streams.

  Resource-based policies let you define access permissions by specifying who has access to each resource, and the actions they are allowed to perform on each resource.

  > When you remove the `StreamSpecification` property from the template, DynamoDB disables the stream but retains any attached resource policy until the stream is deleted after 24 hours. When you modify the `StreamViewType` property, DynamoDB creates a new stream and retains the old stream's resource policy. The old stream and its resource policy are deleted after the 24-hour retention period.

  In a CloudFormation template, you can provide the policy in JSON or YAML format because CloudFormation converts YAML to JSON before submitting it to DynamoDB . For more information about resource-based policies, see [Using resource-based policies for DynamoDB](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/access-control-resource-based.html) and [Resource-based policy examples](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/rbac-examples.html) .

- `streamViewType`: string (required) — When an item in the table is modified, `StreamViewType` determines what information is written to the stream for this table.

  Valid values for `StreamViewType` are:

  - `KEYS_ONLY` - Only the key attributes of the modified item are written to the stream.
  - `NEW_IMAGE` - The entire item, as it appears after it was modified, is written to the stream.
  - `OLD_IMAGE` - The entire item, as it appeared before it was modified, is written to the stream.
  - `NEW_AND_OLD_IMAGES` - Both the new and the old item images of the item are written to the stream.

- `tags`: [CfnTag](/cdk/api/v2/docs/aws-cdk-lib.CfnTag.html)[]