Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
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
| API | Kontolimit: Anfrage | Kontolimit: Streams | Grenzwerte auf Stream-Ebene | Relevante Ausnahmen und Hinweise |
|---|---|---|---|---|
| CreateStream | 50 TPS [s] | 10.000 Streams pro Konto (en) in allen unterstützten Regionen. AnmerkungDieses 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/ |
GeräteCLIs, SDK -gesteuerter Zugriff und die Konsole können dies alle 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 einerGetMediaForFragmentList-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 |
|
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]. AnmerkungDer Mindestwert für |
| 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
|
| 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: 5.000 [h] |
| G etHLSMaster Playlist | 5 TPS [h] | N/A |
| G etHLSMedia Playlist | 5 TPS [h] | Maximale Anzahl von Fragmenten pro Playlist: 5.000 [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.
Kontingentverbrauch von Fragment-Metadaten
| API | Anzahl der pro Anfrage verbrauchten Kontingentpunkte | Geteiltes Kontingent (N) |
|---|---|---|
ListFragments |
Wert des MaxResults Parameters |
10.000 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 fragmentarischer Medienkontingente
| 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
GetClipzu 100 Fragmente in jedem Clip. -
100 Anfragen pro Sekunde bis
GetClipmit 5 Fragmenten in jedem Clip. 2 Anfragen pro Sekunde
GetClipmit 100 Fragmenten in jedem Clip und 3 Anfragen pro SekundeGetMediaForFragmentListin jedem Clip.400 Anfragen pro Sekunde an
GetMP4MediaFragmentund 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 dieputFragmentMetadataMethode in der einenSTATUS_INVALID_METADATA_NAMEFehler (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 |
