Définition et récupération des propriétés et des métadonnées pour les ressources du service Blob

  • Article

Les conteneurs et les objets blob prennent en charge les métadonnées personnalisées, représentées sous forme d'en-têtes HTTP. Les en-têtes de métadonnées peuvent être définies dans une demande qui crée une nouvelle ressource de conteneur ou d'objet blob, ou dans une demande qui crée explicitement une propriété dans une ressource existante.

Cette rubrique contient les sous-rubriques suivantes :

Format d’en-tête des métadonnées

Opérations sur les métadonnées

Propriétés HTTP standard pour les conteneurs et les objets blob

Les objets blob prennent également en charge les balises, un type spécial de métadonnées personnalisées indexées automatiquement par le service Blob. Pour plus d’informations, consultez Gérer et rechercher des données sur Stockage Blob Azure avec l’index blob.

Format d'en-tête de métadonnées

Les en-têtes de métadonnées sont des paires nom-valeur. Le format de l'en-tête est :

x-ms-meta-name:string-value

À compter de la version 2009-09-19, les noms de métadonnées doivent respecter les règles de nommage des identificateurs C#.

Les noms sont sensibles à la casse. Notez que les noms de métadonnées conservent la casse avec laquelle ils ont été créés, mais ne la respecte plus quand ils sont définis ou lus. Si au moins deux en-têtes de métadonnées avec le même nom sont envoyés pour une ressource, le service BLOB renvoie le code d'état 400 (Demande incorrecte).

Les métadonnées se composent de paires nom/valeur. La taille totale de toutes les paires de métadonnées peut atteindre 8 Ko.

Les paires nom-valeur de métadonnées sont des en-têtes HTTP valides, et adhèrent à toutes les restrictions régissant les en-têtes HTTP.

Opérations sur les métadonnées

Les métadonnées dans une ressource d'objet blob ou de conteneur peuvent être récupérées ou définies directement, sans renvoyer ou modifier le contenu de la ressource.

Notez que les valeurs de métadonnées ne peuvent être lues ou écrites entièrement ; les mises à jour partielles ne sont pas prises en charge. La définition des métadonnées dans une ressource remplace toutes les valeurs de métadonnées existantes pour cette ressource.

Récupération de propriétés et de métadonnées

Les opérations GET et HEAD récupèrent les en-têtes de métadonnées du conteneur ou de l'objet blob spécifié. L’opération HEAD retourne uniquement des en-têtes ; elle ne retourne pas de corps de réponse.

La syntaxe URI pour récupérer les en-têtes de métadonnées d'un conteneur est la suivante :

GET/HEAD https://myaccount.blob.core.windows.net/mycontainer?restype=container

La syntaxe URI pour récupérer les en-têtes de métadonnées d'un objet blob est la suivante :

GET/HEAD https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=metadata

Définition des en-têtes de métadonnées

L'opération PUT définit des en-têtes de métadonnées dans le conteneur ou l'objet blob spécifié, en remplaçant toutes les métadonnées existantes de la ressource. L'appel de PUT sans en-tête dans la demande efface toutes les métadonnées existantes de la ressource.

La syntaxe URI pour définir les en-têtes de métadonnées d'un conteneur est la suivante :

PUT https://myaccount.blob.core.windows.net/mycontainer?comp=metadata?restype=container

La syntaxe URI pour définir les en-têtes de métadonnées d'un objet blob est la suivante :

PUT https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=metadata

Propriétés HTTP standard pour les conteneurs et les objets blob

Les conteneurs et les objets blob prennent également en charge certaines propriétés HTTP standard. Les propriétés et les métadonnées sont représentées en tant qu'en-têtes HTTP standard ; la différence entre elles réside dans l'attribution de nom aux en-têtes. Les en-têtes de métadonnées sont nommés avec le préfixe d'en-tête x-ms-meta- et un nom personnalisé. Les en-têtes de propriété utilisent des noms d’en-tête HTTP standard, comme spécifié dans la section 14 Définitions de champ d’en-tête de la spécification du protocole HTTP/1.1.

Les en-têtes HTTP standard pris en charge sur les conteneurs incluent :

  • ETag

  • Last-Modified

Les en-têtes HTTP standard pris en charge sur les objets blob incluent :

  • ETag

  • Last-Modified

  • Content-Length

  • Content-Type

  • Content-MD5

  • Content-Encoding

  • Content-Language

  • Cache-Control

  • Origin

  • Range

Voir aussi

Créer un conteneur
Get Container Properties
Définir les métadonnées du conteneur
Put Blob
Copy Blob
Get Blob Properties
Get Blob Metadata
Set Blob Metadata
Blob Service Concepts
Gérer et rechercher des données dans le Stockage Blob Azure avec un index d’objets blob