本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
疑難排解傳回的播放錯誤 MediaTailor
此小節提供有關測試播放器軟體時和播放器請求的一般處理期間可能會收到的 HTTP 錯誤代碼的資訊。
注意
您也可能在組態作業期間 (如 PutPlaybackConfiguration
和 GetPlaybackConfiguration
) 從 AWS Elemental MediaTailor API 收到錯誤。如需這些錯誤類型的相關資訊,請參閱 AWS Elemental MediaTailorAPI 參考資料。
當您的播放器直接或透過 CDN 傳送要求時,會以AWS Elemental MediaTailor狀態碼 MediaTailor 回應。如果成 MediaTailor 功處理請求,它會返回 HTTP 狀態碼200 OK
,指示成功,以及填充的清單。如果要求不成功,會 MediaTailor 傳回 HTTP 狀態碼、例外狀況名稱和錯誤訊息。
AWS Elemental MediaTailor 會傳回兩個類型的錯誤:
-
客戶端錯誤 — 通常是由請求本身的問題引起的錯誤,例如格式不正確的請求,無效的參數或錯誤的 URL。這些錯誤會有 HTTP
4xx
回應代碼。 -
伺服器錯誤 — 通常是由廣告決策伺服器 (ADS) MediaTailor 或原始伺服器等相依性問題或其中一個相依性所造成的錯誤。這些錯誤會有 HTTP
5xx
回應代碼。
傳回的用戶端播放錯誤 AWS Elemental MediaTailor
一般指引:
您可以在回應的標頭和內文中找到大多數錯誤的詳細資訊。
對於某些錯誤,你需要檢查你的配置設置。您可以從中擷取播放配置的設定AWS Elemental MediaTailor。對於 API,資源是
GetPlaybackConfiguration/
。如需詳細資訊,請參閱 AWS Elemental MediaTailorAPI 參考資料。Name
下表列出 AWS Elemental MediaTailor 的資訊清單操作活動傳回的用戶端錯誤代碼、可能的原因,以及您可以採取以便解決問題的動作。
代碼 | 例外名稱 | 意義 | 處理方式 |
---|---|---|---|
400 | BadRequestException |
MediaTailor 由於格式或內容中出現一個或多個錯誤,因此無法服務請求。參數的格式可能錯誤,或是請求可能包含無效的播放組態或工作階段 ID。 | 確認您的請求格式正確,並包含準確的資訊。確定播放器上的播放端點設定符合 GetPlaybackConfiguration 傳回的 ManifestEndpointPrefix 設定。重試您的請求。 |
403 | AccessDeniedException |
請求中提供的主機標頭不符合 MediaTailor 播放 URL 中設定的資訊清單端點字首。您的 CDN 可能設定錯誤。 | 檢查您的 CDN 設定,並確定您對 MediaTailor 使用正確的資訊清單端點字首。重試您的請求。 |
404 | NotFoundException |
MediaTailor 找不到指定的資訊。可能的原因包括 URL 未對應到服務中的任何項目、組態未定義,或工作階段不可用。 | 檢查您的組態與請求的有效性,然後重新初始化工作階段。 |
409 | ConflictException |
播放器嘗試對單一工作階段同時載入多個播放清單。因此, MediaTailor 偵測到工作階段一致性衝突。HLS 播放器會發生此問題。 | 確定您的播放器一次請求一個播放清單。這會符合 HLS 規格。 |
410 | Gone |
Sup AWS port 操作員已封鎖玩家工作階段或客戶組態。 AWS當我們檢測到來自單個會話或配置的錯誤流量的 4xx 請求時,Support 會在極少數情況下執行此操作。 | 如果您認為不應該封鎖請求,請聯絡 AWS Support |
如果您需要進一步協助,請聯絡 AWS Support
傳回的伺服器播放錯誤 AWS Elemental MediaTailor
一般指引:
您可以在回應的標頭和內文中找到大多數錯誤的詳細資訊。
對於某些錯誤,你需要檢查你的配置設置。您可以從中擷取播放配置的設定AWS Elemental MediaTailor。對於 API,資源是
GetPlaybackConfiguration/
。如需詳細資訊,請參閱 AWS Elemental MediaTailorAPI 參考資料。Name
下表列出 AWS Elemental MediaTailor 的資訊清單操作活動傳回的伺服器錯誤代碼、可能的原因,以及您可以採取以便解決問題的動作。
代碼 | 例外名稱 | 意義 | 處理方式 |
---|---|---|---|
500 | InternalServiceError |
未處理的例外。 | 重試 請求。如果問題仍然存在,請檢查您所在AWS地區的報告健康狀態,網址 MediaTailor 為https://status.aws.amazon.com/ |
502 | BadGatewayException |
原始伺服器位址或廣告決策伺服器 (ADS) 位址無效。無效地址的範例為私有 IP 地址和 localhost 。 |
請確定您的組態具有 ADS 和原始伺服器的正確設定,然後重試請求。 |
502 | UnsupportedManifestException |
原始清單已更改,因此 MediaTailor無法對其進行個性化,或者 MediaTailor 不支持來源的清單格式。 | 這可能只會影響個別工作階段。重新初始化工作階段。您一般可以透過在檢視器中重新整理頁面來達成此目標。如果問題仍存在,請確認 MediaTailor 支援原始伺服器的資訊清單格式。如需相關資訊,請參閱 整合內容來源。 |
503 | LoadShed |
MediaTailor 在服務您的請求時遇到資源限制。 | 重試 請求。如果問題仍然存在,請檢查您所在AWS地區的報告健康狀態,網址 MediaTailor 為https://status.aws.amazon.com/ |
503 | ThrottlingException |
您的每秒交易次數已達到您的配額,且 MediaTailor 正在調節您的使用。 | 重試 請求。您還可以在以下位置查看您所在AWS地區 MediaTailor 的報告健康狀況https://status.aws.amazon.com/ |
504 | GatewayTimeoutException |
連絡原始伺服器 MediaTailor 時發生逾時。 | 重試 請求。如果問題仍存在,請檢查原始伺服器的運作狀態,並確保在原始伺服器在 廣告插入配額 中所列的內容原始伺服器逾時內回應。 |
如果您需要進一步協助,請聯絡 AWS Support
播放錯誤範例
本小節列出一些您可能會在與 AWS Elemental MediaTailor 的互動的命令列中看到的播放錯誤範例。
下列範例顯示AWS Elemental MediaTailor與廣告決策伺服器 (ADS) 或原始伺服器之間發生逾時的結果。
~[]> curl -vvv https://111122223333444455556666123456789012.mediatailor.us-west-2.amazonaws.com/v1/master/123456789012/Multiperiod_DASH_Demo/index.mpd * Trying 54.186.133.224... * Connected to 111122223333444455556666123456789012.mediatailor.us-west-2.amazonaws.com (11.222.333.444) port 555 (#0) * TLS 1.2 connection using TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256 * Server certificate: mediatailor.us-west-2.amazonaws.com * Server certificate: Amazon * Server certificate: Amazon Root CA 1 * Server certificate: Starfield Services Root Certificate Authority - G2 > GET /v1/master/123456789012/Multiperiod_DASH_Demo/index.mpd HTTP/1.1 > Host: 111122223333444455556666123456789012.mediatailor.us-west-2.amazonaws.com > User-Agent: curl/7.43.0 > Accept: */* > < HTTP/1.1 504 Gateway Timeout < Date: Thu, 29 Nov 2018 18:43:14 GMT < Content-Type: application/json < Content-Length: 338 < Connection: keep-alive < x-amzn-RequestId: 123456789012-123456789012 < x-amzn-ErrorType: GatewayTimeoutException:http://internal.amazon.com/coral/com.amazon.elemental.midas.mms.coral/ < * Connection #0 to host 111122223333444455556666123456789012.mediatailor.us-west-2.amazonaws.com left intact {"message":"failed to generate manifest: Unable to obtain template playlist. origin URL:[https://777788889999.mediapackage.us-west-2.amazonaws.com/out/v1/444455556666111122223333/index.mpd], asset path: [index.mpd], sessionId:[123456789012123456789012] customerId:[123456789012]"}%