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.

# Accès à Amazon SNS dans l’AWS CLI
<a name="cli-services-sns"></a>

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](cli-chap-configure.md).

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

**Topics**
+ [Création d’une rubrique](#cli-create-sns-topic)
+ [Abonnement à une rubrique](#cli-subscribe-sns-topic)
+ [Publication dans une rubrique](#cli-publish-sns-topic)
+ [Annulation de l’abonnement à une rubrique](#cli-unsubscribe-sns-topic)
+ [Suppression d’une rubrique](#cli-delete-sns-topic)

## Création d’une rubrique
<a name="cli-create-sns-topic"></a>

Pour créer une rubrique, utilisez la commande [https://docs.aws.amazon.com/cli/latest/reference/sns/create-topic.html](https://docs.aws.amazon.com/cli/latest/reference/sns/create-topic.html) 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
<a name="cli-subscribe-sns-topic"></a>

Pour vous abonner à une rubrique, utilisez la commande [https://docs.aws.amazon.com/cli/latest/reference/sns/subscribe.html](https://docs.aws.amazon.com/cli/latest/reference/sns/subscribe.html). 

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
<a name="cli-publish-sns-topic"></a>

Pour envoyer un message à tous les abonnés d’une rubrique, utilisez la commande [https://docs.aws.amazon.com/cli/latest/reference/sns/publish.html](https://docs.aws.amazon.com/cli/latest/reference/sns/publish.html). 

L’exemple suivant envoie le message « Hello World\$1 » à 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 \$1 » à `saanvi@example.com`.

## Annulation de l’abonnement à une rubrique
<a name="cli-unsubscribe-sns-topic"></a>

Pour vous désabonner d’une rubrique et arrêter de recevoir les messages qui y sont publiés, utilisez la commande [https://docs.aws.amazon.com/cli/latest/reference/sns/unsubscribe.html](https://docs.aws.amazon.com/cli/latest/reference/sns/unsubscribe.html) 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 [https://docs.aws.amazon.com/cli/latest/reference/sns/list-subscriptions.html](https://docs.aws.amazon.com/cli/latest/reference/sns/list-subscriptions.html) pour confirmer que l’ARN n’apparaît plus dans la liste.

```
$ aws sns list-subscriptions
```

## Suppression d’une rubrique
<a name="cli-delete-sns-topic"></a>

Pour supprimer une rubrique, exécutez la commande [https://docs.aws.amazon.com/cli/latest/reference/sns/delete-topic.html](https://docs.aws.amazon.com/cli/latest/reference/sns/delete-topic.html).

```
$ 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 [https://docs.aws.amazon.com/cli/latest/reference/sns/list-topics.html](https://docs.aws.amazon.com/cli/latest/reference/sns/list-topics.html) pour confirmer que la rubrique n’apparaît plus dans la liste.

```
$ aws sns list-topics
```