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. Entity tags (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.