Exporter (0) Imprimer
Développer tout

Set Blob Properties

Mis à jour: janvier 2014

L'opération Set Blob Properties définit les propriétés système de l'objet blob.

La demande Set Blob Properties peut être construite comme indiqué ci-dessous. HTTPS est recommandé. Remplacez moncompte par le nom de votre compte de stockage :

 

  URI de demande de la méthode PUT Version HTTP

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

HTTP/1.1

Lorsque vous élaborez une demande pour le service de stockage émulé, spécifiez le nom d'hôte de l'émulateur et le port de service BLOB sous la forme 127.0.0.1:10000, suivi du nom de compte de stockage émulé :

 

  URI de demande de la méthode PUT Version HTTP

http://127.0.0.1:10000/ devstoreaccount1/mycontainer/myblob?comp=properties

HTTP/1.1

Pour plus d'informations, consultez Utilisation de l'émulateur de stockage Azure pour le développement et le test.

Les paramètres supplémentaires suivants peuvent être spécifiés dans l'URI de la demande.

 

Parameter Description

timeout

Ce paramètre est facultatif. Le paramètre timeout est exprimé en secondes. Pour plus d'informations, consultez Définition de délais d'expiration pour les opérations du service BLOB.

Le tableau suivant décrit les en-têtes de demande obligatoires et facultatifs pour les opérations sur des objets blob de blocs et les objets blob de pages.

 

En-tête de demande Description

Authorization

Obligatoire. Spécifie le schéma d'authentification, le nom du compte et la signature. Pour plus d'informations, consultez Authentification pour les services de stockage Azure.

Date - ou - x-ms-date

Obligatoire. Spécifie le temps universel coordonné (UTC) pour la demande. Pour plus d'informations, consultez Authentification pour les services de stockage Azure.

x-ms-version

Obligatoire pour toutes les demandes authentifiées. Spécifie la version de l'opération à utiliser pour cette demande. Pour plus d'informations, consultez Contrôle de version pour les services de stockage Azure.

x-ms-blob-cache-control

Ce paramètre est facultatif. Modifie la chaîne de contrôle du cache pour l'objet blob.

Si cette propriété n'est pas spécifiée dans la demande, la propriété est désactivée pour l'objet blob. Les appels suivants à Get Blob Properties ne retournent pas cette propriété, sauf si elle est explicitement définie de nouveau dans l'objet blob.

x-ms-blob-content-type

Ce paramètre est facultatif. Définit le type de contenu de l'objet blob.

Si cette propriété n'est pas spécifiée dans la demande, la propriété est désactivée pour l'objet blob. Les appels suivants à Get Blob Properties ne retournent pas cette propriété, sauf si elle est explicitement définie de nouveau dans l'objet blob.

x-ms-blob-content-md5

Ce paramètre est facultatif. Définit le hachage MD5 de l'objet blob.

Si cette propriété n'est pas spécifiée dans la demande, la propriété est désactivée pour l'objet blob. Les appels suivants à Get Blob Properties ne retournent pas cette propriété, sauf si elle est explicitement définie de nouveau dans l'objet blob.

x-ms-blob-content-encoding

Ce paramètre est facultatif. Définit l'encodage du contenu de l'objet blob.

Si cette propriété n'est pas spécifiée dans la demande, la propriété est désactivée pour l'objet blob. Les appels suivants à Get Blob Properties ne retournent pas cette propriété, sauf si elle est explicitement définie de nouveau dans l'objet blob.

x-ms-blob-content-language

Ce paramètre est facultatif. Définit la langue du contenu de l'objet blob.

Si cette propriété n'est pas spécifiée dans la demande, la propriété est désactivée pour l'objet blob. Les appels suivants à Get Blob Properties ne retournent pas cette propriété, sauf si elle est explicitement définie de nouveau dans l'objet blob.

x-ms-lease-id:<ID>

Obligatoire si l'objet blob a un bail actif. Pour effectuer cette opération sur un objet blob avec un bail actif, spécifiez l'ID de bail valide pour cet en-tête.

x-ms-client-request-id

Ce paramètre est facultatif. Fournit une valeur opaque générée par le client avec une limite de caractère de 1 Ko qui est enregistrée dans les journaux d'analyse quand la journalisation de l'analyse de stockage est activée. L'utilisation de cet en-tête est recommandée pour la corrélation des activités côté client avec les requêtes reçues par le serveur. Pour plus d'informations, consultez À propos de la journalisation Storage Analytics et Journalisation du stockage Windows Azure : utilisation des journaux pour suivre les demandes de stockage.

x-ms-blob-content-disposition

Ce paramètre est facultatif. Définit l'en-tête Content-Disposition de l'objet blob. Disponible pour la version du 15/08/2013 et les versions ultérieures.

Le champ d'en-tête de réponse Content-Disposition donne des informations supplémentaires sur la manière de traiter la charge utile de réponse, et peut également être utilisé pour attacher des métadonnées supplémentaires. Afficher par exemple, s'il a la valeur attachment, il indique que l'agent utilisateur ne doit pas afficher la réponse, mais une boîte de dialogue Enregistrer sous avec un nom de fichier différent du nom d'objet blob spécifié.

La réponse des opérations Get Blob et Get Blob Properties inclut l'en-tête content-disposition.

Origin

Ce paramètre est facultatif. Spécifie l'origine à partir de laquelle la demande est émise. La présence de cet en-tête entraîne des en-têtes de partage de ressources cross-origine dans la réponse. Pour plus d'informations, consultez Prise en charge du service Partage des ressources cross-origine (CORS) pour les services de stockage Azure.

Cette opération prend uniquement en charge l'utilisation d'en-têtes conditionnels pour définir les propriétés de l'objet blob uniquement si une condition spécifique est remplie. Pour plus d'informations, consultez Spécification des en-têtes conditionnels pour les opérations du service BLOB.

Le tableau suivant décrit les en-têtes de demande applicables uniquement pour les opérations sur des objets blob de pages.

 

En-tête de demande Description

x-ms-blob-content-length: byte value

Ce paramètre est facultatif. Redimensionne un objet blob de pages à la taille spécifiée. Si la valeur spécifiée est inférieure à la taille actuelle de l'objet blob, alors toutes les pages au-dessus de la valeur spécifiée sont effacées.

Cette propriété ne peut pas être utilisée pour modifier la taille d'un objet blob de blocs. La définition de cette propriété pour un objet blob de blocs retourne le code d'état 400 (Demande incorrecte).

x-ms-sequence-number-action: {max, update, increment}

Facultatif, mais requis si l'en-tête x-ms-blob-sequence-number est défini pour la demande. Cette propriété s'applique uniquement aux objets blob de pages.

Cette propriété indique comment le service doit modifier le numéro séquentiel de l'objet blob. Indiquez l'une des options suivantes pour cette propriété :

  • max : définit le numéro de séquence à la valeur la plus élevée incluse avec la demande et la valeur actuellement stockée pour l'objet blob.

  • update : définit le numéro de séquence à la valeur incluse avec la demande.

  • increment : incrémente la valeur du numéro séquentiel de 1. Si vous spécifiez cette option, n'incluez pas l'en-tête x-ms-blob-sequence-number header ; sinon, le service retourne le code d'état 400 (Demande incorrecte).

x-ms-blob-sequence-number: <num>

Facultatif, mais requis si la propriété x-ms-sequence-number-action est définie à max ou à update. Cette propriété s'applique uniquement aux objets blob de pages.

Cette propriété définit le numéro de séquence de l'objet blob. Le numéro de séquence est une propriété contrôlée par l'utilisateur que vous pouvez utiliser pour suivre les demandes et gérer les problèmes d'accès concurrentiel. Pour plus d'informations, consultez l'opération Put Page.

Utilisez cette propriété avec x-ms-sequence-number-action pour mettre à jour le numéro de séquence de l'objet blob, soit à la valeur spécifiée, soit à la valeur la plus élevée des valeurs spécifiées avec la demande ou actuellement stockées avec l'objet blob. Cet en-tête ne doit pas être spécifié si x-ms-sequence-number-action a la valeur increment; dans ce cas le service incrémente automatiquement le numéro de séquence de un.

Pour définir le numéro de séquence à une valeur de votre choix, cette propriété doit être spécifiée dans la demande avec x-ms-sequence-number-action.

La réponse inclut un code d'état HTTP et un ensemble d'en-têtes de réponse.

Une opération ayant réussi retourne le code d'état 200 (OK).

Pour plus d'informations sur les codes d'état, consultez Codes d'état et codes d'erreur.

La réponse de l'opération inclut les en-têtes suivants. La réponse peut aussi inclure des en-têtes HTTP standard supplémentaires. Tous les en-têtes standard sont conformes à la spécification du protocole HTTP/1.1.

 

Syntaxe Description

ETag

L'ETag contient une valeur que vous pouvez utiliser pour exécuter des opérations conditionnellement. Pour plus d'informations, consultez Spécification des en-têtes conditionnels pour les opérations du service BLOB. Si la version de la demande est 18/08/2011 ou plus récente, la valeur de l'ETag sera entre guillemets.

Last-Modified

Date et heure de la dernière modification apportée à l'objet blob. Le format de date suit RFC 1123. Pour plus d'informations, consultez la rubrique Représentation des valeurs Date/Heure dans les en-têtes.

Toute opération d'écriture dans l'objet blob (notamment les mises à jour des métadonnées ou des propriétés de l'objet blob), modifie la heure de la dernière modification de l'objet blob.

x-ms-blob-sequence-number

Si l'objet blob est un objet blob de pages, le numéro de séquence actuel de l'objet blob est retourné avec cet en-tête.

x-ms-request-id

Cet en-tête identifie de façon unique la demande qui a été effectuée et peut être utilisé pour résoudre les problèmes de la demande. Pour plus d'informations, consultez Dépannage des opérations de l'API.

x-ms-version

Indique la version du service BLOB utilisée pour exécuter la demande. Cet en-tête est retourné pour les demandes effectuées avec la version du 19.09.09 ou ultérieure.

Date

Une valeur de date/heure UTC générée par le service qui indique le moment auquel la réponse a été initiée.

Access-Control-Allow-Origin

Retourné si la demande inclut un en-tête Origin et le partage de ressources cross-origine (CORS) est activé avec une règle de correspondance. Cet en-tête retourne la valeur de l'en-tête de demande d'origine en cas de correspondance.

Access-Control-Expose-Headers

Retourné si la demande inclut un en-tête Origin et le partage de ressources cross-origine (CORS) est activé avec une règle de correspondance. Retourne la liste des en-têtes de réponse qui doivent être exposés au client ou à l'émetteur de la demande.

Access-Control-Allow-Credentials

Retourné si la demande inclut un en-tête Origin et le partage de ressources cross-origine (CORS) est activé avec une règle de correspondance qui n'autorise pas toutes les origines. Cet en-tête doit avoir la valeur True.

Cette opération ne peut être appelée que par le propriétaire du compte et par toute personne qui dispose d'une signature d'accès partagé qui a l'autorisation d'écrire dans l'objet blob ou son conteneur.

La sémantique de mise à jour des propriétés d'un objet blob est la suivante :

  • Le numéro de séquence d'un objet blob de pages est mis à jour uniquement si la demande remplit l'une des conditions suivantes :

    • La demande définit x-ms-sequence-number-action à max ou à update et indique également une valeur pour l'en-tête x-ms-blob-sequence-number.

    • La demande définit x-ms-sequence-number-action à increment, en indiquant que le service doit incrémenter le numéro de séquence de un.

  • La taille d'un objet blob de pages est modifiée uniquement si la demande spécifie une valeur pour l'en-tête x-ms-content-length.

  • Si une demande définit uniquement x-ms-blob-sequence-number et/ou x-ms-content-length, et aucune autre propriété, alors aucune autre propriété de l'objet blob n'est modifiée.

  • Si une ou plusieurs des propriétés suivantes sont définies dans la demande, alors toutes ces propriétés sont définies ensemble. Si une valeur n'est pas fournie pour une propriété donnée lorsqu'au moins une des propriétés répertoriées ci-dessous est définie, cette propriété est effacée pour l'objet blob.

    • x-ms-blob-cache-control

    • x-ms-blob-content-type

    • x-ms-blob-content-md5

    • x-ms-blob-content-encoding

    • x-ms-blob-content-language

    • x-ms-blob-content-disposition

Notez que pour une signature d'accès partagé, vous pouvez remplacer certaines propriétés stockées de l'objet blob en spécifiant des paramètres de requête dans la signature d'accès partagé. Ces propriétés incluent cache-control, content-type, content-encoding, content-language et content-disposition. Pour plus d'informations, consultez Construction de l'URI de signature d'accès partagé.

Afficher:
© 2014 Microsoft