Set Blob PropertiesSet Blob Properties

L'opération Set Blob Properties définit les propriétés système de l'objet blob.The Set Blob Properties operation sets system properties on the blob.

RequêteRequest

La demande Set Blob Properties peut être construite comme indiqué ci-dessous.The Set Blob Properties request may be constructed as follows. HTTPS est recommandé.HTTPS is recommended. Remplacez moncompte par le nom de votre compte de stockage :Replace myaccount with the name of your storage account:

URI de demande de la méthode PUTPUT Method Request URI Version HTTPHTTP Version
https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=properties HTTP/1.1HTTP/1.1

URI du service de stockage émuléEmulated Storage Service URI

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é :When making a request against the emulated storage service, specify the emulator hostname and Blob service port as 127.0.0.1:10000, followed by the emulated storage account name:

URI de demande de la méthode PUTPUT Method Request URI Version HTTPHTTP Version
http://127.0.0.1:10000/ devstoreaccount1/mycontainer/myblob?comp=properties HTTP/1.1HTTP/1.1

Pour plus d’informations, consultez utilisation de l’émulateur de stockage Azure pour le développement et le test.For more information, see Using the Azure Storage Emulator for Development and Testing.

Paramètres URIURI Parameters

Les paramètres supplémentaires suivants peuvent être spécifiés dans l'URI de la demande.The following additional parameters may be specified on the request URI.

ParamètreParameter DescriptionDescription
timeout facultatif.Optional. Le paramètre timeout est exprimé en secondes.The timeout parameter is expressed in seconds. Pour plus d’informations, consultez définition de délais d’attente pour les opérations de service BLOB.For more information, see Setting Timeouts for Blob Service Operations.

En-têtes de demande (tous les types d’objets BLOB)Request Headers (All Blob Types)

Le tableau suivant décrit les en-têtes de demande obligatoires et facultatifs pour tous les types d’objets BLOB.The following table describes required and optional request headers for all blob types.

En-tête de la demandeRequest Header DescriptionDescription
Authorization Obligatoire.Required. Spécifie le schéma d’autorisation, le nom de compte et la signature.Specifies the authorization scheme, account name, and signature. Pour plus d’informations, consultez autoriser les demandes dans le stockage Azure.For more information, see Authorize requests to Azure Storage.
Date ou x-ms-dateDate or x-ms-date Obligatoire.Required. Spécifie la date/heure en temps universel coordonné (UTC) pour la requête.Specifies the Coordinated Universal Time (UTC) for the request. Pour plus d’informations, consultez autoriser les demandes dans le stockage Azure.For more information, see Authorize requests to Azure Storage.
x-ms-version Obligatoire pour toutes les demandes autorisées.Required for all authorized requests. Spécifie la version de l'opération à utiliser pour cette demande.Specifies the version of the operation to use for this request. Pour plus d’informations, consultez contrôle de version pour les services de stockage Azure.For more information, see Versioning for the Azure Storage Services.
x-ms-blob-cache-control facultatif.Optional. Modifie la chaîne de contrôle du cache pour l'objet blob.Modifies the cache control string for the 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.If this property is not specified on the request, then the property will be cleared for the blob. Les appels suivants pour obtenir des propriétés d’objet BLOB ne retournent pas cette propriété, sauf si elle est de nouveau explicitement définie sur l’objet BLOB.Subsequent calls to Get Blob Properties will not return this property, unless it is explicitly set on the blob again.
x-ms-blob-content-type facultatif.Optional. Définit le type de contenu de l'objet blob.Sets the blob’s content type.

Si cette propriété n'est pas spécifiée dans la demande, la propriété est désactivée pour l'objet blob.If this property is not specified on the request, then the property will be cleared for the blob. Les appels suivants pour obtenir des propriétés d’objet BLOB ne retournent pas cette propriété, sauf si elle est de nouveau explicitement définie sur l’objet BLOB.Subsequent calls to Get Blob Properties will not return this property, unless it is explicitly set on the blob again.
x-ms-blob-content-md5 facultatif.Optional. Définit le hachage MD5 de l'objet blob.Sets the blob's MD5 hash.

Si cette propriété n'est pas spécifiée dans la demande, la propriété est désactivée pour l'objet blob.If this property is not specified on the request, then the property will be cleared for the blob. Les appels suivants pour obtenir des propriétés d’objet BLOB ne retournent pas cette propriété, sauf si elle est de nouveau explicitement définie sur l’objet BLOB.Subsequent calls to Get Blob Properties will not return this property, unless it is explicitly set on the blob again.
x-ms-blob-content-encoding facultatif.Optional. Définit l'encodage du contenu de l'objet blob.Sets the blob's content encoding.

Si cette propriété n'est pas spécifiée dans la demande, la propriété est désactivée pour l'objet blob.If this property is not specified on the request, then the property will be cleared for the blob. Les appels suivants pour obtenir des propriétés d’objet BLOB ne retournent pas cette propriété, sauf si elle est de nouveau explicitement définie sur l’objet BLOB.Subsequent calls to Get Blob Properties will not return this property, unless it is explicitly set on the blob again.
x-ms-blob-content-language facultatif.Optional. Définit la langue du contenu de l'objet blob.Sets the blob's content language.

Si cette propriété n'est pas spécifiée dans la demande, la propriété est désactivée pour l'objet blob.If this property is not specified on the request, then the property will be cleared for the blob. Les appels suivants pour obtenir des propriétés d’objet BLOB ne retournent pas cette propriété, sauf si elle est de nouveau explicitement définie sur l’objet BLOB.Subsequent calls to Get Blob Properties will not return this property, unless it is explicitly set on the blob again.
x-ms-lease-id:<ID> Obligatoire si l'objet blob a un bail actif.Required if the blob has an active lease. 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.To perform this operation on a blob with an active lease, specify the valid lease ID for this header.
x-ms-client-request-id facultatif.Optional. Fournit une valeur opaque générée par le client avec une limite de 1 Kio de caractères qui est enregistrée dans les journaux d’analyse lorsque la journalisation de l’analyse de stockage est activée.Provides a client-generated, opaque value with a 1 KiB character limit that is recorded in the analytics logs when storage analytics logging is enabled. L’utilisation de cet en-tête est fortement recommandée pour la mise en corrélation des activités côté client avec les requêtes reçues par le serveur.Using this header is highly recommended for correlating client-side activities with requests received by the server. Pour plus d’informations, consultez à propos de la journalisation des Storage Analytics et de la journalisation Azure : utilisation des journaux pour suivre les demandes de stockage.For more information, see About Storage Analytics Logging and Azure Logging: Using Logs to Track Storage Requests.
x-ms-blob-content-disposition facultatif.Optional. Définit l'en-tête Content-Disposition de l'objet blob.Sets the blob’s Content-Disposition header. Disponible pour la version du 15/08/2013 et les versions ultérieures.Available for versions 2013-08-15 and later.

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.The Content-Disposition response header field conveys additional information about how to process the response payload, and also can be used to attach additional metadata. 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é.For example, if set to attachment, it indicates that the user-agent should not display the response, but instead show a Save As dialog with a filename other than the blob name specified.

La réponse des opérations d' extraction d’objet BLOB et d' extraction de propriétés d’objet BLOB comprend l' content-disposition en-tête.The response from the Get Blob and Get Blob Properties operations includes the content-disposition header.
Origin facultatif.Optional. Spécifie l'origine à partir de laquelle la demande est émise.Specifies the origin from which the request is issued. La présence de cet en-tête entraîne des en-têtes de partage de ressources cross-origine dans la réponse.The presence of this header results in cross-origin resource sharing headers on the response. Pour plus d’informations, consultez prise en charge de cors pour les services de stockage .See CORS Support for the Storage Services for details.

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.This operation also supports the use of conditional headers to set blob properties only if a specified condition is met. Pour plus d’informations, consultez Spécification des en-têtes conditionnels pour les opérations du service Blob.For more information, see Specifying Conditional Headers for Blob Service Operations.

En-têtes de demande (objets blob de pages uniquement)Request Headers (Page Blobs Only)

Le tableau suivant décrit les en-têtes de demande applicables uniquement pour les opérations sur des objets blob de pages.The following table describes request headers applicable only for operations on page blobs.

En-tête de requêteRequest header DescriptionDescription
x-ms-blob-content-length: byte value facultatif.Optional. Redimensionne un objet blob de pages à la taille spécifiée.Resizes a page blob to the specified size. 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.If the specified value is less than the current size of the blob, then all pages above the specified value are cleared.

Cette propriété ne peut pas être utilisée pour modifier la taille d’un objet blob de blocs ou d’un objet blob d’ajout.This property cannot be used to change the size of a block blob or an append blob. La définition de cette propriété pour un objet blob de blocs ou un objet blob d’ajout retourne le code d’état 400 (requête incorrecte).Setting this property for a block blob or an append blob returns status code 400 (Bad Request).
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.Optional, but required if the x-ms-blob-sequence-number header is set for the request. Cette propriété s'applique uniquement aux objets blob de pages.This property applies to page blobs only.

Cette propriété indique comment le service doit modifier le numéro séquentiel de l'objet blob.This property indicates how the service should modify the blob's sequence number. Indiquez l'une des options suivantes pour cette propriété :Specify one of the following options for this property:

- max: Définit le numéro de séquence comme étant le plus élevé de la valeur incluse avec la demande et la valeur actuellement stockée pour l’objet BLOB.- max: Sets the sequence number to be the higher of the value included with the request and the value currently stored for the blob.
- update: Définit le numéro de séquence à la valeur incluse dans la demande.- update: Sets the sequence number to the value included with the request.
- increment: Incrémente la valeur du numéro de séquence de 1.- increment: Increments the value of the sequence number by 1. Si cette option est spécifiée, n'incluez pas x-ms-blob-sequence-number header car un code d'état 400 (Demande incorrecte) sera retourné dans ce cas.If specifying this option, do not include the x-ms-blob-sequence-number header; doing so will return status code 400 (Bad Request).
x-ms-blob-sequence-number: <num> Facultatif, mais requis si la propriété x-ms-sequence-number-action est définie à max ou à update.Optional, but required if the x-ms-sequence-number-action property is set to max or update. Cette propriété s'applique uniquement aux objets blob de pages.This property applies to page blobs only.

Cette propriété définit le numéro de séquence de l'objet blob.This property sets the blob's sequence number. 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.The sequence number is a user-controlled property that you can use to track requests and manage concurrency issues. Pour plus d’informations, consultez l’opération put page .For more information, see the Put Page operation.

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.Use this property together with the x-ms-sequence-number-action to update the blob's sequence number, either to the specified value or to the higher of the values specified with the request or currently stored with the 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.This header should not be specified if x-ms-sequence-number-action is set to increment; in this case the service automatically increments the sequence number by one.

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.To set the sequence number to a value of your choosing, this property must be specified on the request together with x-ms-sequence-number-action.

En-têtes de demande (clés de chiffrement fournies par le client)Request Headers (Customer-provided encryption keys)

À partir de la version 2019-02-02, les en-têtes suivants peuvent être spécifiés sur la demande pour chiffrer un objet BLOB avec une clé fournie par le client.Beginning with version 2019-02-02, the following headers may be specified on the request to encrypt a blob with a customer-provided key. Le chiffrement avec une clé fournie par le client (et le jeu d’en-têtes correspondant) est facultatif.Encryption with a customer-provided key (and the corresponding set of headers) is optional. Si un objet BLOB a déjà été chiffré avec une clé fournie par le client, ces en-têtes doivent être inclus dans la demande pour que l’opération d’écriture soit effectuée avec succès.If a blob has previously been encrypted with a customer-provided key, then these headers must be included on the request to complete the write operation successfully.

En-tête de requêteRequest header DescriptionDescription
x-ms-encryption-key Obligatoire.Required. Clé de chiffrement AES-256 encodée en base64.The Base64-encoded AES-256 encryption key.
x-ms-encryption-key-sha256 Obligatoire.Required. Hachage SHA256 encodé en base64 de la clé de chiffrement.The Base64-encoded SHA256 hash of the encryption key.
x-ms-encryption-algorithm: AES256 Obligatoire.Required. Spécifie l’algorithme à utiliser pour le chiffrement.Specifies the algorithm to use for encryption. La valeur de cet en-tête doit être AES256 .The value of this header must be AES256.

Corps de la demandeRequest Body

Aucun.None.

responseResponse

La réponse inclut un code d'état HTTP et un ensemble d'en-têtes de réponse.The response includes an HTTP status code and a set of response headers.

Code d’étatStatus Code

Une opération réussie envoie le code d'état 200 (OK).A successful operation returns status code 200 (OK).

Pour plus d’informations sur les codes d’État, consultez codes d’État et d’erreur.For information about status codes, see Status and Error Codes.

En-têtes de réponseResponse Headers

La réponse de l'opération inclut les en-têtes suivants.The response for this operation includes the following headers. La réponse peut aussi inclure des en-têtes HTTP standard supplémentaires.The response may also include additional standard HTTP headers. Tous les en-têtes standard sont conformes à la spécification du protocole HTTP/1.1.All standard headers conform to the HTTP/1.1 protocol specification.

SyntaxeSyntax DescriptionDescription
ETag L'ETag contient une valeur que vous pouvez utiliser pour exécuter des opérations conditionnellement.The ETag contains a value that you can use to perform operations conditionally. Pour plus d’informations, consultez spécification d’en-têtes conditionnels pour les opérations de service BLOB .See Specifying Conditional Headers for Blob Service Operations for more information. Si la version de la demande est 18/08/2011 ou plus récente, la valeur de l'ETag sera entre guillemets.If the request version is 2011-08-18 or newer, the ETag value will be in quotes.
Last-Modified Date et heure de la dernière modification apportée à l'objet blob.The date/time that the blob was last modified. Le format de date est conforme à la RFC 1123.The date format follows RFC 1123. Pour plus d’informations, consultez représentation des valeurs de date et d’heure dans les en-têtes.For more information, see Representation of Date-Time Values in Headers.

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.Any write operation on the blob (including updates on the blob's metadata or properties) changes the last modified time of the 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.If the blob is a page blob, the blob's current sequence number is returned with this header.
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.This header uniquely identifies the request that was made and can be used for troubleshooting the request. Pour plus d’informations, consultez Troubleshooting API Operations.For more information, see Troubleshooting API Operations.
x-ms-version Indique la version du service BLOB utilisée pour exécuter la demande.Indicates the version of the Blob service used to execute the request. Cet en-tête est renvoyé pour les demandes effectuées avec la version 2009-09-19 ou une version ultérieure.This header is returned for requests made against version 2009-09-19 and later.
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.A UTC date/time value generated by the service that indicates the time at which the response was initiated.
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.Returned if the request includes an Origin header and CORS is enabled with a matching rule. Cet en-tête retourne la valeur de l'en-tête de demande d'origine en cas de correspondance.This header returns the value of the origin request header in case of a match.
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.Returned if the request includes an Origin header and CORS is enabled with a matching rule. Retourne la liste des en-têtes de réponse qui doivent être exposés au client ou à l'émetteur de la demande.Returns the list of response headers that are to be exposed to the client or issuer of the request.
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.Returned if the request includes an Origin header and CORS is enabled with a matching rule that does not allow all origins. Cet en-tête doit avoir la valeur True.This header will be set to true.
x-ms-client-request-id Cet en-tête peut être utilisé pour dépanner les demandes et les réponses correspondantes.This header can be used to troubleshoot requests and corresponding responses. La valeur de cet en-tête est égale à la valeur de l' x-ms-client-request-id en-tête si elle est présente dans la demande et que la valeur est supérieure à 1024 caractères ASCII visibles.The value of this header is equal to the value of the x-ms-client-request-id header if it is present in the request and the value is at most 1024 visible ASCII characters. Si l' x-ms-client-request-id en-tête n’est pas présent dans la demande, cet en-tête ne sera pas présent dans la réponse.If the x-ms-client-request-id header is not present in the request, this header will not be present in the response.

Corps de la réponseResponse Body

Aucun.None.

AutorisationAuthorization

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.This operation can only be called by the account owner and by anyone with a Shared Access Signature that has permission to write to this blob or its container.

RemarquesRemarks

La sémantique de mise à jour des propriétés d'un objet blob est la suivante :The semantics for updating a blob's properties are as follows:

  • 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 :A page blob's sequence number is updated only if the request meets either of the following conditions:

    • 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.The request sets the x-ms-sequence-number-action to max or update, and also specifies a value for the x-ms-blob-sequence-number header.

    • 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.The request sets the x-ms-sequence-number-action to increment, indicating that the service should increment the sequence number by one.

  • 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.A page blob's size is modified only if the request specifies a value for the x-ms-content-length header.

  • Pour modifier la taille d’un objet blob de pages dans un compte de stockage Premium, la nouvelle taille ne doit pas dépasser la longueur de contenu autorisée par le niveau existant.To change a page blob's size in a premium storage account, the new size must not exceed the content length allowed by the existing tier. Appelez Set Blob Tier avant de redimensionner l’objet BLOB.Call Set Blob Tier before resizing the blob. Pour obtenir la liste des niveaux et la longueur de contenu autorisée, consultez stockage Premium hautes performances et disques managés pour les machines virtuelles.For a list of tiers and allowed content length, see High-performance Premium Storage and managed disks for VMs.

  • 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.If a request sets only x-ms-blob-sequence-number and/or x-ms-content-length, and no other properties, then none of the blob's other properties are modified.

  • 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.If any one or more of the following properties is set in the request, then all of these properties are set together. 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.If a value is not provided for a given property when at least one of the properties listed below is set, then that property will be cleared for the 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

Notes

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é.Note that for a shared access signature, you can override certain properties stored for the blob by specifying query parameters as part of the shared access signature. Ces propriétés incluent cache-control, content-type, content-encoding, content-language et content-disposition.These properties include the cache-control, content-type, content-encoding, content-language, and content-disposition properties. Pour plus d’informations, consultez créer uneSAP de service.For more information, see Create a service SAS.

Voir aussiSee Also

Autoriser les demandes au stockage Azure Authorize requests to Azure Storage
Codes d’État et d’erreurStatus and Error Codes