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 balises d'entité (ETags) et Last-Modified sont des exemples de métadonnées contrôlées par le système. Un objet ETag est une chaîne représentant une version spécifique d'un objet. La date de dernière modification fait partie des métadonnées représentant la date de création ou la date de la dernière modification de l’objet, la date la plus récente étant retenue.
Avec les lectures conditionnelles, vous pouvez renvoyer un objet en fonction de sa date de dernière modification ETag ou de sa date de dernière modification. Vous pouvez spécifier une ETag valeur avec votre demande et renvoyer l'objet uniquement si la ETag valeur correspond. Cela vous permet de ne renvoyer ou ne copier qu’une version spécifique d’un objet. Vous pouvez spécifier une valeur de dernière modification dans votre demande de lecture et ne renvoyer que les objets modifiés depuis une date que vous avez indiquée.
Soutenu APIs
Le APIs support S3 suivant utilise des lectures conditionnelles :
Vous pouvez utiliser les en-têtes suivants pour renvoyer un objet en fonction de la balise d'entité (ETag) ou de la date de dernière modification. Pour plus d'informations sur les métadonnées d'objets telles que ETags et Last-Modified, consultez. Métadonnées d’objet définies par le système
GetObject
-
If-Match— Renvoie l'objet uniquement s'il ETag correspond à celui fourni. -
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 s'il ETag ne correspond pas à celui fourni. -
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 s'il ETag correspond à celui fourni. -
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 s'il ETag ne correspond pas à celui fourni. -
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 s'il ETag correspond à celui fourni. -
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 s'il ETag ne correspond pas à celui fourni. -
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.
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.
