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.
Utilisation des métadonnées d’objet
Amazon S3 propose plusieurs méthodes pour associer des métadonnées à vos objets. Les annotations vous permettent d'associer des charges utiles de données riches allant jusqu'à 1 Mo à des objets à l'aide d'opérations d'API dédiées. Les balises d'objet sont des paires clé-valeur permettant de classer et de contrôler l'accès aux objets. Vous pouvez également définir des métadonnées définies par l'utilisateur au moment du chargement, et Amazon S3 gère automatiquement les métadonnées définies par le système. Pour plus d’informations, consultez Métadonnées d'objets personnalisées, Annoter vos objets, Marquer vos objets, User-defined métadonnées et System-defined métadonnées de l'objet.
Lorsque vous créez un objet, vous spécifiez la clé d’objet, aussi appelée nom de clé, qui identifie de façon unique l’objet dans un compartiment Amazon S3. Pour de plus amples informations, veuillez consulter Attribution d’un nom aux objets Amazon S3. Vous pouvez définir les métadonnées définies par l’utilisateur dans Amazon S3 au moment du chargement de l’objet.
Une fois l’objet chargé, vous ne pourrez plus modifier ces métadonnées définies par l’utilisateur. Le seul moyen de modifier ces métadonnées consisterait à copier l’objet et à en configurer les métadonnées. Pour plus d’informations sur la modification des métadonnées à l’aide de la console Amazon S3, consultez Modification des métadonnées d’objet dans la console Amazon S3.
Métadonnées d'objets personnalisées
Les métadonnées d'objets personnalisées sont des métadonnées que vous contrôlez. Vous pouvez utiliser des métadonnées d'objets personnalisées pour stocker des informations relatives à vos objets pertinentes pour vos applications. Amazon S3 prend en charge trois types de métadonnées d'objets personnalisées : les annotations, les balises d'objet et les métadonnées définies par l'utilisateur.
Annotations
Les annotations sont appelées charges utiles de données que vous pouvez associer à n'importe quel objet Amazon S3 après son téléchargement. Chaque annotation peut stocker jusqu'à 1 Mo de UTF-8 texte, tel que des résultats de AI-generated sortie, des résultats de classification ou des enregistrements de traitement. Vous pouvez créer, récupérer, répertorier et supprimer des annotations sans modifier l'objet lui-même. Pour de plus amples informations, veuillez consulter Annoter vos objets.
Balises d’objet
Les balises d'objet sont des paires clé-valeur que vous pouvez utiliser pour classer, organiser et contrôler l'accès à vos objets. Chaque objet peut comporter jusqu'à 10 balises. Vous pouvez utiliser des balises dans les politiques IAM et de bucket, les règles du cycle de vie S3 et les rapports de répartition des coûts. Pour de plus amples informations, veuillez consulter Marquer vos objets.
User-defined métadonnées
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. Lors du chargement des objets grâce à l’API REST, les noms facultatifs des métadonnées définies par l’utilisateur doivent commencer par « x-amz-meta- » pour se différencier des autres en-têtes HTTP. Lorsque vous récupérez l’objet grâce à l’API REST, ce préfixe est renvoyé. Lors du chargement des objets grâce à l’API SOAP, le préfixe n’est pas requis. Lorsque vous récupérez l’objet grâce à l’API SOAP, le préfixe est supprimé, quelle que soit l’API utilisée pour charger l’objet.
Note
Les SOAP API pour Amazon S3 ne sont pas disponibles pour les nouveaux clients. Leur fin de vie est prévue le 31 août 2025. Nous vous recommandons d'utiliser l'API REST ou les AWS SDK.
Lorsque des métadonnées sont récupérées via l’API REST, Amazon S3 associe les en-têtes avec le même nom (sans tenir compte de la casse) 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.
User-defined les métadonnées sont un ensemble de paires clé-valeur. 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 vous conformer à l'utilisation de US-ASCII caractères lorsque vous utilisez REST et UTF-8 lorsque vous utilisez SOAP ou des téléchargements via un navigateur. POST
Lorsque vous utilisez des US-ASCII caractères autres que des caractères dans vos valeurs de métadonnées, la chaîne Unicode fournie est examinée pour détecter les US-ASCII non-caractères. Les valeurs de ces en-têtes sont décodées en caractères selon la RFC 2047
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 dans le UTF-8 codage 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.
Interrogation de vos métadonnées et accélération de la découverte des données avec les métadonnées S3
Pour trouver, stocker et interroger facilement les métadonnées de vos objets S3, vous pouvez utiliser les métadonnées S3. Avec S3 Metadata, vous pouvez rapidement préparer des données pour les utiliser dans l'analyse commerciale, la récupération de contenu, l'intelligence artificielle et l'apprentissage automatique (AI/ML), la formation de modèles, etc.
Les métadonnées S3 accélèrent la découverte des données en capturant automatiquement les métadonnées des objets de vos compartiments à usage général et en les stockant dans des tables Apache Iceberg entièrement gérées en lecture seule que vous pouvez interroger. Ces tables en lecture seule sont appelées tables de métadonnées. Lorsque des objets sont ajoutés, mis à jour ou supprimés dans vos compartiments à usage général, les métadonnées S3 actualisent automatiquement les tables de métadonnées correspondantes pour refléter les dernières modifications.
Par défaut, S3 Metadata fournit des métadonnées d'objet définies par le système, telles que l'heure de création et la classe de stockage d'un objet, et des métadonnées personnalisées, telles que les balises, les métadonnées définies par l'utilisateur et les annotations. Les métadonnées S3 fournissent également des métadonnées d’événements en signalant, par exemple, les activités de mise à jour ou de suppression d’un objet, ainsi que le Compte AWS ayant effectué la demande.
Les tables de métadonnées sont stockées dans des compartiments de table S3, qui fournissent un stockage optimisé pour les données tabulaires. Pour interroger vos métadonnées, vous pouvez intégrer votre compartiment de tables à des services AWS d'analyse tels qu'Amazon Athena, Amazon Redshift et Amazon Quick.
Pour en savoir plus sur les métadonnées S3, consultez Identification de vos données avec les tables S3 Metadata.
System-defined métadonnées de l'objet
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 liées à la date de création et à la taille de l’objet et utilise ces informations dans le cadre de la gestion des objets.
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. Par conséquent, seul Amazon S3 peut modifier la valeur de date.
-
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 le compartiment est configuré en tant que site web, il se peut que vous souhaitiez rediriger une demande de page vers une autre page ou une URL externe. Dans ce cas, une page Web est un objet dans le compartiment. Amazon S3 stocke la valeur de redirection de la page en tant que métadonnées système que vous pouvez contrôler.
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 Bien 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. La somme de contrôle et 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 du US-ASCII codage de chaque clé et valeur.
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-Encoding |
Les codages de contenu (tels que la compression) qui ont été appliqués aux données de l’objet | 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 balise d’entité (ETag) représente une version spécifique de cet 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), l'ETag est un condensé MD5 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-crc64nvme, 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 dans Amazon S3. | Non |
x-amz-checksum-type |
Type de somme de contrôle, qui détermine la manière dont les sommes de contrôle au niveau de chaque partie sont combinées pour créer une somme de contrôle au niveau de l’objet pour les objets en plusieurs parties. | Oui |
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 à la gestion des versions 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 Bien comprendre et gérer les classes de stockage Amazon S3. | Oui |
x-amz-website-redirect-location |
Un en-tête qui redirige les demandes pour l’objet associé vers un autre objet dans le même compartiment ou une URL externe. Pour plus d’informations, consultez (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 clé KMS 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 () SSE-C. | Oui |
x-amz-tagging |
Ensemble de balises de l’objet. L’ensemble de balises doit être codé en tant que paramètres de requête URL. | Oui |
