Es ist sehr einfach, SNS-Themen und Abonnements zu erstellen und andere Operationen an SNS-Themen vom Terminal aus mit dem Dienstprogramm aw-cli durchzuführen. In diesem Artikel zeige ich Ihnen die Befehle zum Erstellen eines SNS-Themas, eines Abonnements, zum Bestätigen und Löschen des Abonnements mit aws-cli. Es wird davon ausgegangen, dass Sie bereits mit AWS SNS Service vertraut sind.
Informationen zu den Vorgängen, die mit dem Befehlszeilendienstprogramm aws-cli für SNS-Themen ausgeführt werden können, finden Sie hier in der offiziellen Dokumentation.
Voraussetzungen
- AWS-Konto (erstellen wenn Sie noch keins haben).
- Grundlegendes Verständnis von SNS-Themen (Klicken Sie hier, um zu erfahren, wie Sie ein SNS-Thema mit Terraform erstellen).
- Grundlegendes Verständnis des SNS-Abonnements.
- AWS-IAM-Benutzer mit angehängter AmazonSNSFullAccess-Richtlinie und seinen Zugriffs- und Geheimschlüsseln (Klicken Sie hier, um zu erfahren, wie Sie einen IAM-Benutzer erstellen).
- AWS CLI auf Ihrem lokalen Computer installiert.
Was werden wir tun?
- Überprüfen Sie aws CLI und exportieren Sie den AWS-Zugriff und den geheimen Schlüssel auf Ihrem lokalen Computer.
- SNS-Themen mit aws CLI verwalten.
Überprüfen Sie aws cli und exportieren Sie aws access &secret key auf Ihrem lokalen Computer.
Wenn Sie die aws-cli nicht haben, lesen Sie die offizielle Dokumentation hier, um sie auf Ihrem lokalen Computer zu installieren, und überprüfen Sie dann die Version davon mit dem folgenden Befehl.
aws --version
Wenn Sie den folgenden Befehl ausführen, erhalten Sie eine Fehlermeldung, da Sie den Zugriff auf Ihr AWS-Konto im Terminal noch nicht konfiguriert haben.
aws sts get-caller-identity
Exportieren Sie den AWS IAM-Benutzerzugriff und die geheimen Schlüssel auf Ihrem Terminal mit den folgenden Befehlen.
export AWS_ACCESS_KEY_ID=<aws-user-access-key>
export AWS_SECRET_ACCESS_KEY=<aws-user-secret-key>
Dieses Mal können Sie Ihre Identität überprüfen, indem Sie den folgenden Befehl ausführen. Sie sollten Benutzerdetails in der Ausgabe sehen.
aws sts get-caller-identity
SNS-Themen mit aws-cli verwalten
Sehen wir uns die SNS-Themen an, die wir in unserer aktuellen Region haben.
aws sns list-topics
Um einfach ein SNS-Thema zu erstellen, führen Sie den folgenden Befehl aus. Sie können einen beliebigen anderen Namen angeben, wenn Sie möchten.
aws sns create-topic --name my-sns-topic-by-cli
Beim Erstellen eines SNS-Themas können wir auch Tags dafür angeben. Sie können sogar mehrere Tags gleichzeitig angeben.
aws sns create-topic --name my-sns-topic-by-cli-with-tag --tags Key=env,Value=test
Listen Sie die Themen auf und Sie können diesmal die neu erstellten Themen sehen.
aws sns list-topics
Sie können auch die Attribute eines bestimmten SNS-Themas prüfen, indem Sie dessen Arn angeben. Um den Arn des Themas zu erhalten, listen Sie zuerst die Themen auf und kopieren Sie dann den Arn des gewünschten Themas.
aws sns list-topics
aws sns get-topic-attributes --topic-arn arn:aws:sns:us-east-1:<your-account-number>:my-sns-topic-by-cli
Mit dem folgenden Befehl können Sie alle Abonnements in der aktuellen Region überprüfen.
aws sns list-subscriptions
Um ein Abonnement zu erstellen, müssen Sie das Protokoll und den Arn des SNS-Themas angeben. In diesem Fall erstellen wir ein Abonnement mit E-Mail als Endpunkt. Das Abonnement unterstützt verschiedene Endpunkte, Sie können den gewünschten angeben.
aws sns subscribe --topic-arn arn:aws:sns:us-east-1:<your-account-number>:my-sns-topic-by-cli --protocol email --notification-endpoint <email-id>@<domain>
aws sns list-subscriptions
Nachdem das Abonnement erstellt wurde, erhalten Sie eine Bestätigungs-E-Mail. Das Abonnement kann durch Klicken auf den in der E-Mail angegebenen Link bestätigt werden, oder es kann ein Token zur Bestätigung über die CLI verwendet werden. Kopieren Sie die Link-Adresse, um das Token daraus abzurufen. Wir sehen den Befehl zur Bestätigung des Abonnements vom Terminal aus.
Die Adresse des Bestätigungslinks enthält das unten hervorgehobene Token. Kopieren Sie es zur Bestätigung von der CLI.
Um das Abonnement mit aws-cli zu bestätigen, verwenden Sie den folgenden Befehl und geben Sie das Thema-arn und das Token im Befehl an.
aws sns list-subscriptions
aws sns confirm-subscription --topic-arn arn:aws:sns:us-east-1:<your-account-number>:my-sns-topic-by-cli --token 2336412f37fb687f5d51e6e2425e90ccf51427f70d347f743e373ed99c34222d699f93426571175db9bc0b81296ae69f53a889e1fbd11571c642308353d4648c67a2851b17a7f3cc1b7e1aaccae0881c5855df5d37bcae458305855d98fcd012d1ed4728a2064c6425b77b00e62b8d4fcf7fcccfb212d6850e3fa450c25cdf9a
aws sns list-subscriptions
Das Abonnement kann gelöscht oder gekündigt werden, indem Sie einfach den Abonnement-Arn angeben. Sobald der Endpunkt gekündigt wurde, erreichen Benachrichtigungen den Endpunkt nicht mehr.
aws sns list-subscriptions
aws sns unsubscribe --subscription-arn arn:aws:sns:us-east-1:<your-account-number>:my-sns-topic-by-cli:cde0b12a-437c-49da-ab25-bc467701156d
aws sns list-subscriptions
Wenn Sie das Thema nicht mehr benötigen, ist es besser, es zu löschen. Seien Sie vorsichtig beim Löschen des Themas, da es nach dem Löschen nicht wiederhergestellt werden kann.
aws sns list-topics
aws sns delete-topic --topic-arn arn:aws:sns:us-east-1:<your-account-number>:my-sns-topic-by-cli
614 aws sns list-topics
Schlussfolgerung
In diesem Artikel haben wir die Schritte zum Erstellen eines SNS-Themas, Abonnements, Bestätigens des Abonnements gesehen. Wir haben auch gesehen, wie das Abonnement und das SNS-Thema mit dem Befehl aws-cli gelöscht werden können.