Come recuperare o copiare gli oggetti in base ai metadati con letture condizionali - Amazon Simple Storage Service

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à.

Come recuperare o copiare gli oggetti in base ai metadati con letture condizionali

Con la lettura condizionale, è possibile aggiungere un'intestazione supplementare alla richiesta di lettura per aggiungere precondizioni all'operazione S3. Se queste precondizioni non sono soddisfatte, la richiesta di lettura fallisce.

È possibile usare la lettura condizionale sulle richieste GET, HEAD o COPY per restituire un oggetto solo in base ai suoi metadati.

Quando si carica un oggetto, Amazon S3 crea metadati controllati dal sistema che possono essere modificati solo da S3. I tag di entità (ETags) e Last-Modified sono esempi di metadati controllati dal sistema. Un oggetto ETag è una stringa che rappresenta una versione specifica di un oggetto. La data di ultima modifica è costituita da metadati che rappresentano la data di creazione dell'oggetto o l'ultima data di modifica, a seconda di quale sia la più recente.

Con le letture condizionali, è possibile restituire un oggetto in base alla data dell'oggetto ETag o alla data dell'ultima modifica. È possibile specificare un ETag valore nella richiesta e restituire l'oggetto solo se il valore corrisponde. ETag In questo modo si potrebbe garantire la restituzione o la copia di una specifica versione di un oggetto. È possibile specificare un valore di ultima modifica con la richiesta di lettura e restituire un oggetto solo se questo è stato modificato a partire da una data fornita dall'utente.

Supportato APIs

Il seguente APIs supporto per S3 utilizza letture condizionali:

È possibile utilizzare le seguenti intestazioni per restituire un oggetto in base al tag di entità (ETag) o alla data dell'ultima modifica. Per ulteriori informazioni sui metadati degli oggetti, ad esempio ETags Last-Modified, consulta. Metadata di oggetti definiti dal sistema

GetObject

  • If-Match— Restituisce l'oggetto solo se ETag corrisponde a quello fornito.

  • If-Modified-Since - Restituisce l'oggetto solo se è stato modificato dal momento specificato.

  • If-None-Match— Restituisce l'oggetto solo se ETag non corrisponde a quello fornito.

  • If-Unmodified-Since - Restituisce l'oggetto solo se non è stato modificato dal momento specificato.

Per ulteriori informazioni su queste intestazioni, sugli errori restituiti e sull'ordine con cui S3 gestisce più intestazioni condizionali in una singola richiesta, consulta GetObject nel Riferimento API di Amazon Simple Storage Service.

HeadObject

  • If-Match— Restituisce l'oggetto solo se ETag corrisponde a quello fornito.

  • If-Modified-Since - Restituisce l'oggetto solo se è stato modificato dal momento specificato.

  • If-None-Match— Restituisce l'oggetto solo se ETag non corrisponde a quello fornito.

  • If-Unmodified-Since - Restituisce l'oggetto solo se non è stato modificato dal momento specificato.

Per ulteriori informazioni su queste intestazioni, sugli errori restituiti e sull'ordine con cui S3 gestisce più intestazioni condizionali in una singola richiesta, consulta HeadObject nel Riferimento API di Amazon Simple Storage Service.

CopyObject

  • x-amz-copy-source-if-match— Copia l'oggetto sorgente solo se ETag corrisponde a quello fornito.

  • x-amz-copy-source-if-modified-since - Copia l'oggetto di origine solo se è stato modificato dal momento specificato.

  • x-amz-copy-source-if-none-match— Copia l'oggetto sorgente solo se ETag non corrisponde a quello fornito.

  • x-amz-copy-source-if-unmodified-since - Copia l'oggetto di origine solo se non è stato modificato dal momento specificato.

Per ulteriori informazioni su queste intestazioni, sugli errori restituiti e sull'ordine con cui S3 gestisce più intestazioni condizionali in una singola richiesta, consulta CopyObject nel Riferimento API di Amazon Simple Storage Service.