Come prevenire la sovrascrittura degli oggetti con le scritture condizionali

Utilizzando le scritture condizionali, è possibile aggiungere un'ulteriore intestazione alle richieste WRITE per specificare le precondizioni per le operazioni su Amazon S3. Per scrivere oggetti in modo condizionato, aggiungi l'intestazione HTTP If-None-Match o If-Match.

L'intestazione If-None-Match impedisce la sovrascrittura dei dati esistenti, verificando che non vi sia già un oggetto con lo stesso nome di chiave nel bucket.

In alternativa, si può aggiungere l'intestazione If-Match per verificare il tag entità (ETag) di un oggetto prima di scrivere un oggetto. Con questa intestazione, Amazon S3 confronta il valore ETag fornito con il valore ETag dell'oggetto in S3. Se i valori ETag non corrispondono, l'operazione non riesce.

I proprietari dei bucket possono usare le policy di bucket per imporre la scrittura condizionale degli oggetti caricati. Per ulteriori informazioni, consulta Applicazione delle scritture condizionali sui bucket Amazon S3.

Come impedire la sovrascrittura degli oggetti in base ai nomi delle chiavi

È possibile utilizzare l'intestazione condizionale HTTP If-None-Match per verificare se un oggetto esiste già nel bucket specificato in base al nome della chiave prima di crearlo. Quando si carica un oggetto su Amazon S3, si specifica il nome della chiave: un identificatore univoco, sensibile alle maiuscole, di un oggetto in un bucket. Senza l'intestazione HTTP If-None-Match, se si carica un oggetto con un nome di chiave identico in un bucket non aggiornato o con versione sospesa, l'oggetto viene sovrascritto. In un bucket con controllo delle versioni, l'oggetto caricato più di recente diventa la versione corrente dell'oggetto. Le scritture condizionali con l'intestazione HTTP If-None-Match controllano l'esistenza di un oggetto durante l'operazione WRITE. Se nel bucket viene trovato un nome di chiave identico, l'operazione fallisce. Per ulteriori informazioni sull'uso dei nomi delle chiavi, consulta Denominazione di oggetti Amazon S3.

Per eseguire scritture condizionali con l'intestazione HTTP If-None-Match è necessario disporre dell'autorizzazione s3:PutObject. Ciò consente al chiamante di verificare la presenza di oggetti nel bucket. L'intestazione If-None-Match prevede il valore * (asterisco).

È possibile utilizzare l'intestazione If-None-Match con le seguenti API:

aws s3api put-object --bucket amzn-s3-demo-bucket --key dir-1/my_images.tar.bz2 --body my_images.tar.bz2 --if-none-match "*"       

Come impedire la sovrascrittura se l'oggetto è stato modificato

L'ETag di un oggetto è una stringa univoca per l'oggetto e riflette una modifica al contenuto dell'oggetto. È possibile utilizzare l'intestazione If-Match per confrontare il valore ETag di un oggetto in un bucket Amazon S3 con quello fornito dall'utente durante l'operazione WRITE. Se i valori ETag non corrispondono, l'operazione non riesce. Per ulteriori informazioni sugli ETag, consulta Utilizzo di Content-MD5 e di ETag per verificare gli oggetti caricati.

Per eseguire scritture condizionali con l'intestazione HTTP If-Match è necessario disporre delle autorizzazioni s3:PutObject e s3:GetObject. Ciò consente al chiamante di verificare l'ETag e lo stato degli oggetti nel bucket. L'intestazione If-Match prevede il valore ETag come stringa.

È possibile utilizzare l'intestazione If-Match con le seguenti API:

aws s3api put-object --bucket amzn-s3-demo-bucket --key dir-1/my_images.tar.bz2 --body my_images.tar.bz2 --if-match "6805f2cfc46c0f04559748bb039d69ae"       

Comportamento di scrittura condizionale

Scenari di scrittura condizionati

Si considerino i seguenti scenari in cui due client eseguono operazioni sullo stesso bucket.

Scrittura condizionale durante il caricamento multiparte

Le scritture condizionali non considerano le richieste di caricamento multiparte in corso, poiché non sono ancora oggetti completamente scritti. Si consideri il seguente esempio in cui il client 1 sta caricando un oggetto utilizzando il caricamento multiparte. Durante il caricamento multiparte, il client 2 è in grado di scrivere con successo lo stesso oggetto con l'operazione di scrittura condizionale. Successivamente, quando il client 1 tenta di completare il caricamento multiparte utilizzando una scrittura condizionale, il caricamento non riesce.

Cancellazioni simultanee durante il caricamento di più parti

Se una richiesta di cancellazione riesce prima che una richiesta di scrittura condizionale possa essere completata, Amazon S3 restituisce una risposta 409 Conflict o 404 Not Found per l'operazione di scrittura. Questo perché la richiesta di cancellazione avviata in precedenza ha la precedenza sull'operazione di scrittura condizionale. In questi casi, è necessario avviare un nuovo caricamento multiparte.