Amazon IVS Service Quotas

The following are service quotas and limits for Amazon Interactive Video Service (IVS) endpoints, resources, and other operations. Service quotas (also known as limits) are the maximum number of service resources or operations for your AWS account. That is, these limits are per AWS account, unless noted otherwise in the table. Also see AWS Service Quotas.

You use an endpoint to connect programmatically to an AWS service. Also see AWS Service Endpoints.

All quotas are enforced per region.

Important: All accounts have limits on the number of concurrent views and concurrent streams. (A view is a unique viewing session which is actively downloading or playing video. For a more detailed definition, see the Glossary.) Ensure that your limits are adequate and request an increase if needed, especially if you are planning a large streaming event.

Service Quota Increases

For quotas that are adjustable, you can request a rate increase through the AWS console. Use the console to view information about service quotas too.

API call rate quotas are not adjustable.

API Call Rate Quotas

Amazon IVS

Endpoint Type	Endpoint	Default
Channel	BatchGetChannel	5 TPS
Channel	CreateChannel	5 TPS
Channel	DeleteChannel	5 TPS
Channel	GetChannel	5 TPS
Channel	ListChannels	5 TPS
Channel	UpdateChannel	5 TPS
Playback key pair	DeletePlaybackKeyPair	3 TPS
Playback key pair	GetPlaybackKeyPair	3 TPS
Playback key pair	ImportPlaybackKeyPair	3 TPS
Playback key pair	ListPlaybackKeyPairs	3 TPS
Recording configuration	CreateRecordingConfiguration	3 TPS
Recording configuration	DeleteRecordingConfiguration	3 TPS
Recording configuration	GetRecordingConfiguration	3 TPS
Recording configuration	ListRecordingConfigurations	3 TPS
Stream	GetStream	5 TPS
Stream	GetStreamSession	5 TPS
Stream	ListStreams	5 TPS
Stream	ListStreamSessions	5 TPS
Stream	PutMetadata	5 TPS per channel 155 TPS per account
Stream	StopStream	5 TPS
Stream key	BatchGetStreamKey	5 TPS
Stream key	CreateStreamKey	5 TPS
Stream key	DeleteStreamKey	5 TPS
Stream key	GetStreamKey	5 TPS
Stream key	ListStreamKeys	5 TPS
Tags	ListTagsForResource	10 TPS
Tags	TagResource	10 TPS
Tags	UntagResource	10 TPS

Amazon IVS Stage

Endpoint Type	Endpoint	Default
Stage	CreateParticipantToken	50 TPS
Stage	CreateStage	5 TPS
Stage	DeleteStage	5 TPS
Stage	DisconnectParticipant	5 TPS
Stage	GetParticipant	5 TPS
Stage	GetStage	5 TPS
Stage	GetStageSession	5 TPS
Stage	ListStages	5 TPS
Stage	UpdateStage	5 TPS
Stage	ListParticipants	5 TPS
Stage	ListParticipantEvents	5 TPS
Stage	ListStageSessions	5 TPS
Tags	ListTagsForResource	10 TPS
Tags	TagResource	10 TPS
Tags	UntagResource	10 TPS

Amazon IVS Chat

Endpoint Type	Endpoint	Default
Messaging	DeleteMessage	100 TPS
Messaging	DisconnectUser	100 TPS
Messaging	SendEvent	100 TPS
Chat token	CreateChatToken	200 TPS
Logging Configuration	CreateLoggingConfiguration	3 TPS
Logging Configuration	DeleteLoggingConfiguration	3 TPS
Logging Configuration	GetLoggingConfiguration	3 TPS
Logging Configuration	ListLoggingConfigurations	3 TPS
Logging Configuration	UpdateLoggingConfiguration	3 TPS
Room	CreateRoom	5 TPS
Room	DeleteRoom	5 TPS
Room	GetRoom	5 TPS
Room	ListRooms	5 TPS
Room	UpdateRoom	5 TPS
Tags	ListTagsForResource	10 TPS
Tags	TagResource	10 TPS
Tags	UntagResource	10 TPS

Other Quotas

Amazon IVS

Resource or Feature	Default	Adjustable	Description
Channels	5,000	Yes	Maximum number of channels, per AWS Region.
Concurrent streams	100	Yes	Maximum number of channels that can be streamed simultaneously, per AWS Region. If you exceed this threshold, the stream is rejected.
Concurrent views	15,000	Yes	Maximum number of views allowed to play back a live channel, across all channels in an AWS Region. (A view is a unique viewing session which is actively downloading or playing video. See the Important note at the beginning of this page.)
Ingest bitrate (if channel type is BASIC)	1.5 Mbps or 3.5 Mbps	No	Maximum bits per second that can be streamed to a channel whose type is BASIC. If input video quality is 480p or less, the default quota is 1.5 Mbps. If input video quality is more than 480p but less than 1080p, the default quota is 3.5 Mbps. Warning: If you exceed this threshold, the stream probably will disconnect immediately. See the Amazon IVS API Reference for details about channel type.
Ingest bitrate (if channel type is STANDARD)	8.5 Mbps	No	Maximum bits per second that can be streamed to a channel whose type is STANDARD (the default). Warning: If you exceed this threshold, the stream probably will disconnect immediately. See the Amazon IVS API Reference for details about channel type.
Ingest bitrate (if channel type is ADVANCED_HD)	8.5 Mbps	No	Maximum bits per second that can be streamed to a channel whose type is ADVANCED_HD. Warning: If you exceed this threshold, the stream probably will disconnect immediately. See the Amazon IVS API Reference for details about channel type.
Ingest bitrate (if channel type is ADVANCED_SD)	8.5 Mbps	No	Maximum bits per second that can be streamed to a channel whose type is ADVANCED_SD. Warning: If you exceed this threshold, the stream probably will disconnect immediately. See the Amazon IVS API Reference for details about channel type.
Ingest resolution	1080p (2.1M total pixels, 1920 pixels/edge)	No	Maximum resolution in pixels that can be streamed to a channel (regardless of its type). There are two relevant thresholds: total pixels and pixels per edge. Warning: If you exceed either of these thresholds, the stream probably will disconnect immediately. See the Amazon IVS API Reference for details about channel type.
Metadata payload	1 KB	No	Maximum size of a PutMetadata request payload (Amazon IVS API).
Participant publish or subscribe duration	24	No	Maximum length of time a participant can publish or remain subscribed to a stage, in hours.
Playback authorization key pairs	3	No	Maximum number of playback authorization key pairs, per AWS Region.
Playback token size	2 KB	No	Maximum size of the entire JSON web token (JWT) used to initiate playback.
Recording configurations	20	Yes	Maximum number of recording configurations, per AWS Region.
Stage participants (publishers)	12	No	Maximum number of participants who can be publishing to a stage at once.
Stage participants (subscribers)	1,000	Yes	Maximum number of participants who can be subscribing to a stage at once.
Stages	100	Yes	Maximum number of stages, per region.
Stream key	1	No	Maximum number of stream keys, per channel.

Amazon IVS Chat

Resource or Feature	Default	Adjustable	Description
Concurrent chat connections	50,000	Yes	Maximum number of concurrent chat connections per account, across all your rooms in an AWS Region.
Logging configurations	10	Yes	The maximum number of logging configurations that can be created per account in the current AWS Region.
Message review handler timeout period	200	No	Timeout period in milliseconds for all your message review handlers in the current AWS Region. If this is exceeded, the message is allowed or denied depending on the value of the fallbackResult field you configured for the message review handler.
Rate of DeleteMessage requests across all your rooms	100	Yes	Maximum number of DeleteMessage requests that can be made per second across all your rooms. The requests can come from either the Amazon IVS Chat API or the Amazon IVS Chat Messaging API (WebSocket).
Rate of DisconnectUser requests across all your rooms	100	Yes	Maximum number of DisconnectUser requests that can be made per second across all your rooms. The requests can come from either the Amazon IVS Chat API or the Amazon IVS Chat Messaging API (WebSocket).
Rate of messaging requests per connection	10	No	Maximum number of messaging requests per second that a chat connection can make.
Rate of SendMessage requests across all your rooms	1000	Yes	Maximum number of SendMessage requests that can be made per second across all your rooms. These requests come from the Amazon IVS Chat Messaging API (WebSocket).
Rate of SendMessage requests per room	100	No (but configurable through the API)	Maximum number of SendMessage requests that can be made per second for any one of your rooms. This is configurable with the maximumMessageRatePerSecond field of CreateRoom and UpdateRoom. These requests come from the Amazon IVS Chat Messaging API (WebSocket).
Rooms	50,000	Yes	Maximum number of chat rooms per account, per AWS Region.

Service Quotas Integration with CloudWatch Usage Metrics

You can use CloudWatch to proactively manage your service quotas, via CloudWatch usage metrics. You can use these metrics to visualize your current service usage on CloudWatch graphs and dashboards. Amazon IVS usage metrics correspond to Amazon IVS service quotas.

You can use a CloudWatch metric math function to display the service quotas for those resources on your graphs. You can also configure alarms that alert you when your usage approaches a service quota.

To access usage metrics:

1. Open the Service Quotas console at https://console.aws.amazon.com/servicequotas/

2. In the navigation pane, select AWS services.

3. From the AWS services list, search for and select Amazon Interactive Video Service or Amazon Interactive Video Service Chat.

4. In the Service quotas list, select the service quota of interest. A new page opens with information about the service quota/metric.

Alternately, you can get to these metrics through the CloudWatch console. Under AWS Namespaces, choose Usage. Then, from the Service list, choose IVS or IVS Chat. (See Monitoring Amazon IVS with Amazon CloudWatch.)

In the AWS/Usage namespace, Amazon IVS provides the following metric:

Metric Name	Description
ResourceCount	A count of the specified resources running in your account. The resources are defined by the dimensions associated with the metric. Valid statistic: Maximum (the maximum number of resources used during the 1-minute period).

The following dimensions are used to refine the usage metric:

Dimension	Description
Service	The name of the AWS service containing the resource. Valid values: IVS, IVS Chat.
Class	The class of resource being tracked. Valid value: None.
Type	The type of resource being tracked. Valid value: Resource.
Resource	The name of the AWS resource. Valid values: ConcurrentStreams, ConcurrentViews, ConcurrentChatConnections. The ConcurrentStreams and ConcurrentViews usage metrics are copies of the ones in the AWS/IVS namespace (with the None dimension), as described in Monitoring Amazon IVS with Amazon CloudWatch. The ConcurrentChatConnections usage metric is a copy of the one in the AWS/IVSChat namespace (with the None dimension), as described in Monitoring Amazon IVS with Amazon CloudWatch.

Creating a CloudWatch Alarm for Usage Metrics

To create a CloudWatch alarm based on an Amazon IVS or Amazon IVS Chat usage metric:

1. From the Service Quotas console, select the service quota of interest, as described above. Currently, alarms can be created only for ConcurrentStreams, ConcurrentViews, and ConcurrentChatConnections.

2. In the Amazon CloudWatch alarms section, choose Create.

3. From the Alarm threshold dropdown list, choose the percentage of your applied quota value that you want to set as the alarm value.

4. For Alarm name, enter a name for the alarm.

5. Select Create.