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

# Amazon EventBridge を使用してイベント駆動型アプリケーション AWS サポート に統合する
<a name="eventbridge-integration"></a>

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

たとえば、アカウントで次の AWS サポート イベントが発生するたびに通知を受け取ることができます。
+ サポートケースが作成、解決、または再オープンされたとき
+ 既存のサポートケースにコレスポンデンスが追加されたとき

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

## EventBridge が AWS サポート イベントをルーティングする方法
<a name="eventbridge-routes-service-events-aws.support"></a>

EventBridge が AWS サポート イベントと連携する方法は次のとおりです。

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

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

![AWS サービスは EventBridge のデフォルトのイベントバスにイベントを送信します。イベントがルールのイベントパターンに一致すると、EventBridge はそのルールで指定されたターゲットに、イベントを送信します。](http://docs.aws.amazon.com/ja_jp/awssupport/latest/user/images/eventbridge-integration-how-it-works.png)


## AWS サポート イベント
<a name="supported-events"></a>

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


| イベントの詳細のタイプ | 説明 | 
| --- | --- | 
| [Support Case Update](event-detail-support-case-update.md) | サポートケースの変更を表します。 | 

### イベントの構造
<a name="eventbridge-event-structure"></a>

 AWS サービスからのすべてのイベントには、次の 2 種類のデータが含まれます。
+ イベントのソースである AWS サービス、イベントが生成された時刻、イベントが発生したアカウントとリージョンなど、イベントに関するメタデータを含む一般的なフィールドのセット。これらの一般的なフィールドの定義については、「*Amazon EventBridge イベントリファレンス*」の「[イベントの構造](https://docs.aws.amazon.com/eventbridge/latest/ref/overiew-event-structure.html)」を参照してください。
+ `detail` フィールドには、その特定のサービスイベントに固有のデータが含まれます。

### AWS サポート によるイベント配信 AWS CloudTrail
<a name="eventbridge-events-via-cloudtrail"></a>

AWS サービスは EventBridge のデフォルトイベントバスに直接イベントを送信できます。さらに、 AWS CloudTrail は多数の AWS サービスから発生したイベントも EventBridge に送信します。これらのイベントには、API コール、コンソールのサインインとアクション、サービスイベント、CloudTrail Insights などがあります。詳細については、「*Amazon EventBridge ユーザーガイド*」の「[AWS service events delivered via AWS CloudTrail](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-service-event-cloudtrail.html)」を参照してください。

EventBridge に送信される AWS サポート イベントのリストについては、[https://docs.aws.amazon.com/eventbridge/latest/ref/welcome.html](https://docs.aws.amazon.com/eventbridge/latest/ref/welcome.html)の AWS サポート トピックを参照してください。

## イベントに一致する AWS サポート イベントパターンの作成
<a name="eventbridge-event-delivery-filter"></a>

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

各イベントパターンは 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](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-event-patterns.html)」を参照してください。

### 関連情報
<a name="see-also-eventbridge-support"></a>

で EventBridge を使用する方法の詳細については AWS サポート、次のリソースを参照してください。
+ [Amazon EventBridge で AWS サポート API を自動化する方法](https://aws.amazon.com/blogs/mt/how-to-automate-aws-support-api-with-amazon-eventbridge)
+ GitHub の[AWS サポート ケースアクティビティ通知機能](https://github.com/aws-samples/aws-support-case-activity-notifier)