Verwaltung von ElastiCache Amazon SNS SNS-Benachrichtigungen

Mit Amazon Simple Notification Service (Amazon SNS) können Sie konfigurieren ElastiCache , dass Benachrichtigungen für wichtige Cluster-Ereignisse gesendet werden. In diesen Beispielen konfigurieren Sie einen Cluster mit dem Amazon-Ressourcenname (ARN) eines Amazon-SNS-Themas, um Benachrichtigungen zu erhalten.

{
  "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"
        }
      }
    }
  ]
}

Voraussetzungen

Bevor Sie Amazon SNS SNS-Benachrichtigungen für konfigurieren ElastiCache, überprüfen Sie die folgenden Anforderungen:

Erteilen der ElastiCache Erlaubnis zur Veröffentlichung in Ihrem Amazon SNS SNS-Thema

Um Veranstaltungsbenachrichtigungen zu erhalten, müssen Sie die ElastiCache Erlaubnis erteilen, Nachrichten zu Ihrem Amazon SNS SNS-Thema zu veröffentlichen. Dazu fügen Sie dem Amazon SNS SNS-Thema eine ressourcenbasierte Richtlinie hinzu, die es dem elasticache.amazonaws.com Service Principal ermöglicht, Nachrichten zu veröffentlichen.

Die folgende Richtlinie gewährt ElastiCache die erforderliche Genehmigung:

{
  "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"
        }
      }
    }
  ]
}

In der folgenden Tabelle werden die Richtlinienkomponenten beschrieben.

Erteilung der Erlaubnis (Konsole)

Erteilung der Erlaubnis (AWS CLI)

Speichern Sie die Zugriffsrichtlinie in einer Datei mit dem Namen sns-policy.json und führen Sie dann den folgenden Befehl aus:

Für Linux, macOS oder 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

Für 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

Führen Sie den folgenden Befehl aus, um zu überprüfen, ob die Richtlinie korrekt angewendet wurde:

Für Linux, macOS oder Unix:

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

Für Windows:

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

Hinzufügen eines Amazon-SNS-Themas

In den folgenden Abschnitten erfahren Sie, wie Sie mithilfe der AWS Konsole, der oder der ElastiCache API ein Amazon SNS SNS-Thema hinzufügen. AWS CLI

Hinzufügen eines Amazon-SNS-Themas (Konsole)

Das folgende Verfahren zeigt Ihnen, wie Sie ein Amazon-SNS-Thema für einen Cluster hinzufügen. Wenn Sie Valkey oder Redis OSS verwenden, um in Schritt 2 ein Amazon SNS SNS-Thema für eine Replikationsgruppe hinzuzufügen, wählen Sie statt eines Clusters eine Replikationsgruppe aus. Folgen Sie dann den übrigen Schritten.

Hinzufügen eines Amazon SNS SNS-Themas (AWS CLI)

Verwenden Sie den AWS CLI Befehlmodify-cache-cluster, um ein Amazon SNS SNS-Thema für einen Cluster hinzuzufügen oder zu ändern.

Das folgende Codebeispiel fügt einen Amazon-SNS-Themen-ARN zu my-cluster hinzu.

Für Linux, macOS oder Unix:

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

Für Windows:

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

Weitere Informationen finden Sie unter modify-cache-cluster.

Hinzufügen eines Amazon SNS SNS-Themas (ElastiCache API)

Rufen Sie zum Hinzufügen oder Ändern eines Amazon-SNS-Themas für einen Cluster die Aktion ModifyCacheCluster mit folgenden Parametern auf:

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>

Weitere Informationen finden Sie unter ModifyCacheCluster.

Aktivieren und Deaktivieren von Amazon-SNS-Benachrichtigungen

Sie können Benachrichtigungen für einen Cluster aktivieren oder deaktivieren. Das folgende Verfahren zeigt, wie Sie Amazon-SNS-Benachrichtigungen deaktivieren.

Aktivieren und Deaktivieren von Amazon-SNS-Benachrichtigungen (Konsole)

Amazon SNS SNS-Benachrichtigungen aktivieren und deaktivieren (AWS CLI)

Verwenden Sie zum Deaktivieren von Amazon-SNS-Benachrichtigungen den Befehl modify-cache-cluster mit folgenden Parametern:

Für Linux, macOS oder Unix:

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

Für Windows:

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

Amazon SNS SNS-Benachrichtigungen (ElastiCache API) aktivieren und deaktivieren

Rufen Sie zum Deaktivieren von Amazon-SNS-Benachrichtigungen die ModifyCacheCluster-Aktion mit folgenden Parametern auf:

Diese Aktion führt zu folgender oder einer ähnlichen Ausgabe:

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>

Bewährte Sicherheitsmethoden für Amazon SNS SNS-Themenrichtlinien

Um Ihre Amazon SNS SNS-Themenrichtlinie zu schützen, folgen Sie diesen bewährten Methoden:

Stellen Sie sicher, dass Benachrichtigungen funktionieren

Nachdem Sie die Amazon SNS SNS-Themenrichtlinie konfiguriert und das Thema zu Ihrem ElastiCache Cluster hinzugefügt haben, stellen Sie sicher, dass die Benachrichtigungen funktionieren:

Fehlerbehebung Amazon SNS SNS-Benachrichtigungen

Wenn Sie keine Amazon SNS SNS-Benachrichtigungen von erhalten ElastiCache, überprüfen Sie Folgendes: