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à.
# 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);
```
------