リファレンス: 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 アカウント から共有されているカレンダーの状態の変更はサポートされていません。

イベントタイプ: Change Manager

イベントタイプ名 ルールに追加できるイベントの説明
変更要求ステータスの更新 Change Manager の変更要求の状態。イベントルールでは以下の状態を使用できます。
  • APPROVED

  • 拒否

  • InProgress

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

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

  • non_compliant

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

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

  • カスタムインベントリタイプは、すべてのノードでイベントを削除します。

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

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

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

イベントタイプ名 ルールに追加できるイベントの説明
メンテナンスウィンドウのステータス変更通知 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

メンテナンスウィンドウタスクターゲットの呼び出しの状態変更通知。

特定のターゲットのメンテナンスウィンドウタスクの状態が変化します。

この通知は、Run Command タスクに対してのみ完全にサポートされています。このタイプのタスクでは、次の状態の変更を 1 つ以上、イベントルールに追加できます。

  • CANCELLED

  • CANCELLING

  • FAILED

  • IN_PROGRESS

  • SUCCESS

  • TIMED_OUT

オートメーション、AWS Lambda、および AWS Step Functions タスクでは、EventBridge はステート IN_PROGRESS および COMPLETE のみをレポートします。COMPLETE は、タスクが成功したかどうかを報告します。

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

  • REGISTERED

  • UPDATED

イベントタイプ: OpsCenter

イベントタイプ名 ルールに追加できるイベントの説明
OpsItem 作成 OpsItem が作成されるときに発生します。以下のいずれかの OpsItem タイプにルールを追加することができます。
  • /aws/問題

  • /aws/タスク

  • /aws/インサイト

  • /aws/アクションアイテム

OpsItem 更新 OpsItem が更新されるときに発生します。以下のいずれかの OpsItem タイプにルールを追加することができます。
  • /aws/問題

  • /aws/タスク

  • /aws/インサイト

  • /aws/アクションアイテム

イベントタイプ: Parameter Store

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

  • 更新

  • 削除

  • LabelParameterVersion

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

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

  • ExpirationNotification

  • NoChangeNotification

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

イベントタイプ: Run Command

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

  • InProgress

  • TimedOut

  • Canceled

  • 失敗

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

  • InProgress

  • TimedOut

  • Canceled

  • [失敗]

イベントタイプ: State Manager

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

  • Pending

  • 成功

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

  • Pending

  • 成功