Comment empêcher le remplacement d’objets par des écritures conditionnelles

Avec les écritures conditionnelles, vous pouvez ajouter un en-tête supplémentaire à vos demandes WRITE afin de spécifier les conditions préalables à une opération Amazon S3. Pour écrire des objets de manière conditionnelle, ajoutez l’en-tête HTTP If-None-Match ou If-Match.

L’en-tête If-None-Match empêche le remplacement de données existantes en validant qu’aucun objet portant le même nom de clé ne se trouve déjà dans votre compartiment.

Vous pouvez également ajouter l'If-Matchen-tête pour vérifier la balise d'entité (ETag) d'un objet avant d'écrire un objet. Avec cet en-tête, Amazon S3 compare la ETag valeur fournie avec la ETag valeur de l'objet dans S3. Si les ETag valeurs ne correspondent pas, l'opération échoue.

Les propriétaires de compartiments peuvent utiliser des stratégies de compartiment pour appliquer des écritures conditionnelles aux objets chargés. Pour de plus amples informations, veuillez consulter Application d’écritures conditionnelles sur des compartiments Amazon S3.

Comment empêcher le remplacement d’objets en fonction des noms de clé

Vous pouvez utiliser l'en-tête If-None-Match conditionnel HTTP pour vérifier si un objet existe déjà dans le compartiment spécifié en fonction de son nom de clé avant de le créer ou de le copier dans le compartiment de destination.

Les écritures conditionnelles avec l’en-tête HTTP If-None-Match vérifient l’existence d’un objet pendant l’opération WRITE. Si un nom de clé identique est trouvé dans le compartiment, l’opération échoue. Sans l'If-None-Matchen-tête HTTP, si vous chargez ou copiez un objet portant un nom de clé identique dans un bucket non versionné ou dont la version est suspendue, l'objet est remplacé. Pour en savoir plus sur l’utilisation des noms de clé, consultez Attribution d’un nom aux objets Amazon S3.

Pour effectuer des écritures conditionnelles avec l’en-tête HTTP If-None-Match, vous devez avoir l’autorisation s3:PutObject. Cela permet à l’appelant de vérifier la présence d’objets dans le compartiment. L’en-tête If-None-Match s’attend à recevoir la valeur * (astérisque).

Vous pouvez utiliser l'If-None-Matchen-tête avec les éléments suivants 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 "*"             

Comment empêcher les remplacements si l’objet a changé

Un objet ETag est une chaîne unique à l'objet qui reflète une modification du contenu de l'objet. Vous pouvez utiliser l'If-Matchen-tête pour comparer la ETag valeur d'un objet dans un compartiment Amazon S3 avec celle que vous avez fournie pendant l'WRITEopération. Si les ETag valeurs ne correspondent pas, l'opération échoue. Pour plus d'informations sur ETags, voirUtilisation du contenu MD5 et du ETag pour vérifier les objets téléchargés.

Pour effectuer des écritures conditionnelles avec un en-tête HTTP If-Match, vous devez disposer des autorisations s3:PutObject et s3:GetObject. Cela permet à l'appelant de vérifier ETag et de vérifier l'état des objets dans le compartiment. L'If-Matchen-tête attend la ETag valeur sous forme de chaîne.

Vous pouvez utiliser l'If-Matchen-tête avec les éléments suivants 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"             

Comportement des écritures conditionnelles

Scénarios d’écritures conditionnelles

Examinez les scénarios suivants dans lesquels deux clients exécutent des opérations sur le même compartiment.

Écritures conditionnelles lors des chargements partitionnés

Les écritures conditionnelles ne prennent pas en compte les demandes de chargement partitionné en cours, car il ne s’agit pas encore d’objets entièrement écrits. Prenons l’exemple suivant où le client 1 charge un objet à l’aide du chargement partitionné. Pendant le chargement partitionné, le client 2 est en mesure d’écrire avec succès ce même objet grâce à l’opération d’écriture conditionnelle. Par la suite, lorsque le client 1 essaie de finaliser le chargement partitionné à l’aide d’une écriture conditionnelle, le chargement échoue.

Suppressions simultanées lors de chargements partitionnés

Si une demande de suppression aboutit avant qu’une demande d’écriture conditionnelle ne se termine, Amazon S3 renvoie une réponse 409 Conflict ou 404 Not Found pour l’opération d’écriture. Cela est dû au fait que la demande de suppression initiée précédemment a priorité sur l’opération d’écriture conditionnelle. Dans ce cas, vous devrez lancer un nouveau chargement partitionné.