Utilisation des métadonnées d'objet

Vous pouvez définir des métadonnées d'objet dans Amazon S3 au moment du chargement de l'objet. Les métadonnées d'objet sont un ensemble de paires de noms-valeurs. Une fois l'objet chargé, vous ne pouvez pas modifier ses métadonnées. Le seul moyen de modifier les métadonnées d'objet est de faire une copie de l'objet et de configurer les métadonnées.

Lorsque vous créez un objet, vous spécifiez également le nom de clé, qui identifie de façon unique l'objet dans le compartiment. La clé d'objet (ou nom de clé) identifie de façon unique l'objet dans un compartiment Amazon S3. Pour plus d’informations, consultez Dénomination des objets Amazon S3.

Il existe deux types de métadonnées dans Amazon S3 : les métadonnées définies par le système et les métadonnées définies par l'utilisateur. Les sections ci-dessous fournissent plus d'informations sur les métadonnées définies par le système et celles définies par l'utilisateur. Pour en savoir plus sur la modification des métadonnées à l'aide de la console Amazon S3, veuillez consulter Modification des métadonnées d'objet dans la console Amazon S3.

Métadonnées d'objet définies par le système

Pour chaque objet stocké dans un compartiment, Amazon S3 gère un ensemble de métadonnées système. Amazon S3 traite ces métadonnées système selon les besoins. Par exemple, Amazon S3 gère les métadonnées de date et de taille de création de l'objet et utilise ces informations dans le cadre de la gestion de l'objet.

Il existe deux classes de métadonnées système :

• Contrôlées par le système : les métadonnées comme la date de création de l'objet sont contrôlées par le système et seul Amazon S3 peut modifier la valeur.

• Contrôlées par l'utilisateur : les autres métadonnées système, comme la classe de stockage configurée pour l'objet et l'activation du chiffrement côté serveur dans l'objet, sont des exemples de métadonnées système dont vous contrôlez la valeur. Si votre bucket est configuré en tant que site Web, vous souhaiterez parfois rediriger une demande de page vers une autre page ou vers une page externeURL. Dans ce cas, une page Web est un objet dans le compartiment. Amazon S3 stocke la valeur de redirection de la page comme des métadonnées système dont vous contrôlez la valeur.

  Lorsque vous créez des objets, vous pouvez configurer les valeurs de ces éléments de métadonnées système ou mettre à jour les valeurs le cas échéant. Pour plus d’informations sur les classes de stockage, consultez Comprendre et gérer les classes de stockage Amazon S3.

  Amazon S3 utilise des AWS KMS clés pour chiffrer vos objets Amazon S3. AWS KMS chiffre uniquement les données de l'objet. Le total de contrôle, ainsi que l'algorithme spécifié, sont stockés dans le cadre des métadonnées de l'objet. Si un chiffrement côté serveur est demandé pour l'objet, le total de contrôle est stocké sous forme chiffrée. Pour plus d’informations sur le chiffrement côté serveur, consultez Protection des données à l'aide du chiffrement.

Note

L'en-tête de la demande PUT est limité à une taille de 8 Ko. Dans l'en-tête de la demande PUT, les métadonnées définies par le système sont limitées à une taille de 2 Ko. La taille des métadonnées définies par le système est mesurée en additionnant le nombre d'octets de chaque clé et valeur dans le ASCII codage américain.

Le tableau suivant fournit une liste des métadonnées définies par le système et indique si elles peuvent être mises à jour.

Nom	Description	L'utilisateur peut-il modifier la valeur ?
Date	Les date et heure actuelles.	Non
Cache-Control	Champ d'en-tête général utilisé pour spécifier les stratégies de mise en cache.	Oui
Content-Disposition	Informations de présentation des objets.	Oui
Content-Length	La taille des objets en octets.	Non
Content-Type	Le type d’objet.	Oui
Last-Modified	La date de création ou de dernière modification, la plus récente des deux. Pour les chargements partitionnés, la date de création de l'objet correspond à la date de lancement du chargement partitionné.	Non
ETag	Une étiquette d'entité (ETag) qui représente une version spécifique d'un objet. Pour les objets qui ne sont pas chargés en plusieurs parties et qui sont soit non chiffrés, soit chiffrés par chiffrement côté serveur avec des clés gérées par Amazon S3 (SSE-S3), il s'ETagagit d'un MD5 condensé des données.	Non
x-amz-server-side-encryption	En-tête qui indique si le chiffrement côté serveur est activé pour l'objet, et si ce chiffrement utilise les clés AWS Key Management Service (AWS KMS) (SSE-KMS) ou les clés de chiffrement gérées par Amazon S3 (SSE-S3). Pour de plus amples informations, veuillez consulter Protection des données avec le chiffrement côté serveur.	Oui
x-amz-checksum-crc32, x-amz-checksum-crc32c, x-amz-checksum-sha1, x-amz-checksum-sha256	Des en-têtes qui contiennent le total de contrôle ou le récapitulatif de l'objet. Au maximum, un de ces en-têtes sera défini à la fois, en fonction de l'algorithme de total de contrôle que vous demandez à Amazon S3 d'utiliser. Pour plus d'informations sur la façon de sélectionner l'algorithme de total de contrôle,, consultez Vérification de l'intégrité des objets.	Non
x-amz-version-id	La version d'un objet. Lorsque vous activez la gestion des versions sur un compartiment, Amazon S3 attribue un ID de version aux objets ajoutés au compartiment. Pour plus d’informations, consultez Conservation de plusieurs versions d'objets grâce au versionnement S3.	Non
x-amz-delete-marker	Un marqueur booléen qui indique si l'objet est un marqueur de suppression. Ce marqueur n'est utilisé que dans les compartiments pour lesquels la gestion des versions est activée.	Non
x-amz-storage-class	La classe de stockage utilisée pour stocker l'objet. Pour plus d’informations, consultez Comprendre et gérer les classes de stockage Amazon S3.	Oui
x-amz-website-redirect-location	En-tête qui redirige les demandes relatives à l'objet associé vers un autre objet du même compartiment ou vers un objet externeURL. Pour de plus amples informations, veuillez consulter (Facultatif) Configuration de la redirection de pages web.	Oui
x-amz-server-side-encryption-aws-kms-key-id	En-tête qui indique l'ID de la KMS clé de chiffrement AWS KMS symétrique utilisée pour chiffrer l'objet. Cet en-tête est utilisé uniquement lorsque l'en-tête x-amz-server-side-encryption est présent et a la valeur de aws:kms.	Oui
x-amz-server-side-encryption-customer-algorithm	En-tête qui indique si le chiffrement côté serveur avec les clés de chiffrement fournies par le client (SSE-C) est activé. Pour de plus amples informations, veuillez consulter Utilisation du chiffrement côté serveur avec des clés fournies par le client (-C) SSE.	Oui
x-amz-tagging	Ensemble de balises de l'objet. Le jeu de balises doit être codé sous forme de paramètres de URL requête.	Oui

Métadonnées d'objet définies par l'utilisateur

Lorsque vous chargez un objet, vous pouvez également lui attribuer des métadonnées. Vous fournissez ces informations facultatives en tant que paire nom-valeur (clé-valeur) lorsque vous envoyez une demande PUT ou POST pour créer l'objet. Lorsque vous chargez des objets à l'aide de RESTAPI, les noms de métadonnées facultatifs définis par l'utilisateur doivent commencer par x-amz-meta- pour les distinguer des autres HTTP en-têtes. Lorsque vous récupérez l'objet à l'aide de RESTAPI, ce préfixe est renvoyé. Lorsque vous chargez des objets à l'aide du SOAPAPI, le préfixe n'est pas obligatoire. Lorsque vous récupérez l'objet à l'aide du SOAPAPI, le préfixe est supprimé, quel que soit le préfixe que API vous avez utilisé pour télécharger l'objet.

Note

SOAPsupport over HTTP est obsolète, mais il SOAP est toujours disponible. HTTPS Les nouvelles fonctionnalités d'Amazon S3 ne sont pas prises en charge pourSOAP. Au lieu d'utiliserSOAP, nous vous recommandons d'utiliser le REST API ou le AWS SDKs.

Lorsque les métadonnées sont extraites via le RESTAPI, Amazon S3 combine les en-têtes portant le même nom (en excluant les majuscules) dans une liste séparée par des virgules. Si certaines métadonnées contiennent des caractères non imprimables, elles ne sont pas renvoyées. À la place, l'en-tête x-amz-missing-meta est renvoyé avec le nombre d'entrées de métadonnées non imprimables. L'action HeadObject récupère les métadonnées d'un objet sans retourner l'objet lui-même. Cette opération est pratique si vous êtes uniquement intéressé par les métadonnées d'un objet. Pour utiliser HEAD, vous devez disposer d'un accès READ sur l'objet. Pour plus d'informations, consultez HeadObjectle manuel Amazon Simple Storage Service API Reference.

Les métadonnées définies par l'utilisateur sont un ensemble de paires de clés-valeurs. Amazon S3 stocke les clés de métadonnées définies par l'utilisateur en minuscules.

Amazon S3 accepte les caractères Unicode arbitraires dans vos valeurs de métadonnées.

Pour éviter les problèmes liés à la présentation de ces valeurs de métadonnées, vous devez utiliser des ASCII caractères américains lors de l'utilisation REST et UTF -8 lors de l'utilisation SOAP ou des téléchargements via un navigateur. POST

Lorsque vous utilisez des ASCII caractères non américains dans vos valeurs de métadonnées, la chaîne Unicode fournie est examinée pour détecter les caractères non américains. ASCII Les valeurs de ces en-têtes sont décodées en caractères conformément à la norme RFC2047 avant d'être stockées et codées conformément à la norme RFC2047 pour les rendre sûres pour la messagerie avant d'être renvoyées. Si la chaîne ne contient que des ASCII caractères américains, elle est présentée telle quelle.

Voici un exemple.

PUT /Key HTTP/1.1
Host: amzn-s3-demo-bucket.s3.amazonaws.com
x-amz-meta-nonascii: ÄMÄZÕÑ S3

HEAD /Key HTTP/1.1
Host: amzn-s3-demo-bucket.s3.amazonaws.com
x-amz-meta-nonascii: =?UTF-8?B?w4PChE3Dg8KEWsODwpXDg8KRIFMz?=

PUT /Key HTTP/1.1
Host: amzn-s3-demo-bucket.s3.amazonaws.com
x-amz-meta-ascii: AMAZONS3

HEAD /Key HTTP/1.1
Host: amzn-s3-demo-bucket.s3.amazonaws.com
x-amz-meta-ascii: AMAZONS3
		

Note

L'en-tête de la demande PUT est limité à une taille de 8 Ko. Dans l'en-tête de la demande PUT, les métadonnées définies par l'utilisateur sont limitées à une taille de 2 Ko. La taille des métadonnées définies par l'utilisateur est mesurée en additionnant le nombre d'octets du codage UTF -8 de chaque clé et valeur.

Pour plus d'informations sur la modification des métadonnées de votre objet après son téléchargement, en créant une copie de l'objet, en le modifiant et en remplaçant l'ancien objet, ou en créant une version, consultez Modification des métadonnées d'objet dans la console Amazon S3.