Accès à Amazon SNS dans l’AWS CLI

Vous pouvez accéder aux fonctionnalités d’Amazon Simple Notification Service (Amazon SNS) à l’aide de l’AWS Command Line Interface (AWS CLI). Pour afficher les commandes de l’AWS CLI pour Amazon SNS, utilisez la commande suivante.

aws sns help

Avant d’exécuter des commandes, définissez vos informations d’identification par défaut. Pour plus d’informations, consultez Configuration des paramètres de l’AWS CLI.

Cette rubrique montre des exemples de commandes AWS CLI qui effectuent des tâches courantes pour Amazon SNS.

Création d’une rubrique

Pour créer une rubrique, utilisez la commande sns create-topic et spécifiez le nom que vous souhaitez attribuer à la rubrique.

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

Notez la valeur TopicArn de la réponse, que vous utiliserez plus tard pour publier un message.

Abonnement à une rubrique

Pour vous abonner à une rubrique, utilisez la commande sns subscribe.

L’exemple suivant spécifie le protocole email et une adresse e-mail pour notification-endpoint.

$ 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 envoie immédiatement un e-mail de confirmation à l’adresse que vous avez spécifiée dans la commande subscribe. Le message électronique comporte le texte suivant.

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

Une fois que le destinataire clique sur le lien Confirmer l’abonnement, le navigateur du destinataire affiche un message de notification avec des informations similaires à ce qui suit.

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.

Publication dans une rubrique

Pour envoyer un message à tous les abonnés d’une rubrique, utilisez la commande sns publish.

L’exemple suivant envoie le message « Hello World! » à tous les abonnés de la rubrique spécifiée.

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

Dans cet exemple, AWS envoie un message électronique avec le texte « Hello World ! » à saanvi@example.com.

Annulation de l’abonnement à une rubrique

Pour vous désabonner d’une rubrique et arrêter de recevoir les messages qui y sont publiés, utilisez la commande sns unsubscribe et spécifiez l’ARN de la rubrique à laquelle vous voulez vous désabonner.

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

Pour vérifier que vous êtes bien désabonnés, utilisez la commande sns list-subscriptions pour confirmer que l’ARN n’apparaît plus dans la liste.

$ aws sns list-subscriptions

Suppression d’une rubrique

Pour supprimer une rubrique, exécutez la commande sns delete-topic.

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

Pour vérifier qu’AWS a bien supprimé la rubrique, utilisez la commande sns list-topics pour confirmer que la rubrique n’apparaît plus dans la liste.

$ aws sns list-topics