Kontingente für den Amazon Kinesis Video Streams Streams-Service

Kinesis Video Streams hat die folgenden Servicequotas:

Wichtig

Die folgenden Servicekontingente sind entweder weich [s], die durch Einreichung eines Supporttickets aktualisiert werden können, oder hart [h], die nicht erhöht werden können. In den folgenden Tabellen werden neben den einzelnen Servicekontingenten [s] und [h] angezeigt.

APIServicekontingente auf Kontrollebene

Im folgenden Abschnitt werden die Servicekontingenten für die Steuerungsebene beschriebenAPIs. TPSsteht für Transaktionen pro Sekunde.

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

Servicekontingente auf Kontrollebene API
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.		Alle GeräteCLIs, SDK -gesteuerter Zugriff und die Konsole können dies aufrufen. API Nur ein API Aufruf ist erfolgreich, wenn der Stream noch nicht existiert.
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
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]

Kontingente für Medien- und Archivmediendienste API

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

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.

Dienstkontingente auf Datenebene API
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 Anfrage enthält Daten für mehrere Sekunden, was zu einem niedrigeren Wert 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]
G-Sitzung etDASHStreaming URL	25 TPS [h]	N/A	–	N/A
etHLSStreamingG-Sitzung URL	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 [h] TPS	3 [s]	25 MB/s oder 200 Mbit/s [s]	Pro Sekunde werden maximal 5 Fragmente gesendet [h]	Ein einzelner Client sollte nicht mehr als zwei oder drei benötigen, TPS da die Anwendung nach dem Verbindungsaufbau kontinuierlich lesen sollte. Wenn ein typisches Fragment ungefähr 5 MB groß ist, bedeutet dieser Grenzwert ~75 MBps 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.

Dienstkontingente für das Videowiedergabeprotokoll API
API	Grenzwerte auf Sitzungsebene	Grenzwerte auf Fragmentebene
etDASHManifestG-Wiedergabeliste	5 TPS [h]	Maximale Anzahl von Fragmenten pro Playlist: 5000 [h]
G etHLSMaster Playlist	5 TPS [h]	N/A
G etHLSMedia Playlist	5 TPS [h]	Maximale Anzahl von Fragmenten pro Playlist: 5000 [h]
Holen MP4InitFragment	5 TPS [h]	N/A
Holen MP4MediaFragment	20 TPS [h]	N/A
G etTSFragment	20 TPS [h]	N/A

Fragment-Metadaten und Kontingente für fragmentierte Medien

Kinesis Video Streams APIsfür den Zugriff auf archivierte Medien werden anhand der Anzahl der angeforderten Fragmente und nicht anhand der Anzahl der Aufrufe gedrosselt. API APIssind sowohl durch die Anzahl der Fragment-Metadaten als auch durch die Anzahl der angeforderten Fragmentmedien ratenbegrenzt. 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 geteiltAPIs. Das bedeutet, dass für einen bestimmten Stream Anfragen nach Fragmenten aus verschiedenen Quellen dasselbe Kontingent APIs verbrauchen. Wenn entweder das Fragmentmetadaten- oder das Fragmentmedienkontingent für einen Stream überschritten wird, API gibt der a zurückClientLimitExceededException. Die folgenden Tabellen zeigen, wie die beiden Kontingenttypen APIs verbrauchen. Gehen Sie für die zweite Spalte in diesen Tabellen davon aus, dass ein Stream ein Kontingent von N hat, das bedeutet, dass er N Punkte von diesem Quotentyp für diesen Stream verbrauchen APIs muss. Das 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 MPEG DASH UND-Sitzungen, die pro Stream unterstützt werden können. Die Anzahl der HLS DASH UND-Sitzungen, die von Media-Playern 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 HLS mit 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 und der MaxManifestFragmentResults Einstellung 1.000, ruft ein Media Player normalerweise GetDASHManifest einmal zu Beginn der Sitzung auf (verbraucht 1.000 Quota-Punkte für Fragmentmetadaten) 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 Streaming-Metadaten

Die folgenden Dienstkontingente gelten für das Hinzufügen von Streaming-Metadaten zu 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 solches Metadatenelement hinzugefügt wird, gibt die putFragmentMetadata Methode in der einen STATUS_INVALID_METADATA_NAME Fehler (Fehlercode0x52000077) PIC zurück. Ihre Anwendung kann den Fehler dann entweder ignorieren (das Metadatenelement wird PIC nicht hinzugefügt) oder auf den Fehler reagieren.

SDKKontingente für Produzenten

Die folgende Tabelle enthält die aktuellen Kontingente für Werte in. SDK Weitere Informationen finden Sie unter Zu Kinesis Video Streams hochladen.

Anmerkung

Bevor Sie diese Werte festlegen, müssen Sie Ihre Eingabe überprüfen. Die validiert diese Grenzwerte SDK nicht, und es tritt ein Laufzeitfehler auf, wenn die Grenzwerte überschritten werden.

Wert	Limit	Hinweise
Max stream count (Max. Stream-Anzahl)	128	Die maximale Anzahl von Streams, die ein Producer-Objekt erstellen kann. Dies ist ein weiches Limits (Sie können eine Erhöhung beantragen). Es garantiert, dass der Producer nicht versehentlich rekursiv Streams erstellt.
Max device name length (Max. Länge des Gerätenamens)	128 Zeichen
Max tag count (Max. Tag-Anzahl)	50 pro Stream
Max stream name length (Max. Länge des Stream-Namens)	256 Zeichen
Min storage size (Min. Speichergröße)	10 MiB = 10 x 1024 x 1024 Byte
Max storage size (Max. Speichergröße)	10 GiB = 10 x 1024 x 1024 x 1024 Byte
Max root directory path length (Max. Länge des Stammverzeichnispfades)	4,096 Zeichen
Max auth info length (Max. Länge der Authentifizierungsinformationen)	10,000 Bytes
Max. Länge der URI Zeichenfolge	10,000 Zeichen
Max tag name length (Max. Länge des Tag-Namens)	128 Zeichen
Max tag value length (Max. Länge des Tag-Wertes)	1,024 Zeichen
Min security token period (Min. Zeitraum des Sicherheits-Tokens)	30 Sekunden
Security token grace period (Übergangsfrist des Sicherheits-Tokens)	40 Minuten	Wenn die angegebene Dauer länger ist, ist sie auf diesen Wert begrenzt.
Aufbewahrungszeitraum	0 oder mehr als eine Stunde	0 bedeutet keine Aufbewahrung.
Min cluster duration (Min. Cluster-Dauer)	1 Sekunde	Der Wert wird in Einheiten von 100 ns angegeben, was der SDK Standard ist.
Max cluster duration (Max. Cluster-Dauer)	30 Sekunden	Der Wert wird in 100-ns-Einheiten angegeben, was der SDK Standard ist. Das Backend API kann eine kürzere Cluster-Dauer erzwingen.
Max fragment size (Max. Fragmentgröße)	50 MB	Weitere Informationen finden Sie unter Kontingente für den Amazon Kinesis Video Streams Streams-Service.
Max fragment duration (Max. Fragmentdauer)	20 Sekunden	Weitere Informationen finden Sie unter Kontingente für den Amazon Kinesis Video Streams Streams-Service.
Max connection duration (Max. Verbindungsdauer)	45 Minuten	Die Backend schließt die Verbindung nach Verstreichen dieser Frist. Das SDK rotiert das Token und stellt innerhalb dieser Zeit eine neue Verbindung her.
Max. ACK Segmentlänge	1,024 Zeichen	Maximale Segmentlänge der an die ACK Parser-Funktion gesendeten Bestätigung.
Max content type string length (Max. Zeichenfolgenlänge des Inhaltstyps)	128 Zeichen
Max codec ID string length (Max. Zeichenfolgenlänge der Codec-ID)	32 Zeichen
Max track name string length (Max. Zeichenfolgenlänge des Tracknamens)	32 Zeichen
Max codec private data length (Max. Länge privater Codec-Daten)	1 MiB = 1 x 1024 x 1024 Byte
Min timecode scale value length (Min. Länge des Timecode-Skalierungswertes)	100 ns	Der minimale Timecode-Skalenwert zur Darstellung der Frame-Zeitstempel im resultierenden Cluster. MKV Der Wert wird in Schritten von 100 ns angegeben, was der Standard ist. SDK
Max timecode scale value length (Max. Länge des Timecode-Skalierungswertes)	1 Sekunde	Der maximale Timecode-Skalenwert zur Darstellung der Frame-Zeitstempel im resultierenden Cluster. MKV Der Wert wird in Schritten von 100 ns angegeben, was der Standard ist. SDK
Min content view item count (Min. Elementanzahl der Inhaltsansicht)	10
Min buffer duration (Min. Dauer der Pufferung)	20 Sekunden	Der Wert wird in Schritten von 100 ns angegeben, was der SDK Standard ist.
Max update version length (Max. Länge der Aktualisierungsversion)	128 Zeichen
Max. Länge ARN	1024 Zeichen
Max fragment sequence length (Max. Länge der Fragmentsequenz)	128 Zeichen
Maximaler Aufbewahrungszeitraum	10 Jahre