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.

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. Per ulteriori informazioni su Replica in batch, consulta Replica di oggetti esistenti con Replica in batch.

  Gli oggetti passano a uno FAILED stato per problemi come la mancanza delle autorizzazioni dei ruoli di replica, delle autorizzazioni AWS Key Management Service (AWS KMS) o delle 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 nel bucket di origine è abilitata una configurazione di Ciclo di vita S3, Amazon S3 sospende tutte le operazioni del ciclo di vita fino a quando non contrassegna lo stato degli oggetti come COMPLETED o FAILED.

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.

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.

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 AWS Management Console e apri la console Amazon S3 all'indirizzo. https://console.aws.amazon.com/s3/

2. Nel pannello di navigazione a sinistra, scegli Buckets (Bucket).

3. Scegli il nome del bucket di origine della replica nell'elenco Bucket per uso generico.

4. Nell'elenco Oggetti, seleziona il nome dell'oggetto. Viene visualizzata la pagina dei dettagli dell'oggetto.

5. 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);