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

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

注記

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

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

イベントは、独自のアプリケーション、SaaS (Software-as-a-Service) アプリケーション、または AWS サービスの環境の変更を示します。イベントは、ベストエフォートベースで生成されます。ルールで指定されているイベントタイプが検出されると、EventBridge は指定したターゲットにルーティングして処理します。ターゲットには、Amazon Elastic Compute Cloud (Amazon EC2) インスタンス、AWS Lambda 関数、Amazon Kinesis Streams、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 つ以上追加できます。
  • APPROVED

  • Canceled

  • 失敗

  • PendingApproval

  • PendingChangeCalendarOverride

  • 拒否

  • 予定

  • 成功

  • TimedOut

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

  • 失敗

  • 成功

  • TimedOut

イベントタイプ: Change Calendar

イベントタイプ名 ルールに追加できるイベントの説明
カレンダーステートの変更 Change Calendar の状態が変わります。イベントルールには、次の状態の変更を 1 つ、または両方追加できます。
  • オープン

  • クローズ

他の AWS アカウント から共有されているカレンダーの状態の変更はサポートされていません。

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

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

  • non_compliant

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

イベントタイプ名 ルールに追加できるイベントの説明
インベントリリソースの状態の変更 カスタムインベントリの削除と、古いスキーマバージョンを使用する PutInventory 呼び出し。イベントルールには、次の状態の変更を 1 つ以上追加できます。
  • 特定のインスタンスのカスタムインベントリタイプの削除イベント。EventBridge は、カスタム InventoryType ごとにインスタンスあたり 1 つのイベントを送信します。

  • すべてのインスタンスのカスタムインベントリタイプの削除イベント。

  • 古いスキーマバージョンイベントを持つ PutInventory 呼び出し。EventBridge は、スキーマのバージョンが現在のスキーマよりも小さい場合にこのイベントを送信します。このイベントは、すべてのインベントリタイプに適用されます。

詳細については、「」を参照してくださいInventory イベントの EventBridge モニタリングについて

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

イベントタイプ名 ルールに追加できるイベントの説明
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

イベントタイプ: Parameter Store

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

  • 更新

  • 削除

  • LabelParameterVersion

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

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

  • ExpirationNotification

  • NoChangeNotification

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

イベントタイプ: Run Command

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

  • InProgress

  • TimedOut

  • Canceled

  • 失敗

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

  • InProgress

  • TimedOut

  • Canceled

  • 失敗