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à.
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 in cui S3 gestisce più intestazioni condizionali in una singola richiesta, consulta GetObjectnel riferimento all'API di riferimento 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 in cui S3 gestisce più intestazioni condizionali in una singola richiesta, consulta HeadObjectnel riferimento all'API di riferimento 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 in cui S3 gestisce più intestazioni condizionali in un'unica richiesta, consulta CopyObjectnel riferimento all'API di riferimento di Amazon Simple Storage Service.
