EventBridge が AWS サポートイベントを配信する方法 AWS サポートのイベントイベントパターンの作成

Amazon EventBridge を使用して AWS サポートをイベント駆動型アプリケーションに統合する

AWS サポートで発生するイベントを使用してアプリケーションコンポーネント間で通信し、ダウンストリームプロセスを開始するイベント駆動型アプリケーション (EDA) に、AWS サポートを組み込むことができます。

例えば、アカウント内で次の AWS サポートイベントが発生したときに通知を受け取ることができます。

サポートケースが作成、解決、または再オープンされたとき
既存のサポートケースにコレスポンデンスが追加されたとき

これを行うには、Amazon EventBridge を使用して、AWS サポートから他のソフトウェアコンポーネントにイベントを配信します。Amazon EventBridge は、イベントを使用してアプリケーションコンポーネントを接続するサーバーレスサービスです。これにより、コードやオペレーションを追加することなく、AWS サポートなどの AWS サービスをイベント駆動型アーキテクチャに簡単に統合できます。

EventBridge が AWS サポートイベントを配信する方法

EventBridge が AWS サポートイベントを処理する方法を以下に示します。

多くの AWS サービスと同様に、AWS サポートはイベントを生成して EventBridge のデフォルトのイベントバスに送信します。イベントバスはルーターであり、イベントを受信して指定された送信先やターゲットに配信します。ターゲットには、他の AWS サービス、カスタムアプリケーション、SaaS パートナーアプリケーションを含めることができます。

EventBridge は、イベントバスで作成されたルールに従ってイベントを配信します。ルールごとに、フィルターまたはイベントパターンを指定して、必要なイベントのみを選択します。イベントがイベントバスに送信されるたびに、EventBridge はイベントを各ルールと比較します。イベントがルールに一致すると、EventBridge は指定されたターゲットにイベントを配信します。

AWS のサービスは、EventBridge のデフォルトのイベントバスにイベントを送信します。イベントがルールのイベントパターンに一致すると、EventBridge はそのルールで指定されたターゲットに、イベントを送信します。

AWS サポートのイベント

AWS サポートは、次のイベントをデフォルトの EventBridge イベントバスに自動的に配信します。

イベントの詳細のタイプ	説明
Support Case Update	サポートケースの変更を表します。

イベントの構造

AWS サービスからのすべてのイベントには、次の 2 種類のデータが含まれます。

イベントのソースである AWS サービス、イベントが生成された時刻、イベントが発生したアカウントと地域など、イベントに関するメタデータを含む共通のフィールドセット。これらの一般的なフィールドの定義については、「Amazon EventBridge イベントリファレンス」の「イベントの構造」を参照してください。
detail フィールドには、その特定のサービスイベントに固有のデータが含まれます。

AWS CloudTrail を経由した AWS サポートイベントの配信

AWS サービスは、EventBridge のデフォルトのイベントバスに直接イベントを配信できます。また、AWS CloudTrail は多数の AWS サービスから発生したイベントも EventBridge に配信します。これらのイベントには、API コール、コンソールのサインインとアクション、サービスイベント、CloudTrail Insights などがあります。詳細については、「Amazon EventBridge ユーザーガイド」の「AWS service events delivered via AWS CloudTrail」を参照してください。

EventBridge に送信される AWS サポートイベントのリストについては、「AWS イベントリファレンス」の「AWS サポート」のトピックを参照してください。

AWS サポートイベントに一致するイベントパターンの作成

イベントパターンは、選択するイベントに含めるデータを指定するフィルターです。

各イベントパターンは JSON 形式のオブジェクトで、以下が含まれています。

イベントを送信するサービスを識別する source 属性。AWS サポートイベントの場合、ソースは aws.support です。
(オプション): 照合するイベント名の配列を含む detail-type 属性。
(オプション): 照合対象となるその他のイベントデータを含む detail 属性。

例えば、次のイベントパターンでは、AWS サポートからのすべての Support Case Update イベントを選択します。


{
  "source": ["aws.support"],
  "detail-type": ["Support Case Update"]
}

イベント自体の値を含めることで、イベントの選択をより具体的にすることができます。例えば、次のイベントパターンは、再オープンされるケースを表す Support Case Update イベントと一致します。


{
  "source": ["aws.support"],
  "detail-type": ["Support Case Update"],
  "detail": {
      "event-name": "ReopenCase"
    }
}

イベントパターンの記述の詳細については、「EventBridge ユーザーガイド」の「Event patterns」を参照してください。