ElastiCache Amazon SNS 通知の管理

Amazon Simple Notification Service (Amazon SNS) を使用して重要なクラスターイベントの通知が送信されるように ElastiCache を設定できます。これらの例では、Amazon SNS トピックの Amazon リソースネーム（ARN）を使用してクラスターを設定し、通知を受け取るようにします。

{
  "Statement": [
    {
      "Sid": "AllowElastiCachePublish",
      "Effect": "Allow",
      "Principal": {
        "AWS": "*"
      },
      "Action": "SNS:Publish",
      "Resource": "arn:aws:sns:region:account-id:topic-name",
      "Condition": {
        "StringEquals": {
          "AWS:SourceOwner": "account-id"
        }
      }
    }
  ]
}

前提条件

ElastiCache の Amazon SNS 通知を設定する前に、次の要件を確認してください。

Amazon SNS トピックに発行する ElastiCache アクセス許可の付与

イベント通知を受信するには、Amazon SNS トピックにメッセージを発行するアクセス許可を ElastiCache に付与する必要があります。これを行うには、elasticache.amazonaws.comサービスプリンシパルがメッセージを発行できるようにするリソースベースのポリシーを Amazon SNS トピックに追加します。

次のポリシーは、必要なアクセス許可を ElastiCache に付与します。

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "AllowElastiCachePublish",
      "Effect": "Allow",
      "Principal": {
        "Service": "elasticache.amazonaws.com"
      },
      "Action": "sns:Publish",
      "Resource": "arn:aws:sns:region:account-id:topic-name",
      "Condition": {
        "StringEquals": {
          "aws:SourceAccount": "account-id"
        }
      }
    }
  ]
}

次の表に、ポリシーコンポーネントを示します。

アクセス許可の付与 (コンソール)

アクセス許可の付与 (AWS CLI)

アクセスポリシーを という名前のファイルに保存しsns-policy.json、次のコマンドを実行します。

Linux、macOS、Unix の場合:

aws sns set-topic-attributes \
    --topic-arn arn:aws:sns:region:account-id:topic-name \
    --attribute-name Policy \
    --attribute-value file://sns-policy.json \
    --region region

Windows の場合:

aws sns set-topic-attributes ^
    --topic-arn arn:aws:sns:region:account-id:topic-name ^
    --attribute-name Policy ^
    --attribute-value file://sns-policy.json ^
    --region region

ポリシーが正しく適用されたことを確認するには、次のコマンドを実行します。

Linux、macOS、Unix の場合:

aws sns get-topic-attributes \
    --topic-arn arn:aws:sns:region:account-id:topic-name \
    --query 'Attributes.Policy' \
    --output text \
    --region region

Windows の場合:

aws sns get-topic-attributes ^
    --topic-arn arn:aws:sns:region:account-id:topic-name ^
    --query 'Attributes.Policy' ^
    --output text ^
    --region region

Amazon SNS トピックを追加する

以下のセクションでは、 AWS コンソール、、 AWS CLIまたは ElastiCache API を使用して Amazon SNS トピックを追加する方法を示します。

Amazon SNS トピックを追加する (コンソール)

以下の手順は、クラスターの Amazon SNS トピックを追加する方法を示しています。Valkey または Redis OSS を使用してステップ 2 でレプリケーショングループの Amazon SNS トピックを追加する場合、クラスターを選択する代わりに、レプリケーショングループを選択します。次に、以降の同じステップに従います。

Amazon SNS トピックを追加する (AWS CLI)

クラスターの Amazon SNS トピックを追加または変更するには、 AWS CLI コマンド を使用しますmodify-cache-cluster。

次のコード例では、Amazon SNS トピック ARN を my-cluster に追加します。

Linux、macOS、Unix の場合:

aws elasticache modify-cache-cluster \
    --cache-cluster-id my-cluster \
    --notification-topic-arn arn:aws:sns:us-west-2:123456789xxx:ElastiCacheNotifications

Windows の場合:

aws elasticache modify-cache-cluster ^
    --cache-cluster-id my-cluster ^
    --notification-topic-arn arn:aws:sns:us-west-2:123456789xx:ElastiCacheNotifications

詳細については、「modify-cache-cluster」を参照してください。

Amazon SNS トピックを追加する（ElastiCache API）

クラスターの Amazon SNS トピックを追加または変更するには、以下のパラメータを指定して ModifyCacheCluster アクションを呼び出します。

https://elasticache.amazon.com/
    ?Action=ModifyCacheCluster
    &ApplyImmediately=false
    &CacheClusterId=my-cluster
    &NotificationTopicArn=arn%3Aaws%3Asns%3Aus-west-2%3A565419523791%3AElastiCacheNotifications
    &Version=2014-12-01
    &SignatureVersion=4
    &SignatureMethod=HmacSHA256
    &Timestamp=20141201T220302Z
    &X-Amz-Algorithm=&AWS;4-HMAC-SHA256
    &X-Amz-Date=20141201T220302Z
    &X-Amz-SignedHeaders=Host
    &X-Amz-Expires=20141201T220302Z
    &X-Amz-Credential=<credential>
    &X-Amz-Signature=<signature>

詳細については、「ModifyCacheCluster」を参照してください。

Amazon SNS 通知の有効化と無効化

クラスターでは、通知を有効または無効にすることができます。次の手順は、Amazon SNS 通知を無効にする方法を示しています。

Amazon SNS 通知の有効化と無効化（コンソール）

Amazon SNS 通知の有効化と無効化（AWS CLI)

Amazon SNS 通知を無効にするには、以下のパラメータを指定して modify-cache-cluster コマンドを使用します。

Linux、macOS、Unix の場合:

aws elasticache modify-cache-cluster \
    --cache-cluster-id my-cluster \
    --notification-topic-status inactive

Windows の場合:

aws elasticache modify-cache-cluster ^
    --cache-cluster-id my-cluster ^
    --notification-topic-status inactive

Amazon SNS 通知の有効化と無効化（ElastiCache API）

Amazon SNS 通知を無効にするには、以下のパラメータを指定して ModifyCacheCluster アクションを呼び出します。

この呼び出しにより、以下のような出力が返されます。

https://elasticache.us-west-2.amazonaws.com/
    ?Action=ModifyCacheCluster
    &ApplyImmediately=false
    &CacheClusterId=my-cluster
    &NotificationTopicStatus=inactive
    &Version=2014-12-01
    &SignatureVersion=4
    &SignatureMethod=HmacSHA256
    &Timestamp=20141201T220302Z
    &X-Amz-Algorithm=&AWS;4-HMAC-SHA256
    &X-Amz-Date=20141201T220302Z
    &X-Amz-SignedHeaders=Host
    &X-Amz-Expires=20141201T220302Z
    &X-Amz-Credential=<credential>
    &X-Amz-Signature=<signature>

Amazon SNS トピックポリシーのセキュリティのベストプラクティス

Amazon SNS トピックポリシーを保護するには、次のベストプラクティスに従ってください。

通知が機能していることの確認

Amazon SNS トピックポリシーを設定し、トピックを ElastiCache クラスターに追加したら、通知が機能していることを確認します。

Amazon SNS 通知のトラブルシューティング

ElastiCache から Amazon SNS 通知を受信していない場合は、以下を確認してください。