AWS Systems Manager
ユーザーガイド

パラメータストアイベントに基づき、通知の設定またはアクションのトリガーを行う

このセクションのトピックでは、Amazon CloudWatch Events および Amazon Simple Notification Service (Amazon SNS) を使用して、Systems Manager パラメータの変更を通知する方法について説明します。パラメータまたはパラメータラベルのバージョンが作成、更新、または削除されたときに通知する CloudWatch ルールを作成できます。パラメータの有効期限切れ、期限切れ間近、または指定された期間中に変更されていないなど、パラメータポリシーに関する変更またはステータスに関する通知を受信することができます。

注記

パラメータポリシーは、高度なパラメータ階層を使用するパラメータに利用できます。料金が適用されます。詳細については、「パラメータポリシーの使用」および「アドバンストパラメータについて」を参照してください。

以下のトピックでは、特定のパラメータイベントに対してターゲット上で他のアクションをトリガーする方法も説明しています。たとえば、有効期限が切れたか、削除された場合に、そのパラメータを自動的に再作成する AWS Lambda 関数を実行することができます。また、データベースパスワードが更新された際に Lambda 関数をトリガーする通知をセットアップすることもできます。Lambda 関数では、データベース接続を強制的にリセットしたり、新しいパスワードで再接続したりすることができます。また、CloudWatch Events では、Run Command コマンドとオートメーション実行、他の多くの AWS サービスのアクションの実行もサポートしています。詳細については、「Amazon CloudWatch Events User Guide」を参照してください。

開始する前に

作成したルールのターゲットアクションを指定するために必要なリソースを作成します。たとえば、作成したルールが通知の送信用である場合は、まず Amazon SNS トピックを作成します。詳細については、Amazon Simple Notification Service Developer Guide の「Amazon SNS の開始方法」を参照してください。

CloudWatch Events のパラメータを設定するには

このトピックでは、AWS アカウントの 1 つ以上のパラメータに発生したイベントに基づき、ターゲットを呼び出す CloudWatch Events ルールを作成する方法について説明します。

Systems Manager パラメータに CloudWatch Events を設定するには

  1. Sign in to the AWS Management Console and open the CloudWatch console at https://console.aws.amazon.com/cloudwatch/.

  2. 左側のナビゲーションペインで、[Events] を選択し、それから [Create rule] を選択します。

  3. [Event Source] で、[Event Pattern] が選択されていることを確認します。

  4. [イベントパターンのプレビュー] フィールドの [編集] を選択します。

    注記

    [イベントパターンのビルダー] フィールドを使用する代わりに、提供されているサンプルコードを変更します。

  5. 編集ボックスの内容を以下の内容に置き換えます。

    { "source": [ "aws.ssm" ], "detail-type": [ "Parameter Store Change" ], "detail": { "name": [ "/parameter-1-name", "/parameter-2-name/level-2", "/parameter-3-name/level-2/level-3" ], "operation": [ "Create", "Update", "Delete", "LabelParameterVersion" ] } }
  6. アクションを行うパラメータやオペレーションの内容を変更します。

    たとえば、以下の内容は、Oncall/Project/Teamlead という名前のいずれかのパラメータが更新されるとアクションが行われることを意味します。

    { "source": [ "aws.ssm" ], "detail-type": [ "Parameter Store Change" ], "detail": { "name": [ "/Oncall", "/Project/Teamlead" ], "operation": [ "Update" ] } }
  7. [Save] を選択します。

  8. [ターゲット] で、[ターゲットの追加] を選択します。

  9. [Targets] リストで、ターゲットタイプを選択します。たとえば、[Lambda 関数] または [SNS トピック] を選択します。

  10. [入力の設定] を展開し、オプションを選択します。次に、選択したターゲットタイプに必要なその他の設定詳細を入力します。

  11. 必要に応じて、ページの下部までスクロールし、[詳細の設定]を選択します。

  12. CloudWatch Events ルールの名前と説明 (オプション) を入力します。ルールがすぐに有効になるように [有効] ボックスはオンのままにします。

  13. [Create rule] を選択します。

パラメータポリシーに CloudWatch Events を設定する

このトピックでは、AWS アカウントの 1 つ以上のパラメータポリシーに発生したイベントに基づき、ターゲットを呼び出す CloudWatch Events ルールを作成する方法について説明します。詳細パラメータを作成する際、パラメータの失効日、パラメータの有効期限の失効前に通知を受信するタイミング、パラメータが変更されていないことを示す通知を送信するまでの時間を指定します。以下の手順に従ってください。詳細については、「パラメータポリシーの使用」および「アドバンストパラメータについて」を参照してください。

Systems Manager パラメータポリシーに CloudWatch Events を設定するには

  1. Sign in to the AWS Management Console and open the CloudWatch console at https://console.aws.amazon.com/cloudwatch/.

  2. 左側のナビゲーションペインで、[Events] を選択し、それから [Create rule] を選択します。

  3. [Event Source] で、[Event Pattern] が選択されていることを確認します。

  4. [イベントパターンのプレビュー] フィールドの [編集] を選択します。

    注記

    [イベントパターンのビルダー] フィールドを使用する代わりに、提供されているサンプルコードを変更します。

  5. 編集ボックスの内容を以下の内容に置き換えます。

    { "source": [ "aws.ssm" ], "detail-type": [ "Parameter Store Policy Action" ], "detail": { "name": [ "/parameter-1-name", "/parameter-2-name/level-2", "/parameter-3-name/level-2/level-3" ], "policy-type": [ "Expiration", "ExpirationNotification", "NoChangeNotification" ] } }
  6. アクションを行うパラメータやポリシータイプの内容を変更します。たとえば、以下の内容は、OncallDuties という名前のパラメータが失効し、削除された場合にアクションが行われることを意味します。

    { "source": [ "aws.ssm" ], "detail-type": [ "Parameter Store Policy Action" ], "detail": { "name": [ "/OncallDuties" ], "policy-type": [ "Expiration" ] } }
  7. [Save] を選択します。

  8. [ターゲット] で、[ターゲットの追加] を選択します。

  9. [Targets] リストで、ターゲットタイプを選択します。たとえば、[Lambda 関数] または [SNS トピック] を選択します。

  10. [入力の設定] を展開し、オプションを選択します。次に、選択したターゲットタイプに必要なその他の設定詳細を入力します。

  11. 必要に応じて、ページの下部までスクロールし、[詳細の設定]を選択します。

  12. CloudWatch Events ルールの名前と説明 (オプション) を入力します。ルールがすぐに有効になるように [有効] ボックスはオンのままにします。

  13. [Create rule] を選択します。

関連情報