Zugreifen auf Amazon SNS in der AWS CLI

Sie können auf die Funktionen von Amazon Simple Notification Service (Amazon SNS) zugreifen, indem Sie AWS Command Line Interface (AWS CLI) verwenden. Verwenden Sie den folgenden Befehl, um die AWS CLI -Befehle für Amazon SNS aufzulisten.

aws sns help

Bevor Sie Befehle ausführen, richten Sie die Standardanmeldeinformationen ein. Weitere Informationen finden Sie unter Konfiguration der Einstellungen für den AWS CLI.

Dieses Thema zeigt Beispiele für AWS CLI Befehle, die allgemeine Aufgaben für Amazon SNS ausführen.

Erstellen eines Themas

Zum Erstellen eines Themas verwenden Sie den Befehl sns create-topic und geben den Namen an, den Sie dem Thema zuweisen möchten.

$ aws sns create-topic --name my-topic
{
    "TopicArn": "arn:aws:sns:us-west-2:123456789012:my-topic"
}

Notieren Sie sich den TopicArn der Antwort, den Sie später zum Veröffentlichen einer Nachricht benötigen.

Abonnieren eines Themas

Verwenden Sie zum Abonnieren eines Themas den Befehl sns subscribe.

Das folgende Beispiel gibt das email-Protokoll und eine E-Mail-Adresse für den notification-endpoint an.

$ aws sns subscribe --topic-arn arn:aws:sns:us-west-2:123456789012:my-topic --protocol email --notification-endpoint [e-mail]
{
    "SubscriptionArn": "pending confirmation"
}

AWS sendet sofort eine Bestätigungsnachricht per E-Mail an die Adresse, die Sie im subscribe Befehl angegeben haben. Die E-Mail-Nachricht enthält den folgenden Text.

You have chosen to subscribe to the topic:
arn:aws:sns:us-west-2:123456789012:my-topic
To confirm this subscription, click or visit the following link (If this was in error no action is necessary):
Confirm subscription

Nachdem der Empfänger auf den Link für Confirm subscription (Abonnement bestätigen) geklickt hat, zeigt der Browser des Empfängers eine Benachrichtigung mit Informationen ähnlich der folgenden an.

Subscription confirmed!

You have subscribed [e-mail] to the topic:my-topic.

Your subscription's id is:
arn:aws:sns:us-west-2:123456789012:my-topic:1328f057-de93-4c15-512e-8bb22EXAMPLE

If it was not your intention to subscribe, click here to unsubscribe.

Veröffentlichung für ein Thema

Zum Senden einer Nachricht an alle Abonnenten eines Themas verwenden Sie den Befehl sns publish.

Das folgende Beispiel sendet die Meldung „Hallo Welt!“ an alle Abonnenten des angegebenen Themas.

$ aws sns publish --topic-arn arn:aws:sns:us-west-2:123456789012:my-topic --message "Hello World!"
{
    "MessageId": "4e41661d-5eec-5ddf-8dab-2c867EXAMPLE"
}

AWS Sendet in diesem Beispiel eine E-Mail-Nachricht mit dem Text „Hello World!“ [e-mail].

Abbestellen eines Themas

Zum Abmelden von einem Thema und zum Beenden des Empfangs von Nachrichten zu diesem Thema verwenden Sie den Befehl sns unsubscribe und geben den ARN des Themas an, das Sie nicht mehr abonnieren möchten.

$ aws sns unsubscribe --subscription-arn arn:aws:sns:us-west-2:123456789012:my-topic:1328f057-de93-4c15-512e-8bb22EXAMPLE

Wenn Sie prüfen möchten, ob das Abonnement erfolgreich beendet wurde, verwenden Sie den Befehl sns list-subscriptions, um zu bestätigen, dass der ARN nicht mehr in der Liste erscheint.

$ aws sns list-subscriptions

Löschen eines Themas

Mit dem Befehl sns delete-topic können Sie ein Thema löschen.

$ aws sns delete-topic --topic-arn arn:aws:sns:us-west-2:123456789012:my-topic

Um zu überprüfen, ob das Thema AWS erfolgreich gelöscht wurde, verwenden Sie den Befehl, um zu bestätigen, dass das Thema nicht mehr in der Liste erscheint.

$ aws sns list-topics