---
type: resource-type
title: StreamConsumer
description: aws resource type AWS::Kinesis::StreamConsumer
name: StreamConsumer
lexicon: aws
resource_type: AWS::Kinesis::StreamConsumer
---
`AWS::Kinesis::StreamConsumer`, a resource type of the aws lexicon.

## Properties

- `ConsumerName` (`string`, required): The name of the Kinesis Stream Consumer. For a given Kinesis data stream, each consumer must have a unique name. However, consumer names don't have to be unique across data streams.
- `StreamARN` (`string`, required): The Amazon resource name (ARN) of the Kinesis data stream that you want to register the consumer with.
- `ConsumerARN` (`string`, optional): The ARN returned by Kinesis Data Streams when you registered the consumer. If you don't know the ARN of the consumer that you want to deregister, you can use the ListStreamConsumers operation to get a list of the descriptions of all the consumers that are currently registered with a given data stream. The description of a consumer contains its ARN.
- `ConsumerCreationTimestamp` (`string`, optional): Timestamp when the consumer was created.
- `ConsumerStatus` (`string`, optional): A consumer can't read data while in the CREATING or DELETING states. Valid Values: CREATING | DELETING | ACTIVE
- `Tags` (`StreamConsumer_Tag[]`, optional): An arbitrary set of tags (key–value pairs) to associate with the Kinesis consumer.

## Attributes

- `ConsumerARN`
- `ConsumerCreationTimestamp`
- `ConsumerStatus`