Configurar notificações de evento do Ciclo de Vida do S3 - Amazon Simple Storage Service

Configurar notificações de evento do Ciclo de Vida do S3

Para receber uma notificação quando o Amazon S3 exclui um objeto ou o transiciona para outra classe de armazenamento do Amazon S3 ao seguir uma regra do Ciclo de Vida do S3, é possível configurar uma notificação de eventos do Amazon S3.

É possível receber notificações para os seguintes eventos do Ciclo de Vida do S3:

  • Eventos de transição: ao usar o tipo de evento s3:LifecycleTransition, você poderá receber uma notificação quando um objeto for transferido para outra classe de armazenamento do Amazon S3 por uma configuração do Ciclo de Vida do S3.

  • Eventos de expiração (exclusão): ao usar os tipos de evento LifecycleExpiration, você poderá receber notificações sempre que o Amazon S3 excluir um objeto com base na configuração do Ciclo de Vida do S3.

    Há dois tipos de evento de expiração:

    • O tipo de evento s3:LifecycleExpiration:Delete notifica você quando um objeto em um bucket sem versionamento é excluído. s3:LifecycleExpiration:Delete também notifica quando uma versão de objeto é excluída permanentemente por uma configuração do Ciclo de Vida do S3.

    • O tipo de evento s3:LifecycleExpiration:DeleteMarkerCreated notifica você quando o Ciclo de Vida do S3 cria um marcador de exclusão depois que uma versão atual de um objeto no bucket com versionamento é excluída. Para ter mais informações, consulte Excluir versões de objetos de um bucket com versionamento habilitado.

O Amazon S3 pode publicar notificações de eventos em um tópico do Amazon Simple Notification Service (Amazon SNS), em uma fila do Amazon Simple Queue Service (Amazon SQS) ou em uma função do AWS Lambda. Para ter mais informações, consulte Notificações de eventos do Amazon S3.

Consulte instruções sobre como configurar Notificações de Eventos do Amazon S3 em Usar o Amazon SQS, o Amazon SNS e o AWS Lambda.

Veja a seguir um exemplo de mensagem que o Amazon S3 envia para publicar um evento s3:LifecycleExpiration:Delete. Para ter mais informações, consulte Estrutura de mensagens de evento.

{  
   "Records":[  
      {  
         "eventVersion":"2.3",
         "eventSource":"aws:s3",
         "awsRegion":"us-west-2",
         "eventTime":"1970-01-01T00:00:00.000Z",
         "eventName":"LifecycleExpiration:Delete",
         "userIdentity":{  
            "principalId":"s3.amazonaws.com"
         },
         "requestParameters":{  
            "sourceIPAddress":"s3.amazonaws.com"
         },
         "responseElements":{  
            "x-amz-request-id":"C3D13FE58DE4C810",
            "x-amz-id-2":"FMyUVURIY8/IgAtTv8xRjskZQpcIZ9KG4V5Wp6S7S/JRWeUWerMUE5JgHvANOjpD"
         },
         "s3":{  
            "s3SchemaVersion":"1.0",
            "configurationId":"testConfigRule",
            "bucket":{  
               "name":"amzn-s3-demo-bucket",
               "ownerIdentity":{  
                  "principalId":"A3NL1KOZZKExample"
               },
               "arn":"arn:aws:s3:::amzn-s3-demo-bucket"
            },
            "object":{  
               "key":"expiration/delete",
               "sequencer":"0055AED6DCD90281E5",              
            }
         }
      }
   ]
}

As mensagens que o Amazon S3 envia para publicar um evento s3:LifecycleTransition também incluem as seguintes informações:

"lifecycleEventData":{
    "transitionEventData": {
        "destinationStorageClass": the destination storage class for the object
    }
}