Notificações de eventos do Amazon S3
Você pode usar o recurso Notificações de eventos do Amazon S3 para receber notificações quando determinados eventos acontecerem no bucket do S3. Para habilitar notificações, adicione uma configuração de notificação que identifique os eventos que deseja que o Amazon S3 publique. Verifique se ele também identifica os destinos para os quais você deseja que o Amazon S3 envie as notificações. Armazene essa configuração no sub-recurso notification associado a um bucket. Para obter mais informações, consulte Opções de configuração do bucket. O Amazon S3 fornece uma API para gerenciamento desse sub-recurso.
Importante
As notificações de eventos do Amazon S3 são projetadas para serem entregues pelo menos uma vez. Em geral, as notificações de eventos são entregues em segundos, mas, às vezes, podem levar um minuto ou mais.
Visão geral das notificações de eventos do Amazon S3
Atualmente, o Amazon S3 pode publicar notificações para os seguintes eventos:
-
Eventos de criação de novos objetos
-
Eventos de remoção de objetos
-
Eventos de restauração de objetos
-
Eventos de perda de objeto com Reduced Redundancy Storage (RRS)
-
Eventos de replicação
-
Eventos de validade do S3 Lifecycle
-
Eventos de transição do S3 Lifecycle
-
Eventos de arquivamento automático do S3 Intelligent-Tiering
-
Eventos de marcação de objetos
-
Eventos PUT de ACL de objeto
Para obter descrições completas de todos os tipos de evento compatíveis, consulte Tipos de evento compatíveis com SQS, SNS e Lambda.
O Amazon S3 pode enviar mensagens de notificação de eventos aos seguintes destinos. Você especifica o valor do nome de recurso da Amazon (ARN) desses destinos na configuração de notificação.
-
Amazon Simple Notification Service (Amazon SNS) topics
-
Filas do Amazon Simple Queue Service (Amazon SQS)
-
Função do AWS Lambda
-
Amazon EventBridge
Para ter mais informações, consulte Destinos de eventos suportados.
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.
Atenção
Se a notificação for gravada no mesmo bucket que aciona a notificação, isso poderá causar um loop de execução. Por exemplo, se o bucket acionar uma função do Lambda toda vez que houver um upload de objeto, e a função fizer upload de um objeto no bucket, a função será acionada indiretamente. Para evitar isso, use dois buckets ou configure o trigger para só se aplicar a um prefixo usado em objetos recebidos.
Para obter mais informações e um exemplo de uso de notificações do Amazon S3 com AWS Lambda, consulte Uso do AWS Lambda com o Amazon S3 no Guia do desenvolvedor do AWS Lambda.
Para obter mais informações sobre o número de configurações de notificação de eventos que você pode criar por bucket, consulte Cotas de serviço do Amazon S3 na Referência geral da AWS.
Para obter mais informações sobre notificações de eventos do S3, consulte as seções a seguir.
Tópicos
