Métadonnées des objets

Cette page traite des champs de métadonnées stockés avec des objets dans Cloud Storage. Pour savoir comment afficher et définir des métadonnées pour des objets, consultez la page Afficher et modifier des métadonnées d'objet.

Présentation

Les objets stockés dans Cloud Storage sont associés à des métadonnées. Les métadonnées identifient les propriétés de l'objet et spécifient la manière dont l'objet doit être géré lors de son accès. Les métadonnées existent sous forme de paires clé/valeur. Par exemple, la classe de stockage d'un objet est représentée par l'entrée de métadonnées storageClass:REGIONAL. storageClass est la clé pour les métadonnées, et tous les objets sont associés à une clé de ce type. REGIONAL spécifie la valeur de cet objet spécifique, qui varie d'un objet à l'autre.

La mutabilité des métadonnées est variable : certaines métadonnées peuvent être modifiées à tout moment, certaines ne peuvent être définies qu'au moment de la création de l'objet et d'autres peuvent être uniquement affichées. Par exemple, vous pouvez modifier la valeur des métadonnées Cache-Control à tout moment, mais les métadonnées storageClass peuvent uniquement être attribuées lors de la création ou de la réécriture de l'objet et vous ne pouvez pas modifier directement la valeur des métadonnées generation, bien que la valeur de generation change lorsque l'objet est écrasé.

Métadonnées modifiables

Pour les objets, il existe deux catégories de métadonnées que les utilisateurs peuvent modifier :

  • Métadonnées à clé fixe : métadonnées dont les clés sont définies, mais pour lesquelles vous pouvez spécifier une valeur.

  • Métadonnées personnalisées : métadonnées que vous ajoutez en spécifiant à la fois une clé et une valeur associée à la clé.

Lors de la modification de métadonnées, vous devez généralement éviter les caractères non ASCII, car ceux-ci ne sont pas autorisés dans les en-têtes HTTP utilisés par l'API XML. De plus, lorsque vous utilisez l'API XML, la taille combinée de l'URL de la requête et des en-têtes HTTP est limitée à 16 Ko. Vous devez, par conséquent, tenir compte de cette limite pour la taille totale de vos métadonnées.

Métadonnées à clé fixe

Si vous disposez des autorisations suffisantes pour le faire, vous pouvez modifier les métadonnées suivantes pour les objets :

Métadonnées de contrôle des accès

Cloud Storage utilise l'outil IAM (Identity and Access Management) et des listes de contrôle d'accès (LCA) pour contrôler l'accès aux objets. Utilisez ces liens pour en savoir plus sur ces méthodes de contrôle des accès et les métadonnées associées.

Cache-Control

Les métadonnées Cache-Control peuvent spécifier deux aspects différents de la diffusion de données à partir de Cloud Storage : elles indiquent si les données peuvent être mises en cache et si celles-ci peuvent être transformées.

Mettre des données en cache

Les métadonnées Cache-Control vous permettent de définir les autorisations de mise en cache de vos objets par les caches de navigateur et Internet, ainsi que la durée de mise en cache. Si la valeur de Cache-Control est paramétrée sur no-cache, l'objet ne doit pas être mis en cache et si la valeur est paramétrée sur max-age=[TIME_IN_SECONDS], l'objet peut être mis en cache pour une durée déterminée.

Cache-Control ne s'applique qu'aux objets accessibles publiquement, car les données non publiques ne peuvent pas être mises en cache. Sauf indication contraire, la durée du paramètre Cache-Control pour les objets accessibles au public est de 3 600 secondes.

Si vous autorisez la mise en cache, il est possible que les versions antérieures des objets soient visibles au moment du téléchargement, même après le téléchargement d'un nouvel objet de remplacement. En effet, les objets les plus anciens restent dans le cache pendant un certain temps. De plus, il n'existe aucun moyen de forcer l'expiration globale d'un objet mis en cache, étant donné que les objets peuvent être mis en cache à différents endroits sur Internet. Si vous souhaitez empêcher la mise en cache des objets lisibles publiquement, vous devez définir le paramètre Cache-Control:private sur l'objet.

Transformer les données

Les métadonnées Cache-Control vous permettent également de diffuser les objets tels qu'ils sont stockés, sans appliquer de transformation aux données, telle que la suppression du codage de contenu gzip pour les clients incompatibles. Pour diffuser un objet tel quel, définissez le paramètre Cache-Control:no-transform.

Content-Disposition

Les métadonnées Content-Disposition spécifient la présentation des données en cours de transmission. La définition du paramètre Content-Disposition vous permet de contrôler le style de présentation du contenu. Vous pouvez par exemple déterminer si une pièce jointe doit être automatiquement affichée ou si une forme d'action de l'utilisateur doit être requise pour l'ouvrir. Consultez le document https://tools.ietf.org/html/rfc6266 pour découvrir la spécification des métadonnées Content-Disposition.

Content-Encoding

Les métadonnées Content-Encoding peuvent être utilisées pour indiquer qu'un objet est compressé, tout en maintenant le paramètre Content-Type sous-jacent de l'objet. Par exemple, un fichier texte compressé avec gzip peut à la fois être défini comme fichier texte dans Content-Type et comme fichier compressé gzip dans Content-Encoding. Vous devez vous assurer que les fichiers sont bien compressés à l'aide du paramètre Content-Encoding spécifié avant de les télécharger, cela peut sinon entraîner un comportement inattendu lors du téléchargement des objets. Pour en savoir plus, consultez la page relative au Transcodage.

Pour le contenu compressible, tel que du texte, l'utilisation de Content-Encoding: gzip permet de réduire les coûts de stockage et de réseau, et d'améliorer les performances de traitement du contenu. Toutefois, il est préférable d'éviter d'appliquer un autre niveau de compression aux contenus déjà intrinsèquement compressés, tels que les archives et de nombreux formats de supports, et de les marquer dans les métadonnées Content-Encoding. En effet, cela est généralement préjudiciable à la fois pour la taille et les performances des objets.

Content-Language

Les métadonnées Content-Language indiquent la ou les langues auxquelles l'objet est destiné. Reportez-vous aux codes de langue ISO 639-1 pour connaître les valeurs acceptées pour ces métadonnées.

Content-Type

Les métadonnées les plus couramment définies sont Content-Type (également appelées type MIME), qui permettent aux navigateurs de restituer correctement l'objet. Tous les objets ont une valeur définie dans leurs métadonnées Content-Type, mais cette valeur ne correspond pas nécessairement au type sous-jacent de l'objet. Par exemple, si la valeur de Content-Type n'est pas spécifiée par le programme de téléchargement et ne peut pas être déterminée, celle-ci est définie sur application/octet-stream ou sur application/x-www-form-urlencoded, selon le mode de téléchargement de l'objet. Pour obtenir la liste des types MIME valides, consultez la page IANA Media Types.

Métadonnées personnalisées

Les métadonnées personnalisées sont des métadonnées que vous pouvez ajouter et supprimer. Pour créer des métadonnées personnalisées, vous devez spécifier une valeur et une clé. Une fois que vous avez créé une paire de métadonnées personnalisée key:value, vous pouvez supprimer la clé ou modifier la valeur.

Sur la page Afficher et modifier des métadonnées, vous trouverez des informations sur la définition de métadonnées personnalisées. Notez que l'utilisation de métadonnées personnalisées engendre des coûts de stockage et de réseau.

Métadonnées non modifiables

Certaines métadonnées ne peuvent pas être modifiées directement. Ces métadonnées sont définies au moment de la création ou de la réécriture de l'objet. Dans le cadre de la création ou de la réécriture de l'objet, vous pouvez définir certaines métadonnées, telles que la classe de stockage de l'objet ou les clés de chiffrement fournies par le client. D'autres métadonnées sont automatiquement ajoutées et peuvent seulement être visualisées, telles que le numéro de génération de l'objet, ou ses date et heure de création.

Cette page vous a-t-elle été utile ? Évaluez-la :

Envoyer des commentaires concernant…

Besoin d'aide ? Consultez notre page d'assistance.