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
<a name="conditional-reads"></a>

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
<a name="conditional-read-apis"></a>

Il seguente APIs supporto per S3 utilizza letture condizionali:
+ [https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html)
+ [https://docs.aws.amazon.com/AmazonS3/latest/API/API_HeadObject.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_HeadObject.html)
+ [https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html)

È 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](UsingMetadata.md#SysMetadata)

**[https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html)**  

+ `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 [https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html) nel Riferimento API di Amazon Simple Storage Service.

**[https://docs.aws.amazon.com/AmazonS3/latest/API/API_HeadObject.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_HeadObject.html)**  

+ `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 [https://docs.aws.amazon.com/AmazonS3/latest/API/API_HeadObject.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_HeadObject.html) nel Riferimento API di Amazon Simple Storage Service.

**[https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html)**  

+ `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.
+ `If-Match`— Copia l'oggetto solo se ETag corrisponde a quello fornito. `If-Match`si aspetta il ETag valore come stringa.
+ `If-None-Match`— Copia l'oggetto solo se ETag non corrisponde a quello fornito. `If-None-Match`si aspetta il carattere '\$1' (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 [https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html) nel Riferimento API di Amazon Simple Storage Service.