GetMediaForFragmentList - Amazon Kinesis Video Streams
AnforderungssyntaxURIAnforderungsparameterAnforderungstextAntwortsyntaxAntwortelementeFehlerWeitere Informationen finden Sie unter:

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.

GetMediaForFragmentList

Ruft Medien für eine Liste von Fragmenten (angegeben durch die Fragmentnummer) aus den archivierten Daten in einem Amazon Kinesis Kinesis-Videostream ab.

Anmerkung

Sie müssen zuerst den aufrufen GetDataEndpointAPI, um einen Endpunkt zu erhalten. Senden Sie dann die GetMediaForFragmentList Anfragen mit dem Parameter --endpoint-url an diesen Endpunkt.

Grenzwerte finden Sie unter Kinesis Video Streams Streams-Kontingente.

Wichtig

Wenn nach dem Aufrufen eines archivierten Kinesis Video Streams Streams-Mediums ein Fehler ausgegeben wirdAPI, enthält dieser zusätzlich zum HTTP Statuscode und dem Antworttext die folgenden Informationen:

  • x-amz-ErrorTypeHTTPHeader — enthält zusätzlich zu dem, was der HTTP Statuscode angibt, einen spezifischeren Fehlertyp.

  • x-amz-RequestIdHTTPHeader — Wenn Sie ein Problem melden möchten AWS, kann das Support-Team das Problem anhand der Anforderungs-ID besser diagnostizieren.

Sowohl der HTTP Statuscode als auch der ErrorType Header können verwendet werden, um programmatische Entscheidungen darüber zu treffen, ob und unter welchen Bedingungen Fehler wiederholt werden können. Außerdem können sie Informationen darüber liefern, welche Maßnahmen der Client-Programmierer möglicherweise ergreifen muss, um es erneut erfolgreich zu versuchen.

Weitere Informationen finden Sie im Abschnitt Fehler am Ende dieses Themas sowie unter Häufige Fehler.

Anforderungssyntax

POST /getMediaForFragmentList HTTP/1.1
Content-type: application/json

{
   "Fragments": [ "string" ],
   "StreamARN": "string",
   "StreamName": "string"
}

URIAnforderungsparameter

Die Anfrage verwendet keine URI Parameter.

Anforderungstext

Die Anfrage akzeptiert die folgenden Daten im JSON Format.

Fragments

Eine Liste der Fragmente, für die Medien abgerufen werden sollen. Sie rufen diese Werte mit abListFragments.

Typ: Zeichenfolgen-Array

Array-Mitglieder: Die Mindestanzahl beträgt 1 Element. Die maximale Anzahl beträgt 1000 Elemente.

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

Pattern: ^[0-9]+$

Erforderlich: Ja

StreamARN

Der Amazon-Ressourcenname (ARN) des Streams, aus dem Fragmentmedien abgerufen werden sollen. Geben Sie entweder diesen Parameter oder den StreamName Parameter an.

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

StreamName

Der Name des Streams, aus dem Fragmentmedien abgerufen werden sollen. Geben Sie entweder diesen Parameter oder den StreamARN Parameter an.

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

Antwortsyntax

HTTP/1.1 200
Content-Type: ContentType

Payload

Antwortelemente

Wenn die Aktion erfolgreich ist, sendet der Dienst eine HTTP 200-Antwort zurück.

Die Antwort gibt die folgenden HTTP Header zurück.

ContentType

Der Inhaltstyp des angeforderten Mediums.

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

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

Die Antwort gibt Folgendes als HTTP Hauptteil zurück.

Payload

Die Payload, die Kinesis Video Streams zurückgibt, ist eine Sequenz von Chunks aus dem angegebenen Stream. Informationen zu den Chunks finden Sie unter. PutMedia Die Chunks, die Kinesis Video Streams im GetMediaForFragmentList Aufruf zurückgibt, enthalten auch die folgenden zusätzlichen Matroska () -Tags: MKV

  • AWS_ _ KINESISVIDEO FRAGMENT _ NUMBER — Die im Chunk zurückgegebene Fragmentnummer.

  • AWS_ _ KINESISVIDEO _ SERVER SIDE _ TIMESTAMP — Serverseitiger Zeitstempel des Fragments.

  • AWS_ _ KINESISVIDEO _ PRODUCER SIDE _ TIMESTAMP — Produzentenseitiger Zeitstempel des Fragments.

Die folgenden Tags werden aufgenommen, falls eine Ausnahme auftritt:

  • AWS_ KINESISVIDEO _ FRAGMENT _ NUMBER — Die Nummer des Fragments, das die Ausnahme ausgelöst hat.

  • AWS_ KINESISVIDEO _ EXCEPTION _ ERROR _ CODE — Der Integer-Code des Fehlers.

  • AWS_ KINESISVIDEO _ EXCEPTION _ MESSAGE — Eine Textbeschreibung der Ausnahme.

Fehler

Weitere Informationen zu den allgemeinen Fehlern, die bei allen Aktionen zurückgegeben werden, finden Sie unter Häufige Fehler.

ClientLimitExceededException

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

HTTPStatuscode: 400

InvalidArgumentException

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

HTTPStatuscode: 400

NotAuthorizedException

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

HTTPStatuscode: 401

ResourceNotFoundException

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.

HTTPStatuscode: 404

Weitere Informationen finden Sie unter:

Weitere Informationen zur Verwendung API in einer der sprachspezifischen Sprachen AWS SDKs finden Sie im Folgenden: