ジョブのステータスの通知 - Amazon Elastic Transcoder

でコストを節約し、より多くの機能を取得 AWS Elemental MediaConvert

MediaConvert は、包括的な一連の高度なトランスコード機能を提供する、より新しいファイルベースのビデオトランスコードサービスで、オンデマンド料金は 1 分あたり 0.0075 USD からとなります。もっと読む。

既に Amazon Elastic Transcoder をご使用中ですか？ への移行は簡単です MediaConvert。詳細については、移行プロセスに関する貴重な情報やその他のリソースへのリンクを記載した本概要を参照してください。

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

ジョブのステータスの通知

Elastic Transcoder には、ジョブのステータスが変わると通知する機能があります。Elastic Transcoder では、以下のステータスに変わると通知が送信されるように設定できます。

  • Progressing: Elastic Transcoder によるパイプライン内のジョブの処理が開始されました。

  • Complete: Elastic Transcoder によるパイプライン内のジョブの処理が完了しました。

  • Warning: Elastic Transcoder によるパイプライン内のジョブの処理中に警告が発生しました。

  • Error: Elastic Transcoder によるパイプライン内のジョブの処理中にエラーが発生しました。

Elastic Transcoder は、Amazon Simple Notification Service (Amazon ) を使用して通知を送信しますSNS。Amazon SNSには、HTTPエンドポイント、E メールアドレス、Amazon Simple Queue Service (Amazon SQS) キューにメッセージを送信する機能など、さまざまな通知オプションが用意されています。これらのオプションとその他のオプションの詳細については、「Amazon Simple Notification Service デベロッパー ガイド」を参照してください。

通知はイベント駆動型のアプリケーションの設計に便利です。通知を使用してジョブが完了したタイミングを判断すると、ポーリングを削除でき、ポーリングによって発生する例外 Limit Exceeded (HTTPステータスコード 429) が発生することはありません。

通知はパイプラインの作成または更新時に設定します。そのパイプラインにジョブを送信するたびに、Elastic Transcoder によって該当する通知が送信されます。

重要

通知を変更すると、その変更はすぐに反映されます。通知の変更後に送信するジョブだけでなく、すでに送信したが Elastic Transcoder によってまだ処理が開始されていないジョブにも、変更は適用されます。

Elastic Transcoder の使用時にジョブステータスの変更を通知するように Elastic Transcoder を設定するにはAPI：

  1. 1 つ以上の Amazon SNSトピックを作成し、各トピックをサブスクライブします。詳細については、Amazon Simple Notification Service ドキュメントを参照してください。

    使用する Amazon SNSトピックが既にある場合は、このステップをスキップできます。

  2. パイプラインを作成するか、既存のパイプラインを更新します。通知するステータスの変更 (進行、完了、警告、エラー) ごとに、ステップ 1 で作成した該当する Amazon SNSトピックを指定します。詳細については「パイプラインを作成する」、「パイプラインを更新する」または「パイプラインの通知を更新する」を参照してください。

  3. Elastic Transcoder にジョブを送信することで、[Progressing] ステータスと [Complete] ステータスについての通知をテストします。

Elastic Transcoder コンソールを使用して、通知を設定することもできます。コンソールを使用する場合は、パイプラインを作成または更新するときに Amazon SNSトピックを作成できます。ただし、新しいトピックをサブスクライブCLIするには、Amazon SNSコンソールAPI、、または を使用する必要があります。

Elastic Transcoder がステータスの変更の通知を送信すると、通知で返されるメッセージは次のJSON形式になります。メッセージには、ジョブのステータスだけでなく、各出力のステータスも含まれます。

{
   "state" : "PROGRESSING|COMPLETED|WARNING|ERROR",
   "errorCode" : "the code of any error that occurred",
   "messageDetails" : "the notification message you created in Amazon SNS",
   "version" : "API version that you used to create the job",
   "jobId" : "value of Job:Id object that Elastic Transcoder 
             returns in the response to a Create Job request",
   "pipelineId" : "value of PipelineId object 
                  in the Create Job request",
   "input" : {
      job Input settings
   },
   "outputKeyPrefix" : "prefix for file names in Amazon S3 bucket",
   "outputs": [
      {
         applicable job Outputs settings,
         "status" : "Progressing|Complete|Warning|Error"
      },
      {...}
   ],
   "playlists": [
      {
         applicable job playlists settings
      }
   ],
   "userMetadata": {
      "metadata key": "metadata value"
   }
}