本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
GetMediaForFragmentList
從 Amazon Kinesis 視訊串流中的封存資料取得片段清單 (由片段編號指定) 的媒體。
注意
您必須先呼叫 GetDataEndpoint
API 以取得端點。然後使用 --end 點 url 參數將GetMediaForFragmentList
請求發送到此端點。
如需限制,請參閱 Kinesis Video Streams 限制。
重要
如果在叫用 Kinesis 影片串流封存媒體 API 之後擲回錯誤,除了 HTTP 狀態碼和回應本文之外,它還包含下列資訊:
-
x-amz-ErrorType
HTTP 標頭 — 除了 HTTP 狀態碼提供的內容之外,還包含更具體的錯誤類型。 -
x-amz-RequestId
HTTP 標頭 — 如果您想向其報告問題 AWS,支持團隊可以在給出請求 ID 時更好地診斷問題。
HTTP 狀態碼和 ErrorType 標頭都可以用來做出關於錯誤是否可重試以及在什麼情況下是否可重試的程式設計決定,以及提供有關用戶端程式設計人員可能需要採取哪些動作才能成功再試一次的資訊。
如需詳細資訊,請參閱本主題底部的「錯誤」一節,以及常見錯誤。
請求語法
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。長度上限為 1024。
模式:
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 傳回的承載是指定串流中的一系列區塊。如需有關區塊的資訊,請參閱PutMedia。Kinesis Video Streams 在
GetMediaForFragmentList
呼叫中傳回的區塊也包含下列其他 Matroska (MKV) 標記:-
AW_ 動態片段-區塊中傳回的片段編號。
-
伺服器端時間戳記-片段的伺服器端時間戳記。
-
AW_ 生產者 _ 側面時間戳記-片段的生產者端時間戳記。
如果發生異常,將包括以下標籤:
-
AW_ 中國視頻片段 _ 號碼-拋出異常的片段的編號。
-
AW_ 中國異常 _ 錯誤代碼-錯誤的整數碼。
-
AW_ 中國例外 _ 訊息-例外狀況的文字描述。
-
錯誤
如需所有動作常見錯誤的資訊,請參閱常見錯誤。
- ClientLimitExceededException
-
Kinesis Video Streams 已限制要求,因為您已超過限制。稍後再嘗試撥打電話。如需有關限制的資訊,請參閱 Kinesis Video Streams 限制。
HTTP 狀態碼:400
- InvalidArgumentException
-
指定的參數超出其限制、不受支援或無法使用。
HTTP 狀態碼:400
- NotAuthorizedException
-
狀態碼:403,調用者未授權在給定流上執行操作,或令牌已過期。
狀態碼:
- ResourceNotFoundException
-
GetImages
當 Kinesis 影片串流找不到您指定的串流時,就會擲回此錯誤。GetHLSStreamingSessionURL
如果在請求的時間範圍內沒有片段PlaybackMode
的流請求具有ON_DEMAND
orLIVE_REPLAY
的會話,或者如果在過去 30 秒內沒有片段PlaybackMode
的LIVE
流請求具有 of 的會話,則GetDASHStreamingSessionURL
拋出此錯誤。HTTP 狀態碼:404
另請參閱
如需在其中一個特定語言 AWS SDK 中使用此 API 的詳細資訊,請參閱下列內容: