Amazon Interactive Video Service endpoints and quotas - AWS General Reference

Amazon Interactive Video Service endpoints and quotas

The following are the service endpoints and service quotas for this service. To connect programmatically to an AWS service, you use an endpoint. In addition to the standard AWS endpoints, some AWS services offer FIPS endpoints in selected Regions. For more information, see AWS service endpoints. Service quotas, also referred to as limits, are the maximum number of service resources or operations for your AWS account. For more information, see AWS service quotas.

Service endpoints

Amazon IVS uses an API for setting up and configuring IVS low-latency and real-time streaming applications. Amazon IVS Chat uses the main Chat API for setting up and managing chat rooms, and the Chat Messaging API for sending and receiving chat messages.

IVS low-latency streaming endpoints

Region Name Region Endpoint Protocol
US East (N. Virginia) us-east-1 ivs.us-east-1.amazonaws.com HTTPS
US West (Oregon) us-west-2 ivs.us-west-2.amazonaws.com HTTPS
Asia Pacific (Mumbai) ap-south-1 ivs.ap-south-1.amazonaws.com HTTPS
Asia Pacific (Seoul) ap-northeast-2 ivs.ap-northeast-2.amazonaws.com HTTPS
Asia Pacific (Tokyo) ap-northeast-1 ivs.ap-northeast-1.amazonaws.com HTTPS
Europe (Frankfurt) eu-central-1 ivs.eu-central-1.amazonaws.com HTTPS
Europe (Ireland) eu-west-1 ivs.eu-west-1.amazonaws.com HTTPS

IVS real-time streaming endpoints

Region Name Region Endpoint Protocol
US East (N. Virginia) us-east-1 ivsrealtime.us-east-1.amazonaws.com HTTPS
US West (Oregon) us-west-2 ivsrealtime.us-west-2.amazonaws.com HTTPS
Asia Pacific (Mumbai) ap-south-1 ivsrealtime.ap-south-1.amazonaws.com HTTPS
Asia Pacific (Seoul) ap-northeast-2 ivsrealtime.ap-northeast-2.amazonaws.com HTTPS
Asia Pacific (Tokyo) ap-northeast-1 ivsrealtime.ap-northeast-1.amazonaws.com HTTPS
Europe (Frankfurt) eu-central-1 ivsrealtime.eu-central-1.amazonaws.com HTTPS
Europe (Ireland) eu-west-1 ivsrealtime.eu-west-1.amazonaws.com HTTPS

IVS Chat endpoints

Region Name Region Endpoint Protocol
US East (N. Virginia) us-east-1 ivschat.us-east-1.amazonaws.com HTTPS
US West (Oregon) us-west-2 ivschat.us-west-2.amazonaws.com HTTPS
Asia Pacific (Mumbai) ap-south-1 ivschat.ap-south-1.amazonaws.com HTTPS
Asia Pacific (Seoul) ap-northeast-2 ivschat.ap-northeast-2.amazonaws.com HTTPS
Asia Pacific (Tokyo) ap-northeast-1 ivschat.ap-northeast-1.amazonaws.com HTTPS
Europe (Frankfurt) eu-central-1 ivschat.eu-central-1.amazonaws.com HTTPS
Europe (Ireland) eu-west-1 ivschat.eu-west-1.amazonaws.com HTTPS

IVS Chat messaging endpoints

Region Name Region Endpoint Protocol
US East (N. Virginia) us-east-1 edge.ivschat.us-east-1.amazonaws.com WSS
US West (Oregon) us-west-2 edge.ivschat.us-west-2.amazonaws.com WSS
Asia Pacific (Mumbai) ap-south-1 edge.ivschat.ap-south-1.amazonaws.com WSS
Asia Pacific (Seoul) ap-northeast-2 edge.ivschat.ap-northeast-2.amazonaws.com WSS
Asia Pacific (Tokyo) ap-northeast-1 edge.ivschat.ap-northeast-1.amazonaws.com WSS
Europe (Frankfurt) eu-central-1 edge.ivschat.eu-central-1.amazonaws.com WSS
Europe (Ireland) eu-west-1 edge.ivschat.eu-west-1.amazonaws.com WSS

Service quotas

For more information, see Low-Latency Streaming Service Quotas in the Amazon IVS Low-Latency Streaming User Guide and Real-Time Streaming Service Quotas in the Amazon IVS Real-Time Streaming User Guide.

If there is a discrepancy, regard the User Guides as definitive.

IVS low-latency streaming quotas

Name 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 playback a live channel simultaneously, across all channels, in an AWS Region. (A view is a unique viewing session which is actively downloading or playing video.)
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. For details on channel type, see Channel Types in the IVS Low-Latency Streaming API Reference.
Ingest bitrate (if channel type is STANDARD, with single-track input) 8.5 Mbps No Maximum bits per second that can be streamed to a channel whose type is STANDARD (the default), with single-track input. Warning: If you exceed this threshold, the stream probably will disconnect immediately. For details on channel type, see Channel Types in the IVS Low-Latency Streaming API Reference.
Ingest bitrate (if channel type is STANDARD, with multitrack input up to FULL_HD resolution) 15 Mbps No Maximum bits per second that can be streamed to a channel whose type is STANDARD (the default), whose multitrackInputConfiguration.maximumResolution is SD, HD, or FULL_HD, with multitrack input. Warning: If you exceed this threshold, the stream probably will disconnect immediately. For details on channel type, see Channel Types in the IVS Low-Latency Streaming API Reference.
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. For details on channel type, see Channel Types in the IVS Low-Latency Streaming API Reference.
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. For details on channel type, see Channel Types in the IVS Low-Latency Streaming API Reference.
Ingest resolution (single-track input) 1080p (2.1M total pixels, 1920 pixels/edge) No Maximum resolution in pixels that can be streamed to a channel (regardless of its type) with single-track input. 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. For details on channel type, see Channel Types in the IVS Low-Latency Streaming API Reference.
Ingest resolution (if channel type is STANDARD, with multitrack input) see Description No Maximum resolution in pixels that can be streamed to an individual track on a channel whose type is STANDARD, with multitrack input. The default varies depending on the value of multitrackInputConfiguration.maximumResolution:
  • SD: 480p (0.4M total pixels, 864 pixels/edge)

  • HD: 720p (0.9M total pixels, 1280 pixels/edge)

  • FULL_HD: 1080p (2.1M total pixels, 1920 pixels/edge)>

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. For details on channel type, see Channel Types in the IVS Low-Latency Streaming API Reference.
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 restriction policies 3 No Maximum number of playback restriction policies, per AWS Region.
Playback restriction policy countries 200 No

Maximum size of the allowedCountries list in a playback restriction policy; that is, the maximum number of countries per policy.

Playback restriction policy origins 5 No

Maximum size of the allowedOrigins list in a playback restriction policy; that is, the maximum number of origins per policy.

Playback restriction policy origin length 256 No

Maximum size (in characters) of an entry in the allowedOrigins list in a playback restriction policy.

Playback token size 2 KB No Maximum size of the entire JSON web token (JWT) used to initiate playback.
PutMetadata rate per channel 5 No Maximum PutMetadata transactions per second per channel.
Recording configurations 20 Yes Maximum number of recording configurations, per AWS Region.
Stream key 1 No Maximum number of stream keys, per channel.
Stream takeovers 100 Yes Maximum number of stream takeovers, per stream.

IVS real-time streaming quotas

Name Default Adjustable Description
EncoderConfigurations 20 Yes Maximum number of EncoderConfiguration objects per account.
Composition destinations 2 No Maximum number of Destination objects in a Composition object.
Composition: max duration 24 No Maximum amount of time a composition can exist, in hours.
Compositions 5 Yes Maximum concurrent Composition objects per account.
IngestConfigurations 100 Yes Maximum number of IngestConfiguration objects per account.
Participant publish bitrate 8.5 Mbps No Maximum bits per second that can be streamed to a stage.
Participant publish or subscribe duration 24 No Maximum length of time a participant can publish or remain subscribed to a stage, in hours.
Participant publish resolution 720p No Maximum resolution of video published by participants.
Participant download bitrate 8.5 Mbps No Maximum aggregate download bitrate across all of a participant’s subscriptions.
PublicKeys 3 No Maximum number of public keys, per AWS Region.
Stage participants (publishers) 12 No Maximum number of participants who can be publishing to a stage at once.
Stage participants (subscribers) 10,000 Yes (up to 25,000) Maximum number of participants who can be subscribing to a stage at once.
Stages 1,000 Yes

Maximum number of stages, per AWS Region.

StorageConfigurations 5 Yes

Maximum number of StorageConfiguration objects per account.

IVS Chat quotas

Name 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 1,000 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 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 Create Room and Update Room. 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.