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, puoi aggiungere l'If-Matchintestazione per controllare il tag di entità di un oggetto (ETag) 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 ETag valori non corrispondono, l'operazione fallisce.

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 If-None-Match condizionale HTTP per verificare se un oggetto esiste già nel bucket specificato in base al nome della chiave prima di crearlo o copiarlo nel bucket di destinazione.

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. Senza l'If-None-Matchintestazione HTTP, se carichi o copi un oggetto con un nome di chiave identico in un bucket senza versione o con versione sospesa, l'oggetto viene sovrascritto. 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'If-None-Matchintestazione con quanto segue: APIs

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

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

aws s3api complete-multipart-upload --multipart-upload file://mpustruct --bucket amzn-s3-demo-bucket --key dir-1/my_images.tar.bz2 --upload-id upload-id  --if-none-match "*"             

Come impedire la sovrascrittura se l'oggetto è stato modificato

Un oggetto ETag è una stringa che è unica per l'oggetto e riflette una modifica al contenuto dell'oggetto. Puoi utilizzare l'If-Matchintestazione per confrontare il ETag valore di un oggetto in un bucket Amazon S3 con uno fornito durante l'operazione. WRITE Se i ETag valori non corrispondono, l'operazione fallisce. Per ulteriori informazioni su ETags, vedereUtilizzo di Content- MD5 and the 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 controllare ETag e verificare lo stato degli oggetti nel bucket. L'If-Matchintestazione prevede che il ETag valore sia una stringa.

È possibile utilizzare l'If-Matchintestazione con quanto segue: APIs

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

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

aws s3api complete-multipart-upload --multipart-upload file://mpustruct --bucket amzn-s3-demo-bucket --key dir-1/my_images.tar.bz2 --upload-id upload-id --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.