Quotas and limits for queues - Amazon Kinesis Data Streams
Services or capabilities described in AWS documentation might vary by Region. To see the differences applicable to the AWS European Sovereign Cloud Region, see the AWS European Sovereign Cloud User Guide.

Quotas and limits for queues

The following quotas and limits apply to queues. A queue works only on a stream in On-demand Standard or On-demand Advantage capacity mode. Provisioned mode is not supported.

Resource quotas

Resource Value Notes
Receive throughput Virtually unlimited A queue suits workloads that receive large volumes of records across many consumer instances. A record counts against the queue's in-flight limit from the time a consumer instance receives it until the instance acknowledges it, so monitor InFlightQueueRecords to see how close your queue consumer is to that limit.
Queues per stream 20 on On-demand Standard, 50 on On-demand Advantage A queue counts as one registered consumer, and queues share this limit with enhanced fan-out consumers, so the two together cannot exceed it. For more information, see Registered consumer sharing.
Streams per queue 1 A queue delivers records from exactly one stream, and StreamConfigurationList must contain exactly one entry. To consume a second stream, create a second queue.
Concurrent queues in CREATING or DELETING state per account per Region 5 The number of queues that can be in the CREATING or DELETING state at the same time in an account in a Region.
Maximum in-flight records per queue 120,000 The number of records that can be in flight for a queue at the same time.
Visible records a metric reports 1,000,000 VisibleQueueRecords and VisibleDeadLetterQueueRecords each report up to 1,000,000 records. A queue can hold more visible records than its metric reports.
Records per call 10 A receive call returns up to 10 records, set by Limit. An acknowledge, visibility, or restore call accepts up to 10 entries. Both limits apply to records and to dead-letter records.
Maximum record size a queue delivers The stream's maximum record size A queue delivers any record written to its stream, up to 10 MiB.

Configuration ranges

Setting Range Notes
Visibility timeout 0 to 43,200 seconds Up to 12 hours. Set per queue or per receive call. Set to 0 to make a record visible immediately.
MaxReceiveCount 1 to 1,000 The number of times a record can be received without being acknowledged before it becomes a dead-letter record. Required when TargetType is BUILT_IN. A queue that you create without DeadLetterConfiguration gets a MaxReceiveCount of 6.
Receive wait time 1 to 20 seconds (default 9) How long a receive call waits for records to arrive.
ListQueues maximum results per page 1 to 10,000 Use pagination tokens to retrieve additional results.
Queue name length 1 to 128 characters The pattern is [a-zA-Z0-9_.-]+.

Control plane API limits

These limits apply per AWS account per Region to the queue control plane operations, which create and manage your queues. A control plane call that exceeds a limit fails with LimitExceededException, and a throttled data plane call fails with ThrottlingException. Retry the call with exponential backoff.

API API call limit
CreateQueue 5 TPS
DeleteQueue 5 TPS
DeleteResourcePolicy 5 TPS
DescribeQueue 20 TPS
GetResourcePolicy 5 TPS
ListQueues 5 TPS
PutResourcePolicy 5 TPS
UpdateQueue 5 TPS

Registered consumer sharing

A queue counts as one registered consumer on its stream. A queue shares the stream registered consumer limit with enhanced fan-out consumers: 20 on On-demand Standard and 50 on On-demand Advantage. For more information about registered consumers, see Develop enhanced fan-out consumers with dedicated throughput.