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

# Amazon EventBridge でのルールの作成
<a name="eb-create-rule-visual"></a>

## 前提条件
<a name="eb-create-rule-prerequisites"></a>

開始する前に、以下を確認してください。
+ Amazon EventBridge コンソールへのアクセス
+ EventBridge ルールを作成するための適切な IAM アクセス許可
+ イベント駆動型アーキテクチャの基本的な理解

## 概要:
<a name="eb-create-rule-overview"></a>

EventBridge が受信したイベントに対してアクションを実行するには、ルールを作成できます。イベントがルールで定義されたイベントパターンと一致すると、EventBridge は指定されたターゲットにイベントを送信します。

このトピックでは、指定したイベントバスに送信されるイベントを EventBridge が一致させるために使用するルールを作成する方法について説明します。

EventBridge ルールの作成には、主に 4 つのステップがあります。

1. 処理するイベントを選択する

1. イベントフィルタリングとテストを設定する

1. ターゲットの選択と設定

1. ルール設定を構成する

## イベントを選択する
<a name="eb-create-rule-source"></a>

まず、ターゲットに送信するイベントを選択します。

**イベントを選択するには**

1. Amazon EventBridge コンソール の[https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/) を開いてください。

1. ナビゲーションペインで、**ルール**を選択し、**ルールの作成**を選択します。

1. Events ****タブで、ターゲットに送信するイベントを見つけます。

   1. **AWS サービスイベント**または**カスタムイベント**を選択します。

   1. 検索ボックスを使用するか、イベントリストを参照して、ターゲットに送信するイベントを見つけます。

   1. 1 つ以上のイベントを**ビルド**キャンバスにドラッグし、**トリガーイベントにドロップします**。

   EventBridge は**トリガーイベント**セクションを表示します。このセクションには以下が含まれます。
   + 選択した**イベント**を一覧表示するイベント。
   + **スキーマ**。使用可能な場合は、選択したイベントのスキーマを表示します。

     **スキーマ**には 3 つのタブがあります。
     + **ツリー**: イベントスキーマのツリービュー。
     + **コード**: Open API 仕様または JSON 形式のイベントスキーマ。
     + **情報**: スキーマの概要情報。
   + **サンプルイベント**。使用可能な場合は、選択したイベントのサンプルを表示します。
   + 選択したすべての**イベントを選択するイベントパターンを含むイベントパターン (フィルタ)**。

## 必要なもののみを送信するようにイベントをフィルタリングする
<a name="eb-create-rule-event-pattern-visual"></a>

おそらく、特定のタイプの*すべての*イベントをターゲットに送信するわけではありません。イベントパターンをより具体的にすることで、関心のある属性と値を含むイベントのみを選択できます。

### イベントパターンを編集する (オプション)
<a name="eb-create-rule-event-pattern-steps"></a>

**トリガーイベント**ペインでは、次の 2 つの方法でイベントパターンを構築できます。
+ **スキーマ**ツリービューを使用して視覚的に表示
+ **イベントパターン**ペインで JSON を直接編集する

**スキーマツリービューを使用してイベントパターンを編集するには**

1. **スキーマ**ペインの**ツリー**タブを選択します。

1. フィルターを追加および編集して、イベントパターンを構築します。

   1. イベントパターンにフィルターとして追加する属性の横にあるフィルターアイコンを選択します。

   1. ドロップダウンリストから比較演算子を選択します。

      比較演算子の詳細については、[「イベントパターンの作成](eb-create-pattern-operators.md)」を参照してください。

   1. 一致させる値を入力します。

   1. 完了するには、チェックマークをクリックします。

   EventBridge は、作成したフィルターを**イベントパターン**ペインの JSON に追加します。

1. 必要なすべてのイベント属性に一致するイベントパターンを構築するまで、フィルターを追加します。

### イベントパターンをテストする
<a name="eb-create-rule-event-pattern-test"></a>

必要なすべてのイベント属性に一致するイベントパターンを構築したら、イベントパターンが期待どおりに動作することをテストします。

#### イベントパターンをテストする (オプション)
<a name="eb-create-rule-event-pattern-test-steps"></a>

1. テスト用のサンプルイベントを選択するか、独自のイベントを使用します。
   + **提供されたサンプルイベントを使用する**

     1. **提供されたサンプルイベントを使用する** を選択します。

     1. **サンプルトリガーイベント**で、ドロップダウンリストからテストに使用するイベントを選択します。
   + **独自のイベントを使用する**

     1. **[独自のイベントを使用]** を選択します。

        EventBridge は、空の `details` 要素を持つ汎用イベントを表示します。

     1. イベント JSON を編集して、イベントパターンをテストするイベントを作成します。
**ヒント**  
テストで使用する独自のカスタムイベントを作成するための開始点として、提供されているサンプルイベントを使用できます。  
**[提供されたサンプルイベントを使用]** を選択し、**[サンプルトリガーイベント]** からイベントを選択して、**[コピー]** を選択します。
**[独自のイベントを使用]** を選択します。
ウィンドウでイベント全体を選択し、サンプルイベントを貼り付けます。
必要に応じてイベントを編集します。

1. **テストの実行** を選択します。

   EventBridge は、テストイベントがイベントパターンと一致するかどうかを示すメッセージを表示します。

## ターゲットを選択する
<a name="eb-create-rule-target-visual"></a>

1 つ (および最大 5 つ) のターゲットを**ビルド**キャンバスにドラッグし、**ターゲット**にドロップして、指定されたイベントパターンに一致するイベントを受信します。ターゲットには以下が含まれます。
+ 同じ または別の EventBridge イベントバス AWS アカウント
+ Salesforce などの SaaS パートナーを含む EventBridge API の送信先
+ Amazon SQS キューや Amazon SNS トピックなど、さまざまな AWS サービスリソース

**ターゲットを選択するには**

1. ターゲットペインから**ターゲット**タイプを選択し、ビルドキャンバスの**ターゲット**シェイプにドロップします。

   EventBridge は、ビルドの**ターゲット**セクションに、選択したターゲットのタイプに基づいて該当する設定オプションを表示します。
**ヒント**  
複数のターゲットを指定した場合、ターゲットシェイプを選択すると、そのターゲットの設定セクションが表示されます。

1. ターゲットタイプに基づいてターゲットを設定します。詳細な設定手順については、[EventBridge ターゲット](eb-targets.md)」を参照してください。

### ターゲットに送信されるイベントデータをカスタマイズする
<a name="eb-create-rule-target-transform"></a>

EventBridge イベントバスまたは EventBridge API 送信先以外のターゲットを選択した場合は、ターゲットに実際に配信されるデータをカスタマイズできます。

#### 送信されたイベントデータを変換または置き換える (オプション)
<a name="eb-create-rule-target-transform-steps"></a>

1. ビルドデザインキャンバスで、**ターゲット**シェイプ**の入力変換**アイコンを選択します。

   EventBridge は**入力変換**セクションを表示します。

1. **入力変換設定**で、**有効化** を選択します。

1. 変換方法を選択して、一致するイベントのためにターゲットに送信されるテキストをカスタマイズする方法を選択します。
   + **一致したイベントの一部** — EventBridge は、元のソースイベントの指定された部分のみをターゲットに送信します。
   + **定数 (JSON テキスト)** — EventBridge は指定された JSON テキストのみをターゲットに送信します。元のソースイベントは、いずれの部分も送信されません。
   + **入力トランスフォーマー** – EventBridge がターゲットに送信するテキストをカスタマイズするように入力トランスフォーマーを設定します。詳細については、[「ターゲット入力の変換](eb-transform-target-input.md)」を参照してください。

## ルールを設定する
<a name="eb-create-rule-configure"></a>

最後に、ルールを設定して作成します。

**ルールを設定するには (コンソール)**

1. [**設定**] を選択します。

1. ルールの**名前**を入力し、オプションで**説明**を入力します。

   ルールは、同じ AWS リージョン および同じイベントバスの別のルールと同じ名前にすることはできません。

1. **[Event bus]** (イベントバス) で、このルールに関連付けるイベントバスを選択します。

   このルールをアカウントからのイベントと一致させるには、**AWS のデフォルトのイベントバス**を選択します。 AWS のサービス アカウントの がイベントを送信すると、常にアカウントのデフォルトのイベントバスに送信されます。

1. ルールが作成されるとすぐに有効にするには、**アクティベーション **で**アクティブ**を有効にします。

1. (オプション) ルールに 1 つ以上のタグを入力します。詳細については、「[Amazon EventBridge でのリソースのタグ付け](eb-tagging.md)」を参照してください。

1. **[作成]** を選択します。

## 次の手順
<a name="eb-create-rule-next-steps"></a>

ルールを作成したら、次のことができます。
+ [メトリクスを使用してルールのパフォーマンスをモニタリングする](eb-monitoring.md)
+ [サンプルイベントでルールをテストする](eb-event-pattern-sandbox.md)
+ [必要に応じてイベントパターンを変更する](eb-event-patterns.md)
+ [既存のルールにターゲットを追加する](eb-targets.md)

## その他のリソース
<a name="eb-create-rule-additional-resources"></a>

EventBridge ルールの詳細については、以下を参照してください。
+ [EventBridge ルールの概要](eb-rules.md)
+ [イベントパターンの作成](eb-event-patterns.md)
+ [EventBridge ターゲット](eb-targets.md)
+ [EventBridge ルールのトラブルシューティング](eb-troubleshooting.md)