Accès à Amazon SNS dans le AWS CLI

Cette documentation concerne AWS CLI uniquement la version 1 du. Pour la documentation relative à la version 2 du AWS CLI, consultez le guide de l'utilisateur de la version 2.

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Cette documentation concerne AWS CLI uniquement la version 1 du. Pour la documentation relative à la version 2 du AWS CLI, consultez le guide de l'utilisateur de la version 2.

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Vous pouvez accéder aux fonctionnalités d'Amazon Simple Notification Service (Amazon SNS) à l'aide AWS Command Line Interface du ().AWS CLI Pour répertorier les AWS CLI commandes 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 de plus amples informations, veuillez consulter Configuration des paramètres pour AWS CLI.

Cette rubrique présente des exemples de AWS CLI commandes qui exécutent des tâches courantes pour Amazon SNS.

Créer 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 le code TopicArn de la réponse, que vous utiliserez plus tard pour publier un message.

S'abonner à 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 le code 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 message de confirmation par e-mail à l'adresse que vous avez spécifiée dans la subscribe commande. 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.

Publier dans une rubrique

Pour envoyer un message à tous les abonnés d'un sujet, utilisez la sns publishcommande.

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 e-mail avec le texte « Hello World ! » àsaanvi@example.com.

Annuler l'abonnement à une rubrique

Pour vous désabonner d'un sujet et ne plus recevoir de messages publiés sur ce sujet, utilisez la sns unsubscribecommande et spécifiez l'ARN du sujet dont vous souhaitez 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 vous êtes bien désinscrit, utilisez la sns list-subscriptionscommande pour confirmer que l'ARN n'apparaît plus dans la liste.

$ aws sns list-subscriptions

Supprimer une rubrique

Pour supprimer un sujet, exécutez la sns delete-topiccommande.

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

Pour vérifier que AWS le sujet a bien été supprimé, utilisez la sns list-topicscommande pour confirmer que le sujet n'apparaît plus dans la liste.

$ aws sns list-topics