疑難排解傳回的播放錯誤 MediaTailor - AWS Elemental MediaTailor
客戶端錯誤伺服器錯誤範例

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

疑難排解傳回的播放錯誤 MediaTailor

本節提供您在測試播放程式軟體和正常處理播放程式要求期間可能收到的HTTP錯誤碼的相關資訊。

注意

您也可能會收到錯誤訊息 AWS Elemental MediaTailor API，在像PutPlaybackConfiguration和這樣的組態作業期間GetPlaybackConfiguration。如需有關這些錯誤類型的資訊，請參閱 AWS Elemental MediaTailor API參考。

當您的玩家傳送請求至 AWS Elemental MediaTailor，無論是直接或通過CDN，與狀態碼 MediaTailor 響應。如果成 MediaTailor 功處理請求，它會返回HTTP狀態碼200 OK，指示成功，以及填充的清單。如果要求不成功，會 MediaTailor 傳回HTTP狀態碼、例外名稱和錯誤訊息。

AWS Elemental MediaTailor 返回兩類錯誤：

  • 客戶端錯誤 — 通常是由請求本身的問題引起的錯誤，例如格式不正確的請求，無效的參數或錯URL誤。這些錯誤具有HTTP4xx回應碼。

  • 伺服器錯誤 — 通常是由問題 MediaTailor 或其中一個相依性所造成的錯誤，例如廣告決策伺服器 (ADS) 或原始伺服器。這些錯誤具有HTTP5xx回應碼。

傳回的用戶端播放錯誤 AWS Elemental MediaTailor

一般指引：

  • 您可以在回應的標頭和內文中找到大多數錯誤的詳細資訊。

  • 對於某些錯誤，你需要檢查你的配置設置。您可以從以下位置檢索播放配置的設置 AWS Elemental MediaTailor。 對於API，資源是GetPlaybackConfiguration/Name。如需詳細資訊，請參閱 AWS Elemental MediaTailor API參考。

下表列出的資訊清單操作活動所傳回的用戶端錯誤碼 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 同時 AWS Support 操作員已封鎖玩家工作階段或客戶設定。 AWS 當我們檢測到來自單個會話或配置的錯誤流量的 4xx 請求時，Support 會在極少數情況下執行此操作。 如果您認為不應封鎖要求，請連絡 Sup AWSport 部門。他們可以調查此情況，並在適當時移除封鎖篩選。

如果您需要進一步協助，請聯絡 Sup AWSport 部門。

傳回的伺服器播放錯誤 AWS Elemental MediaTailor

一般指引：

  • 您可以在回應的標頭和內文中找到大多數錯誤的詳細資訊。

  • 對於某些錯誤，你需要檢查你的配置設置。您可以從以下位置檢索播放配置的設置 AWS Elemental MediaTailor。 對於API，資源是GetPlaybackConfiguration/Name。如需詳細資訊，請參閱 AWS Elemental MediaTailor API參考。

下表列出的資訊清單操作活動所傳回的伺服器錯誤碼 AWS Elemental MediaTailor、可能的原因，以及您可以採取的行動來解決這些問題。

代碼 例外名稱 意義 處理方式
500 InternalServiceError 未處理的例外。 重試 請求。如果問題仍然存在，請檢查報告 MediaTailor 的健康狀態 AWS 區域在https://status.aws.amazon.com/.
502 BadGatewayException 原始伺服器位址或廣告決策伺服器 (ADS) 位址無效。無效地址的範例為私有 IP 地址和 localhost。 請確定您的組態具有ADS與原始伺服器的正確設定，然後重試該要求。
502 UnsupportedManifestException 原始清單已更改，因此 MediaTailor無法對其進行個性化，或者 MediaTailor 不支持來源的清單格式。 這可能只會影響個別工作階段。重新初始化工作階段。您一般可以透過在檢視器中重新整理頁面來達成此目標。如果問題仍然存在，請確認是否 MediaTailor支援來源的資訊清單格式。如需相關資訊，請參閱 整合內容來源。
503 LoadShed MediaTailor 在服務您的請求時遇到資源限制。 重試 請求。如果問題仍然存在，請檢查報告 MediaTailor 的健康狀態 AWS 區域在https://status.aws.amazon.com/.
503 ThrottlingException 您的每秒交易數已達到您的配額，並且 MediaTailor 正在限制您的使用。 重試 請求。您也可以檢查報告的 MediaTailor 健康狀況 AWS 區域在https://status.aws.amazon.com/. 您可能想要提高每秒交易次數的配額。如需詳細資訊，請參閱廣告插入的配額。
504 GatewayTimeoutException 連絡原始伺服器 MediaTailor 時發生逾時。 重試 請求。如果問題仍存在，請檢查原始伺服器的運作狀態，並確保在原始伺服器在 廣告插入的配額 中所列的內容原始伺服器逾時內回應。

如果您需要進一步協助，請聯絡 Sup AWSport 部門。

播放錯誤範例

本節列出了您可能在命令行互動中看到的播放錯誤的一些示例 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]"}%