本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
此小節提供有關測試播放器軟體時和播放器請求的一般處理期間可能會收到的 HTTP 錯誤代碼的資訊。
注意
在 PutPlaybackConfiguration和 等組態操作期間，您也可能收到來自 AWS Elemental MediaTailor API 的錯誤GetPlaybackConfiguration。如需有關這些錯誤類型的資訊，請參閱 AWS Elemental MediaTailor API 參考。
當您的玩家直接或透過 CDN 傳送請求時 AWS Elemental MediaTailor，MediaTailor 會以狀態碼回應。如果 MediaTailor 成功處理請求，則會傳回 HTTP 狀態碼 200 OK，指出成功，以及填入的資訊清單。如果請求失敗，MediaTailor 會傳回 HTTP 狀態碼、例外名稱和錯誤訊息。
AWS Elemental MediaTailor 傳回兩種錯誤類別：
-
用戶端錯誤 – 通常由請求本身的問題引起的錯誤，例如格式不正確的請求、無效的參數或錯誤的 URL。這些錯誤會有 HTTP
4xx回應代碼。 -
伺服器錯誤 – 通常由 MediaTailor 或其其中一個相依性的問題引起的錯誤，例如廣告決策伺服器 (ADS) 或原始伺服器。這些錯誤會有 HTTP
5xx回應代碼。
傳回的用戶端播放錯誤 AWS Elemental MediaTailor
一般指引：
您可以在回應的標頭和內文中找到大多數錯誤的詳細資訊。
對於某些錯誤，您需要檢查組態設定。您可以從 擷取播放組態的設定 AWS Elemental MediaTailor。對於 API，資源為
GetPlaybackConfiguration/。如需詳細資訊，請參閱 AWS Elemental MediaTailor API 參考。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 |
AWS 支援運算子已封鎖玩家工作階段或客戶組態。在極少數情況下，當我們偵測到來自單一工作階段或組態之錯誤流量的 4xx 請求量非常高時， AWS 支援會這麼做。 | 如果您認為不應封鎖請求，請聯絡 AWS Support |
如果您需要進一步協助，請聯絡 AWS Support
傳回的伺服器播放錯誤 AWS Elemental MediaTailor
一般指引：
您可以在回應的標頭和內文中找到大多數錯誤的詳細資訊。
對於某些錯誤，您需要檢查組態設定。您可以從 擷取播放組態的設定 AWS Elemental MediaTailor。對於 API，資源為
GetPlaybackConfiguration/。如需詳細資訊，請參閱 AWS Elemental MediaTailor API 參考。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]"}%
