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.