アマゾンを有効にする EventBridge

CloudFormationEventBridgeデフォルトでは Amazon にイベントを送信します。CloudFormationコンソールと AWS Command Line Interface (AWS CLI) を使用して、イベントに一致するルールとターゲットを指定します。

EventBridgeイベントを受信すると、ルールを適用してイベントをターゲットにルーティングします。ルールは、イベントの構造、またはスケジュールのいずれかに基づいて、イベントをターゲットにマッチングさせます。

AWS Management Console

1. 開始するには、EventBridgeコンソールにログインします。

2. ナビゲーションペインで [Rules] (ルール) を選択します。

3. [Create rule] (ルールの作成) を選択します。

4. [Create rule] (ルールの作成) ページに、次のように入力します。

   1. ルールの名前と説明を入力します。

   2. [Define pattern (パターンの定義)] で、[Event pattern (イベントパターン)] を選択します。

      サービス別に事前定義済みのパターンを選択し、続けてAWS、CloudFormation、、イベントタイプを選択します。

   3. Select event bus (イベントバスを選択)で、AWS default event bus を選択します。スケジュールされたルールは、デフォルトのイベントバスでのみ作成できます。

   4. [Select targets] (ターゲットの選択) で、[Batch job queue] (バッチジョブキュー) を選択し、次のフィールドを適切に指定します。

      • [Job queue] (ジョブキュー): ジョブをスケジュールするジョブキューの Amazon リソースネーム (ARN) を入力します。

      • [Job definition] (ジョブ定義): ジョブに使用するジョブ定義の名前、改正、または完全な ARN を入力します。

      • [Job name] (ジョブ名): ジョブの名前を入力します。

      • [Array size] (配列サイズ): (オプション) 複数のコピーを実行するためのジョブの配列サイズを入力します。

      • [Job attempts] (ジョブの試行): (オプション) ジョブが失敗したときに再試行する回数を入力します。

5. バッチジョブキューのターゲットタイプの場合、EventBridgeターゲットにイベントを送信する権限が必要です。EventBridgeルールの実行に必要な IAM ロールを作成できます。以下のいずれかを行ってください。

   • 自動的に IAM ロールを作成するには、[この特定のリソースに対して新しいロールを作成する] を選択します。

   • 以前に作成した IAM ロールを使用するには、[Use existing role] (既存のロールの使用) を選択します。

6. Retry policy and dead-letter queue:(ポリシーとデッドレターキューを再試行:)のRetry policy(再試行ポリシー)で次の操作を実行します。

   1. [Maximum age of event] (イベントの最大有効期間) に、1 分 (00:01) から 24 時間 (24:00) の間の値を入力します。

   2. Retry attempts(再試行)で、0～185 の数値を入力します。

7. Dead-letter queue(デッドレターキュー) で、標準 Amazon SQS キューをデッドレターキューとして使用するかどうかを選択します。EventBridgeこのルールに一致するイベントを、ターゲットに配信できない場合、デッドレターキューに送信します。以下のいずれかを実行します。

   • デッドレターキューを使用しない場合は、[None] (なし) を選択します。

   • [デッドレターキューとして使用する現在の AWS アカウントの Amazon SQS キューを選択] を選択し、ドロップダウンリストから使用するキューを選択します。

   • Select an Amazon SQS queue in an other AWS account as a dead-letter queue(他の アカウントの Amazon SQS キューをデッドレターキューとして選択) を選択し、使用するキューの ARN を入力します。EventBridgeメッセージを送信する権限を付与するリソースベースのポリシーをキューにアタッチする必要があります。

8. (オプション) ルールに 1 つ以上のタグを入力します。

9. [Create] (作成) を選択します。

EventBridgeイベントパターン

EventBridgeコンソールで使用されるイベントパターンの例を以下に示します。これらを使用してルールを作成し、通知を送信します。

リソースステータスイベント

次の例では、EventBridgeイベントによってリソースのステータスが変化したときに Amazon に通知を送信します。

スタックステータスイベント

次の例では、EventBridgeイベントによってスタックのステータスが変化したときに Amazon に通知を送信します。

ドリフト検出ステータスイベント

次の例では、EventBridgeドリフト検出によってステータスイベントが特定されたときに Amazon に通知を送信します。

StackSetステータスイベント

次の例では、EventBridgeStackSetイベントによってステータスが変化したときに Amazon に通知を送信します。

StackSetスタックインスタンスステータスイベント

次の例では、EventBridgeStackSetイベントによってスタックインスタンスのステータスが変化したときに Amazon に通知を送信します。

StackSet操作ステータスイベント

次の例では、EventBridgeStackSetイベントによって操作ステータスが変化したときに Amazon に通知を送信します。

AWS CLI

create-stack、、delete-stackおよびを使用してupdate-stack、生成されたイベントを Amazon EventBridge に送信します。

次の例では、スタックを作成して Amazon に通知を送信しますEventBridge。

aws cloudformation create-stack --stack-name myteststack --template-body file://sampletemplate.json --parameters ParameterKey=KeyPairName,ParameterValue=TestKey ParameterKey=SubnetIDs,ParameterValue=SubnetID1\\,SubnetID2

次の例では、スタックを更新して Amazon に通知を送信しますEventBridge。

aws cloudformation update-stack --stack-name myteststack --template-url https://s3.amazonaws.com/sample/sampletemplate.json --parameters ParameterKey=KeyPairName,ParameterValue=SampleKeyPair ParameterKey=SubnetIDs,ParameterValue=SampleSubnetID1\\,SampleSubnetID2

次の例では、スタックを削除して Amazon EventBridge に通知を送信します。

aws cloudformation delete-stack --stack-name myteststack

次の例では、スタックのドリフトを検出し、Amazon EventBridge に通知を送信します。

aws cloudformation detect-stack-drift --stack-name myteststack

EventBridgeアマゾンの権限

AWS CloudFormationAmazon にイベントを配信するための追加の権限は必要ありませんEventBridge。

イベントには、の API CloudFormation オペレーションですでに入手可能な情報が含まれています。

Amazon EventBridge トラブルシューティング

トラブルシューティングの方法についてはEventBridge、Amazon EventBridgeユーザーガイドの「Amazon EventBridge のトラブルシューティング」を参照してください。