Kinesis Video Streams Streams-Dienstkontingente

Kinesis Video Streams hat die folgenden Servicequotas:

Wichtig

Bei den folgenden Servicekontingenten handelt es sich entweder um Soft [s], die durch Einreichung eines Support-Tickets aktualisiert werden können, oder um Hard [h], die nicht erhöht werden können. In den folgenden Tabellen werden neben den einzelnen Servicekontingenten [s] und [h] angezeigt.

API-Dienstkontingente auf Kontrollebene

Im folgenden Abschnitt werden Dienstkontingente für APIs auf Kontrollebene beschrieben. TPS steht für Transaktionen pro Sekunde.

Wenn ein Anforderungslimit auf Konto- oder Ressourcenebene erreicht wird, wird a ausgelöst. ClientLimitExceededException

API-Dienstkontingente auf Kontrollebene
API	Kontolimit: Anfrage	Kontolimit: Streams	Grenzwerte auf Stream-Ebene	Relevante Ausnahmen und Hinweise
CreateStream	50 TPS [s]	10000 Streams pro Konto (en) in den Regionen USA Ost (Nord-Virginia) und USA West (Oregon). 5000 Streams pro Konto (en) in allen anderen unterstützten Regionen. Anmerkung Dieses Limit kann auf bis zu 100 000 (oder mehr) Streams pro Konto [s] erhöht werden. Melden Sie sich AWS Management Console unter an https://console.aws.amazon.com/ und reichen Sie eine Anfrage zur Erhöhung des Service-Limits für Kinesis Video Streams ein, um eine Erhöhung dieses Limits zu beantragen.	N/A	Diese API kann über Geräte, CLIs, SDK-gesteuerten Zugriff und die Konsole aufgerufen werden. Es ist nur ein API-Aufruf erfolgreich, wenn der Stream noch nicht vorhanden ist.
DeleteEdgeConfiguration	10 TPS [h]	N/A	1 TPS [h]
DeleteStream	50 TPS [h]	N/A	5 TPS [h]
DescribeEdgeConfiguration	50 TPS [h]	N/A	5 TPS [h]
DescribeImageGenerationConfiguration	50 TPS [h]	N/A	5 TPS [h]
DescribeMappedResourceConfiguration	50 TPS [h]	N/A	5 TPS [h]
DescribeNotificationConfiguration	50 TPS [h]	N/A	5 TPS [h]
DescribeStream	300 TPS [h]	N/A	5 TPS [h]
GetDataEndpoint	300 TPS [h]	N/A	5 TPS [h]	Wird alle 45 Minuten aufgerufen, um das Streaming-Token für die meisten PutMedia/GetMedia-Anwendungsfälle zu aktualisieren. Das Caching von Datenendpunkten ist sicher, wenn die Anwendung sie bei einem Fehler erneut lädt.
ListEdgeAgentConfigurations	50 TPS [h]	N/A	N/A
ListStreams	50 TPS [h]	N/A	N/A
ListTagsForStream	50 TPS [h]	N/A	5 TPS [h]
StartEdgeConfigurationUpdate	10 TPS [h]	N/A	1 TPS [h]
TagStream	50 TPS [h]	N/A	5 TPS [h]
UntagStream	50 TPS [h]	N/A	5 TPS [h]
UpdateDataRetention	50 TPS [h]	N/A	5 TPS [h]
UpdateImageGenerationConfiguration	50 TPS [h]	N/A	5 TPS [h]
UpdateNotificationConfiguration	50 TPS [h]	N/A	5 TPS [h]
UpdateStream	50 TPS [h]	N/A	5 TPS [h]

API-Dienstkontingente für Medien und archivierte Medien

Im folgenden Abschnitt werden Dienstkontingente für Medien und APIs für archivierte Medien beschrieben.

Wenn ein Anforderungslimit auf Konto- oder Ressourcenebene erreicht wird, wird a ausgelöst. ClientLimitExceededException

Wenn ein Grenzwert auf Verbindungsebene erreicht wird, wird die Ausnahme ConnectionLimitExceededException ausgelöst.

Die folgenden Fehler und Bestätigungen werden ausgelöst, wenn ein Grenzwert auf Fragmentebene erreicht wird:

• Eine MIN_FRAGMENT_DURATION_REACHED-Bestätigung wird zurückgegeben, wenn ein Fragment unterhalb der Mindestdauer liegt.

• Eine MAX_FRAGMENT_DURATION_REACHED-Bestätigung wird zurückgegeben, wenn ein Fragment oberhalb der Höchstdauer liegt.

• Eine MAX_FRAGMENT_SIZE-Bestätigung wird zurückgegeben, wenn ein Fragment die maximale Datengröße überschreitet.

• Eine FragmentLimitExceeded-Ausnahme wird ausgelöst, wenn ein Fragmentgrenzwert in einer GetMediaForFragmentList-Operation erreicht wird.

API-Dienstkontingente auf Datenebene
API	Grenzwerte auf Stream-Ebene	Grenzwerte auf Verbindungsebene	Bandbreitenbegrenzung	Grenzwerte auf Fragmentebene	Relevante Ausnahmen und Hinweise
PutMedia	5 TPS [h]	1 [s]	12,5 MB/Sekunde oder 100 Mbit/s [s] pro Stream	Minimale Fragmentdauer: 1 Sekunde [h] Maximale Fragmentdauer: 20 Sekunden [h] Maximale Fragmentgröße: 50 MB [h] Maximale Anzahl von Tracks: 3 [s] Maximale Anzahl gesendeter Fragmente pro Sekunde: 5 [h] Maximales Limit für Fragment-Metadaten: 10 Tags [h]	Eine typische PutMedia-Anforderung enthält die Daten für mehrere Sekunden, was zu einem niedrigeren TPS pro Stream führt. Wenn es mehrere gleichzeitige Verbindungen gibt, die die Kontingente überschreiten, wird die letzte Verbindung akzeptiert.
GetClip	N/A	N/A	100 MB Größenbeschränkung [h]	Maximale Anzahl der Fragmente: 200 [h]
GetDASHStreamingSessionURL	25 TPS [h]	N/A	–	N/A
GetHLSStreamingSessionURL	25 TPS [h]	N/A	–	–
GetImages	–	N/A	100 MB [h]	N/A	Die maximale Anzahl von Bildern pro Anfrage beträgt 100 [h]. Anmerkung Der Mindestwert für SamplingInterval ist 200 Millisekunden (ms), was 5 Bildern pro Sekunde entspricht.
GetMedia	5 TPS [h]	3 [s]	25 MB/s oder 200 Mbit/s [s]	Maximale Anzahl gesendeter Fragmente pro Sekunde: 6 [h]	Ein einzelner Client sollte nicht mehr als zwei oder drei TPS benötigen, da die Anwendung nach dem Verbindungsaufbau kontinuierlich lesen sollte. Wenn ein typisches Fragment etwa 5 MB groß ist, bedeutet dieser Grenzwert ~75 MB/s pro Kinesis-Videostream. Ein solcher Stream hat eine ausgehende Bitrate, die etwa doppelt so hoch ist wie die maximale eingehende Bitrate des Streams. Anmerkung GetMediawird nicht für die HLS/DASH-Wiedergabe verwendet.
GetMediaForFragmentList	N/A	5 [s]	25 MB/s oder 200 Mbit/s [s]	Maximale Anzahl der Fragmente: 1000 [h]	Fünf fragmentbasierte, verbrauchende Anwendungen können gleichzeitig aufgerufen werden. GetMediaForFragmentList Weitere Verbindungen werden abgelehnt.

API-Dienstkontingente für das Videowiedergabeprotokoll
API	Grenzwerte auf Sitzungsebene	Grenzwerte auf Fragmentebene
GetDash ManifestPlaylist	5 TPS [h]	Maximale Anzahl von Fragmenten pro Playlist: 5000 [h]
Holen Sie sich HLS MasterPlaylist	5 TPS [h]	N/A
Holen Sie sich HLS MediaPlaylist	5 TPS [h]	Maximale Anzahl von Fragmenten pro Playlist: 5000 [h]
Holen Sie sich MP4 InitFragment	5 TPS [h]	N/A
Holen Sie sich MP4 MediaFragment	20 TPS [h]	N/A
GetTSFragment	20 TPS [h]	N/A

Fragment-Metadaten und Kontingente für fragmentierte Medien

Kinesis Video Streams Streams-APIs für den Zugriff auf archivierte Medien werden anhand der Anzahl der angeforderten Fragmente und nicht anhand der Anzahl der API-Aufrufe gedrosselt. APIs sind sowohl durch die Anzahl der Fragment-Metadaten als auch durch die Anzahl der angeforderten Fragmentmedien begrenzt. Die Kontingente für Fragmentmetadaten und Fragmentmedien werden pro Stream angewendet. Mit anderen Worten, Anfragen nach Fragmentmetadaten oder Medien in einem Stream gelten nicht für die Kontingente eines anderen Streams. Innerhalb eines bestimmten Streams wird jedes Kontingent jedoch von mehreren APIs gemeinsam genutzt. Das bedeutet, dass für einen bestimmten Stream Anfragen nach Fragmenten über verschiedene APIs aus demselben Kontingent stammen. Wenn entweder das Fragmentmetadaten- oder das Fragmentmedienkontingent für einen Stream überschritten wird, gibt die API a zurückClientLimitExceededException. Die folgenden Tabellen zeigen, wie die APIs die einzelnen Quotentypen verbrauchen. Gehen Sie für die zweite Spalte in diesen Tabellen davon aus, dass, wenn ein Stream ein Kontingent von N hat, das bedeutet, dass die APIs über N Punkte verfügen, die von diesem Quotentyp für diesen Stream verbraucht werden können. Die GetClip API erscheint in beiden Tabellen.

Verbrauch von Fragmentmetadaten
API	Anzahl der pro Anfrage verbrauchten Kontingentpunkte	Geteiltes Kontingent (N)
ListFragments	Wert des MaxResults Parameters	10000 Quotenpunkte pro Sekunde, pro Stream [h]
GetClip	Anzahl der Fragmente im resultierenden Clip
GetHLSMediaPlaylist	Wert des MaxMediaPlaylistFragmentResults Parameters
GetDASHManifest	Wert des MaxManifestFragmentResults Parameters
GetImages	Wert von 400 + maximale Anzahl angeforderter Bilder

Verbrauch von Fragment-Medienkontingenten
API	Anzahl der pro Anfrage verbrauchten Kontingentpunkte	Geteiltes Kontingent (N)
GetMediaForFragmentList	Anzahl der Fragmente im Fragments-Parameter	500 Quotenpunkte pro Sekunde, pro Stream [h]
GetClip	Anzahl der Fragmente im resultierenden Clip
GetMP4MediaFragment	1
GetTSFragment	1
GetImages	Maximale Anzahl angeforderter Bilder

Bei einem Kontingent von 500 Fragmentmedien pro Sekunde werden beispielsweise die folgenden Aufrufmuster für einen bestimmten Stream unterstützt:

• 5 Anfragen pro Sekunde bis GetClip zu 100 Fragmente in jedem Clip.

• 100 Anfragen pro Sekunde bis GetClip mit 5 Fragmenten in jedem Clip.

• 2 Anfragen pro Sekunde GetClip mit 100 Fragmenten in jedem Clip und 3 Anfragen pro Sekunde GetMediaForFragmentList in jedem Clip.

• 400 Anfragen pro Sekunde an GetMP4MediaFragment und 100 Anfragen pro Sekunde anGetTSFragment.

Diese Kontingente haben wichtige Auswirkungen auf die Anzahl der HLS- und MPEG-DASH-Sitzungen, die pro Stream unterstützt werden können. Die Anzahl der HLS- und DASH-Sitzungen, die von Mediaplayern zu einem bestimmten Zeitpunkt verwendet werden können, ist unbegrenzt. Daher ist es wichtig, dass die Wiedergabeanwendung nicht zulässt, dass zu viele Sitzungen gleichzeitig verwendet werden. In den folgenden beiden Beispielen wird beschrieben, wie Sie die Anzahl der gleichzeitigen Wiedergabesitzungen ermitteln, die unterstützt werden können:

Beispiel 1: Live-Streaming

In einem Live-Streaming-Szenario mit HLS, Fragmenten mit einer Dauer von 1 Sekunde, einer Audio- und Videospur und einer MaxMediaPlaylistFragmentResults Einstellung von fünf führt ein Media Player in der Regel zwei Aufrufe GetHLSMediaPlaylist pro Sekunde durch. Ein Anruf bezieht sich auf die neuesten Videometadaten und ein anderer auf die entsprechenden Audio-Metadaten. Die beiden Aufrufe verbrauchen jeweils fünf Quotenpunkte für Fragmentmetadaten. Außerdem werden zwei Aufrufe GetMP4MediaFragment pro Sekunde getätigt: ein Anruf für das neueste Video und ein weiterer für das entsprechende Audio. Jeder Anruf verbraucht ein einzelnes Fragment-Medientoken, sodass insgesamt zwei Token verbraucht werden.

In diesem Szenario können bis zu 250 gleichzeitige Wiedergabesitzungen unterstützt werden. Bei 250 Sitzungen verbraucht dieses Szenario 2.500 Fragmentmetadaten-Kontingentpunkte pro Sekunde (deutlich unter dem Kontingent von 10.000) und 500 Fragmentmedienkontingentpunkte pro Sekunde.

Beispiel 2: Wiedergabe auf Abruf

In einem On-Demand-Wiedergabe-Szenario eines vergangenen Ereignisses mit MPEG-DASH, einer Audio- und Videospur, die auf 1.000 MaxManifestFragmentResults eingestellt ist, ruft ein Media Player normalerweise GetDASHManifest einmal zu Beginn der Sitzung auf (verbraucht 1.000 Fragmentmetadaten-Quota-Punkte) und ruft mit einer GetMP4MediaFragment Geschwindigkeit von bis zu 5 Mal pro Sekunde auf (verbraucht 5 Fragment-Medienkontingentpunkte), bis alle Fragmente geladen sind. In diesem Szenario können bis zu 10 neue Sitzungen pro Sekunde gestartet werden (genau bei der Quote von 10.000 Fragmentmetadaten pro Sekunde), und bis zu 100 Sitzungen können Fragmentmedien mit einer Geschwindigkeit von 5 pro Sekunde aktiv laden (genau bei der Quote von 500 Fragmentmedien pro Sekunde).

Sie können ArchivedFragmentsConsumed.Metadata und verwendenArchivedFragmentsConsumed.Media, um den Verbrauch von Fragment-Metadaten bzw. Quotenpunkten für Fragmentmedien zu überwachen. Hinweise zur Überwachung finden Sie unterÜberwachung von Amazon Kinesis Video Streams.

Kontingente für Fragmentmetad

Die folgenden Dienstkontingente gelten für das Hinzufügen von Fragment-Metadaten zu Fragmenten in einem Kinesis-Videostream:

• Sie können einem Fragment bis zu 10 Metadatenelemente voranstellen.

• Der Metadaten-Name eines Fragments kann bis zu 128 Bytes lang sein.

• Der Metadaten-Wert eines Fragments kann bis zu 256 Bytes lang sein.

• Der Name eines Fragment-Metadaten darf nicht mit der Zeichenfolge "AWS" beginnen. Wenn ein entsprechendes Metadatenelement hinzugefügt wird, gibt die Methode putFragmentMetadata im PIC einen STATUS_INVALID_METADATA_NAME-Fehler (Fehlercode 0x52000077) zurück. Ihre Anwendung kann dann entweder den Fehler ignorieren (der PIC fügt das Metadatenelement nicht hinzu) oder auf den Fehler reagieren.

Stream-Tags

Diese Metadaten-Schlüssel-Wert-Paare gelten für die gesamte Kinesis Video Streams Streams-Ressource, nicht für einzelne Fragmente, die in einem Kinesis-Videostream enthalten sind.

Jeder Kinesis-Videostream unterstützt bis zu 50 Tags.

Einschränkungen TagStream für die Schlüssel und Werte von Stream-Tags finden Sie unter.