Esta documentação é somente para a versão 1 da AWS CLI. Para obter a documentação relacionada à AWS CLI versão 2, consulte o Guia do usuário da versão 2.

Acesso ao Amazon SNS na AWS CLI

É possível acessar os recursos do Amazon Simple Notification Service (Amazon SNS) usando a AWS Command Line Interface (AWS CLI). Para listar os comandos da AWS CLI para o Amazon SNS, use o comando a seguir.

aws sns help

Antes de executar quaisquer comandos, defina suas credenciais padrão. Para ter mais informações, consulte Como definir as configurações da AWS CLI.

Este tópico mostra exemplos de comandos da AWS CLI que executam tarefas comuns para o Amazon SNS.

Criar um tópico

Para criar um tópico, use o comando sns create-topic e especifique o nome a ser atribuído a ele.

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

Anote o TopicArn da resposta que você usará mais tarde para publicar uma mensagem.

Assinar um tópico

Para assinar um tópico, use o comando sns subscribe.

O exemplo a seguir especifica o protocolo email e um endereço de e-mail para o 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"
}

O AWS envia imediatamente uma mensagem de confirmação para o endereço de e-mail especificado no comando subscribe. A mensagem de e-mail tem o seguinte 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

Assim que o destinatário clicar no link Confirm subscription (Confirmar assinatura), o navegador do destinatário exibirá uma mensagem de notificação com informações semelhantes à seguinte.

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 em um tópico

Para enviar uma mensagem a todos os assinantes de um tópico, use o comando sns publish.

O exemplo a seguir envia a mensagem “Hello World!” para todos os assinantes do tópico especificado.

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

Neste exemplo, a AWS envia uma mensagem de e-mail com o texto “Hello World!” para saanvi@example.com.

Cancelar a assinatura de um tópico

Para cancelar a assinatura de um tópico e parar de receber as mensagens publicadas nesse tópico, use o comando sns unsubscribe e especifique o ARN do tópico do qual você deseja cancelar a assinatura.

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

Para verificar se a assinatura foi cancelada com êxito, use o comando sns list-subscriptions para confirmar que o ARN não aparece mais na lista.

$ aws sns list-subscriptions

Excluir um tópico

Para excluir um tópico, execute o comando sns delete-topic.

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

Para verificar se a AWS excluiu o tópico com êxito, use o comando sns list-topics para confirmar que o tópico não aparece mais na lista.

$ aws sns list-topics