# Acceso a Amazon SNS en la AWS CLI
<a name="cli-services-sns"></a>

Puede acceder a las características de Amazon Simple Notification Service (Amazon SNS) a través de AWS Command Line Interface (AWS CLI). Para mostrar la lista de los comandos de AWS CLI para Amazon SNS, utilice el siguiente comando.

```
aws sns help
```

Antes de ejecutar los comandos, defina sus credenciales predeterminadas. Para obtener más información, consulte [Configuración de los ajustes de AWS CLI](cli-chap-configure.md).

En este tema se muestran ejemplos de comandos de la AWS CLI que realizan tareas comunes para Amazon SNS.

**Topics**
+ [Crear un tema](#cli-create-sns-topic)
+ [Suscripción a un tema](#cli-subscribe-sns-topic)
+ [Publicar en un tema](#cli-publish-sns-topic)
+ [Cancelación de la suscripción a un tema](#cli-unsubscribe-sns-topic)
+ [Eliminación de un tema](#cli-delete-sns-topic)

## Crear un tema
<a name="cli-create-sns-topic"></a>

Para crear un tema, utilice el comando [https://docs.aws.amazon.com/cli/latest/reference/sns/create-topic.html](https://docs.aws.amazon.com/cli/latest/reference/sns/create-topic.html) y especifique el nombre que desea asignar al tema.

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

Anote el valor de `TopicArn` de la respuesta, que utilizará más adelante para publicar un mensaje.

## Suscripción a un tema
<a name="cli-subscribe-sns-topic"></a>

Para suscribirse a un ‎tema, utilice el comando [https://docs.aws.amazon.com/cli/latest/reference/sns/subscribe.html](https://docs.aws.amazon.com/cli/latest/reference/sns/subscribe.html). 

En el siguiente ejemplo se especifica el protocolo `email` y una dirección de correo electrónico para el `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 envía inmediatamente un mensaje de confirmación a la dirección de correo electrónico que ha especificado en el comando `subscribe`. El mensaje de correo electrónico tiene este texto.

```
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
```

Cuando el destinatario hace clic en el enlace **Confirm subscription (Confirmar suscripción)**, el navegador del destinatario muestra un mensaje de notificación con información similar a la siguiente.

```
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.
```

## Publicar en un tema
<a name="cli-publish-sns-topic"></a>

Para enviar un mensaje a todos los suscriptores de un ‎tema, utilice el comando [https://docs.aws.amazon.com/cli/latest/reference/sns/publish.html](https://docs.aws.amazon.com/cli/latest/reference/sns/publish.html). 

En el siguiente ejemplo se envía el mensaje “Hola mundo” a todos los suscriptores del tema especificado.

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

En este ejemplo, AWS envía un mensaje de correo electrónico con el texto “Hola mundo” a `saanvi@example.com`.

## Cancelación de la suscripción a un tema
<a name="cli-unsubscribe-sns-topic"></a>

‎Para cancelar la suscripción a un tema y dejar de recibir los mensajes que se publican en él, utilice el comando [https://docs.aws.amazon.com/cli/latest/reference/sns/unsubscribe.html](https://docs.aws.amazon.com/cli/latest/reference/sns/unsubscribe.html) y especifique el ARN del tema del que desea cancelar la suscripción.

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

‎Para verificar que se ha cancelado la suscripción correctamente, utilice el comando [https://docs.aws.amazon.com/cli/latest/reference/sns/list-subscriptions.html](https://docs.aws.amazon.com/cli/latest/reference/sns/list-subscriptions.html) para confirmar que el ARN ya no aparece en la lista.

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

## Eliminación de un tema
<a name="cli-delete-sns-topic"></a>

‎Para eliminar un tema, ejecute el comando [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
```

Para verificar que AWS ha eliminado ‎el tema correctamente, utilice el comando [https://docs.aws.amazon.com/cli/latest/reference/sns/list-topics.html](https://docs.aws.amazon.com/cli/latest/reference/sns/list-topics.html) para confirmar que el tema ya no aparece en la lista.

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