Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# Monitoraggio della replica con parametri, notifiche di eventi e stati
È possibile monitorare le configurazioni di replica in tempo reale e i processi Replica in batch S3 tramite i seguenti meccanismi:
+ Parametri di **replica S3: quando abiliti i parametri** di replica S3, CloudWatch Amazon emette parametri che puoi utilizzare per tenere traccia dei byte in sospeso, delle operazioni in sospeso e della latenza di replica a livello di regola di replica. Puoi visualizzare i parametri di replica S3 tramite la console Amazon S3 e la console Amazon. CloudWatch Nella console Amazon S3 è possibile visualizzare questi parametri nella scheda **Parametri** del bucket di origine. Per ulteriori informazioni sui parametri di Replica S3, consulta [Utilizzo dei parametri di Replica S3](repl-metrics.md).
+ **Parametri di S3 Storage Lens**: oltre ai parametri di Replica S3, è possibile utilizzare i parametri di Protezione dati relativi alla replica forniti dai pannelli di controllo di S3 Storage Lens. Ad esempio, se si utilizzano i parametri gratuiti di S3 Storage Lens, è possibile visualizzare parametri come il numero totale di byte replicati dal bucket di origine o il numero di oggetti replicati dal bucket di origine.
Per verificare la posizione complessiva di replica, è possibile abilitare parametri avanzati in S3 Storage Lens. Con i parametri avanzati di S3 Storage Lens, è possibile vedere di quante regole di vario tipo si dispone, incluso il numero di regole di replica con una destinazione di replica non valida.
Per ulteriori informazioni sull'utilizzo dei parametri di replica in S3 Storage Lens, consulta [Visualizzazione dei parametri di replica nei pannelli di controllo di S3 Storage Lens](viewing-replication-metrics-storage-lens.md).
+ **Notifiche di eventi S3**: S3 Event Notifications può inviarti notifiche a livello di oggetto nei casi in cui gli oggetti non si replicano nella loro destinazione Regione AWS o quando gli oggetti non vengono replicati entro determinate soglie. Notifiche di eventi S3 fornisce i seguenti tipi di eventi di replica: `s3:Replication:OperationFailedReplication`, `s3:Replication:OperationMissedThreshold`, `s3:Replication:OperationReplicatedAfterThreshold` e `s3:Replication:OperationNotTracked`.
Gli eventi Amazon S3 sono disponibili tramite Amazon Simple Queue Service (Amazon SQS), Amazon Simple Notification Service (Amazon SNS) oppure. AWS Lambda Per ulteriori informazioni, consulta [Ricezione di eventi di errore di replica con notifiche di eventi Amazon S3](replication-metrics-events.md).
+ **Valori dello stato della replica**: è possibile recuperare anche lo stato della replica degli oggetti. Lo stato della replica consente di determinare lo stato corrente di un oggetto sottoposto a replica. Lo stato della replica di un oggetto di origine restituirà `PENDING`, `COMPLETED` o `FAILED`. Lo stato della replica di una replica restituirà `REPLICA`.
È anche possibile utilizzare i valori dello stato della replica durante la creazione di processi di Replica in batch S3. Ad esempio questi valori di stato possono essere utilizzati per replicare gli oggetti che non sono mai stati replicati o la cui replica non è andata a buon fine.
Per ulteriori informazioni sul recupero dello stato della replica degli oggetti, consulta [Ottenimento delle informazioni sullo stato della replica](replication-status.md). Per ulteriori informazioni sull'utilizzo di questi valori con Replica in batch, consulta [Filtri per i processi Batch Replication](s3-batch-replication-batch.md#batch-replication-filters).
**Topics**
+ [Utilizzo dei parametri di Replica S3](repl-metrics.md)
+ [Visualizzazione dei parametri di replica nei pannelli di controllo di S3 Storage Lens](viewing-replication-metrics-storage-lens.md)
+ [Ricezione di eventi di errore di replica con notifiche di eventi Amazon S3](replication-metrics-events.md)
+ [Ottenimento delle informazioni sullo stato della replica](replication-status.md)
# Utilizzo dei parametri di Replica S3
Le metriche di replica S3 forniscono metriche dettagliate per le regole nella configurazione di replica. Con i parametri di replica, puoi monitorare l' minute-by-minuteavanzamento tenendo traccia dei byte in sospeso, delle operazioni in sospeso, delle operazioni che non hanno avuto esito positivo e della latenza di replica.
**Nota**
I parametri di replica S3 vengono fatturati alla stessa tariffa dei parametri personalizzati di Amazon. CloudWatch Per ulteriori informazioni, consulta i [ CloudWatchprezzi di Amazon](https://aws.amazon.com/cloudwatch/pricing/).
Se utilizzi S3 Replication Time Control, Amazon CloudWatch inizia a riportare i parametri di replica 15 minuti dopo aver abilitato S3 RTC sulla rispettiva regola di replica.
I parametri di replica S3 vengono attivati automaticamente quando si abilita il controllo del tempo di replica di S3 (S3 RTC). È anche possibile abilitare i parametri di Replica S3 indipendentemente da S3 RTC durante [la creazione o la modifica di una regola](replication-walkthrough1.md). La funzionalità di controllo del tempo di replica di S3 (S3 RTC) include altre funzionalità, ad esempio un Accordo sul livello di servizio (SLA) e notifiche per soglie non raggiunte. Per ulteriori informazioni, consulta [Soddisfazione dei requisiti di conformità con il controllo del tempo di replica di Amazon S3](replication-time-control.md).
Quando i parametri di replica S3 sono abilitati, Amazon S3 pubblica i seguenti parametri su Amazon. CloudWatch CloudWatchle metriche vengono fornite con la massima diligenza possibile.
| Nome parametro | Descrizione parametro | A quali oggetti si applica questo parametro? | In quale Regione viene pubblicato questo parametro? | Questo parametro viene ancora pubblicato se il bucket di destinazione viene eliminato? | Questo parametro viene ancora pubblicato se la replica non avviene? |
| --- | --- | --- | --- | --- | --- |
| **Byte in attesa di replica** | Numero totale di byte di oggetti in attesa di replica per una determinata regola di replica. | Questo parametro si applica solo ai nuovi oggetti replicati con la replica tra Regioni di S3 (S3 CRR) o la replica nella stessa Regione di S3 (S3 SRR). | Questo parametro viene pubblicato nella Regione del bucket di destinazione. | No | Sì |
| **Latenza di replica** | Numero massimo di secondi in base ai quali il bucket di destinazione della replica è dietro al bucket di origine per una determinata regola di replica. | Questo parametro si applica solo ai nuovi oggetti replicati con S3 CRR o S3 SRR. | Questo parametro viene pubblicato nella Regione del bucket di destinazione. | No | Sì |
| **Operazioni in attesa di replica** | Numero di operazioni in attesa di replica per una determinata regola di replica. Questa metrica tiene traccia delle operazioni relative agli oggetti, ai marker di eliminazione, ai tag, agli elenchi di controllo degli accessi (ACLs) e a S3 Object Lock. | Questo parametro si applica solo ai nuovi oggetti replicati con S3 CRR o S3 SRR. | Questo parametro viene pubblicato nella Regione del bucket di destinazione. | No | Sì |
| **Operazioni di replica non riuscite** | Numero di operazioni che non sono state replicate per una determinata regola di replica. Questa metrica tiene traccia delle operazioni relative agli oggetti, ai marker di eliminazione, ai tag, agli elenchi di controllo degli accessi (ACLs) e al blocco degli oggetti. **Operazioni di replica non riuscite** tiene traccia degli errori di Replica Amazon S3 aggregati a intervalli di un minuto. Per identificare gli oggetti specifici la cui replica non è riuscita e i relativi motivi, iscriviti all'evento `OperationFailedReplication` mediante la funzionalità Notifiche eventi Amazon S3. Per ulteriori informazioni, consulta [Ricezione di eventi di errore di replica con notifiche di eventi Amazon S3](replication-metrics-events.md). | Questo parametro si applica sia ai nuovi oggetti replicati con S3 CRR o S3 SRR sia agli oggetti esistenti replicati con S3 Batch Replication. Se un job di S3 Batch Replication non viene eseguito affatto, i parametri non vengono inviati ad Amazon. CloudWatch Ad esempio, il processo non verrà eseguito se non disponi delle autorizzazioni necessarie per eseguire un processo Replica Amazon S3 o se i tag o il prefisso nella configurazione della replica non corrispondono. | Questo parametro viene pubblicato nella Regione del bucket di origine. | Sì | No |
Per informazioni sull'utilizzo di queste metriche in, consulta. CloudWatch [Parametri di replica S3 in CloudWatch](metrics-dimensions.md#s3-cloudwatch-replication-metrics)
## Abilitazione dei parametri di replica S3
Puoi iniziare a utilizzare i parametri di replica S3 con una regola di replica nuova o esistente. Per istruzioni complete sulla creazione delle regole di replica, consulta [Configurazione della replica per i bucket nello stesso account](replication-walkthrough1.md). Puoi decidere di applicare la regola di replica a un intero bucket S3 o a oggetti Amazon S3 con un prefisso o un tag specifico.
In questo argomento vengono fornite le istruzioni per abilitare le metriche di Replica S3 nella configurazione della replica quando i bucket di origine e destinazione sono di proprietà dello stesso o di diversi Account AWS.
Per abilitare le metriche di replica utilizzando AWS Command Line Interface (AWS CLI), è necessario aggiungere una configurazione di replica al bucket di origine con enabled. `Metrics` In questa configurazione di esempio, gli oggetti con il prefisso `Tax` vengono replicati nel bucket di destinazione `amzn-s3-demo-bucket` e vengono generate le metriche per tali oggetti.
```
{
"Rules": [
{
"Status": "Enabled",
"Filter": {
"Prefix": "Tax"
},
"Destination": {
"Bucket": "arn:aws:s3:::amzn-s3-demo-bucket",
"Metrics": {
"Status": "Enabled"
}
},
"Priority": 1
}
],
"Role": "IAM-Role-ARN"
}
```
## Visualizzazione dei parametri di replica
I parametri di Replica S3 sono visualizzati nella scheda **Parametri** del bucket per uso generico di origine nella console Amazon S3. Queste CloudWatch metriche Amazon sono disponibili anche nella CloudWatch console Amazon. Quando abiliti i parametri di replica S3, Amazon CloudWatch emette parametri che puoi utilizzare per tenere traccia dei byte in sospeso, delle operazioni in sospeso e della latenza di replica a livello di regola di replica.
I parametri di Replica S3 vengono attivati automaticamente quando si abilita la replica con la funzionalità di controllo del tempo di replica di S3 (S3 RTC) utilizzando la console Amazon S3 o la REST API di Amazon S3. È anche possibile abilitare i parametri di Replica S3 indipendentemente da S3 RTC durante [la creazione o la modifica di una regola](replication-walkthrough1.md).
Se utilizzi S3 Replication Time Control, Amazon CloudWatch inizia a riportare i parametri di replica 15 minuti dopo aver abilitato S3 RTC sulla rispettiva regola di replica. Per ulteriori informazioni, consulta [Utilizzo dei parametri di Replica S3](#repl-metrics).
Le metriche di replica tengono traccia della regola della configurazione di replica. IDs Un ID regola di replica può essere specifico per un prefisso, un tag o una combinazione di entrambi.
Per ulteriori informazioni sui CloudWatch parametri per Amazon S3, consulta. [Monitoraggio delle metriche con Amazon CloudWatch](cloudwatch-monitoring.md)
**Prerequisiti**
Creare una regola di replica che dispone di parametri di Replica S3 abilitati. Per ulteriori informazioni, consulta [Abilitazione dei parametri di replica S3](#enabling-replication-metrics).
**Per visualizzare i parametri di Replica S3 tramite la scheda **Parametri** del bucket di origine**
1. Accedi a Console di gestione AWS e apri la console Amazon S3 all'indirizzo. [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)
1. Nel riquadro di navigazione sinistro, scegli **Bucket per uso generico**.
1. Nell’elenco dei bucket seleziona il nome del bucket contenente gli oggetti per cui desideri ottenere le metriche di replica.
1. Seleziona la scheda **Parametri**.
1. In **Parametri di replica**, scegli le regole di replica per le quali desideri visualizzare i parametri.
1. Seleziona **Visualizza grafici**.
Amazon S3 visualizza i grafici relativi a **Latenza di replica**, **Byte in attesa di replica**, **Operazioni in attesa di replica** e **Operazioni di replica non riuscite** per le regole selezionate.
# Visualizzazione dei parametri di replica nei pannelli di controllo di S3 Storage Lens
Oltre ai [parametri di Replica S3](repl-metrics.md), è possibile utilizzare i parametri di Protezione dati relativi alla replica forniti da S3 Storage Lens. S3 Storage Lens è una funzionalità di analisi dell'archiviazione su cloud che puoi utilizzare per avere una panoramica completa a livello di organizzazione sull'utilizzo e sulle attività relative all'archiviazione di oggetti. Per ulteriori informazioni, consulta [Utilizzo di S3 Storage Lens per proteggere i dati](https://docs.aws.amazon.com/AmazonS3/latest/userguide/storage-lens-data-protection.html#storage-lens-data-protection-replication-rule).
A un costo aggiuntivo, è possibile eseguire l'aggiornamento e ricevere due livelli di parametri di S3 Storage Lens: parametri gratuiti e parametri e suggerimenti avanzati. I parametri avanzati e i suggerimenti ti consentono di accedere a parametri e funzionalità aggiuntive per ottenere informazioni dettagliate sul tuo spazio di archiviazione. Per maggiori informazioni sui prezzi di S3 Storage Lens, consulta i [prezzi di Amazon S3](https://aws.amazon.com/s3/pricing).
Se si utilizzano i parametri gratuiti di S3 Storage Lens, è possibile visualizzare parametri come il numero totale di byte replicati dal bucket di origine o il numero di oggetti replicati dal bucket di origine.
Per verificare la posizione complessiva di replica, è possibile abilitare parametri avanzati in S3 Storage Lens. Con i parametri avanzati di S3 Storage Lens, è possibile vedere di quante regole di vario tipo si dispone, incluso il numero di regole di replica con una destinazione di replica non valida.
Per un elenco completo dei parametri di S3 Storage Lens, inclusi i parametri di replica presenti in ogni livello, consulta il [Glossario dei parametri di S3 Storage Lens](https://docs.aws.amazon.com/AmazonS3/latest/userguide/storage_lens_metrics_glossary.html?icmpid=docs_s3_user_guide_replication.html).
**Prerequisiti**
Creare una [configurazione della replica in tempo reale](replication-how-setup.md) o un [processo di Replica in batch S3](s3-batch-replication-batch.md).
**Per visualizzare i parametri di replica in Amazon S3 Storage Lens**
1. Creare un pannello di controllo di S3 Storage Lens. Per step-by-step istruzioni, consulta[Utilizzo della console S3](storage_lens_creating_dashboard.md#storage_lens_console_creating).
1. (Facoltativo) Durante la configurazione del pannello di controllo, se desideri visualizzare tutti i parametri di replica di S3 Storage Lens, seleziona **Parametri e raccomandazioni avanzati**, quindi seleziona **Parametri avanzati di protezione dei dati**. Per un elenco completo dei parametri, consulta [Glossario dei parametri di S3 Storage Lens](https://docs.aws.amazon.com/AmazonS3/latest/userguide/storage_lens_metrics_glossary.html?icmpid=docs_s3_user_guide_replication.html).
Se si abilitano i suggerimenti e i parametri avanzati, è possibile ottenere ulteriori informazioni sulle configurazioni di replica. I parametri relativi al conteggio delle regole di replica di S3 Storage Lens possono essere utilizzati per ottenere informazioni dettagliate sui bucket configurati per la replica. Queste informazioni includono le regole di replica all'interno di e tra bucket e regioni. Per ulteriori informazioni, consulta [Conteggiare il numero totale di regole di replica per ogni bucket](storage-lens-data-protection.md#storage-lens-data-protection-replication-rule).
1. Dopo aver creato il pannello di controllo, aprilo e scegli la scheda **Bucket**.
1. Scorri fino alla sezione **Buckets** (Bucket). In **Metrics categories** (Categorie parametri), scegli **Data protection** (Protezione dati). Quindi deseleziona **Summary** (Riepilogo).
1. Per filtrare l'elenco **Bucket** in modo da visualizzare solo i parametri di replica, scegli l'icona delle preferenze (![\[The preferences icon in the S3 Storage Lens dashboard.\]](http://docs.aws.amazon.com/it_it/AmazonS3/latest/userguide/images/preferences.png)).
1. Deseleziona tutti i parametri di protezione dei dati finché non rimangono selezionati solo i parametri di replica.
1. (Facoltativo) In **Page size** (Dimensioni pagina), scegli il numero di bucket da visualizzare nell'elenco.
1. Scegli **Continua**.
# 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.
Utilizzando i seguenti tipi di `Replication` eventi, è possibile monitorare l' minute-by-minuteavanzamento degli eventi di replica tenendo traccia dei byte in sospeso, delle operazioni in sospeso e della latenza di replica. Per ulteriori informazioni sui parametri di Replica S3, consulta [Utilizzo dei parametri di Replica S3](repl-metrics.md).
+ 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](notification-how-to-event-types-and-destinations.md#supported-notification-event-types).
Per l'elenco dei codici di errore acquisiti da Notifiche di eventi S3, consulta [Motivi degli errori di replica Amazon S3](#replication-failure-codes).
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](EventNotifications.md).
Per istruzioni su come configurare Notifiche di eventi Amazon S3, consulta [Abilitare le notifiche di eventi](how-to-enable-disable-notification-intro.md).
**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](repl-metrics.md#enabling-replication-metrics).
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](notification-content-structure.md).
```
{
"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](s3-batch-replication-batch.md#batch-replication-completion-report).
| Motivo dell'errore di replica | Description |
| --- | --- |
| `AssumeRoleNotPermitted` | Amazon S3 non può assumere il ruolo AWS Identity and Access Management (IAM) specificato nella configurazione di replica o nel job Batch Operations. |
| `DstBucketInvalidRegion` | Il bucket di destinazione non è Regione AWS uguale a quello specificato dal job Batch Operations. 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](object-lock-managing.md). |
| `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` | La chiave AWS Key Management Service (AWS KMS) per il bucket di destinazione non è in uno stato valido. Rivedi e abilita la AWS KMS chiave richiesta. Per ulteriori informazioni sulla gestione delle AWS KMS chiavi, consulta [Key states of AWS KMS keys](https://docs.aws.amazon.com/kms/latest/developerguide/key-state.html) nella *AWS Key Management Service Developer Guide*. |
| `DstKmsKeyNotFound` | La AWS KMS chiave configurata per il bucket di destinazione nella configurazione di 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 gli elenchi di controllo degli accessi agli oggetti (ACLs) 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](object-lock.md#object-lock-legal-holds). |
| `DstPutObjectNotPermitted` | Amazon S3 non è in grado di replicare oggetti nel bucket di destinazione. Ciò può verificarsi quando mancano le autorizzazioni (`s3:ReplicateObject`o le `s3:ObjectOwnerOverrideToBucketOwner` autorizzazioni) richieste per il bucket di destinazione o quando la policy AWS KMS chiave non consente al ruolo di replica del bucket di origine di utilizzare la AWS KMS chiave (`kms:Decrypt`e le azioni) nel bucket di destinazione. `kms:GenerateDataKey*` |
| `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 è Regione AWS uguale a quello specificato dal job Batch Operations. 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 ACLs sono abilitati, verifica se Object Ownership è impostato su Bucket owner preferred o Object writer. 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ò assumere la proprietà di tutti gli oggetti nel proprio bucket impostando Object Ownership su Bucket owner, imposto e disabilitando. ACLs |
| `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` | La AWS KMS chiave per il bucket di origine non è in uno stato valido. Rivedi e abilita la AWS KMS chiave richiesta. Per ulteriori informazioni sulla gestione delle AWS KMS chiavi, consulta [Key states of AWS KMS keys](https://docs.aws.amazon.com/kms/latest/developerguide/key-state.html) nella *AWS Key Management Service Developer Guide*. |
| `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. |
### Argomenti correlati
[Configurazione delle autorizzazioni per la replica in tempo reale](setting-repl-config-perm-overview.md)
[Risoluzione dei problemi nella replica](replication-troubleshoot.md)
# Ottenimento delle informazioni sullo stato della replica
Lo stato della replica consente di determinare lo stato corrente di un oggetto da replicare. Lo stato della replica di un oggetto di origine restituirà `PENDING`, `COMPLETED` o `FAILED`. Lo stato della replica di una replica restituirà `REPLICA`.
È anche possibile utilizzare i valori dello stato della replica durante la creazione di processi di Replica in batch S3. Ad esempio questi valori di stato possono essere utilizzati per replicare gli oggetti che non sono mai stati replicati o la cui replica non è andata a buon fine. Per ulteriori informazioni sull'utilizzo di questi valori con Replica in batch, consulta [Utilizzo delle informazioni sullo stato della replica con i processi di Replica in batch](#replication-status-batch-replication).
**Topics**
+ [Panoramica dello stato della replica](#replication-status-overview)
+ [Stato della replica in caso di replica su più bucket di destinazione](#replication-status-multiple-destinations)
+ [Stato della replica se è abilitata la sincronizzazione della modifica alla replica Amazon S3](#replication-status-replica-mod-syn)
+ [Utilizzo delle informazioni sullo stato della replica con i processi di Replica in batch](#replication-status-batch-replication)
+ [Ricerca dello stato di replica](#replication-status-usage)
## Panoramica dello stato della replica
Nella replica esistono un bucket di origine in cui si configura la replica e uno o più bucket di destinazione in cui Amazon S3 replica gli oggetti. Quando si richiede un oggetto (utilizzando `GetObject`) o i metadati di un oggetto (utilizzando `HeadObject`) da questi bucket, Amazon S3 restituisce l'intestazione `x-amz-replication-status` nella risposta:
+ Quando richiedi un oggetto dal bucket di origine, Amazon S3 restituisce l'intestazione `x-amz-replication-status` se l'oggetto nella richiesta è idoneo per la replica.
Supponi, ad esempio, che nella configurazione di replica venga specificato il prefisso di oggetto `TaxDocs` che indica ad Amazon S3 di replicare solo gli oggetti con il prefisso del nome della chiave `TaxDocs`. Tutti gli oggetti caricati che hanno questo prefisso del nome della chiave, ad esempio `TaxDocs/document1.pdf`, verranno replicati. Per le richieste di oggetti con questo prefisso del nome della chiave, Amazon S3 restituisce l'intestazione `x-amz-replication-status` con uno dei valori seguenti per lo stato della replica dell'oggetto: `PENDING`, `COMPLETED` o `FAILED`.
**Nota**
Se la replica dell'oggetto ha esito negativo dopo il caricamento di un oggetto, non è possibile provare a eseguirla di nuovo. È necessario caricare nuovamente l'oggetto oppure utilizzare Replica in batch S3 per replicare eventuali oggetti la cui replica non è riuscita. S3 Lifecycle blocca le azioni di scadenza e transizione su oggetti con stato di replica `PENDING` o`FAILED`. Per ulteriori informazioni su Replica in batch, consulta [Replica di oggetti esistenti con Replica in batch](s3-batch-replication-batch.md).
Gli oggetti passano a uno `FAILED` stato per problemi come le autorizzazioni mancanti per i ruoli di replica, le autorizzazioni AWS Key Management Service (AWS KMS) o le autorizzazioni del bucket. In caso di errori temporanei, ad esempio se un bucket o una Regione non è disponibile, lo stato della replica non passerà a `FAILED`, ma rimarrà `PENDING`. Dopo che la risorsa torna online, Amazon S3 riprende la replica di tali oggetti.
+ Quando richiedi un oggetto dal bucket di destinazione, se l'oggetto nella richiesta è una replica creata da Amazon S3, Amazon S3 restituisce l'intestazione `x-amz-replication-status` con il valore `REPLICA`.
**Nota**
Prima di eliminare un oggetto da un bucket di origine in cui è abilitata la replica, è consigliabile controllare lo stato della replica per assicurarsi che l'oggetto sia stato replicato.
Se una configurazione del ciclo di vita S3 è abilitata nel bucket di origine, Amazon S3 sospende le azioni del ciclo di vita finché non contrassegna lo stato di replica dell'oggetto come. `COMPLETED` Se lo stato di replica è impostato`FAILED`, S3 Lifecycle continua a bloccare le azioni di scadenza e transizione sull'oggetto fino a quando non viene risolto il problema di replica sottostante. Per ulteriori informazioni, consulta [Ciclo di vita S3 e](lifecycle-and-other-bucket-config.md#lifecycle-and-replication).
## Stato della replica in caso di replica su più bucket di destinazione
Quando si replicano oggetti in più bucket di destinazione, l'intestazione `x-amz-replication-status` funziona in modo diverso. L'intestazione dell'oggetto di origine restituisce un valore `COMPLETED` solo se la replica ha esito positivo su tutte le destinazioni. L'intestazione rimane al valore `PENDING` fino al completamento della replica per tutte le destinazioni. Se la replica su una o più destinazioni non riesce, viene restituita l'intestazione `FAILED`.
## Stato della replica se è abilitata la sincronizzazione della modifica alla replica Amazon S3
Quando le regole di replica abilitano la sincronizzazione delle modifiche alla replica Amazon S3, le repliche possono riportare stati diversi da `REPLICA`. Se le modifiche dei metadati sono in corso di replica, l'intestazione `x-amz-replication-status` restituisce `PENDING`. Se la sincronizzazione delle modifiche della replica non riesce a replicare i metadati, l'intestazione restituisce `FAILED`. Se i metadati vengono replicati correttamente, le repliche restituiscono l'intestazione `REPLICA`.
## Utilizzo delle informazioni sullo stato della replica con i processi di Replica in batch
Quando si crea un processo di Replica in batch, è possibile specificare opzionalmente dei filtri aggiuntivi, ad esempio la data di creazione dell'oggetto e lo stato della replica, al fine di ridurre l'ambito del processo.
Puoi filtrare gli oggetti da replicare in base al valore `ObjectReplicationStatuses` fornendo uno o più dei seguenti valori:
+ `"NONE"`: indica che Amazon S3 non ha mai tentato di replicare l'oggetto in precedenza.
+ `"FAILED"`: indica che Amazon S3 ha tentato di replicare l'oggetto in precedenza ma la replica non è andata a buon fine.
+ `"COMPLETED"`: indica che Amazon S3 ha replicato correttamente l'oggetto in precedenza.
+ `"REPLICA"`: indica che si tratta di un oggetto di replica replicato da Amazon S3 da un'altra origine.
Per ulteriori informazioni sull'utilizzo di questi valori dello stato della replica con Replica in batch, consulta [Filtri per i processi Batch Replication](s3-batch-replication-batch.md#batch-replication-filters).
## Ricerca dello stato di replica
Per visualizzare lo stato della replica degli oggetti in un bucket, è possibile utilizzare lo strumento Inventario Amazon S3. Amazon S3 invia un file CSV al bucket di destinazione specificato nella configurazione dell'inventario. Puoi anche utilizzare Amazon Athena per eseguire una query sullo stato della replica nel report di inventario. Per ulteriori informazioni su Inventario Amazon S3, consulta [Catalogazione e analisi dei dati con Inventario S3](storage-inventory.md).
Puoi anche trovare lo stato della replica degli oggetti utilizzando la console Amazon S3,AWS CLI() o AWS Command Line Interface AWS l'SDK.
### Utilizzo della console S3
Nella console Amazon S3 è possibile visualizzare lo stato della replica di un oggetto nella pagina dei dettagli dell'oggetto.
1. Accedi a Console di gestione AWS e apri la console Amazon S3 all'indirizzo. [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)
1. Nel pannello di navigazione a sinistra, scegli **Buckets** (Bucket).
1. Scegli il nome del bucket di origine della replica nell'elenco **Bucket per uso generico**.
1. Nell'elenco **Oggetti**, seleziona il nome dell'oggetto. Viene visualizzata la pagina dei dettagli dell'oggetto.
1. Nella scheda **Proprietà** scorrere verso il basso fino alla sezione **Panoramica della gestione degli oggetti**. In **Configurazioni di gestione**, controllare il valore in **Stato della replica**.
### Utilizzando il AWS CLI
Utilizzate il `head-object` comando AWS Command Line Interface (AWS CLI) per recuperare i metadati degli oggetti, come illustrato nell'esempio seguente. Sostituire `amzn-s3-demo-source-bucket1` con il nome del bucket di origine della replica e sostituire l'altro `user input placeholders` con le proprie informazioni.
```
aws s3api head-object --bucket amzn-s3-demo-source-bucket1 --key object-key --version-id object-version-id
```
Il comando restituisce i metadati dell'oggetto, incluso l'elemento `ReplicationStatus` come illustrato nella risposta di esempio seguente.
```
{
"AcceptRanges":"bytes",
"ContentType":"image/jpeg",
"LastModified":"Mon, 23 Mar 2015 21:02:29 GMT",
"ContentLength":3191,
"ReplicationStatus":"COMPLETED",
"VersionId":"jfnW.HIMOfYiD_9rGbSkmroXsFj3fqZ.",
"ETag":"\"6805f2cfc46c0f04559748bb039d69ae\"",
"Metadata":{
}
}
```
### Usando il AWS SDKs
I seguenti frammenti di codice ottengono lo stato di replica utilizzando rispettivamente AWS SDK per Java e AWS SDK per .NET.
------
#### [ Java ]
```
GetObjectMetadataRequest metadataRequest = new GetObjectMetadataRequest(bucketName, key);
ObjectMetadata metadata = s3Client.getObjectMetadata(metadataRequest);
System.out.println("Replication Status : " + metadata.getRawMetadataValue(Headers.OBJECT_REPLICATION_STATUS));
```
------
#### [ .NET ]
```
GetObjectMetadataRequest getmetadataRequest = new GetObjectMetadataRequest
{
BucketName = sourceBucket,
Key = objectKey
};
GetObjectMetadataResponse getmetadataResponse = client.GetObjectMetadata(getmetadataRequest);
Console.WriteLine("Object replication status: {0}", getmetadataResponse.ReplicationStatus);
```
------