VENTES: 1-800-867-1389

Définition et récupération de propriétés et de métadonnées pour les ressources d'objets blob

Mis à jour: novembre 2014

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 de métadonnées

Opérations sur les métadonnées

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

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

Depuis la version du 19/09/2009, les noms de métadonnées doivent respecter les règles d'affectation de noms des identificateurs C#.

Les noms ne respectent pas 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).

La taille totale des métadonnées, y compris le nom et la valeur, ne peut pas dépasser 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.

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.

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é. Ces opérations renvoient des en-têtes uniquement ; elles ne renvoient pas un 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

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

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 les noms d'en-tête HTTP standard, tels que spécifiés dans la section 14 Définitions des champs 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

Cela vous a-t-il été utile ?
(1500 caractères restants)
Merci pour vos suggestions.
Afficher:
© 2015 Microsoft