Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Comment récupérer ou copier des objets en fonction des métadonnées avec des lectures conditionnelles
Avec les lectures conditionnelles, vous pouvez inclure un en-tête supplémentaire à votre demande de lecture afin d’ajouter des conditions préalables à votre opération S3. Si ces conditions préalables ne sont pas remplies, la demande de lecture échouera.
Vous pouvez utiliser des lectures conditionnelles au niveau des demandes GET, HEAD ou COPY pour ne renvoyer un objet qu’en fonction de ses métadonnées.
Lorsque vous chargez un objet, Amazon S3 crée des métadonnées contrôlées par le système qui ne peuvent être modifiées que par S3. Les étiquettes d'entité (ETags) Last-Modified sont des exemples de métadonnées contrôlées par le système. L'ETag d'un objet est une chaîne représentant une version spécifique d'un objet. Last-Modified la date est une métadonnée représentant la date de création d'un objet ou la date de dernière modification, la date la plus récente étant retenue.
Avec les lectures conditionnelles, vous pouvez renvoyer un objet en fonction de son ETag ou de sa Last-Modified date. Vous pouvez spécifier une valeur de balise d’entité avec votre demande et renvoyer l’objet uniquement si cette valeur correspond. Cela vous permet de ne renvoyer ou ne copier qu’une version spécifique d’un objet. Vous pouvez spécifier une Last-Modified valeur dans votre demande de lecture et renvoyer un objet uniquement si cet objet a été modifié depuis une date que vous avez indiquée.
API prises en charge
Les API S3 suivantes prennent en charge l’utilisation de lectures conditionnelles :
Vous pouvez utiliser les en-têtes suivants pour renvoyer un objet en fonction de la balise d’entité ou de sa date de dernière modification. Pour plus d'informations sur les métadonnées d'objets telles que les ETags et Last-Modified, consultezSystem-defined métadonnées de l'objet.
GetObject
-
If-Match: renvoie l’objet uniquement si sa balise d’entité correspond à celle fournie. -
If-Modified-Since: renvoie l’objet uniquement s’il a été modifié depuis l’heure spécifiée. -
If-None-Match: renvoie l’objet uniquement si sa balise d’entité ne correspond pas à celle fournie. -
If-Unmodified-Since: renvoie l’objet uniquement s’il n’a pas été modifié depuis l’heure spécifiée.
Pour plus d’informations sur ces en-têtes, les erreurs renvoyées et l’ordre dans lequel S3 gère plusieurs en-têtes conditionnels dans une seule demande, consultez GetObject dans la Référence d’API Amazon Simple Storage Service.
HeadObject
-
If-Match: renvoie l’objet uniquement si sa balise d’entité correspond à celle fournie. -
If-Modified-Since: renvoie l’objet uniquement s’il a été modifié depuis l’heure spécifiée. -
If-None-Match: renvoie l’objet uniquement si sa balise d’entité ne correspond pas à celle fournie. -
If-Unmodified-Since: renvoie l’objet uniquement s’il n’a pas été modifié depuis l’heure spécifiée.
Pour plus d’informations sur ces en-têtes, les erreurs renvoyées et l’ordre dans lequel S3 gère plusieurs en-têtes conditionnels dans une seule demande, consultez HeadObject dans la Référence d’API Amazon Simple Storage Service.
CopyObject
-
x-amz-copy-source-if-match: copie l’objet source uniquement si sa balise d’entité correspond à celle fournie. -
x-amz-copy-source-if-modified-since: copie l’objet source uniquement s’il a été modifié depuis l’heure spécifiée. -
x-amz-copy-source-if-none-match: copie l’objet source uniquement si sa balise d’entité ne correspond pas à celle fournie. -
x-amz-copy-source-if-unmodified-since: copie l’objet source uniquement s’il n’a pas été modifié depuis l’heure spécifiée. -
If-Match— Copie l'objet uniquement si son ETag correspond à celui fourni.If-Matchattend la valeur ETag sous forme de chaîne. -
If-None-Match— Copie l'objet uniquement si son ETag ne correspond pas à celui fourni.If-None-Matchattend le caractère « * » (astérisque).
Pour plus d’informations sur ces en-têtes, les erreurs renvoyées et l’ordre dans lequel S3 gère plusieurs en-têtes conditionnels dans une seule demande, consultez CopyObject dans la Référence d’API Amazon Simple Storage Service.
