

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

# Tutorial: enviar um e-mail usando o Amazon EventBridge quando ocorrerem eventos
<a name="eb-s3-object-created-tutorial"></a>

É possível enviar notificações por e-mail quando objetos do [Amazon Simple Storage Service (Amazon S3)](https://docs.aws.amazon.com/AmazonS3/latest/userguide/Welcome.html) são criados usando o Amazon EventBridge e o [Amazon SNS](https://docs.aws.amazon.com/sns/latest/dg/welcome.html). Neste tutorial, serão criados um tópico e uma assinatura do SNS. Em seguida, será criada uma [regra](eb-rules.md) no console do EventBridge que enviará [eventos](eb-events.md) para esse tópico quando os eventos `Object Created` do Amazon S3 forem recebidos.

**Topics**
+ [Pré-requisitos](#eb-s3-object-created-tutorial-prerequisite)
+ [Etapa 1: criar um tópico do Amazon SNS](#eb-s3-object-created-tutorial-create-topic)
+ [Etapa 2: criar uma assinatura do Amazon SNS](#eb-s3-object-created-tutorial-create-sns)
+ [Etapa 3: criar uma regra](#eb-s3-object-created-tutorial-create-rule)
+ [Etapa 4: testar a regra](#eb-s3-object-created-tutorial-test-rule)
+ [Etapa 5: limpar os recursos](#cleanup)

## Pré-requisitos
<a name="eb-s3-object-created-tutorial-prerequisite"></a>

Para receber eventos do Amazon S3 no EventBridge, é preciso habilitar o EventBridge no console do Amazon S3. Este tutorial pressupõe que o EventBridge esteja habilitado. Para obter mais informações, consulte [Como ativar o Amazon EventBridge no console do S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/enable-event-notifications-eventbridge.html).

## Etapa 1: criar um tópico do Amazon SNS
<a name="eb-s3-object-created-tutorial-create-topic"></a>

Crie um tópico para receber os eventos do EventBridge.

**Para criar um tópico**

1. Abra o console do Amazon SNS em [https://console.aws.amazon.com/sns/v3/home](https://console.aws.amazon.com/sns/v3/home).

1. No painel de navegação, escolha **Tópicos**.

1. Escolha **Criar tópico**.

1. Em **Tipo**, escolha **Padrão**.

1. Insira **eventbridge-test** como o nome do tópico.

1. Escolha **Criar tópico**.

## Etapa 2: criar uma assinatura do Amazon SNS
<a name="eb-s3-object-created-tutorial-create-sns"></a>

Crie uma assinatura para receber notificações por e-mail do Amazon S3 quando os eventos forem recebidos pelo tópico.

**Criar uma assinatura**

1. Abra o console do Amazon SNS em [https://console.aws.amazon.com/sns/v3/home](https://console.aws.amazon.com/sns/v3/home).

1. No painel de navegação, escolha **Assinaturas**.

1. Selecione **Create subscription**.

1. Em **ARN do tópico**, escolha o tópico criado na etapa 1. Para este tutorial, escolha **eventbridge-test**.

1. Em **Protocolo**, escolha **Email**.

1. Para **Endpoint**, insira seu endereço de e-mail.

1. Selecione **Criar assinatura**.

1. Confirme a assinatura escolhendo **Confirmar assinatura** no e-mail que você recebe das notificações AWS.

## Etapa 3: criar uma regra
<a name="eb-s3-object-created-tutorial-create-rule"></a>

Crie uma regra para enviar eventos ao seu tópico quando um objeto do Amazon S3 é criado.

**Como criar uma regra**

1. Abra o console do Amazon EventBridge em [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/).

1. No painel de navegação, escolha **Regras**.

1. Escolha **Create rule**.

1. Insira um nome e uma descrição para a regra. Por exemplo, nomeie a regra como `s3-test`

1. Em **Barramento de eventos**, selecione **padrão**.

1. Em **Rule type**, escolha **Rule with an event pattern**.

1. Escolha **Próximo**.

1. Em **Event source**, escolha **Eventos da AWS ou eventos de parceiro do EventBridge**.

1. Em **Método de criação**, escolha **Usar formulário de padrão**.

1. Em **Event pattern** (Padrão de evento), faça o seguinte:

   1. Em **Origem do evento,** selecione **serviços da AWS** na lista suspensa.

   1. Para o **serviço da AWS**, selecione **Simple Storage Service (S3)** na lista suspensa.

   1. Para **Tipo de evento**, escolha **Notificação de eventos do Amazon S3** na lista suspensa.

   1. Escolha **Eventos específicos** e escolha **Objeto criado** na lista suspensa.

   1. Escolha **Adicionar bucket**

1. Escolha **Próximo**.

1. Em **Tipos de destino**, escolha **Serviço da AWS**.

1. Em **Selecionar um destino**, escolha o **tópico do SNS** na lista suspensa.

1. Em **Tópico**, selecione o tópico do Amazon SNS criado na seção **Etapa 1: criar um tópico do SNS**. Neste exemplo, selecione `eventbridge-test`.

1. Escolha **Próximo**.

1. Escolha **Próximo**.

1. Analise os detalhes da regra e selecione **Criar regra**.

## Etapa 4: testar a regra
<a name="eb-s3-object-created-tutorial-test-rule"></a>

Para testar sua regra, crie um objeto do Amazon S3 fazendo o upload de um arquivo em um bucket compatível com o Eventbridge. Em seguida, aguarde alguns minutos e verifique se recebeu um e-mail de notificações da AWS.

## Etapa 5: limpar os recursos
<a name="cleanup"></a>

Agora você pode excluir os recursos criados para este tutorial, a menos que queira mantê-los. Ao excluir os recursos da AWS que não estão mais sendo usados, são evitadas cobranças desnecessárias em sua conta da AWS.

**Para excluir o tópico do SNS**

1. Abra a página [Tópicos](https://console.aws.amazon.com/sns/v3/home#/topics) do console do SNS.

1. Selecione o tópico que foi criado.

1. Escolha **Excluir**.

1. Insira **delete me**.

1. Escolha **Excluir**.

**Para excluir a assinatura do SNS**

1. Abra a página de [Assinaturas](https://console.aws.amazon.com/sns/v3/home#/subscriptions) no console do Amazon SNS.

1. Selecione a assinatura que foi criada.

1. Escolha **Excluir**.

1. Escolha **Excluir**.

**Para excluir as regras do EventBridge**

1. Abra a página [Regras](https://console.aws.amazon.com/events/home#/rules) no console do EventBridge.

1. Selecione as regras que foram criadas.

1. Escolha **Excluir**.

1. Escolha **Excluir**.