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) 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 la data è un metadato che rappresenta 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, vedete. Last-Modified 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.
Per informazioni sull'utilizzo delle intestazioni condizionali per evitare la sovrascrittura durante le operazioni di scrittura, vedere. Come prevenire la sovrascrittura degli oggetti con le scritture condizionali
