翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # GetMediaForFragmentList Amazon Kinesis ビデオストリームのアーカイブデータからフラグメント（フラグメント番号で指定）のリストのメディアを取得します。 **注記** エンドポイントを取得するには、最初に `GetDataEndpoint` API を呼び出す必要があります。次に、[--endpoint-url parameter](https://docs.aws.amazon.com/cli/latest/reference/) を使用して `GetMediaForFragmentList` リクエストをこのエンドポイントに送信します。 制限については、[「Kinesis Video Streams のクォータ](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/limits.html)」を参照してください。 **重要** Kinesis Video Streams アーカイブメディア API を呼び出した後にエラーがスローされた場合、HTTP ステータスコードとレスポンス本文に加えて、次の情報が含まれます。 `x-amz-ErrorType` HTTP ヘッダー — HTTP ステータスコードで提供されるものに加えて、より具体的なエラータイプが含まれます。 `x-amz-RequestId` HTTP ヘッダー – 問題を に報告する場合 AWS、リクエスト ID を指定すれば、サポートチームが問題をより適切に診断できます。 HTTP ステータスコードと ErrorType ヘッダーの両方を使用すれば、エラーが再試行可能かどうか、またはどのような条件下でエラーが再試行可能かについてプログラムで判断したり、クライアントプログラマーが再度試行するために必要なアクションに関する情報を提供したりできます。 詳細については、このトピックの下部にある**[Errors]** (エラー) セクションおよび「[Common Errors](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/CommonErrors.html)」を参照してください。 ## リクエストの構文 ``` POST /getMediaForFragmentList HTTP/1.1 Content-type: application/json { "Fragments": [ "{{string}}" ], "StreamARN": "{{string}}", "StreamName": "{{string}}" } ``` ## URI リクエストパラメータ リクエストでは URI パラメータを使用しません。 ## リクエストボディ リクエストは以下の JSON 形式のデータを受け入れます。 ** [Fragments](#API_reader_GetMediaForFragmentList_RequestSyntax) ** メディアを取得するフラグメントの数のリスト。これらの値は、[ListFragments](API_reader_ListFragments.md) で取得します。 型: 文字列の配列 配列メンバー: 最小数は 1 項目です。最大数は 1000 項目です。 長さの制限：最小長 1、最大長は 128 です。 パターン: `^[0-9]+$` 必須: はい ** [StreamARN](#API_reader_GetMediaForFragmentList_RequestSyntax) ** フラグメントメディアを取得するストリームの Amazon リソースネーム (ARN)。このパラメータ、または `StreamName` パラメータのいずれかを指定してください。 タイプ: 文字列 長さの制限: 最小長は 1 です。最大長は 1,024 です。 パターン: `arn:[a-z\d-]+:kinesisvideo:[a-z0-9-]+:[0-9]+:[a-z]+/[a-zA-Z0-9_.-]+/[0-9]+` 必須: いいえ ** [StreamName](#API_reader_GetMediaForFragmentList_RequestSyntax) ** フラグメントメディアを取得するストリームの名前。このパラメータ、または `StreamARN` パラメータのいずれかを指定してください。 タイプ: 文字列 長さの制約: 最小長は 1 です。最大長は 256 です。 パターン: `[a-zA-Z0-9_.-]+` 必須: いいえ ## レスポンスの構文 ``` HTTP/1.1 200 Content-Type: {{ContentType}} {{Payload}} ``` ## レスポンス要素 アクションが成功すると、サービスは HTTP 200 レスポンスを返します。 レスポンスでは、以下の HTTP ヘッダーが返されます。 ** [ContentType](#API_reader_GetMediaForFragmentList_ResponseSyntax) ** リクエストされたメディアのコンテンツタイプ 長さの制限：最小長 1、最大長は 128 です。 パターン: `^[a-zA-Z0-9_\.\-]+$` レスポンスは、HTTP 本文として以下を返します。 ** [Payload](#API_reader_GetMediaForFragmentList_ResponseSyntax) ** Kinesis Video Streams が返すペイロードは、指定されたストリームからのチャンクのシーケンスです。チャンクの詳細については、「[PutMedia](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_dataplane_PutMedia.html)」を参照してください。Kinesis Video Streams が `GetMediaForFragmentList` の呼び出しで返すチャンクには、次の追加の Matroska (MKV) タグも含まれます。 + AWS\_KINESISVIDEO\_FRAGMENT\_NUMBER - チャンクで返されるフラグメント番号。 + AWS\_KINESISVIDEO\_SERVER\_SIDE\_TIMESTAMP - フラグメントのサーバー側のタイムスタンプ。 + AWS\_KINESISVIDEO\_PRODUCER\_SIDE\_TIMESTAMP - フラグメントのプロデューサー側のタイムスタンプ。 例外が発生した場合、次のタグが含まれます。 + AWS\_KINESISVIDEO\_FRAGMENT\_NUMBER - 例外をスローしたフラグメントの数。 + AWS\_KINESISVIDEO\_EXCEPTION\_ERROR\_CODE - エラーの整数コード。 + AWS\_KINESISVIDEO\_EXCEPTION\_MESSAGE - 例外のテキスト説明。 ## エラー すべてのアクションに共通のエラーについては、「[一般的なエラータイプ](CommonErrors.md)」を参照してください。 ** ClientLimitExceededException ** 制限を超えたため、Kinesis Video Streams がリクエストをスロットリングしました。後で呼び出しを試みてください。制限の詳細については、[「Kinesis Video Streams のクォータ](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/limits.html)」を参照してください。 HTTP ステータスコード: 400 ** InvalidArgumentException ** 指定されたパラメータが制限を超えているか、サポートされていない、または使用できません。 HTTP ステータスコード: 400 ** NotAuthorizedException ** ステータスコード: 403 呼び出し元が指定されたストリームで操作を実行する権限がないか、トークンの有効期限が切れています。 HTTP ステータスコード: 401 ** ResourceNotFoundException ** `GetImages` Kinesis Video Streams が指定したストリームを見つけられない場合、 はこのエラーをスローします。 `GetHLSStreamingSessionURL` リクエストされた時間範囲内にフラグメントがないストリームに対して `ON_DEMAND`または `PlaybackMode`のセッション`LIVE_REPLAY`がリクエストされた場合、または過去 30 秒以内にフラグメントがないストリームに対して `PlaybackMode`のセッション`LIVE`がリクエストされた場合、 と はこのエラーを`GetDASHStreamingSessionURL`スローします。 HTTP ステータスコード: 404 ## 以下の資料も参照してください。 言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス 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 for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesis-video-reader-data-2017-09-30/GetMediaForFragmentList) + [AWS SDK for 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 for 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)