によって返される再生エラーのトラブルシューティング 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、成功と入力されたマニフェストが示されます。リクエストが失敗した場合、 はHTTPステータスコード、例外名、エラーメッセージ MediaTailor を返します。

AWS Elemental MediaTailor は 2 つのクラスのエラーを返します。

  • クライアントエラー – 通常、リクエスト自体の問題によって発生するエラー。不適切な形式のリクエスト、無効なパラメータ、または不正な などですURL。これらのエラーにはHTTP4xxレスポンスコードがあります。

  • サーバーエラー – 広告決定サーバー (ADS) やオリジンサーバーなど、 MediaTailor またはその依存関係のいずれかの問題によって通常発生するエラー。これらのエラーにはHTTP5xxレスポンスコードがあります。

によって返されるクライアント再生エラー AWS Elemental MediaTailor

一般的なガイダンス:

  • レスポンスのヘッダーとボディ内にあるほとんどのエラーに関する詳細情報を見つけることができます。

  • 一部のエラーについては、設定をチェックする必要があります。再生設定の設定は、 から取得できます。 AWS Elemental MediaTailor。 の場合API、リソースは ですGetPlaybackConfiguration/Name。詳細については、「」を参照してください。 AWS Elemental MediaTailor API 「」を参照してください

次の表に、 のマニフェスト操作アクティビティによって返されるクライアントエラーコードを示します。 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 An AWS サポートオペレーターがプレイヤーセッションまたは顧客設定をブロックしました。 AWS Support は、単一のセッションまたは設定について、規格外のトラフィックに由来する極めて大量の 4xx リクエストを検出するといったまれな状況で、このようなブロックを実行します。 リクエストをブロックすべきではないと思われる場合は、 AWS サポートにお問い合わせください。適切であれば、状況を調査し、ブロッキングフィルターを削除することができます。

さらにサポートが必要な場合は、 AWS サポートにお問い合わせください。

によって返されるサーバー再生エラー 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 1 秒あたりのトランザクション数がクォータに達し、 の使用がスロットリング MediaTailor されています。 リクエストを再試行します。の の報告されたヘルスを確認することもできます MediaTailor 。 AWS のリージョンhttps://status.aws.amazon.com/。1 秒あたりのトランザクション数のクオータを引き上げることをお勧めします。詳細については、「広告挿入のクォータ」を参照してください。
504 GatewayTimeoutException MediaTailor がオリジンサーバーに接続している間にタイムアウトが発生しました。 リクエストを再試行します。問題が解決しない場合は、オリジンサーバーの状態をチェックし、オリジンサーバーが 広告挿入のクォータ に記載されているコンテンツオリジンサーバーのタイムアウト内に応答していることを確認します。

さらにサポートが必要な場合は、 AWS サポートにお問い合わせください。

再生エラーの例

このセクションでは、 とのコマンドラインインタラクションに表示される可能性のある再生エラーの例をいくつか示します。 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]"}%