リクエストの構文 URI リクエストパラメータリクエスト本文レスポンスの構文レスポンス要素エラー以下の資料も参照してください。

GetMediaForFragmentList

Amazon Kinesis ビデオストリームのアーカイブデータからフラグメント（フラグメント番号で指定）のリストのメディアを取得します。

注記

エンドポイントを取得するには、まず GetDataEndpointAPIを呼び出す必要があります。次に、--endpoint-url parameter を使用して GetMediaForFragmentList リクエストをこのエンドポイントに送信します。

制限については、「Kinesis Video Streams のクォータ」を参照してください。

重要

Kinesis Video Streams アーカイブメディアを呼び出した後にエラーがスローされた場合API、HTTPステータスコードとレスポンス本文に加えて、次の情報が含まれます。

x-amz-ErrorType HTTP header – HTTPステータスコードが提供するものに加えて、より具体的なエラータイプが含まれます。
x-amz-RequestId HTTP ヘッダー — 問題をに報告したい場合 AWS、リクエスト ID が与えられていれば、サポートチームが問題をより適切に診断できます。

HTTP ステータスコードと ErrorType ヘッダーの両方を使用して、エラーが再試行可能かどうか、どのような条件下で再試行できるかをプログラムで決定したり、クライアントプログラマーが再試行を正常に行うためにどのようなアクションを実行する必要があるかに関する情報を提供したりできます。

詳細については、このトピックの下部にある[Errors] (エラー) セクションおよび「Common Errors」を参照してください。

リクエストの構文


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

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

URI リクエストパラメータ

リクエストはURIパラメータを使用しません。

リクエスト本文

リクエストは、 JSON形式の次のデータを受け入れます。

Fragments

メディアを取得するフラグメントの数のリスト。これらの値は、ListFragments で取得します。

型: 文字列の配列

配列メンバー：最小数は 1 項目です。最大数は 1000 項目です。

長さの制限：最小長は 1 です。最大長は 128 です。

Pattern: ^[0-9]+$

必須：はい

StreamARN

フラグメントメディアを取得するストリームの 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

フラグメントメディアを取得するストリームの名前。このパラメータ、または StreamARN パラメータのいずれかを指定してください。

型: 文字列

長さの制限：最小長は 1 です。最大長は 256 です。

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

必須：いいえ

レスポンスの構文


HTTP/1.1 200
Content-Type: ContentType

Payload

レスポンス要素

アクションが成功すると、サービスは 200 HTTP レスポンスを返します。

レスポンスは次のHTTPヘッダーを返します。

ContentType

リクエストされたメディアのコンテンツタイプ

長さの制限：最小長は 1 です。最大長は 128 です。

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

レスポンスは本文として以下を返しますHTTP。

Payload

Kinesis Video Streams が返すペイロードは、指定されたストリームからのチャンクのシーケンスです。チャンクの詳細については、「」を参照してくださいPutMedia。Kinesis Video Streams がGetMediaForFragmentList呼び出しで返すチャンクには、次の追加の Matroska (MKV) タグも含まれます。

AWS_KINESISVIDEO_FRAGMENT_NUMBER - チャンクで返されるフラグメント番号。
AWS_KINESISVIDEOSERVER_SIDE_TIMESTAMP - フラグメントのサーバー側のタイムスタンプ。
AWS_KINESISVIDEOPRODUCER_SIDE_TIMESTAMP - フラグメントのプロデューサー側のタイムスタンプ。

例外が発生した場合、次のタグが含まれます。

AWS_KINESISVIDEO_FRAGMENT_NUMBER - 例外をスローしたフラグメントの数。
AWS_KINESISVIDEO_EXCEPTIONERROR_CODE - エラーの整数コード。
AWS_KINESISVIDEO_EXCEPTION_MESSAGE - 例外のテキスト説明。

エラー

すべてのアクションに共通のエラーについては、「共通エラー」を参照してください。

ClientLimitExceededException

制限を超えたため、Kinesis Video Streams がリクエストをスロットリングしました。後で呼び出しを試みてください。制限の詳細については、「Kinesis Video Streams のクォータ」を参照してください。

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

以下の資料も参照してください。

言語固有ののいずれかAPIでこれを使用する方法の詳細については AWS SDKs、以下を参照してください。

ブラウザで JavaScript が無効になっているか、使用できません。

AWS ドキュメントを使用するには、JavaScript を有効にする必要があります。手順については、使用するブラウザのヘルプページを参照してください。

ドキュメントの表記規則

GetImages

ListFragments