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

への移行の詳細については AWS Elemental MediaConvert、この[ブログ記事](https://aws.amazon.com/blogs/media/how-to-migrate-workflows-from-amazon-elastic-transcoder-to-aws-elemental-mediaconvert/)を参照してください。

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

# ジョブのステータスの通知
<a name="notifications"></a>

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 デベロッパー ガイド](https://docs.aws.amazon.com/sns/latest/dg/)」を参照してください。

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

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

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

Elastic Transcoder API を使用して、ジョブのステータスの変更を通知するように Elastic Transcoder を設定する方法

1. 1 つ以上の Amazon SNS トピックを作成し、各トピックにサブスクライブします。詳細については、[Amazon Simple Notification Service ドキュメント](https://aws.amazon.com/documentation/sns/)を参照してください。

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

1. パイプラインを作成するか、既存のパイプラインを更新します。変わったときに通知の対象にするステータス ([Progressing]、[Complete]、[Warning]、[Error]) ごとに、ステップ 1 で作成した該当する Amazon SNS トピックを指定します。詳細については「[パイプラインを作成する](create-pipeline.md)」、「[パイプラインを更新する](update-pipeline.md)」または「[パイプラインの通知を更新する](update-pipeline-notifications.md)」を参照してください。

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

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

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"
   }
}
```