Manage enhanced fan-out consumers with the Amazon CLI or APIs
Consumers that use enhanced fan-out in Amazon Kinesis Data Streams can receive records from a data stream with dedicated throughput of up to 2 MB of data per second per shard. For more information, see Develop enhanced fan-out consumers with dedicated throughput.
You can use Amazon CLI or Kinesis Data Streams APIs to register, describe, list, and deregister a consumer that uses enhanced fan-out in Kinesis Data Streams.
Manage consumers using the Amazon CLI
You can register, describe, list, and deregister enhanced fan-out consumers using the Amazon CLI. For examples, see the following documentation.
- register-stream-consumer
-
Registers a consumer for a Kinesis data stream. You can apply tags while registering the consumer.
- describe-stream-consumer
-
Gets the description of a registered consumer with either consumer ARN or consumer name and stream ARN combination.
- list-stream-consumers
-
Lists the consumers registered to receive data from a stream using enhanced fan-out.
- deregister-stream-consumer
-
Deregister a consumer with either consumer ARN or consumer name and stream ARN combination.
Manage consumers using the Kinesis Data Streams APIs
You can register, describe, list, and deregister enhanced fan-out consumers using the Kinesis Data Streams APIs. For examples, see the following documentation.
- RegisterStreamConsumer
-
Registers a consumer for a Kinesis data stream with tags. You can apply tags while registering the consumer.
- DescribeStreamConsumer
-
Gets the description of a registered consumer with either consumer ARN or consumer name and stream ARN combination.
- ListStreamConsumers
-
Lists the consumers registered to receive data from a stream using enhanced fan-out.
- DeregisterStreamConsumer
-
Deregister a consumer with either consumer ARN or consumer name and stream ARN combination.
Tagging consumers
You can assign your own metadata to streams and enhanced fan-out consumers you create in Kinesis Data Streams in the form of tags. You can use tags to categorize and track costs of your consumers. You can also control access to consumers using tags with attribute-based access control (ABAC). For more information, see Tag your Amazon Kinesis Data Streams resources.