GetImages

Der Endzeitstempel für den Bereich der zu generierenden Bilder. Liegt der Zeitbereich zwischen StartTimestamp und EndTimestamp mehr als 300 Sekunden darüberStartTimestamp, erhalten Sie eineIllegalArgumentException.

Typ: Zeitstempel

Erforderlich: Ja

Das Format, das zum Codieren des Bilds verwendet wird.

Typ: Zeichenfolge

Zulässige Werte: JPEG | PNG

Erforderlich: Ja

Die Liste einer Struktur mit Schlüssel-Wert-Paaren, die zusätzliche Parameter enthält, die bei der Generierung des Bildes angewendet werden können. Der FormatConfig Schlüssel ist derJPEGQuality, der den JPEG-Qualitätsschlüssel angibt, der zur Generierung des Bildes verwendet werden soll. Der FormatConfig Wert akzeptiert Ganzzahlen von 1 bis 100. Wenn der Wert 1 ist, wird das Bild mit geringerer Qualität und der besten Komprimierung generiert. Wenn der Wert 100 ist, wird das Bild mit der besten Qualität und weniger Komprimierung generiert. Wenn kein Wert angegeben wird, wird der Standardwert des JPEGQuality Schlüssels auf 80 gesetzt.

Typ: Abbildung einer Zeichenfolge auf eine Zeichenfolge

Karteneinträge: Maximale Anzahl von 1 Element.

Gültige Schlüssel: JPEGQuality

Längenbeschränkungen für Werte: Mindestlänge von 0. Maximale Länge beträgt 256 Zeichen.

Wertemuster: ^[a-zA-Z_0-9]+

Erforderlich: Nein

Die Höhe des Ausgabebilds, das in Verbindung mit dem WidthPixels Parameter verwendet wird. Wenn HeightPixels sowohl als auch WidthPixels Parameter angegeben sind, wird das Bild gestreckt, sodass es dem angegebenen Seitenverhältnis entspricht. Wenn nur der HeightPixels Parameter angegeben wird, wird das ursprüngliche Seitenverhältnis zur Berechnung des WidthPixels Verhältnisses verwendet. Wenn keiner der Parameter angegeben wird, wird die ursprüngliche Bildgröße zurückgegeben.

Typ: Ganzzahl

Gültiger Bereich: Mindestwert 1. Maximalwert von 2160.

Erforderlich: Nein

Der Ursprung der Server- oder Producer-Zeitstempel, die zur Generierung der Bilder verwendet werden sollen.

Typ: Zeichenfolge

Zulässige Werte: PRODUCER_TIMESTAMP | SERVER_TIMESTAMP

Erforderlich: Ja

Die maximale Anzahl von Bildern, die von der API zurückgegeben werden sollen.

Type: Long

Gültiger Bereich: Mindestwert 1. Maximalwert 100.

Erforderlich: Nein

Ein Token, das angibt, wo mit der Paginierung der nächsten Gruppe von Bildern begonnen werden soll. Dies ist das Ergebnis GetImages:NextToken einer zuvor gekürzten Antwort.

Typ: Zeichenfolge

Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 4096 Zeichen.

Pattern: [a-zA-Z0-9+/]+={0,2}

Erforderlich: Nein

Das Zeitintervall in Millisekunden (ms), in dem die Bilder aus dem Stream generiert werden müssen. Der Mindestwert, der bereitgestellt werden kann, ist 200 ms (5 Bilder pro Sekunde). Wenn der Zeitstempelbereich unter dem Abtastintervall liegt, startTimestamp wird das Bild von zurückgegeben, sofern verfügbar.

Typ: Ganzzahl

Erforderlich: Ja

Der Startpunkt, von dem aus die Bilder generiert werden sollen. Damit ein Bild zurückgegeben werden kann, StartTimestamp muss dieser Wert innerhalb eines gültigen Zeitstempelbereichs liegen.

Typ: Zeitstempel

Erforderlich: Ja

Der Amazon-Ressourcenname (ARN) des Streams, aus dem die Bilder abgerufen werden sollen. Sie müssen entweder den StreamName oder den angebenStreamARN.

Typ: Zeichenfolge

Längenbeschränkungen: Minimale Länge von 1. Maximale Länge beträgt 1024 Zeichen.

Pattern: arn:[a-z\d-]+:kinesisvideo:[a-z0-9-]+:[0-9]+:[a-z]+/[a-zA-Z0-9_.-]+/[0-9]+

Erforderlich: Nein

Der Name des Streams, aus dem die Bilder abgerufen werden sollen. Sie müssen entweder den StreamName oder den angebenStreamARN.

Typ: Zeichenfolge

Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 256 Zeichen.

Pattern: [a-zA-Z0-9_.-]+

Erforderlich: Nein

Die Breite des Ausgabebilds, das in Verbindung mit dem HeightPixels Parameter verwendet wird. Wenn WidthPixels sowohl als auch HeightPixels Parameter angegeben sind, wird das Bild gestreckt, sodass es dem angegebenen Seitenverhältnis entspricht. Wenn nur der WidthPixels Parameter angegeben wird oder wenn nur der angegeben HeightPixels wird, ValidationException wird a ausgelöst. Wenn keiner der Parameter angegeben wird, wird die ursprüngliche Bildgröße aus dem Stream zurückgegeben.

Typ: Ganzzahl

Gültiger Bereich: Mindestwert 1. Der Maximalwert ist 3840.

Erforderlich: Nein

Die Liste der aus dem Videostream generierten Bilder. Wenn für den angegebenen Zeitstempel kein Medium verfügbar ist, wird der NO_MEDIA Fehler in der Ausgabe aufgeführt. Wenn während der Generierung des Bildes ein Fehler auftritt, MEDIA_ERROR wird dieser in der Ausgabe als Ursache für das fehlende Bild aufgeführt.

Typ: Array von Image-Objekten

Das verschlüsselte Token, das in der Anfrage zum Abrufen weiterer Bilder verwendet wurde.

Typ: Zeichenfolge

Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 4096 Zeichen.

Pattern: [a-zA-Z0-9+/]+={0,2}

Kinesis Video Streams hat die Anfrage gedrosselt, weil Sie ein Limit überschritten haben. Versuchen Sie später, den Anruf zu tätigen. Informationen zu Limits finden Sie unter Kinesis Video Streams Streams-Limits.

HTTP Status Code: 400

Ein bestimmter Parameter überschreitet seine Beschränkungen, wird nicht unterstützt oder kann nicht verwendet werden.

HTTP Status Code: 400

Statuscode: 403, Der Aufrufer ist nicht berechtigt, einen Vorgang mit dem angegebenen Stream auszuführen, oder das Token ist abgelaufen.

HTTP-Statuscode: 401

GetImageslöst diesen Fehler aus, wenn Kinesis Video Streams den von Ihnen angegebenen Stream nicht finden kann.

GetHLSStreamingSessionURLund GetDASHStreamingSessionURL gibt diesen Fehler aus, wenn eine Sitzung mit einem PlaybackMode of ON_DEMAND oder für einen Stream angefordert LIVE_REPLAY wird, der innerhalb des angeforderten Zeitraums keine Fragmente enthält, oder wenn eine Sitzung mit einem PlaybackMode of für einen Stream angefordert LIVE wird, der innerhalb der letzten 30 Sekunden keine Fragmente enthält.

HTTP Status Code: 404