As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Uso do Amazon SNS com a 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 obter mais informações, consulte Configurar o 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