Recepción de eventos de error de replicación con notificaciones de eventos de Amazon S3 - Amazon Simple Storage Service
Motivos de errores de replicación de Amazon S3

Recepción de eventos de error de replicación con notificaciones de eventos de Amazon S3

Si ha habilitado las métricas de replicación de S3 en la configuración de replicación, puede configurar las notificaciones de eventos de Amazon S3 para que le notifiquen cuando los objetos no se replican en la Región de AWS de destino. Si ha habilitado el control del tiempo de replicación de S3 (S3 RTC) en la configuración de replicación, también podrá recibir una notificación cuando los objetos no se repliquen dentro del límite de 15 minutos del RTC de S3 para la replicación.

Mediante los siguientes tipos de eventos de Replication, puede supervisar el progreso de los eventos de replicación minuto a minuto al realizar el seguimiento de los bytes y las operaciones pendientes, y la latencia de replicación. Para obtener más información acerca de las métricas de replicación de S3, consulte Uso de métricas de replicación de S3.

  • El tipo de evento s3:Replication:OperationFailedReplication le notifica cuando un objeto que era apto para la replicación no pudo replicarse.

  • El tipo de evento s3:Replication:OperationMissedThreshold le notifica cuando un objeto que era elegible para la replicación que usa S3 RTC supera el umbral de 15 minutos para la replicación.

  • El tipo de evento s3:Replication:OperationReplicatedAfterThreshold le notifica cuando un objeto que era elegible para la replicación que usa S3 RTC replica después del umbral de 15 minutos.

  • El tipo de evento s3:Replication:OperationNotTracked le notifica cuando un objeto que era elegible para la replicación en directo (replicación en la misma región [SRR] o replicación entre regiones [CRR]) deja de someterse al seguimiento de las métricas de replicación.

Para obtener descripciones completas de todos los tipos de eventos de replicación compatibles, consulte Tipos de eventos admitidos para SQS, SNS y Lambda.

Para obtener una lista de los códigos de error capturados por las notificaciones de eventos de S3, consulte Motivos de errores de replicación de Amazon S3.

Puede recibir notificaciones de eventos de S3 a través de Amazon Simple Queue Service (Amazon SQS), Amazon Simple Notification Service (Amazon SNS) o AWS Lambda. Para obtener más información, consulte Notificaciones de eventos de Amazon S3.

Para obtener instrucciones sobre cómo configurar notificaciones de eventos de Amazon S3, consulte Enabling event notifications (Habilitación de notificaciones de eventos).

nota

Además de habilitar las notificaciones de eventos, asegúrese de habilitar también las métricas de replicación de S3. Para obtener más información, consulte Habilitación de métricas de replicación de S3.

El siguiente mensaje es un ejemplo de un mensaje que Amazon S3 envía para publicar un evento de s3:Replication:OperationFailedReplication. Para obtener más información, consulte Estructura de mensaje 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 errores de replicación de Amazon S3

En el siguiente gráfico se muestran los motivos de los errores de replicación de Amazon. Puede ver estos motivos al recibir el evento s3:Replication:OperationFailedReplication con las notificaciones de eventos de Amazon S3 y, a continuación, consultar el valor failureReason.

También puede ver estos motivos de error en un informe de finalización de replicación por lotes de S3. Para obtener más información, consulte Informe de finalización de replicación por lotes.

Motivo de error de replicación

Descripción

AssumeRoleNotPermitted

Amazon S3 no puede asumir el rol de AWS Identity and Access Management (IAM) especificado en la configuración de la replicación o en el trabajo de operaciones por lotes.

DstBucketInvalidRegion

El bucket de destino no está en la misma Región de AWS que la especificada en el trabajo de Operaciones por lotes. Este error es específico de la replicación por lotes.

DstBucketNotFound

Amazon S3 no encuentra el bucket de destino especificado en la configuración de replicación.

DstBucketObjectLockConfigMissing

Para replicar objetos de un bucket de origen con el bloqueo de objetos activado, el bucket de destino también debe tener habilitado el bloqueo de objetos. El error indica que es posible que el bloqueo de objetos no esté habilitado en el bucket de destino. Para obtener más información, consulte Consideraciones sobre el bloqueo de objetos.

DstBucketUnversioned

El control de versiones no está habilitado en el bucket de destino de S3. Habilite el control de versiones en el bucket de destino para replicar objetos con Replicación de S3.

DstDelObjNotPermitted

Amazon S3 no puede replicar los marcadores de eliminación en el bucket de destino. Es posible que falte el permiso s3:ReplicateDelete para el bucket de destino.

DstKmsKeyInvalidState

La clave de AWS Key Management Service (AWS KMS) del bucket de destino se encuentra en un estado no válido. Revise y habilite la clave AWS KMS requerida. Para obtener más información sobre la administración de claves de AWS KMS, consulte Estados de las claves de AWS KMS en la Guía para desarrolladores de AWS Key Management Service.

DstKmsKeyNotFound

La clave de AWS KMS clave configurada para el bucket de destino en la configuración de replicación no existe.

DstMultipartCompleteNotPermitted

Amazon S3 no puede completar la carga multiparte de objetos en el bucket de destino. Es posible que falte el permiso s3:ReplicateObject para el bucket de destino.

DstMultipartInitNotPermitted

Amazon S3 no puede iniciar la carga multiparte de objetos en el bucket de destino. Es posible que falte el permiso s3:ReplicateObject para el bucket de destino.

DstMultipartPartUploadNotPermitted

Amazon S3 no puede cargar objetos de carga multiparte en el bucket de destino. Es posible que falte el permiso s3:ReplicateObject para el bucket de destino.

DstObjectHardDeleted

La replicación por lotes de S3 no admite volver a replicar objetos eliminados con el ID de versión del objeto del bucket de destino. Este error es específico de la replicación por lotes.

DstPutAclNotPermitted

Amazon S3 no puede replicar las listas de control de acceso (ACL) del objeto en el bucket de destino. Es posible que falte el permiso s3:ReplicateObject para el bucket de destino.

DstPutLegalHoldNotPermitted

Amazon S3 no puede aplicar una retención legal de Bloqueo de objetos en los objetos de destino durante la replicación de objetos inmutables. Es posible que falte el permiso s3:PutObjectLegalHold para el bucket de destino. Para obtener más información, consulte Retenciones legales.

DstPutObjectNotPermitted

Amazon S3 no puede replicar objetos en el bucket de destino. Es posible que falten los permiso s3:ReplicateObject o s3:ObjectOwnerOverrideToBucketOwner para el bucket de destino.

DstPutRetentionNotPermitted

Amazon S3 no puede aplicar un periodo de retención en los objetos de destino durante la replicación de objetos inmutables. Es posible que falte el permiso s3:PutObjectRetention para el bucket de destino.

DstPutTaggingNotPermitted

Amazon S3 no puede replicar etiquetas de objetos en el bucket de destino. Es posible que falte el permiso s3:ReplicateObject para el bucket de destino.

DstVersionNotFound

Amazon S3 no puede encontrar la versión del objeto requerida en el bucket de destino para la que se deben replicar los metadatos.

InitiateReplicationNotPermitted

Amazon S3 no puede iniciar la replicación en objetos. Puede que falte el permiso s3:InitiateReplication para el trabajo de operaciones por lotes. Este error es específico de la replicación por lotes.

SrcBucketInvalidRegion

El bucket de origen no está en la misma Región de AWS que la especificada en el trabajo de operaciones por lotes. Este error es específico de la replicación por lotes.

SrcBucketNotFound

Amazon S3 no puede encontrar el bucket de origen.

SrcBucketReplicationConfigMissing

Amazon S3 no encuentra una configuración de replicación para el bucket de origen.

SrcGetAclNotPermitted

Amazon S3 no puede acceder al objeto del bucket de origen para la replicación. Es posible que falte el permiso s3:GetObjectVersionAcl para el objeto del bucket de origen.

Los objetos del bucket de origen deben pertenecer al propietario del bucket. Si las ACL están habilitadas, compruebe si la propiedad del objeto está establecida en Propietario del bucket preferido o Escritor de objetos. Si la propiedad del objeto está establecida en Propietario del bucket preferido, los objetos del bucket de origen deben tener la ACL bucket-owner-full-control para que el propietario del bucket se convierta en propietario del objeto. La cuenta de origen puede asumir la propiedad de todos los objetos de su bucket configurando la propiedad de los objetos en Propietario del bucket obligatorio y desactivando las ACL.

SrcGetLegalHoldNotPermitted

Amazon S3 no puede acceder a la información de retención legal de Bloqueo de objetos de S3.

SrcGetObjectNotPermitted

Amazon S3 no puede acceder al objeto del bucket de origen para la replicación. Es posible que falte el permiso s3:GetObjectVersionForReplication para el bucket de origen.

SrcGetRetentionNotPermitted

Amazon S3 no puede acceder a la información del periodo de retención de Bloqueo de objetos de S3.

SrcGetTaggingNotPermitted

Amazon S3 no puede acceder a la información de las etiquetas de objetos desde el bucket de origen. Es posible que falte el permiso s3:GetObjectVersionTagging para el bucket de origen.

SrcHeadObjectNotPermitted

Amazon S3 no puede recuperar los metadatos del objeto del bucket de origen. Es posible que falte el permiso s3:GetObjectVersionForReplication para el bucket de origen.

SrcKeyNotFound

Amazon S3 no puede encontrar la clave del objeto de origen para replicarla. Es posible que el objeto de origen se haya eliminado antes de que se completara la replicación.

SrcKmsKeyInvalidState

La clave de AWS KMS del bucket de origen no tiene un estado válido. Revise y habilite la clave AWS KMS requerida. Para obtener más información sobre la administración de claves de AWS KMS, consulte Estados de las claves de AWS KMS en la Guía para desarrolladores de AWS Key Management Service.

SrcObjectNotEligible

Algunos objetos no son aptos para la replicación. Esto puede deberse a la clase de almacenamiento del objeto o a que las etiquetas del objeto no coinciden con la configuración de replicación.

SrcObjectNotFound

El objeto de origen no existe.

SrcReplicationNotPending

Amazon S3 ya ha replicado este objeto. Este objeto ya no está pendiente de replicación.

SrcVersionNotFound

Amazon S3 no puede encontrar la versión del objeto de origen para replicarla. Es posible que la versión del objeto de origen se haya eliminado antes de que se completara la replicación.

Configuración de permisos para la replicación en directo

Solución de problemas de replicación