Amazon Interactive Video Service endpoints and quotas
To connect programmatically to an AWS service, you use an endpoint. AWS services offer the following endpoint types in some or all of the AWS Regions that the service supports: IPv4 endpoints, dual-stack endpoints, and FIPS endpoints. Some services provide global endpoints. 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.
The following are the service endpoints and service quotas for this service.
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.
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:
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 |
| Playback restriction policy origins | 5 | No | Maximum size of the |
| Playback restriction policy origin length | 256 | No | Maximum size (in characters) of an entry in the
|
| 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 resources per account. |
| Composition destinations | 2 | No | Maximum number of Destination objects in a Composition resource. |
| Composition: max duration | 24 | No | Maximum amount of time a composition can exist, in hours. |
| Compositions | 5 | Yes |
Maximum concurrent Composition resources per account. |
| Compositions per stage | 5 | Yes |
Maximum concurrent Composition resources per stage. |
| IngestConfigurations | 100 | Yes |
Maximum number of IngestConfiguration resources 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 |
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 resources 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. |
