翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # GetClip 指定した時間範囲において、アーカイブされたオンデマンドメディアを含む MP4 ファイル (クリップ) を、指定したビデオストリームからダウンロードできます。 StreamName パラメーターと StreamARN パラメーターはどちらもオプションですが、この API 操作を呼び出すときは、StreamName または StreamARN のいずれかを指定する必要があります。 **注記** エンドポイントを取得するには、最初に `GetDataEndpoint` API を呼び出す必要があります。次に、[--endpoint-url parameter](https://docs.aws.amazon.com/cli/latest/reference/) を使用して `GetClip` リクエストをこのエンドポイントに送信します。 Amazon Kinesis のビデオストリームには、MP4 を使用してデータを提供するための次の要件があります。 + [動画再生トラックの要件](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/video-playback-requirements.html)。 + データの保持期間が 0 より大きい。 + 各フラグメントの動画トラックに、AVC (Advanced Video Coding) のコーデックプライベートデータが H.264 形式で、および HEVC のコーデックプライベートデータが H.265 形式で含まれている必要があります。詳細については、「[MPEG-4 仕様 ISO/IEC 14496-15](https://www.iso.org/standard/55980.html)」を参照してください。ストリームデータを特定の形式に適応させる方法については、「[NAL 適応フラグ](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/producer-reference-nal.html)」を参照してください。 + 各フラグメントのオーディオトラック (存在する場合) に、コーデックプライベートデータが AAC 形式 ([AAC 仕様 ISO/IEC 13818-7](https://www.iso.org/standard/43345.html)) または [MS Wave 形式](https://www.mmsp.ece.mcgill.ca/Documents/AudioFormats/WAVE/WAVE.html) で含まれている必要があります。 `GetClip.OutgoingBytes` Amazon CloudWatch メトリックスをモニタリングすることで、送信データの量をモニタリングできます。CloudWatch を使用して Kinesis Video Streams をモニタリングする方法については、「[Monitoring Kinesis Video Streams](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/monitoring.html)」を参照してください。料金の詳細については、[Amazon Kinesis Video Streams の料金](https://aws.amazon.com/kinesis/video-streams/pricing/)と[AWS 料金](https://aws.amazon.com/pricing/)」を参照してください。送信 AWS データには料金が適用されます。 **重要** 各フラグメントに含まれるコーデックプライベートデータ (CPD) には、フラグメントを適切にデコードするために必要なフレームレート、解像度、エンコーディングプロファイルなどのコーデック固有の初期化情報が含まれています。CPD の変更は、結果のクリップのターゲットフラグメント間ではサポートされていません。CPD は、クエリされたメディアを通じて一貫性を保つ必要があります。そうしないと、エラーが返されます。 **重要** トラックの変更はサポートされていません。トラックは、クエリされたメディア全体で一貫性を維持する必要があります。ストリームのフラグメントがビデオのみからオーディオとビデオの両方に変わった場合、または AAC オーディオトラックが A-Law オーディオトラックに変更された場合、エラーが返されます。 ## リクエストの構文 ``` POST /getClip HTTP/1.1 Content-type: application/json { "ClipFragmentSelector": { "FragmentSelectorType": "string", "TimestampRange": { "EndTimestamp": number, "StartTimestamp": number } }, "StreamARN": "string", "StreamName": "string" } ``` ## URI リクエストパラメータ リクエストでは URI パラメータを使用しません。 ## リクエストボディ リクエストは以下の JSON 形式のデータを受け入れます。 ** [ClipFragmentSelector](#API_reader_GetClip_RequestSyntax) ** 要求されたクリップの時間範囲とタイムスタンプのソース。 型: [ClipFragmentSelector](API_reader_ClipFragmentSelector.md) オブジェクト 必須: はい ** [StreamARN](#API_reader_GetClip_RequestSyntax) ** メディアクリップを取得するストリームの Amazon リソースネーム (ARN)。 StreamName または StreamArn を指定する必要があります。 タイプ: 文字列 長さの制限: 最小長は 1 です。最大長は 1,024 です。 パターン: `arn:[a-z\d-]+:kinesisvideo:[a-z0-9-]+:[0-9]+:[a-z]+/[a-zA-Z0-9_.-]+/[0-9]+` 必須: いいえ ** [StreamName](#API_reader_GetClip_RequestSyntax) ** メディアクリップを取得するストリームの名前。 StreamName または StreamArn を指定する必要があります。 タイプ: 文字列 長さの制約: 最小長は 1 です。最大長は 256 です。 パターン: `[a-zA-Z0-9_.-]+` 必須: いいえ ## レスポンスの構文 ``` HTTP/1.1 200 Content-Type: ContentType Payload ``` ## レスポンス要素 アクションが成功すると、サービスは HTTP 200 レスポンスを返します。 レスポンスでは、以下の HTTP ヘッダーが返されます。 ** [ContentType](#API_reader_GetClip_ResponseSyntax) ** 要求されたクリップ内のメディアのコンテンツタイプ。 長さの制限：最小長 1、最大長は 128 です。 パターン: `^[a-zA-Z0-9_\.\-]+$` レスポンスは、HTTP 本文として以下を返します。 ** [Payload](#API_reader_GetClip_ResponseSyntax) ** 指定したビデオストリームのメディアクリップを含む従来の MP4 ファイル。出力には、指定された開始タイムスタンプから (最初の) 100 MB 分のフラグメントまたは 200 個のフラグメントが含まれます。詳細については、[「Kinesis Video Streams のクォータ](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/limits.html)」を参照してください。 ## エラー すべてのアクションに共通のエラーについては、「[一般的なエラータイプ](CommonErrors.md)」を参照してください。 ** ClientLimitExceededException ** 制限を超えたため、Kinesis Video Streams がリクエストをスロットリングしました。後で呼び出しを試みてください。制限の詳細については、[「Kinesis Video Streams のクォータ](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/limits.html)」を参照してください。 HTTP ステータスコード: 400 ** InvalidArgumentException ** 指定されたパラメータが制限を超えているか、サポートされていない、または使用できません。 HTTP ステータスコード: 400 ** InvalidCodecPrivateDataException ** ビデオストリームの少なくとも 1 つのトラックにあるコーデックのプライベートデータは、この操作には無効です。 HTTP ステータスコード: 400 ** InvalidMediaFrameException ** 要求されたクリップの 1 つまたは複数のフレームは、指定されたコーデックに基づいて解析できませんでした。 HTTP ステータスコード: 400 ** MissingCodecPrivateDataException ** ビデオストリームの少なくとも 1 つのトラックにコーデックのプライベートデータがありませんでした。 HTTP ステータスコード: 400 ** NoDataRetentionException ** `GetImages` は、データを保持しないストリーム (つまり、 `DataRetentionInHours`の が 0) に対してリクエストされました。 HTTP ステータスコード: 400 ** NotAuthorizedException ** ステータスコード: 403 呼び出し元が指定されたストリームで操作を実行する権限がないか、トークンの有効期限が切れています。 HTTP ステータスコード: 401 ** ResourceNotFoundException ** `GetImages` Kinesis Video Streams が指定したストリームを見つけられない場合、 はこのエラーをスローします。 `GetHLSStreamingSessionURL` リクエストされた時間範囲内にフラグメントがないストリームに対して `ON_DEMAND`または `PlaybackMode`のセッション`LIVE_REPLAY`がリクエストされた場合、または過去 30 秒以内にフラグメントがないストリームに対して `PlaybackMode`のセッション`LIVE`がリクエストされた場合、 と はこのエラーを`GetDASHStreamingSessionURL`スローします。 HTTP ステータスコード: 404 ** UnsupportedStreamMediaTypeException ** メディアのタイプ (h.264 または h.265 ビデオ、AAC または G.711 オーディオなど) は、再生セッションの最初のフラグメントのトラックのコーデック IDs から判断できませんでした。トラック 1 のコーデック ID は `V_MPEG/ISO/AVC` である必要があります。また、オプションでトラック 2 のコーデック ID は `A_AAC` である必要があります。 HTTP ステータスコード: 400 ## 以下の資料も参照してください。 言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/kinesis-video-reader-data-2017-09-30/GetClip) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesis-video-reader-data-2017-09-30/GetClip) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/kinesis-video-reader-data-2017-09-30/GetClip) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesis-video-reader-data-2017-09-30/GetClip) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesis-video-reader-data-2017-09-30/GetClip) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesis-video-reader-data-2017-09-30/GetClip) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesis-video-reader-data-2017-09-30/GetClip) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesis-video-reader-data-2017-09-30/GetClip) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/kinesis-video-reader-data-2017-09-30/GetClip) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesis-video-reader-data-2017-09-30/GetClip)