リファレンス: Systems Manager 用の Amazon EventBridge イベントパターンおよびタイプ - AWS Systems Manager

リファレンス: Systems Manager 用の Amazon EventBridge イベントパターンおよびタイプ

注記

Amazon EventBridge は、イベントを管理するために推奨される方法です。CloudWatch イベント および EventBridge は同じ基盤となるサービスと API ですが、EventBridge の方がより多くの機能を提供します。CloudWatch または EventBridge で行った変更は、各コンソールに表示されます。詳細については、Amazon EventBridge ユーザーガイド を参照してください。

Amazon EventBridge (EventBridge) を使用すると、受信イベントを照合し、処理のためにターゲットにルーティングするルールを作成できます。

イベントは、独自のアプリケーション、SaaS (Software-as-a-Service) アプリケーション、または AWS サービスの環境の変更を示します。ルールで指定されているイベントタイプが検出されると、EventBridge は指定したターゲットにルーティングして処理します。ターゲットには、Amazon Elastic Compute Cloud (Amazon EC2) インスタンス、AWS Lambda 関数、Amazon Kinesis ストリーム、Amazon Elastic Container Service (Amazon ECS) タスク、AWS Step Functions ステートマシン、Amazon Simple Notification Service (Amazon SNS) トピック、Amazon Simple Queue Service (Amazon SQS) キュー、組み込みターゲットなどを含めることができます。

EventBridge ルール作成の詳細については、以下の各トピックを参照してください。

このトピックの後半では、EventBridge ルールに含めることができる Systems Manager イベントのタイプについて説明します。

イベントタイプ: オートメーション

イベントタイプ名 ルールに追加できるイベントの説明
EC2 オートメーション実行ステータス変更の通知 オートメーションワークフローの全体的なステータスが変化します。イベントルールには、次のステータスの変更を 1 つ以上追加できます。
  • キャンセル

  • 失敗

  • InProgress

  • Pending

  • 成功

  • TimedOut

EC2 オートメーションステップステータス変更の通知 オートメーションワークフローの特定のステップのステータスが変化します。イベントルールには、次のステータスの変更を 1 つ以上追加できます。
  • キャンセル

  • 失敗

  • InProgress

  • Pending

  • 成功

  • TimedOut

イベントタイプ: 設定コンプライアンス

イベントタイプ名 ルールに追加できるイベントの説明
設定コンプライアンスのステータスの変更 関連付けのコンプライアンスまたはパッチコンプライアンスのいずれかで、マネージドインスタンスの状態が変化します。イベントルールには、次の状態の変更を 1 つ以上追加できます。
  • compliant

  • non_compliant

イベントタイプ: インベントリ

イベントタイプ名 ルールに追加できるイベントの説明
インベントリリソースの状態の変更 Systems Manager インベントリの変更によって追跡されるリソースの状態です。

イベントタイプ: ステートマネージャー

イベントタイプ名 ルールに追加できるイベントの説明
EC2 ステートマネージャーの関連付けの状態の変更 関連付けの全体的な状態は、適用に応じて変化します。イベントルールには、次の状態の変更を 1 つ以上追加できます。
  • 失敗

  • Pending

  • 成功

EC2 ステートマネージャーインスタンスの関連付けの状態の変更 関連付けの対象となる 1 つのマネージドインスタンスの状態が変更されます。イベントルールには、次の状態の変更を 1 つ以上追加できます。
  • 失敗

  • Pending

  • 成功

イベントタイプ: メンテナンスウィンドウ

イベントタイプ名 ルールに追加できるイベントの説明
メンテナンスウィンドウのステータス変更通知 1 つまたは複数のメンテナンスウィンドウの全体的なステータスが変化します。イベントルールには、次の状態の変更を 1 つ以上追加できます。
  • DISABLED

  • ENABLED

メンテナンスウィンドウのターゲット登録通知 1 つまたは複数のメンテナンスウィンドウターゲットのステータスが変化します。イベントルールには、次の状態の変更を 1 つ以上追加できます。
  • DEREGISTERED

  • REGISTERED

  • UPDATED

メンテナンスウィンドウの実行状態変更通知 メンテナンスウィンドウの全体的なステータスが、実行中に変化します。イベントルールには、次の状態の変更を 1 つ以上追加できます。
  • CANCELLED

  • CANCELLING

  • FAILED

  • IN_PROGRESS

  • 保留中

  • SKIPPED_OVERLAPPING

  • SUCCESS

  • TIMED_OUT

メンテナンスウィンドウタスクの実行状態変更通知 メンテナンスウィンドウ内のタスクの状態が、実行中に変化します。イベントルールには、次の状態の変更を 1 つ以上追加できます。
  • CANCELLED

  • CANCELLING

  • FAILED

  • IN_PROGRESS

  • SUCCESS

  • TIMED_OUT

メンテナンスウィンドウタスクターゲットの呼び出しの状態変更通知。 特定のターゲットのメンテナンスウィンドウタスクの状態が変化します。イベントルールには、次の状態の変更を 1 つ以上追加できます。
  • CANCELLED

  • CANCELLING

  • FAILED

  • IN_PROGRESS

  • SUCCESS

  • TIMED_OUT

メンテナンスウィンドウのタスク登録通知 1 つまたは複数のメンテナンスウィンドウタスクの状態が変化します。イベントルールには、次の状態の変更を 1 つ以上追加できます。
  • DEREGISTERED

  • REGISTERED

  • UPDATED

イベントタイプ: パラメータストア

イベントタイプ名 ルールに追加できるイベントの説明
パラメータストアの変更 パラメータの状態が変化します。イベントルールには、次の状態の変更を 1 つ以上追加できます。
  • 作成

  • 更新

  • 削除

  • LabelParameterVersion

詳細については、「パラメータの EventBridge を設定する」を参照してください。

パラメータストアポリシーのアクション 詳細パラメータポリシーの変更の条件が満たされます。イベントルールには、次のステータスの変更を 1 つ以上追加できます。
  • 有効期限

  • ExpirationNotification

  • NoChangeNotification

詳細については、「パラメータポリシーに EventBridge を設定する」を参照してください。

イベントタイプ: Run Command

イベントタイプ名 ルールに追加できるイベントの説明
EC2 コマンド呼び出しステータス変更の通知 個々のマネージドインスタンスに送信されるコマンドのステータスが変化します。イベントルールには、次のステータスの変更を 1 つ以上追加できます。
  • 成功

  • InProgress

  • TimedOut

  • キャンセル

  • 失敗

EC2 コマンドステータス変更の通知 コマンドの全体的なステータスが変化します。イベントルールには、次のステータスの変更を 1 つ以上追加できます。
  • 成功

  • InProgress

  • TimedOut

  • キャンセル

  • 失敗