サポート終了通知: 2025 年 11 月 13 日に、 AWS は Amazon Elastic Transcoder のサポートを終了します。2025 年 11 月 13 日以降、Elastic Transcoder コンソールまたは Elastic Transcoder リソースにアクセスできなくなります。

への移行の詳細については AWS Elemental MediaConvert、このブログ記事を参照してください。

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

Elastic Transcoder でのエラー処理

リクエストを送信して Elastic Transcoder API からの応答を取得するとき、以下の 2 種類の API エラーが発生する場合があります。

各 API エラーについて、Elastic Transcoder によって以下の値が返されます。

クライアントとサーバーのエラーについて Elastic Transcoder によって返されるエラーコードのリストについては、「API のエラーコード（クライアントエラーとサーバーエラー）」を参照してください。

さらに、Elastic Transcoder によるジョブの処理中にエラーが発生する場合があります。詳細については、「ジョブ処理中のエラー」を参照してください。

API のエラーコード（クライアントエラーとサーバーエラー）

HTTP ステータスコードは、特定のオペレーションが成功したかどうかを示しています。

応答コード 200 は、オペレーションが成功したことを示します。その他のエラーコードは、クライアントエラー（4xx）またはサーバーエラー（5xx）を示します。

以下の表に、Elastic Transcoder によって返されるエラーを示します。一部のエラーは、同じリクエストを再試行することで解決されます。この表は、連続的な再試行によって解決する可能性が高いエラーを示しています。[Retry (リトライ)] 列の値は次のことを示しています。

リクエストの再試行の詳細については、「エラーの再試行とエクスポネンシャルバックオフ」を参照してください。

エラー応答のサンプル

以下の HTTP 応答は、inputBucket の値が null であり、有効な値でなかったことを示しています。

HTTP/1.1 400 Bad Request
x-amzn-RequestId: b0e91dc8-3807-11e2-83c6-5912bf8ad066
x-amzn-ErrorType: ValidationException
Content-Type: application/json
Content-Length: 124
Date: Mon, 26 Nov 2012 20:27:25 GMT

{"message":"1 validation error detected: Value null at 'inputBucket' failed to satisfy constraint: Member must not be null"}

ジョブ処理中のエラー

ジョブの処理中に Elastic Transcoder でエラーが発生したときは、以下の 2 つの方法でエラーがレポートされます。

エラーの捕捉

アプリケーションをスムーズに実行するには、エラーを見つけ、エラーに対応するロジックを組み込む必要があります。1 つの一般的なアプローチとしては、try ブロックまたは if-then ステートメントにリクエストを実装する方法が挙げられます。

AWS SDK は独自に再試行とエラーチェックを実行します。いずれかの AWS SDK の使用中にエラーが発生した場合は、エラーコードと説明が表示されます。また Request ID の値も表示されます。Request ID の値は、Elastic Transcoder のサポートによって問題のトラブルシューティングを行うために役立ちます。

次の例では、AWS SDK for Java を使用して try ブロック内の項目を削除し、catch ブロックを使用してエラーに対応しています。この場合、リクエストが失敗したと警告されます。この例では AmazonServiceException クラスを使用して、Request ID を含むオペレーションエラーに関する情報を取り出しています。さらにこの例では、その他の理由でリクエストが失敗した場合のために、AmazonClientException クラスも使用されています。

try {
   DeleteJobRequest request = new DeleteJobRequest(jobId);
   DeleteJobResult result = ET.deleteJob(request);
   System.out.println("Result: " + result);
   // Get error information from the service while trying to run the operation	
   }  catch (AmazonServiceException ase) {
      System.err.println("Failed to delete job " + jobId);
      // Get specific error information
      System.out.println("Error Message:    " + ase.getMessage());
      System.out.println("HTTP Status Code: " + ase.getStatusCode());
      System.out.println("AWS Error Code:   " + ase.getErrorCode());
      System.out.println("Error Type:       " + ase.getErrorType());
      System.out.println("Request ID:       " + ase.getRequestId());
   // Get information in case the operation is not successful for other reasons	
   }  catch (AmazonClientException ace) {
      System.out.println("Caught an AmazonClientException, which means"+
      " the client encountered " +
      "an internal error while trying to " +
      "communicate with Elastic Transcoder, " +
      "such as not being able to access the network.");
      System.out.println("Error Message: " + ace.getMessage());
   }

エラーの再試行とエクスポネンシャルバックオフ

DNS サーバー、スイッチ、ロードバランサーなど、ネットワークの多数のコンポーネントが、特定のリクエストの存続期間中どこでもエラーを生成する可能性があります。

ネットワーク環境でこれらのエラー応答を処理する通常の方法は、クライアントアプリケーションで再試行を実装することです。この技術は、アプリケーションの信頼性を向上させ、開発者の運用コストを削減します。

Elastic Transcoder をサポートする各 AWS SDK には自動再試行ロジックが実装されています。AWS SDK for Java は自動的にリクエストを再試行します。再試行は、ClientConfiguration クラスを使用して設定できます。たとえば、ウェブページが最小のレイテンシーで再試行なしでリクエストを実行する場合などに、再試行ロジックを停止させることがあります。再試行を無効にするには、ClientConfiguration クラスを使用し、maxErrorRetry の 0 値を指定します。

AWS SDK を使用していない場合は、サーバーエラー (5xx) を受け取る元のリクエストを再試行する必要があります。ただし、クライアントエラー (4xx、ThrottlingException または ProvisionedThroughputExceededException 以外) は、再試行する前にリクエスト自体を修正して問題を解決する必要があることを示しています。

単純な再試行に加えて、効果的なフロー制御を行うために、エクスポネンシャルバックオフアルゴリズムを使用することをお勧めします。エクスポネンシャルバックオフの背後にある考え方は、連続したエラー応答の再試行間の待機時間を徐々に長く使用することです。たとえば、最初の再試行前に 1 秒間、2 回目の再試行前に 4 秒間、3 回目の再試行前に 16 秒間というように、待機時間を指定します。ただし、リクエストが 1 分後に成功しなかった場合、問題はハードリミットであり、リクエストの頻度でない可能性があります。たとえば、最大許可のパイプライン数に達した可能性があります。1 分程度で再試行が停止するように最大回数を設定します。

次に、再試行ロジックが含まれたワークフローを示します。このワークフローロジックでは、最初にそのエラーがサーバーエラー (5xx) であるかどうかが判別されます。エラーがサーバーエラーである場合は、コードによって元のリクエストが再試行されます。

currentRetry = 0
DO
  set retry to false

  execute Elastic Transcoder request

  IF Exception.errorCode = ProvisionedThroughputExceededException
    set retry to true
  ELSE IF Exception.httpStatusCode = 500
    set retry to true
  ELSE IF Exception.httpStatusCode = 400
    set retry to false 
    fix client error (4xx)

  IF retry = true  
    wait for (2^currentRetry * 50) milliseconds
    currentRetry = currentRetry + 1

WHILE (retry = true AND currentRetry < MaxNumberOfRetries)  // limit retries