Zugreifen auf Amazon SNS in der AWS CLI

Sie können auf die Funktionen von Amazon Simple Notification Service (Amazon SNS) zugreifen, indem Sie die 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 Konfigurieren der Einstellungen für die AWS CLI.

Dieses Thema enthält Beispiele für AWS CLI-Befehle, über die allgemeine Aufgaben für Amazon SNS ausgeführt werden.

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 saanvi@example.com
{
    "SubscriptionArn": "pending confirmation"
}

AWS sendet sofort eine Bestätigungsnachricht per E-Mail an die Adresse, die Sie im Befehl subscribe 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 saanvi@example.com 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"
}

In diesem Beispiel sendet AWS eine E-Mail-Nachricht mit dem Text „Hallo Welt!“ an saanvi@example.com.

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

Wenn Sie prüfen möchten, ob AWS das Thema erfolgreich gelöscht hat, verwenden Sie den Befehl sns list-topics, um zu bestätigen, dass das Thema nicht mehr in der Liste erscheint.

$ aws sns list-topics