Amazon IVS Service Quotas - Amazon Interactive Video Service

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.

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 Chat

Endpoint Type Endpoint Default
Messaging

DeleteMessage

10 TPS
Messaging

DisconnectUser

10 TPS
Messaging

SendEvent

10 TPS
Chat token

CreateChatToken

10 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 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).

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.
Stream key 1 No Maximum number of stream keys, per channel.

Amazon IVS Chat

Resource or Feature Default Adjustable Description
Concurrent chat connections 5,000 Yes Maximum number of concurrent chat connections per account, across all your rooms in an 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 10 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 10 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 3 No (but configurable through the API) Maximum number of messaging requests per second that a chat connection can make. The message rate limit per chat room is configurable with the maximumMessageRatePerSecond field of CreateRoom and UpdateRoom.
Rate of SendMessage requests across all your rooms 100 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 10 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 5,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.