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

# EventBridge ルールの設定
<a name="setting-up-cloudwatch-event-rules"></a>

Amazon EventBridge ルールを設定するには: からの AWS Elemental MediaConvert イベントと、Amazon Simple Notification Service (Amazon SNS) や などのジョブステータスの変更に応答するターゲットサービスをリンクするルールを作成します AWS Lambda。

で EventBridge ルールを設定するチュートリアルについては AWS Elemental MediaConvert、「」を参照してください[チュートリアル: 失敗したジョブに関する E メール通知の設定](#mediaconvert_sns_tutorial)。

MediaConvert によって EventBridge イベントストリームで送信されるイベントのリストについては、「[MediaConvert EventBridge イベントのリスト](mediaconvert_event_list.md)」を参照してください。

EventBridge の使用方法の詳細については、[「Amazon EventBridge ユーザーガイド」](https://docs.aws.amazon.com/eventbridge/latest/userguide/)を参照してください。

トラブルシューティングの詳細については、「Amazon EventBridge ユーザーガイド」の[「Amazon EventBridge のトラブルシューティング」](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-troubleshooting.html)を参照してください 。

**Topics**
+ [チュートリアル: 失敗したジョブに関する E メール通知の設定](#mediaconvert_sns_tutorial)
+ [ステップ 1: Amazon SNS でトピックを作成する](#mediaconvert_sns_create_topic)
+ [ステップ 2: EventBridge ルールでイベントパターンを指定する](#mediaconvert_sns_rule_event_source)
+ [ステップ 3: Amazon SNS トピックを追加してルールを完了する](#add-target-and-finish-rule)
+ [ステップ 4: ルールをテストする](#mediaconvert_sns_test_rule)

## チュートリアル: 失敗したジョブに関する E メール通知の設定
<a name="mediaconvert_sns_tutorial"></a>

このチュートリアルでは、ジョブのステータスが `ERROR` に変わったときのイベントをキャプチャし、そのイベントをユーザーに通知する EventBridge イベントルールを設定します。これを行うには、まず、失敗したジョブに関する E メール通知を送信する Amazon SNS のトピックを作成します。次に、EventBridge でルールを作成します。イベントソースを定義して Amazon SNS トピック (「ターゲット」) を参照します。

## ステップ 1: Amazon SNS でトピックを作成する
<a name="mediaconvert_sns_create_topic"></a>

EventBridge ルールの設定の前半部分では、ルールのターゲットを作成します。この例では、Amazon SNS トピックを作成してサブスクライブします。

**Amazon SNS トピックを作成するには**

1. Amazon SNS コンソール ([https://console.aws.amazon.com/sns/v3/home](https://console.aws.amazon.com/sns/v3/home)) を開きます。

1. ナビゲーションペインで、[**Topics (トピック)**]、[**Create topic (トピックの作成)**] の順に選択してください。

1. [**Type (タイプ)**] で、[**Standard (標準)**] を選択します。

1. [**名**] については、**MediaConvertJobErrorAlert** を入力し、[**トピックを作成**] を選択します。

1. 作成したトピックの**[名前]**を選択して、**[トピックの詳細]**を表示します。

1. **[MediaConvertJobErrorAlert]** の [**トピックの詳細**] ページで、[**サブスクリプション**] セクションの **[サブスクリプションを作成] **を選択します。

1. [**Protocol (プロトコル)**] で [**Email (Eメール)**] を選択します。**[Endpoint (エンドポイント)]** に、Amazon SNS から通知を送信する先の E メールアドレスを入力します。

1. [**Create subscription (サブスクリプションを作成)**] を選択します。

1. Amazon SNS から通知 E メールが送信されます。受信した E メールで、[**Confirm subscription (サブスクリプションを確認)**] リンクを選択します。

## ステップ 2: EventBridge ルールでイベントパターンを指定する
<a name="mediaconvert_sns_rule_event_source"></a>

このステップでは、EventBridge ルールでイベントパターンを指定する方法を説明します。このルールはジョブステータスが `ERROR` に変更したときに MediaConvert によって送信されるイベントをキャプチャします。

**EventBridge ルールでイベントパターンを設定するには**

1. Amazon EventBridge コンソール ([https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/)) を開きます。

1. ナビゲーションペインで [**Rules (ルール)**] を選択します。**デフォルト**の **[イベントバス]** を維持し、次に **[ルールを作成]** を選択します。

1. **[名前]** に「**MediaConvertJobStateError**」と入力し、**[次へ]** を選択します。

1. [イベントソース] から始まる **[イベントパターン]** セクションで、以下の設定を選択します。
   + **イベントソース**: **AWS services**
   + **AWS サービス**: **MediaConvert**
   + **イベントタイプ**: **MediaConvert Job State Change**
   + **イベントタイプ、特定の状態**：**ERROR**

1. **[イベントパターン]** ボックスは以下の例のようになります。

   ```
   {
     "source": ["aws.mediaconvert"],
     "detail-type": ["MediaConvert Job State Change"],
     "detail": {
       "status": ["ERROR"]
     }
   }
   ```

   このコードは、ジョブのステータスが `ERROR` に変わるイベントに一致する EventBridge イベントルールを定義します。イベントパターンの詳細については、*「Amazon CloudWatch ユーザーガイド」*の[「Events and event patterns (イベントとイベントパターン)」](https://docs.aws.amazon.com/AmazonCloudWatch/latest/DeveloperGuide/CloudWatchEventsandEventPatterns.html)を参照してください。

1. [**次へ**] を選択します。

## ステップ 3: Amazon SNS トピックを追加してルールを完了する
<a name="add-target-and-finish-rule"></a>

次に、ステップ 1 で作成した Amazon SNS トピックを、ステップ 2 で開始した EventBridge ルールに追加します。

**Amazon SNS トピックを追加して EventBridge ルールを完了するには**

1. **[ターゲットを選択]** セクションで **[ターゲットの選択]** の **[SNS トピック]** を選択します。

1. **[トピック]** で、**[MediaConvertJobErrorAlert]** を選択します。

1. [**次へ**] を選択します。

1. オプションでタグを追加します。続いて、[**Next (次へ)**] を選択します。

1. 設定を確認します。次に、**[Create rule (ルールを作成)]** を選択します。

## ステップ 4: ルールをテストする
<a name="mediaconvert_sns_test_rule"></a>

ルールをテストするには、エラーが発生することがわかっているジョブを送信します。例えば、存在しない入力の場所を指定します。イベントルールが正しく設定されていれば、数分以内にイベントテキストメッセージが記載された E メールが届きます。

**ルールをテストするには**

1. [https://console.aws.amazon.com/mediaconvert](https://console.aws.amazon.com/mediaconvert) で AWS Elemental MediaConvert コンソールを開きます。

1. MediaConvert の新しいジョブを送信します。詳細については、「[チュートリアル: ジョブ設定の構成](setting-up-a-job.md)」を参照してください。

1. Amazon SNS トピックの設定時に指定した E メールアカウントを確認します。ジョブエラーに関する E メール通知を受信したことを確認します。