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

# Amazon EventBridge でのイベントアーカイブの作成
<a name="eb-archive-event"></a>

EventBridge でアーカイブを作成するときに、[イベントパターン](eb-event-patterns.md)を指定することにより、どのイベントをアーカイブに送信するかを決定することができます。EventBridge は、イベントパターンに一致するイベントをアーカイブに送信します。また、保存期間を設定して、イベントが破棄される前にアーカイブに保存します。

[イベントバスの作成](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-event-bus.html)の一環としてアーカイブを作成することもできます。これらのアーカイブには無期限の保持ポリシーがあり、イベントフィルターはありませんが、アーカイブの作成後に[更新](https://docs.aws.amazon.com/eventbridge/latest/userguide/event-bus-update-archive.html)できます。

**Topics**
+ [アーカイブを定義する](#eb-create-archive-define)
+ [イベントパターンを構築する (オプション)](#eb-create-archive-event-pattern)

## アーカイブを定義する
<a name="eb-create-archive-define"></a>

まず、アーカイブの名前と説明を入力し、イベントを受信するイベントバスを指定します。必要に応じて、アーカイブにイベントを保持する期間を設定することもできます。

**アーカイブを定義するには**

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

1. ソースイベントバスに移動するか、アーカイブを直接作成します。
   + ナビゲーションペインの [**Event Buses**] (イベントバス) を選択します。

     イベントバスの詳細ページで、**[アーカイブ]** タブを選択します。
   + ナビゲーションペインで [**Archives (アーカイブ)**] を選択します。

1. [**Create archive**] (アーカイブの作成) を選択します。

1. **[アーカイブの詳細]** にアーカイブの名前を入力し、必要に応じて説明を入力します。

    この名前は、選択されたリージョンのアカウントで一意である必要があります。アーカイブの作成後は、名前を変更できません。

1. **[ソース]** には、アーカイブにイベントを送信するイベントバスを選択します。

   既存のイベントバスの詳細ページから移動した場合、そのイベントバスの名前がデフォルトで表示されます。

   アーカイブ作成後は、ソースイベントバスを変更することはできません。

1. **[保持期間]** には、アーカイブにイベントを保持する期間を指定します。
   + [**Indefinite**] (不定期) を選択して、アーカイブ内のイベントを保持し、削除しないようにする。
   + 設定された保持期間に対して、何日後に EventBridge がアーカイブからイベントを削除するかを入力します。

1. **[暗号化]** では、アーカイブに保存するイベントを暗号化するときに EventBridge が使用する KMS キーを選択します。
**重要**  
EventBridge がソースイベントバスの暗号化にカスタマーマネージドキーを使用するよう指定した場合は、イベントバスのアーカイブにもカスタマーマネージドキーを指定することを強くお勧めします。
   + **[AWS 所有のキー を使用]** を選択すると、EventBridge は AWS 所有のキーを使用してデータを暗号化します。

     この AWS 所有のキーは、複数の AWS アカウントで使用できるように EventBridge が所有および管理している KMS キーです。一般に、リソースを保護する暗号化キーを制御する必要がない限り、AWS 所有のキー は良い選択です。

     これがデフォルトです。
   + **[カスタマーマネージドキーを使用]** を選択すると、EventBridge は、指定または作成したカスタマーマネージドキーを使用してデータを暗号化します。

     カスタマーマネージドキーは、ユーザーが作成、所有、管理する AWS アカウントの KMS キーです。ユーザーは、この KMS キーに関する完全なコントロール権を持ちます。

     1. 既存のカスタマーマネージドキーを指定するか、**[新しい KMS キーを作成]** を選択します。

       EventBridge は、キーステータスと、指定されたカスタマーマネージドキーに関連付けられているキーエイリアスを表示します。

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

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

次に、オプションのステップとして、EventBridge がアーカイブに送信するイベントをフィルタリングするためのイベントパターンを構築します。そのためには、イベントソースを指定し、イベントパターンのベースを選択し、照合する属性と値を定義します。また、JSON でイベントパターンを生成し、サンプルイベントに対してテストすることもできます。

イベントパターンの詳細については、「[](eb-event-patterns.md)」を参照してください。

**イベントパターンを作成するには**

1. **[Event source]** (イベントソース) で、**[AWS events or EventBridge partner events]** ( イベントまたは EventBridge パートナーイベント) を選択してください。

1. (オプション) **[サンプルイベント]** セクションで、イベントパターンを照らし合わせてテストする **[サンプルイベントタイプ]** を選択します。

   次のサンプルイベントタイプを使用できます｡
   + **[AWS イベント]** — サポートされている AWS のサービスから発行されたイベントを選択します。
   + **[EventBridge partner events]** (EventBridge パートナーイベント) — Salesforce など、EventBridge をサポートしているサードパーティのサービスから送信されるイベントから選択できます。
   + **[自分のイベントを入力]** — 自分のイベントを JSON テキストで入力します。

     独自のカスタムイベントを作成するための開始点として AWS イベントまたはパートナーイベントを使用することもできます。

     1. **[AWS イベント]** または **[EventBridge パートナーイベント]** を選択します。

     1. **[サンプルイベント]** ドロップダウンを使用して、カスタムイベントの開始点として使用するイベントを選択します。

        EventBridge にサンプルイベントが表示されます。

     1. **[コピー]** を選択します。

     1. **[イベントタイプ]** で **[自分のイベントを入力]** を選択します。

     1. JSON 編集ペインのサンプルイベント構造を削除し、その場所に AWS イベントまたはパートナーイベントを貼り付けます。

     1. イベント JSON を編集して独自のサンプルイベントを作成します。

1. **[Creation method]** (作成方法) を選択します。イベントパターンは、EventBridge のスキーマまたはテンプレートから定義するか、またはカスタムイベントパターンを作成できます。

------
#### [ Existing schema ]

   既存の EventBridge スキーマを使用してイベントパターンを作成するには、以下を実行します。

   1. **[Creation method]** (作成方法) セクションの **[Method]** (メソッド) で、**[Use schema]** (スキーマを使用) を選択します。

   1. **[Event pattern]** (イベントパターン) セクションの **[Schema type]** (スキーマタイプ) で、**[Select schema from Schema registry]** (スキーマレジストリからスキーマを選択) を選択します。

   1. **[Schema registry]** (スキーマレジストリ) では、ドロップダウンボックスを選択して、`aws.events` などのスキーマレジストリの名前を入力します。表示されるドロップダウンリストからオプションを選択することもできます。

   1. **[Schema]** (スキーマ) では、ドロップダウンボックスを選択して、使用するスキーマの名前を入力します。例えば、`aws.s3@ObjectDeleted`。表示されるドロップダウンリストからオプションを選択することもできます。

   1. **[Models]** (モデル) セクションでは、任意の属性の横にある **[Edit]** (編集) ボタンを選択してプロパティを開きます。必要に応じて **[Relationship]** (関係) フィールドと **[Value]** (値) フィールドを設定し、次に **[Set]** (設定) を選択して属性を保存します。
**注記**  
属性の定義については、属性名の横にある**[Info]** (情報) アイコンを選択してください。イベントで属性のプロパティを設定する方法については、属性のプロパティダイアログボックスの **[Note]** (注意) セクションを開いてください。  
属性のプロパティを削除するには、その属性の **[Edit]** (編集) ボタンを選択し、**[Clear]** (クリア) を選択します。

   1. **[Generate event pattern in JSON]** (JSON でイベントパターンを生成) を選択し、イベントパターンを JSON テキストとして生成して検証します。

   1. (オプション) サンプルイベントをテストパターンと照らし合わせてテストするには、**[テストパターン]** を選択します。

      サンプルイベントがイベントパターンと一致するかどうかを示すメッセージボックスが表示されます。

      次のオプションのいずれかを選択することもできます。
      + **[Copy]** (コピー) — イベントパターンをデバイスのクリップボードにコピーします。
      + **[Prettify]** (整文) — 改行、タブ、スペースを追加して JSON テキストを読みやすくします。

------
#### [ Custom schema ]

   カスタムスキーマを記述し、それをイベントパターンに変換して、以下の操作を行います。

   1. **[Creation method]** (作成方法) セクションの **[Method]** (メソッド) で、**[Use schema]** (スキーマを使用) を選択します。

   1. **[Event pattern]** (イベントパターン) セクションで、**[Schema type]** (スキーマの種類) で、**[Enter schema]** (スキーマを入力) を選択します。

   1. テキストボックスにスキーマを入力します。スキーマは有効な JSON テキストとしてフォーマットする必要があります。

   1. **[Models]** (モデル) セクションで、任意の属性の横にある**[Edit]** (編集) ボタンを選択してプロパティを開きます。必要に応じて **[Relationship]** (関係) フィールドと **[Value]** (値) フィールドを設定し、次に **[Set]** (設定) を選択して属性を保存します。
**注記**  
属性の定義については、属性名の横にある**[Info]** (情報) アイコンを選択してください。イベントで属性のプロパティを設定する方法については、属性のプロパティダイアログボックスの **[Note]** (注意) セクションを開いてください。  
属性のプロパティを削除するには、その属性の **[Edit]** (編集) ボタンを選択し、**[Clear]** (クリア) を選択します。

   1. **[Generate event pattern in JSON]** (JSON でイベントパターンを生成) を選択し、イベントパターンを JSON テキストとして生成して検証します。

   1. (オプション) サンプルイベントをテストパターンと照らし合わせてテストするには、**[テストパターン]** を選択します。

      サンプルイベントがイベントパターンと一致するかどうかを示すメッセージボックスが表示されます。

      次のオプションのいずれかを選択することもできます。
      + **[Copy]** (コピー) — イベントパターンをデバイスのクリップボードにコピーします。
      + **[Prettify]** (整文) — 改行、タブ、スペースを追加して JSON テキストを読みやすくします。

------
#### [ Event pattern ]

   カスタムイベントパターンを JSON 形式で記述するには、以下を実行します。

   1. **[Creation method]** (作成方法) セクションの **[Method]** (メソッド) で、**[Custom pattern (JSON editor)]** (カスタムパターン (JSON エディタ)) を選択します。

   1. **[Event pattern]** (イベントパターン) には、カスタムイベントパターンを JSON 形式のテキストで入力します。

   1. (オプション) サンプルイベントをテストパターンと照らし合わせてテストするには、**[テストパターン]** を選択します。

      サンプルイベントがイベントパターンと一致するかどうかを示すメッセージボックスが表示されます。

      次のオプションのいずれかを選択することもできます。
      + **[Copy]** (コピー) — イベントパターンをデバイスのクリップボードにコピーします。
      + **[Prettify]** (整文) — 改行、タブ、スペースを追加して JSON テキストを読みやすくします。
      + **[Event pattern form]** (イベントパターンフォーム) — パターンビルダーでイベントパターンを開きます。パターンをそのままパターンビルダーでレンダリングできない場合、EventBridge はパターンビルダーを開く前に警告を表示します。

------

1. [**Create archive**] (アーカイブの作成) を選択します。

イベントがアーカイブに正常に送信されたことを確認するには、EventBridge APIの [https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_DescribeArchive.html](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_DescribeArchive.html) オペレーションを使用して、アーカイブのイベント数が `EventCount` に反映されているかどうかを確認できます。0 の場合、アーカイブにはイベントはありません。