Habilitar e configurar notificações de eventos usando o console do Amazon S3

Você pode habilitar certos eventos de bucket do Amazon S3 para enviar uma mensagem de notificação para um destino sempre que ocorrer um desses eventos. Esta seção explica como usar o console do Amazon S3 para habilitar notificações de evento. Para obter informações sobre como usar notificações de eventos com os AWS SDKs e as APIs REST do Amazon S3, consulte Configuração de notificações de eventos de forma programática.

Pré-requisitos: antes de habilitar as notificações de eventos para seu bucket, você deve configurar um dos tipos de destino e, em seguida, configurar permissões. Para obter mais informações, consulte Destinos de eventos suportados e Conceder permissões para publicar mensagens de notificação de vento a um destino.

nota

As filas FIFO (primeiro entrar, primeiro a sair) do Amazon Simple Queue Service não são compatíveis como destino de notificação de evento do Amazon S3. Para enviar uma notificação de um evento do Amazon S3 para uma fila FIFO do Amazon SQS, você pode usar o Amazon EventBridge. Para ter mais informações, consulte Habilitar o Amazon EventBridge.

Habilitar notificações do Amazon SNS, Amazon SQS ou Lambda usando o console do Amazon S3

Para habilitar e configurar notificações de evento para um bucket do S3

1. Faça login no AWS Management Console e abra o console do Amazon S3 em https://console.aws.amazon.com/s3/.

2. Na lista Buckets, escolha o nome do bucket para o qual você deseja habilitar eventos.

3. Escolha Properties (Propriedades).

4. Navegue até a seção Event Notifications (Notificações de eventos) e escolha Create event notification (Criar notificação de evento).

5. Na seção General configuration (Configuração geral), especifique o nome do evento descritivo para sua notificação de evento. Opcionalmente, você também pode especificar um prefixo e um sufixo para limitar as notificações a objetos com chaves terminando nos caracteres especificados.

   1. Insira uma descrição para o Event name (Nome do evento).

      Se você não inserir um nome, um identificador exclusivo global (GUID) será gerado e usado para o nome.

   2. (Opcional) Para filtrar notificações de eventos por prefixo, insira um Prefix (Prefixo).

      Por exemplo, é possível configurar um filtro de prefixo para receber notificações somente quando os arquivos são adicionados a uma pasta específica (por exemplo, images/).

   3. (Opcional) Para filtrar notificações de eventos por sufixo, insira um Suffix (Sufixo).

      Para obter mais informações, consulte Configurar notificações de eventos usando filtragem de nomes de chave de objeto.

6. Na seção Event types (Tipos de evento), selecione um ou mais tipos de eventos para os quais você deseja receber notificações.

   Para obter uma lista dos diferentes tipos de evento, consulte Tipos de evento compatíveis com SQS, SNS e Lambda.

7. Na seção Destination (Destino), escolha o destino da notificação de evento.

   nota

   Antes de publicar notificações de eventos, você deve conceder à entidade principal do Amazon S3 as permissões necessárias para chamar a API relevante. Desse modo, ela pode publicar notificações em uma função Lambda, tópico do SNS ou fila SQS.

   1. Selecione o tipo de destino: Lambda Function (Função do Lambda), SNS Topic (Tópico do SNS) ou SQS Queue (Fila do SQS).

   2. Depois de escolher o tipo de destino, escolha uma função, um tópico ou uma fila na lista.

   3. Como alternativa, se você preferir especificar um nome de recurso da Amazon (ARN), selecione Enter ARN (Inserir ARN) e insira o ARN.

   Para obter mais informações, consulte Destinos de eventos suportados.

8. Escolha Save changes (Salvar alterações) e o Amazon S3 enviará uma mensagem de teste para o destino de notificação de evento.