Amazon EventBridge イベントパターン

特定のイベントバスまたはパイプに配信されるすべてのイベントを処理する必要がない場合があります。むしろ、イベントのソース、イベントタイプ、および/またはそれらのイベントの属性に基づいて、配信されるすべてのイベントのサブセットを選択することをお勧めします。

ターゲットに送信するイベントを指定するには、イベントパターン を作成します。イベントパターンは、イベントをターゲットに送信するかどうかを決定するために が EventBridge 使用するデータを定義します。イベントパターンがイベントと一致する場合、 EventBridge はイベントをターゲットに送信します。イベントパターンは、一致するイベントと同じ構造をしています。イベントパターンは、イベントに一致するか、一致しないかのいずれかになります。

例えば、Amazon からの次のイベントを考えてみましょうEC2。

{
  "version": "0",
  "id": "6a7e8feb-b491-4cf7-a9f1-bf3703467718",
  "detail-type": "EC2 Instance State-change Notification",
  "source": "aws.ec2",
  "account": "111122223333",
  "time": "2017-12-22T18:43:48Z",
  "region": "us-west-1",
  "resources": [
    "arn:aws:ec2:us-west-1:123456789012:instance/i-1234567890abcdef0"
  ],
  "detail": {
    "instance-id": "i-1234567890abcdef0",
    "state": "terminated"
  }
}

次のイベントパターンは、すべての Amazon EC2instance-terminationイベントを選択します。イベントパターンは、イベントに一致する 3 つの要件を指定することでこれを行います。

1. イベントソースは Amazon である必要がありますEC2。

2. イベントは Amazon EC2状態変更通知である必要があります。

3. Amazon EC2インスタンスの状態は である必要がありますterminated。

{
  "source": ["aws.ec2"],
  "detail-type": ["EC2 Instance State-change Notification"],
  "detail": {
    "state": ["terminated"]
  }
}

この例では、イベントパターンには、event-- sourceおよび detail-type-- に関するフィールドと、event body- からのフィールドが含まれていることに注意してくださいstate。

重要

では EventBridge、 higher-than-expected 料金やスロットリングにつながる可能性のあるルールを作成できます。例えば、ルールが無限に再帰的に実行される無限ループに陥るようなルールを誤って作成してしまうことがあります。Amazon S3 バケットでACLs変更された を検出し、ソフトウェアをトリガーして目的の状態に変更するルールを作成したとします。ルールが慎重に記述されていない場合、その後の への変更によってルールが再度ACLs起動され、無限ループが作成されます。

このような予期しない結果を最小限に抑えるための正確なルールやイベントパターンを記述する方法に関するガイダンスについては、ルールのベストプラクティス および ベストプラクティス を参照してください。

イベントバスのイベントパターン

イベントバスでは、バス用に作成する各ルールにイベントパターンを指定できます。これにより、特定のターゲットに送信するイベントを選択できます。イベントバスのイベントパターンは、イベントソース、イベントメタデータ、および/またはイベント詳細値と照合できます。

次の動画では、イベントバスのイベントパターンの基本について説明します。

EventBridge Pipes のイベントパターン

EventBridge Pipes では、イベントパターンを指定して、パイプターゲットに配信するパイプソースからのイベントをフィルタリングできます。各パイプには単一のイベントソースがあるため、パイプのイベントパターンはイベントメタデータや詳細値と照合できます。

パイプイベントパターンの構築にすべてのイベントフィールドを使用できるわけではありません。詳細については、「フィルタリング」を参照してください。