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à (ETag) Last-Modified sono esempi di metadati controllati dal sistema. L'ETag di un oggetto è una stringa che rappresenta una versione specifica di un oggetto. Last-Modified date sono i metadati che rappresentano la data di creazione di un oggetto o la data dell'ultima modifica, a seconda di quale sia l'ultima.
Con le letture condizionali, puoi restituire un oggetto in base all'ETag o alla data dell'oggetto. Last-Modified È possibile specificare un valore ETag con la richiesta e restituire l'oggetto solo se il valore ETag corrisponde. In questo modo si potrebbe garantire la restituzione o la copia di una specifica versione di un oggetto. È possibile specificare un Last-Modified valore nella richiesta di lettura e restituire un oggetto solo se tale oggetto è stato modificato dopo una data fornita.
API supportate
Le seguenti API S3 supportano l'uso della lettura condizionale:
È possibile usare le seguenti intestazioni per restituire un oggetto in base al suo tag entità (ETag) o alla data di ultima modifica. Per ulteriori informazioni sui metadati degli oggetti come ETags e Last-Modified, consulta. System-defined metadati degli oggetti
GetObject
-
If-Match- Restituisce l'oggetto solo se il suo 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 il suo 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 il suo 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 il suo 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 di origine solo se il suo 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 di origine solo se il suo 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. -
If-Match— Copia l'oggetto solo se il relativo ETag corrisponde a quello fornito.If-Matchsi aspetta il valore ETag come stringa. -
If-None-Match— Copia l'oggetto solo se il relativo ETag non corrisponde a quello fornito.If-None-Matchsi aspetta il carattere '*' (asterisco).
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.
