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 ajouter 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 ou HEAD des COPY requêtes pour renvoyer un objet uniquement en fonction de ses métadonnées. GET
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 est une métadonnée représentant la date de création d'un objet ou la date de dernière modification, selon la dernière de ces deux dates.
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 permet de garantir que vous ne renvoyez ou ne copiez qu'une version spécifique d'un objet. Vous pouvez spécifier une valeur de dernière modification dans votre demande de lecture et renvoyer un objet uniquement si cet objet a été modifié 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, voir GetObjectdans le Amazon Simple Storage Service API Reference.
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, voir HeadObjectdans le Amazon Simple Storage Service API Reference.
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 la date 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 la date 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, voir CopyObjectdans le Amazon Simple Storage Service API Reference.
