Ricezione di eventi di errore di replica con notifiche di eventi Amazon S3 - Amazon Simple Storage Service
Motivi degli errori di replica Amazon S3

Ricezione di eventi di errore di replica con notifiche di eventi Amazon S3

Se sulla propria configurazione della replica sono stati abilitati i parametri di Replica S3, è possibile configurare Notifiche di eventi Amazon S3 per inviare una notifica quando gli oggetti non vengono replicati nella loro Regione AWS di destinazione. Se si è abilitato il controllo del tempo di replica di S3 (S3 RTC) sulla propria configurazione della replica, è anche possibile ricevere una notifica quando gli oggetti non vengono replicati entro la soglia S3 RTC di 15 minuti per la replica.

Attraverso l'uso dei seguenti tipi di evento Replication, è possibile monitorare l'avanzamento degli eventi di replica minuto per minuto controllando i byte in sospeso, le operazioni in sospeso e la latenza di replica. Per ulteriori informazioni sui parametri di Replica S3, consulta Utilizzo dei parametri di Replica S3.

  • Il tipo di evento s3:Replication:OperationFailedReplication notifica quando un oggetto idoneo per la replica non è stato replicato.

  • Il tipo di evento s3:Replication:OperationMissedThreshold notifica quando un oggetto idoneo per la replica che utilizza S3 RTC supera la soglia di 15 minuti per la replica.

  • Il tipo di evento s3:Replication:OperationReplicatedAfterThreshold notifica quando un oggetto idoneo per la replica che utilizza S3 RTC viene replicato dopo la soglia di 15 minuti.

  • Il tipo di evento s3:Replication:OperationNotTracked notifica quando un oggetto idoneo per la replica in tempo reale (replica nella stessa Regione [SRR] o replica tra Regioni [CRR]) non è più monitorato dai parametri di replica.

Per una descrizione completa dei tipi di eventi di replica supportati, consulta Tipi di eventi supportati per SQS, SNS e Lambda.

Per l'elenco dei codici di errore acquisiti da Notifiche di eventi S3, consulta Motivi degli errori di replica Amazon S3.

Puoi ricevere notifiche di eventi Amazon S3 utilizzando Amazon Simple Queue Service (Amazon SQS), Servizio di notifica semplice Amazon (Amazon SNS) o AWS Lambda. Per ulteriori informazioni, consulta Notifiche di eventi Amazon S3.

Per istruzioni su come configurare Notifiche di eventi Amazon S3, consulta Abilitare le notifiche di eventi.

Nota

Oltre ad abilitare le notifiche degli eventi, assicurarsi di abilitare anche i parametri di Replica S3. Per ulteriori informazioni, consulta Abilitazione dei parametri di replica S3.

Quello che segue è un esempio di un messaggio inviato da Amazon S3 per pubblicare un evento s3:Replication:OperationFailedReplication. Per ulteriori informazioni, consulta Struttura del messaggio di 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"
      }
    }
  ]
}

Motivi degli errori di replica Amazon S3

La seguente tabella elenca i motivi degli errori di replica in Amazon S3. È possibile visualizzare questi motivi ricevendo l'evento s3:Replication:OperationFailedReplication con Notifiche di eventi Amazon S3 e cercando il valore failureReason.

Puoi visualizzare questi motivi di errore anche nei report di completamento della replica in batch in S3. Per ulteriori informazioni, consulta Report di completamento della replica in batch.

Motivo dell'errore di replica

Descrizione

AssumeRoleNotPermitted

Amazon S3 non può assumere il ruolo AWS Identity and Access Management (IAM) specificato nella configurazione della replica o nel processo Operazioni in batch.

DstBucketInvalidRegion

Il bucket di destinazione non è nella stessa Regione AWS specificata dal processo delle Operazioni in batch. Questo errore è specifico per la replica in batch.

DstBucketNotFound

Amazon S3 non è in grado di trovare il bucket di destinazione specificato nella configurazione della replica.

DstBucketObjectLockConfigMissing

Per replicare gli oggetti da un bucket di origine con la funzionalità di blocco degli oggetti abilitata, anche la destinazione deve avere il blocco degli oggetti abilitato. Questo errore indica che il blocco degli oggetti potrebbe non essere abilitato nel bucket di destinazione. Per ulteriori informazioni, consulta Considerazioni su Object Lock.

DstBucketUnversioned

Il controllo delle versioni non è abilitato per il bucket di destinazione S3. Per replicare gli oggetti con la funzionalità Replica Amazon S3, abilita il controllo delle versioni per bucket di destinazione.

DstDelObjNotPermitted

Amazon S3 non è in grado di replicare i contrassegni di eliminazione nel bucket di destinazione. È possibile che manchi l'autorizzazione s3:ReplicateDelete per il bucket di destinazione.

DstKmsKeyInvalidState

Lo stato della chiave AWS Key Management Service (AWS KMS) per il bucket di destinazione non è valido. Rivedi e abilita la chiave AWS KMS richiesta. Per ulteriori informazioni sulla gestione delle chiavi AWS KMS, consulta Stati chiave delle chiavi AWS KMS nella Guida per gli sviluppatori di AWS Key Management Service.

DstKmsKeyNotFound

La chiave AWS KMS configurata per il bucket di destinazione nella configurazione della replica non esiste.

DstMultipartCompleteNotPermitted

Amazon S3 non è in grado di completare i caricamenti in più parti degli oggetti nel bucket di destinazione. È possibile che manchi l'autorizzazione s3:ReplicateObject per il bucket di destinazione.

DstMultipartInitNotPermitted

Amazon S3 non è in grado di avviare i caricamenti in più parti degli oggetti nel bucket di destinazione. È possibile che manchi l'autorizzazione s3:ReplicateObject per il bucket di destinazione.

DstMultipartUploadNotPermitted

Amazon S3 non è in grado di caricare oggetti in più parti nel bucket di destinazione. È possibile che manchi l'autorizzazione s3:ReplicateObject per il bucket di destinazione.

DstObjectHardDeleted

S3 Batch Replication non supporta la ripetizione della replica di oggetti eliminati con l'ID versione dell'oggetto del bucket di destinazione. Questo errore è specifico per la replica in batch.

DstPutAclNotPermitted

Amazon S3 non è in grado di replicare le liste di controllo degli accessi (ACL) dell'oggetto nel bucket di destinazione. È possibile che manchi l'autorizzazione s3:ReplicateObject per il bucket di destinazione.

DstPutLegalHoldNotPermitted

Amazon S3 non è in grado di impostare un blocco legale di Object Lock per l’oggetto di destinazione durante la replica di oggetti immutabili. È possibile che manchi l'autorizzazione s3:PutObjectLegalHold per il bucket di destinazione. Per ulteriori informazioni, consulta Blocchi a fini giudiziari.

DstPutObjectNotPermitted

Amazon S3 non è in grado di replicare oggetti nel bucket di destinazione. Ciò può verificarsi quando mancano le autorizzazioni richieste (s3:ReplicateObject o s3:ObjectOwnerOverrideToBucketOwner) per il bucket di destinazione o quando la policy della chiave AWS KMS non consente al ruolo di replica del bucket di origine di utilizzare la chiave AWS KMS (le azioni kms:Decrypt e kms:GenerateDataKey*) nel bucket di destinazione.

DstPutRetentionNotPermitted

Amazon S3 non è in grado di impostare un periodo di conservazione degli oggetti di destinazione durante la replica di oggetti immutabili. È possibile che manchi l'autorizzazione s3:PutObjectRetention per il bucket di destinazione.

DstPutTaggingNotPermitted

Amazon S3 non è in grado di replicare tag di oggetti nel bucket di destinazione. È possibile che manchi l'autorizzazione s3:ReplicateObject per il bucket di destinazione.

DstVersionNotFound

Amazon S3 non è in grado di trovare la versione dell'oggetto richiesta nel bucket di destinazione per cui devono essere replicati i metadati.

InitiateReplicationNotPermitted

Amazon S3 non è in grado di avviare la replica sugli oggetti. È possibile che manchi l'autorizzazione s3:InitiateReplication per il processo Operazioni in batch. Questo errore è specifico per la replica in batch.

SrcBucketInvalidRegion

Il bucket di origine non è nella stessa Regione AWS specificata dal processo Operazioni in batch. Questo errore è specifico per la replica in batch.

SrcBucketNotFound

Amazon S3 non è in grado di trovare il bucket di origine.

SrcBucketReplicationConfigMissing

Amazon S3 non è riuscito a trovare una configurazione della replica per il bucket di origine.

SrcGetAclNotPermitted

Amazon S3 non è in grado di accedere all'oggetto nel bucket di origine per la replica. È possibile che manchi l'autorizzazione s3:GetObjectVersionAcl per l'oggetto del bucket di origine.

Gli oggetti nel bucket di origine devono essere di proprietà del proprietario del bucket. Se gli ACL sono abilitati, verifica se Proprietà dell'oggetto è impostata su Proprietario del bucket preferito o Autore dell'oggetto. Se Proprietà dell'oggetto è impostata su Proprietario del bucket preferito, gli oggetti del bucket di origine devono avere l'ACL bucket-owner-full-control affinché il proprietario del bucket diventi il proprietario dell'oggetto. L'account di origine può acquisire la proprietà di tutti gli oggetti nel relativo bucket impostando Proprietà dell'oggetto su Proprietario del bucket preferito e disabilitando gli ACL.

SrcGetLegalHoldNotPermitted

Amazon S3 non è in grado di accedere alle informazioni di conservazione legale di S3 Object Lock.

SrcGetObjectNotPermitted

Amazon S3 non è in grado di accedere all'oggetto nel bucket di origine per la replica. È possibile che manchi l'autorizzazione s3:GetObjectVersionForReplication per il bucket di origine.

SrcGetRetentionNotPermitted

Amazon S3 non è in grado di accedere alle informazioni del periodo di conservazione di S3 Object Lock.

SrcGetTaggingNotPermitted

Amazon S3 non è in grado di accedere alle informazioni sui tag di oggetto dal bucket di origine. È possibile che manchi l'autorizzazione s3:GetObjectVersionTagging per il bucket di origine.

SrcHeadObjectNotPermitted

Amazon S3 non è in grado di recuperare i metadati dell'oggetto dal bucket di origine. È possibile che manchi l'autorizzazione s3:GetObjectVersionForReplication per il bucket di origine.

SrcKeyNotFound

Amazon S3 non è in grado di trovare la chiave dell'oggetto di origine da replicare. L'oggetto di origine potrebbe essere stato eliminato prima del completamento della replica.

SrcKmsKeyInvalidState

Lo stato della chiave AWS KMS per il bucket di origine non è valido. Rivedi e abilita la chiave AWS KMS richiesta. Per ulteriori informazioni sulla gestione delle chiavi AWS KMS, consulta Stati chiave delle chiavi AWS KMS nella Guida per gli sviluppatori di AWS Key Management Service.

SrcObjectNotEligible

Alcuni oggetti non sono idonei per la replica. Ciò può essere dovuto alla classe di archiviazione dell'oggetto o ai tag dell'oggetto che non corrispondono alla configurazione di replica.

SrcObjectNotFound

L'oggetto di origine non esiste.

SrcReplicationNotPending

Amazon S3 ha già replicato questo oggetto. Questo oggetto non è più in attesa di replica.

SrcVersionNotFound

Amazon S3 non è in grado di trovare la versione dell'oggetto di origine da replicare. La versione dell'oggetto di origine potrebbe essere stato eliminato prima del completamento della replica.

Configurazione delle autorizzazioni per la replica in tempo reale

Risoluzione dei problemi nella replica