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 politiques 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é

Avant de créer un objet, vous pouvez utiliser l’en-tête conditionnel HTTP If-None-Match pour vérifier si cet objet existe déjà dans le compartiment spécifié en fonction de son nom de clé. Lorsque vous chargez un objet sur Amazon S3, vous spécifiez le nom de la clé, qui est un identifiant unique, sensible à la casse, d’un objet dans un compartiment. Sans l’en-tête HTTP If-None-Match, si vous chargez un objet avec un nom de clé identique dans un compartiment pour lequel la gestion des versions est suspendue ou n’est pas activée, l’objet sera remplacé. Dans un compartiment pour lequel la gestion des versions est activée, l’objet le plus récemment chargé devient la version actuelle de l’objet. 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. 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 put-object --bucket amzn-s3-demo-bucket --key dir-1/my_images.tar.bz2 --body my_images.tar.bz2 --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 contenus 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 put-object --bucket amzn-s3-demo-bucket --key dir-1/my_images.tar.bz2 --body my_images.tar.bz2 --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é.