本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。 # GetMediaForFragmentList 從 Amazon Kinesis 影片串流中的封存資料取得片段清單（由片段編號指定）的媒體。 **注意** 您必須先呼叫 `GetDataEndpoint` API 才能取得端點。然後使用 [--endpoint-url 參數](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 標頭都可以用來對錯誤是否可以重試和在何種條件下進行程式設計決策，並提供用戶端程式設計人員可能需要採取的動作的相關資訊，以便成功重試。如需詳細資訊，請參閱本主題底部的**錯誤**區段，以及[常見錯誤](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 Resource Name (ARN)。指定此參數或 `StreamName` 參數。類型：字串長度限制：長度下限為 1。長度上限為 1024。模式：`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` 如果`LIVE_REPLAY`請求具有 `ON_DEMAND`或 `PlaybackMode`的工作階段的串流在請求的時間範圍內沒有片段，或者請求具有 `PlaybackMode`的工作階段的串流在過去 30 秒內沒有片段，`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 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesis-video-reader-data-2017-09-30/GetMediaForFragmentList) + [AWS 適用於 C\+\+ 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesis-video-reader-data-2017-09-30/GetMediaForFragmentList) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesis-video-reader-data-2017-09-30/GetMediaForFragmentList) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesis-video-reader-data-2017-09-30/GetMediaForFragmentList) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesis-video-reader-data-2017-09-30/GetMediaForFragmentList) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesis-video-reader-data-2017-09-30/GetMediaForFragmentList) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesis-video-reader-data-2017-09-30/GetMediaForFragmentList) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/kinesis-video-reader-data-2017-09-30/GetMediaForFragmentList) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesis-video-reader-data-2017-09-30/GetMediaForFragmentList)