翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # MediaTailor からの再生のトラブルシューティング このセクションでは、プレイヤーソフトウェアのテスト中、およびプレイヤーリクエストの通常の処理中に受け取る可能性がある HTTP エラーコードについて説明します。 **注記** また、 `PutPlaybackConfiguration`や などの設定オペレーション中に AWS Elemental MediaTailor API からエラーが表示されることがあります`GetPlaybackConfiguration`。これらのタイプのエラーの詳細については、 [AWS Elemental MediaTailor API リファレンス](https://docs.aws.amazon.com/mediatailor/latest/apireference/Welcome.html)を参照してください。 プレイヤーが AWS Elemental MediaTailor直接または CDN を介して にリクエストを送信すると、MediaTailor はステータスコードで応答します。MediaTailor がリクエストを正常に処理すると、設定済みのマニフェストと共に、成功を示す HTTP ステータスコード `200 OK` を返します。リクエストが失敗した場合、MediaTailor は HTTP ステータスコード、例外名、およびエラーメッセージを返します。 AWS Elemental MediaTailor は 2 つのクラスのエラーを返します。 + **クライアントエラー** - 通常、不適切にフォーマットされたリクエスト、無効なパラメータ、または不正な URL といったリクエスト自体の問題が原因で発生するエラー。このようなエラーの場合は HTTP `4xx` レスポンスコードが表示されます。 + **サーバーエラー** - 通常、MediaTailor に関する問題、または広告決定サーバー (ADS) やオリジンサーバーといった依存関係のいずれかに関する問題が原因で発生するエラー。このようなエラーの場合は HTTP `5xx` レスポンスコードが表示されます。 **Topics** + [によって返されるクライアント再生エラー AWS Elemental MediaTailor](#playback-errors-client) + [によって返されるサーバー再生エラー AWS Elemental MediaTailor](#playback-errors-server) + [再生エラーの例](#playback-errors-examples) ## によって返されるクライアント再生エラー AWS Elemental MediaTailor 一般的なガイダンス: + レスポンスのヘッダーとボディ内にあるほとんどのエラーに関する詳細情報を見つけることができます。 + 一部のエラーについては、設定をチェックする必要があります。再生設定の設定は、 から取得できます AWS Elemental MediaTailor。API の場合、リソースは `GetPlaybackConfiguration/Name` です。詳細については、「[AWS Elemental MediaTailor API リファレンス](https://docs.aws.amazon.com/mediatailor/latest/apireference/)」を参照してください。 次の表に、 のマニフェスト操作アクティビティによって返されるクライアントエラーコード 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 サポートオペレーターがプレイヤーセッションまたは顧客設定をブロックしました。 AWS サポートは、1 つのセッションまたは設定の誤ったトラフィックから発生する非常に大量の 4xx リクエストを検出すると、まれにこれを行います。 | リクエストをブロックする必要はないと思われる場合は、[AWS Support](https://aws.amazon.com/premiumsupport/) までお問い合わせください。適切であれば、状況を調査し、ブロッキングフィルターを削除することができます。 | 追加のサポートが必要な場合は、[AWS Support](https://aws.amazon.com/premiumsupport/) にお問い合わせください。 ## によって返されるサーバー再生エラー AWS Elemental MediaTailor 一般的なガイダンス: + レスポンスのヘッダーとボディ内にあるほとんどのエラーに関する詳細情報を見つけることができます。 + 一部のエラーについては、設定をチェックする必要があります。再生設定の設定は、 から取得できます AWS Elemental MediaTailor。API の場合、リソースは `GetPlaybackConfiguration/Name` です。詳細については、「[AWS Elemental MediaTailor API リファレンス](https://docs.aws.amazon.com/mediatailor/latest/apireference/)」を参照してください。 次の表に、マニフェスト操作アクティビティによって返されるサーバーエラーコード AWS Elemental MediaTailor、考えられる原因、およびそれらを解決するために実行できるアクションを示します。 | コード | 例外名 | 意味 | 対応方法 | | --- | --- | --- | --- | | 500 | InternalServiceError | 処理されない例外 | リクエストを再試行します。問題が解決しない場合は、 でお使いの AWS リージョンの MediaTailor の報告された正常性を確認します[https://status.aws.amazon.com/](https://status.aws.amazon.com/)。 | | 502 | BadGatewayException | オリジンサーバーアドレス、または広告決定サーバー (ADS) アドレスが無効です。無効なアドレスには、プライベート IP アドレスや localhost などがあります。 | 設定に ADS とオリジンサーバー用の正しい設定があることを確認してから、リクエストを再試行してください。 | | 502 | UnsupportedManifestException | オリジンマニフェストが変更されていて MediaTailor がそれをパーソナライズできない、または MediaTailor がオリジンのマニフェスト形式をサポートしません。 | これは個々のセッションにのみ影響する可能性があります。セッションを再度開始してください。これは通常、ビューワー内のページを更新することで実行できます。問題が解決しない場合は、MediaTailor がオリジンのマニフェスト形式をサポートすることを確認してください。詳細については、「[コンテンツソースの統合](integrating-origin.md)」を参照してください。 | | 503 | LoadShed | リクエストへの対応中に、MediaTailor でリソース制限が発生しました。 | リクエストを再試行してください。問題が解決しない場合は、 でお使いの AWS リージョンの MediaTailor の報告された正常性を確認します[https://status.aws.amazon.com/](https://status.aws.amazon.com/)。 | | 503 | ThrottlingException | 1 秒あたりのトランザクション数がクォータに到達したため、MediaTailor が使用をスロットリングしています。 | リクエストを再試行します。また、 で、お使いの AWS リージョンの MediaTailor の報告された状態を確認することもできます[https://status.aws.amazon.com/](https://status.aws.amazon.com/)。1 秒あたりのトランザクション数のクオータを引き上げることをお勧めします。詳細については、「[広告挿入のクォータ](quotas.md#ad-insertion-quotas)」を参照してください。 | | 504 | GatewayTimeoutException | MediaTailor がオリジンサーバーと通信している間にタイムアウトが発生しました。 | リクエストを再試行します。問題が解決しない場合は、オリジンサーバーの状態をチェックし、オリジンサーバーが [広告挿入のクォータ](quotas.md#ad-insertion-quotas) に記載されているコンテンツオリジンサーバーのタイムアウト内に応答していることを確認します。 | 追加のサポートが必要な場合は、[AWS Support](https://aws.amazon.com/premiumsupport/) にお問い合わせください。 ## 再生エラーの例 このセクションでは、コマンドラインの操作に表示される可能性のある再生エラーの例をいくつか示します 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]"}% ```