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.

Only the following quotas are adjustable:

API Call Rate Quotas

Endpoint Type Endpoint Default Quota
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

ListStreams

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

Resource Quotas

Resource Default Quota Description
Channels 5000 Maximum number of channels, per AWS region.
Playback authorization key pairs 3 Maximum number of playback authorization key pairs, per AWS region.
Recording configurations 20 Maximum number of recording configurations, per AWS region.
Stream key 1 Maximum number of stream keys, per channel.

Contribution and Playback Quotas

Resource or Feature Default Quota Description
Playback token size 2 KB Maximum size of the entire JSON web token (JWT) used to initiate playback.
Concurrent views 15000 Maximum number of views allowed to play back a live channel, across all channels in an AWS region.
Metadata payload 1 KB

Maximum size of a PutMetadata request payload (Amazon IVS API).

Concurrent streams 100 Maximum number of channels that can be streamed simultaneously, per AWS region. If you exceed this threshold, the stream is rejected.

Ingest bitrate (if channel type is STANDARD)

8.5 Mbps

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 BASIC)

1.5 Mbps

Maximum bits per second that can be streamed to a channel whose type is BASIC. 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 (if channel type is STANDARD)

1080p (2.1M total pixels, 1920 pixels/edge)

Maximum resolution in pixels that can be streamed to a channel whose type is STANDARD (the default). 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.

Ingest resolution (if channel type is BASIC)

480p (415K total pixels, 855 pixels/edge)

Maximum resolution in pixels that can be streamed to a channel whose type is BASIC. 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.

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.

  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. (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 value: IVS.

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.

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.

Creating a CloudWatch Alarm for Usage Metrics

To create a CloudWatch alarm based on an Amazon IVS 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 and ConcurrentViews.

  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.