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

Acessando a Amazon SNS no AWS CLI

Você pode acessar os recursos do Amazon Simple Notification Service (AmazonSNS) usando o AWS Command Line Interface (AWS CLI). Para listar os AWS CLI comandos para a AmazonSNS, use o comando a seguir.

aws sns help

Antes de executar quaisquer comandos, defina suas credenciais padrão. Para obter mais informações, consulte Definindo configurações para o AWS CLI.

Este tópico mostra exemplos de AWS CLI comandos que realizam tarefas comuns para a AmazonSNS.

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"
}

AWS envia imediatamente uma mensagem de confirmação por e-mail para o endereço especificado no subscribe comando. 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, AWS envia uma mensagem de e-mail com o texto “Hello World!” parasaanvi@example.com.

Cancelar a assinatura de um tópico

Para cancelar a assinatura de um tópico e parar de receber mensagens publicadas nesse tópico, use o comando e especifique o tópico ARN 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 você cancelou a assinatura com sucesso, use o comando 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 o tópico AWS foi excluído com êxito, use o comando para confirmar que o tópico não aparece mais na lista.

$ aws sns list-topics