Receber eventos de falha de replicação com Notificações de Eventos do Amazon S3

Se você habilitou as métricas de replicação do S3 na configuração de replicação, poderá configurar as notificações de eventos do Amazon S3 para notificar você quando os objetos não forem replicados para a Região da AWS de destino. Se você habilitou o Controle de Tempo de Replicação do S3 (S3 RTC) na configuração de replicação, também poderá receber notificação quando os objetos não forem replicados no limite de 15 minutos do S3 RTC para replicação.

Ao usar os tipos de evento Replication a seguir, é possível acompanhar o andamento minuto a minuto dos eventos de replicação monitorando os bytes pendentes, as operações pendentes e a latência da replicação. Para ter mais informações sobre as métricas de replicação do S3, consulte Usar métricas de replicação do S3.

Para ter descrições completas de todos os tipos de evento de replicação compatíveis, consulte Tipos de evento compatíveis com SQS, SNS e Lambda.

Para ter uma lista dos códigos de falha capturados pelas notificações de eventos do S3, consulte Motivos de falha da replicação do Amazon S3.

Você pode receber Notificações de eventos do S3 por meio do Amazon Simple Queue Service (Amazon SQS), do Amazon Simple Notification Service (Amazon SNS) ou do AWS Lambda. Para ter mais informações, consulte Notificações de eventos do Amazon S3.

Para obter instruções sobre como configurar as notificações de evento do Amazon S3, consulte Habilitar notificações de eventos.

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

{
  "Records": [
    {
      "eventVersion": "2.2",
      "eventSource": "aws:s3",
      "awsRegion": "us-east-1",
      "eventTime": "2024-09-05T21:04:32.527Z",
      "eventName": "Replication:OperationFailedReplication",
      "userIdentity": {
        "principalId": "s3.amazonaws.com"
      },
      "requestParameters": {
        "sourceIPAddress": "s3.amazonaws.com"
      },
      "responseElements": {
        "x-amz-request-id": "123bf045-2b4b-4ca8-a211-c34a63c59426",
        "x-amz-id-2": "12VAWNDIHnwJsRhTccqQTeAPoXQmRt22KkewMV8G3XZihAuf9CLDdmkApgZzudaIe2KlLfDqGS0="
      },
      "s3": {
        "s3SchemaVersion": "1.0",
        "configurationId": "ReplicationEventName",
        "bucket": {
          "name": "amzn-s3-demo-bucket1",
          "ownerIdentity": {
            "principalId": "111122223333"
          },
          "arn": "arn:aws:s3:::amzn-s3-demo-bucket1"
        },
        "object": {
          "key": "replication-object-put-test.png",
          "size": 520080,
          "eTag": "e12345ca7e88a38428305d3ff7fcb99f",
          "versionId": "abcdeH0Xp66ep__QDjR76LK7Gc9X4wKO",
          "sequencer": "0066DA1CBF104C0D51"
        }
      },
      "replicationEventData": {
        "replicationRuleId": "notification-test-replication-rule",
        "destinationBucket": "arn:aws:s3:::amzn-s3-demo-bucket2",
        "s3Operation": "OBJECT_PUT",
        "requestTime": "2024-09-05T21:03:59.168Z",
        "failureReason": "AssumeRoleNotPermitted"
      }
    }
  ]
}

Motivos de falha da replicação do Amazon S3

A tabela a seguir relaciona os motivos de falha da replicação do Amazon S3. É possível visualizar esses motivos ao receber o evento s3:Replication:OperationFailedReplication com as notificações de eventos do Amazon S3 e, depois, examinar o valor failureReason.

Você também pode visualizar esses motivos de falha em um relatório de conclusão da replicação em lote do S3. Para ter mais informações, consulte Relatório de conclusão da replicação em lote.

Tópicos relacionados da

Configurar permissões para replicação em tempo real

Solução de problemas de replicação