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 die `GetDataEndpoint` API aufrufen, um einen Endpunkt zu erhalten. Senden Sie dann die `GetMediaForFragmentList` Anfragen mit dem Parameter [--endpoint-url an diesen Endpunkt](https://docs.aws.amazon.com/cli/latest/reference/). Grenzwerte finden Sie unter [Kinesis Video Streams Streams-Kontingente](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/limits.html). **Wichtig** Wenn nach dem Aufrufen einer Kinesis Video Streams Streams-API für archivierte Medien ein Fehler ausgelöst wird, enthält dieser zusätzlich zum HTTP-Statuscode und dem Antworttext die folgenden Informationen: `x-amz-ErrorType`HTTP-Header — enthält zusätzlich zu dem, was der HTTP-Statuscode bietet, einen spezifischeren Fehlertyp. `x-amz-RequestId`HTTP-Header — 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 Informationen darüber bereitgestellt werden, 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.](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/CommonErrors.html) ## Anforderungssyntax ``` POST /getMediaForFragmentList HTTP/1.1 Content-type: application/json { "Fragments": [ "{{string}}" ], "StreamARN": "{{string}}", "StreamName": "{{string}}" } ``` ## URI-Anfrageparameter Die Anforderung verwendet keine URI-Parameter. ## Anforderungstext Die Anforderung akzeptiert die folgenden Daten im JSON-Format. ** [Fragments](#API_reader_GetMediaForFragmentList_RequestSyntax) ** Eine Liste der Fragmente, für die Medien abgerufen werden sollen. Sie rufen diese Werte mit ab[ListFragments](API_reader_ListFragments.md). 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](#API_reader_GetMediaForFragmentList_RequestSyntax) ** 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](#API_reader_GetMediaForFragmentList_RequestSyntax) ** 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 Service eine HTTP 200-Antwort zurück. Die Antwort gibt die folgenden HTTP-Header zurück. ** [ContentType](#API_reader_GetMediaForFragmentList_ResponseSyntax) ** 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](#API_reader_GetMediaForFragmentList_ResponseSyntax) ** 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](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_dataplane_PutMedia.html) 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 Fragmentnummer wurde im Chunk zurückgegeben. + AWS\_KINESISVIDEO\_SERVER\_SIDE\_TIMESTAMP - Serverseitiger Zeitstempel des Fragments. + AWS\_KINESISVIDEO\_PRODUCER\_SIDE\_TIMESTAMP - Herstellerseitiger Zeitstempel des Fragments. Die folgenden Tags werden hinzugefügt, 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 Fehlertypen](CommonErrors.md). ** 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](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/limits.html). HTTP-Statuscode: 400 ** InvalidArgumentException ** Ein angegebener Parameter überschreitet seine Beschränkungen, wird nicht unterstützt oder kann nicht verwendet werden. HTTP-Statuscode: 400 ** NotAuthorizedException ** Statuscode: 403, Der Aufrufer ist nicht berechtigt, einen Vorgang mit dem angegebenen Stream auszuführen, oder das Token ist abgelaufen. HTTP-Statuscode: 401 ** ResourceNotFoundException ** `GetImages`löst diesen Fehler aus, wenn Kinesis Video Streams den von Ihnen angegebenen Stream nicht finden kann. `GetHLSStreamingSessionURL`und `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-Statuscode: 404 ## Weitere Informationen finden Sie unter: Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen AWS SDKs finden Sie im Folgenden: + [AWS Befehlszeilenschnittstelle V2](https://docs.aws.amazon.com/goto/cli2/kinesis-video-reader-data-2017-09-30/GetMediaForFragmentList) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesis-video-reader-data-2017-09-30/GetMediaForFragmentList) + [AWS SDK for C\+\+](https://docs.aws.amazon.com/goto/SdkForCpp/kinesis-video-reader-data-2017-09-30/GetMediaForFragmentList) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesis-video-reader-data-2017-09-30/GetMediaForFragmentList) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesis-video-reader-data-2017-09-30/GetMediaForFragmentList) + [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesis-video-reader-data-2017-09-30/GetMediaForFragmentList) + [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesis-video-reader-data-2017-09-30/GetMediaForFragmentList) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesis-video-reader-data-2017-09-30/GetMediaForFragmentList) + [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/kinesis-video-reader-data-2017-09-30/GetMediaForFragmentList) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesis-video-reader-data-2017-09-30/GetMediaForFragmentList)