EventBridge ルールの設定

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

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

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

EventBridge の使用方法の詳細については、「Amazon EventBridge ユーザーガイド」を参照してください。

トラブルシューティングの詳細については、「Amazon EventBridge ユーザーガイド」の「Amazon EventBridge のトラブルシューティング」を参照してください 。

チュートリアル: 失敗したジョブに関する E メール通知の設定

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

ステップ 1: Amazon SNS でトピックを作成する

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

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

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

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

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

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

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

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

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

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

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

ステップ 2: EventBridge ルールでイベントパターンを指定する

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

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

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

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

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

4. [イベントソース] から始まる [イベントパターン] セクションで、以下の設定を選択します。

   • イベントソース: AWS services

   • AWS サービス: MediaConvert

   • イベントタイプ: MediaConvert Job State Change

   • イベントタイプ、特定の状態：ERROR

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

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

   このコードは、ジョブのステータスが ERROR に変わるイベントに一致する EventBridge イベントルールを定義します。イベントパターンの詳細については、「Amazon CloudWatch ユーザーガイド」の「Events and event patterns (イベントとイベントパターン)」を参照してください。

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

ステップ 3: Amazon SNS トピックを追加してルールを完了する

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

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

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

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

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

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

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

ステップ 4: ルールをテストする

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

ルールをテストするには

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

2. MediaConvert の新しいジョブを送信します。詳細については、「チュートリアル: ジョブ設定の構成」を参照してください。

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