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.
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.
API-Dienstkontingente auf Kontrollebene
Im folgenden Abschnitt werden Dienstkontingente für die Kontrollebene beschrieben APIs. TPS steht 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äte CLIs, SDK-gesteuerter Zugriff und die Konsole können alle diese API aufrufen. 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 | ||
| 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 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.
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 |
|
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] | |
| Holen Sie sich die SessionUrl DASHStreaming | 25 TPS [h] | N/A | – | N/A | |
| Holen Sie sich die SessionURL HLSStreaming | 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 TPS [h] | 3 [s] | 25 MB/s oder 200 Mbit/s [s] | Es können maximal 5 Fragmente pro Sekunde [h] gesendet werden | 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 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. |
API-Dienstkontingente für das Videowiedergabeprotokoll
| API | Grenzwerte auf Sitzungsebene | Grenzwerte auf Fragmentebene |
|---|---|---|
| DASHManifestPlaylist abrufen | 5 TPS [h] | Maximale Anzahl von Fragmenten pro Playlist: 5.000 [h] |
| HLSMasterPlaylist abrufen | 5 TPS [h] | N/A |
| HLSMediaPlaylist abrufen | 5 TPS [h] | Maximale Anzahl von Fragmenten pro Playlist: 5.000 [h] |
| Holen MP4 InitFragment | 5 TPS [h] | N/A |
| Holen MP4 MediaFragment | 20 TPS [h] | N/A |
| Holen TSFragment | 20 TPS [h] | N/A |
Fragment-Metadaten und Kontingente für fragmentierte Medien
Kinesis Video 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 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 geteilt APIs. 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, gibt die API 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. Die 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- 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 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 entsprechendes Metadatenelement hinzugefügt wird, gibt die MethodeputFragmentMetadataim PIC einenSTATUS_INVALID_METADATA_NAME-Fehler (Fehlercode0x52000077) zurück. Ihre Anwendung kann dann entweder den Fehler ignorieren (der PIC fügt das Metadatenelement nicht hinzu) oder auf den Fehler reagieren.
SDK-Kontingente für Produzenten
Die folgende Tabelle enthält die aktuellen Kontingente für Werte im SDK. Weitere Informationen finden Sie unter Zu Kinesis Video Streams hochladen.
Anmerkung
Bevor Sie diese Werte festlegen, müssen Sie Ihre Eingabe überprüfen. Das SDK prüft diese Limits nicht. Wenn sie überschritten werden, treten Laufzeitfehler auf.
| 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 URI string length (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. Dabei handelt es sich um den SDK-Standard. |
| Max cluster duration (Max. Cluster-Dauer) | 30 Sekunden | Der Wert wird in Einheiten von 100 ns angegeben. Dabei handelt es sich um den SDK-Standard. Die 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 baut innerhalb dieses Zeitraums eine neue Verbindung auf. |
| Max ACK segment length (Max. ACK-Segmentlänge) | 1,024 Zeichen | Maximale Segmentlänge der an die ACK-Parser-Funktion gesendeten Empfangsbestä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-Skalierungswert zur Darstellung der Frame-Zeitstempel im resultierenden MKV-Cluster. Der Wert wird in Inkrementen von 100 ns angegeben. Dabei handelt es sich um den SDK-Standard. |
| Max timecode scale value length (Max. Länge des Timecode-Skalierungswertes) | 1 Sekunde | Der maximale Timecode-Skalierungswert zur Repräsentierung der Frame-Zeitstempel im resultierenden MKV-Cluster. Der Wert wird in Inkrementen von 100 ns angegeben. Dabei handelt es sich um den SDK-Standard. |
| Min content view item count (Min. Elementanzahl der Inhaltsansicht) | 10 | |
| Min buffer duration (Min. Dauer der Pufferung) | 20 Sekunden | Der Wert wird in Inkrementen von 100 ns angegeben. Dabei handelt es sich um den SDK-Standard. |
| Max update version length (Max. Länge der Aktualisierungsversion) | 128 Zeichen | |
| Max ARN length (Max. ARN-Länge) | 1024 Zeichen | |
| Max fragment sequence length (Max. Länge der Fragmentsequenz) | 128 Zeichen | |
| Maximaler Aufbewahrungszeitraum | 10 Jahre |
