翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
によって返される再生エラーのトラブルシューティング MediaTailor
このセクションでは、プレイヤーソフトウェアのテスト中、およびプレイヤーリクエストの通常の処理中に受け取る可能性がある HTTP エラーコードについて説明します。
注記
AWS Elemental MediaTailor API からエラーが送信される場合があります。たとえば、PutPlaybackConfiguration
および GetPlaybackConfiguration
のような設定オペレーション中に返ります。これらのタイプのエラーについては、AWS Elemental MediaTailorAPI リファレンスをご覧ください。
プレーヤーが直接AWS Elemental MediaTailor、または CDN を介してにリクエストを送信すると、 MediaTailor ステータスコードが返されます。 MediaTailor リクエストが正常に処理されると、成功を示す HTTP ステータスコードと200 OK
、入力されたマニフェストが返されます。リクエストが失敗すると、HTTP ステータスコード、例外名、 MediaTailor エラーメッセージが返されます。
AWS Elemental MediaTailor より、2 つのエラークラスが返ります。
-
クライアントエラー - 通常、不適切にフォーマットされたリクエスト、無効なパラメータ、または不正な URL といったリクエスト自体の問題が原因で発生するエラー。このようなエラーの場合は HTTP
4xx
レスポンスコードが表示されます。 -
サーバーエラー — 通常、広告決定サーバー (ADS) MediaTailor や配信元サーバーなどの依存関係の問題や依存関係のいずれかが原因で発生するエラー。このようなエラーの場合は HTTP
5xx
レスポンスコードが表示されます。
によって返されるクライアント再生エラー AWS Elemental MediaTailor
一般的なガイダンス:
レスポンスのヘッダーとボディ内にあるほとんどのエラーに関する詳細情報を見つけることができます。
一部のエラーについては、設定をチェックする必要があります。再生設定の設定はから取得できますAWS Elemental MediaTailor。API の場合、リソースは
GetPlaybackConfiguration/
です。詳細については、「AWS Elemental MediaTailor API リファレンス」を参照してください。Name
以下のテーブルは、AWS Elemental MediaTailor のマニフェスト操作アクティビティによって返るクライアントエラーコード、考えられる原因、およびそれらを解決するために実行できるアクションの一覧を示したものです。
コード | 例外名 | 意味 | 対応方法 |
---|---|---|---|
400 | BadRequestException |
MediaTailor フォーマットまたはコンテンツに 1 つまたは複数のエラーがあるため、リクエストを処理できません。パラメータが不適切にフォーマットされている、または無効な再生設定やセッション ID がリクエストに含まれている可能性があります。 | リクエストが適切にフォーマットされており、正確な情報が含まれていることをチェックします。プレイヤーの再生エンドポイント設定が ManifestEndpointPrefix によって返される GetPlaybackConfiguration 設定と一致していることを確認します。リクエストを再実行します。 |
403 | AccessDeniedException |
リクエストで提供されたホストヘッダーが、 MediaTailor の再生 URLで設定されているマニフェストエンドポイントプレフィックスと一致しません。CDN が誤って設定された可能性があります。 | CDN 設定を確認し、 MediaTailor の正しいマニフェストエンドポイントプレフィックスを使用していることを確認します。リクエストを再実行します。 |
404 | NotFoundException |
MediaTailor 指定された情報が見つかりません。サービス内の何にもマップされていない URL、未定義の設定、利用できないセッションなどの理由が考えられます。 | 設定とリクエストの有効性を確認してから、セッションを再開してください。 |
409 | ConflictException |
プレイヤーが単一のセッションに複数のプレイリストを同時にロードしようとしました。その結果、 MediaTailor セッションの一貫性の競合が検出されました。この問題は、HLS プレーヤーで発生します。 | プレイヤーがプレイリストを一度に 1 つずつリクエストしていることを確認します。これは HLS 仕様で規定されています。 |
410 | Gone |
AWS Support のオペレーターが、プレイヤーセッションまたは顧客設定をブロックしました。AWSSupport は、単一のセッションまたは設定について、規格外のトラフィックに由来する極めて大量の 4xx リクエストを検出するといったまれな状況で、このようなブロックを実行します。 | リクエストをブロックする必要はないと思われる場合は、AWS Support |
追加のサポートが必要な場合は、AWS Support
から返されたサーバー再生エラー AWS Elemental MediaTailor
一般的なガイダンス:
レスポンスのヘッダーとボディ内にあるほとんどのエラーに関する詳細情報を見つけることができます。
一部のエラーについては、設定をチェックする必要があります。再生設定の設定はから取得できますAWS Elemental MediaTailor。API の場合、リソースは
GetPlaybackConfiguration/
です。詳細については、「AWS Elemental MediaTailor API リファレンス」を参照してください。Name
以下のテーブルは、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 |
1 秒あたりのトランザクション数がクオータに到達したため、 MediaTailor で使用がスロットリングされています。 | リクエストを再試行します。AWS リージョンのレポートされた MediaTailor の状態を確認することもできます (https://status.aws.amazon.com/ |
504 | GatewayTimeoutException |
MediaTailor オリジンサーバーへの接続中にタイムアウトが発生しました。 | リクエストを再試行します。問題が解決しない場合は、オリジンサーバーの状態をチェックし、オリジンサーバーが 広告挿入のクォータ に記載されているコンテンツオリジンサーバーのタイムアウト内に応答していることを確認します。 |
追加のサポートが必要な場合は、AWS Support
再生エラーの例
このセクションでは、AWS Elemental MediaTailor とのコマンドラインの通信で生じる可能性がある再生エラーの例をいくつか示します。
次の例は、広告決定サーバー (ADS) AWS Elemental MediaTailor と配信元サーバーの間でタイムアウトが発生した場合の結果を示しています。
~[]> 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]"}%