GetMediaForFragmentList - Amazon Kinesis Video Streams

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

GetMediaForFragmentList

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

注記

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

制限については、「Kinesis Video Streams Limits」を参照してください。

重要

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

  • x-amz-ErrorType HTTP ヘッダー — HTTP ステータスコードで提供されるものに加えて、より具体的なエラータイプが含まれます。

  • x-amz-RequestIdHTTP ヘッダー — に問題を報告したい場合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 です。

パターン: ^[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 です。

パターン:[a-zA-Z0-9_.-]+

必須: いいえ

レスポンスの構文

HTTP/1.1 200 Content-Type: ContentType Payload

レスポンス要素

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

レスポンスでは、以下の HTTP ヘッダーが返されます。

ContentType

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

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

パターン: ^[a-zA-Z0-9_\.\-]+$

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

Payload

Kinesis Video Streams が返すペイロードは、指定されたストリームからのチャンクのシーケンスです。チャンクについて詳しくは、を参照してください。PutMediaKinesis 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-例外に関するテキストによる説明。

エラー

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

ClientLimitExceededException

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

HTTP ステータスコード:400

InvalidArgumentException

指定されたパラメータが制限を超えているか、サポートされていない、または使用できません。

HTTP ステータスコード:400

NotAuthorizedException

ステータスコード: 403 呼び出し元が指定されたストリームで操作を実行する権限がないか、トークンの有効期限が切れています。

HTTP ステータスコード: 401

ResourceNotFoundException

GetImagesKinesis ビデオストリームが指定したストリームを見つけられない場合、このエラーが発生します。

GetHLSStreamingSessionURLまた、要求された時間範囲内にフラグメントがないストリームに対して PlaybackMode of ON_DEMAND LIVE_REPLAY またはのセッションが要求された場合、または過去 30 秒以内にフラグメントのないストリームに対して PlaybackMode of LIVE のセッションが要求された場合に、GetDASHStreamingSessionURLこのエラーが発生します。

HTTP ステータスコード: 404

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

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