翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # ListFragments アーカイブデータ内の指定したストリームとタイムスタンプ範囲から [Fragment](API_reader_Fragment.md) オブジェクトのリストを返します。 フラグメントのリストは、結果整合性があります。これは、フラグメントが保持されているという確認応答をプロデューサーが受信した場合でも、`ListFragments` へのリクエストから結果がすぐに返されない場合があることを意味します。ただし、結果は通常、1 秒未満で入手できます。 **注記** エンドポイントを取得するには、最初に `GetDataEndpoint` API を呼び出す必要があります。次に、[--endpoint-url parameter](https://docs.aws.amazon.com/cli/latest/reference/) を使用して `ListFragments` リクエストをこのエンドポイントに送信します。 **重要** 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 /listFragments HTTP/1.1 Content-type: application/json { "FragmentSelector": { "FragmentSelectorType": "{{string}}", "TimestampRange": { "EndTimestamp": {{number}}, "StartTimestamp": {{number}} } }, "MaxResults": {{number}}, "NextToken": "{{string}}", "StreamARN": "{{string}}", "StreamName": "{{string}}" } ``` ## URI リクエストパラメータ リクエストでは URI パラメータを使用しません。 ## リクエストボディ リクエストは以下の JSON 形式のデータを受け入れます。 ** [FragmentSelector](#API_reader_ListFragments_RequestSyntax) ** 返すフラグメントの範囲のタイムスタンプ範囲とタイムスタンプオリジンを記述します。 これは、 `NextToken`が API で渡されていない場合にのみ必要です。 型: [FragmentSelector](API_reader_FragmentSelector.md) オブジェクト 必須: いいえ ** [MaxResults](#API_reader_ListFragments_RequestSyntax) ** 返すフラグメントの総数。使用可能なフラグメントの総数が `max-results` で指定された値を超える場合、ページネーションを再開するために使用できる[ListFragments:NextToken](#KinesisVideo-reader_ListFragments-response-NextToken) が出力に提供されます。　　 デフォルト値は 100 です。 タイプ: Long 有効範囲: 最小値は 1 です。最大値は 1000 です。 必須: いいえ ** [NextToken](#API_reader_ListFragments_RequestSyntax) ** ページ分割を始める場所を指定するトークン。これは、以前に切り詰められたレスポンスからの [ListFragments:NextToken](#KinesisVideo-reader_ListFragments-response-NextToken) です。 タイプ: 文字列 長さの制約: 最小長は 1 です。最大長は 4,096 です。 パターン: `[a-zA-Z0-9+/]+={0,2}` 必須: いいえ ** [StreamARN](#API_reader_ListFragments_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_ListFragments_RequestSyntax) ** フラグメントリストを取得するストリームの名前。このパラメータ、または `StreamARN` パラメータのいずれかを指定してください。 タイプ: 文字列 長さの制約: 最小長は 1 です。最大長は 256 です。 パターン: `[a-zA-Z0-9_.-]+` 必須: いいえ ## レスポンスの構文 ``` HTTP/1.1 200 Content-type: application/json { "Fragments": [ { "FragmentLengthInMilliseconds": number, "FragmentNumber": "string", "FragmentSizeInBytes": number, "ProducerTimestamp": number, "ServerTimestamp": number } ], "NextToken": "string" } ``` ## レスポンス要素 アクションが成功すると、サービスは HTTP 200 レスポンスを返します。 サービスから以下のデータが JSON 形式で返されます。 ** [Fragments](#API_reader_ListFragments_ResponseSyntax) ** セレクター基準を満たすストリームからのアーカイブされた [Fragment](API_reader_Fragment.md) オブジェクトのリスト。結果は、ページ間でも特定の順序ではありません。 ストリームにセレクタ条件を満たすフラグメントがない場合、空のリストが返されます。 型: [Fragment](API_reader_Fragment.md) オブジェクトの配列 ** [NextToken](#API_reader_ListFragments_ResponseSyntax) ** 返されたリストが切り捨てられた場合、操作はこのトークンを返します。これは次のページの結果を取得する上で使用します。返す結果がそれ以上存在しない場合、この値は `null` になります。 タイプ: 文字列 長さの制約: 最小長は 1 です。最大長は 4,096 です。 パターン: `[a-zA-Z0-9+/]+={0,2}` ## エラー すべてのアクションに共通のエラーについては、「[一般的なエラータイプ](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/ListFragments) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesis-video-reader-data-2017-09-30/ListFragments) + [AWS SDK for C\+\+](https://docs.aws.amazon.com/goto/SdkForCpp/kinesis-video-reader-data-2017-09-30/ListFragments) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesis-video-reader-data-2017-09-30/ListFragments) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesis-video-reader-data-2017-09-30/ListFragments) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesis-video-reader-data-2017-09-30/ListFragments) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesis-video-reader-data-2017-09-30/ListFragments) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesis-video-reader-data-2017-09-30/ListFragments) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/kinesis-video-reader-data-2017-09-30/ListFragments) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesis-video-reader-data-2017-09-30/ListFragments)