Get BlobGet Blob

L'opération Get Blob lit ou télécharge un objet blob à partir du système, y compris ses métadonnées et propriétés.The Get Blob operation reads or downloads a blob from the system, including its metadata and properties. Vous pouvez également appeler Get Blob pour lire un instantané.You can also call Get Blob to read a snapshot.

RequêteRequest

La demande Get Blob peut être construite comme indiqué ci-dessous.The Get Blob 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 méthode GETGET Method Request URI Version HTTPHTTP Version
https://myaccount.blob.core.windows.net/mycontainer/myblob

https://myaccount.blob.core.windows.net/mycontainer/myblob?snapshot=<DateTime>

https://myaccount.blob.core.windows.net/mycontainer/myblob?versionid=<DateTime>

HTTP/1.0HTTP/1.0

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 méthode GETGET Method Request URI Version HTTPHTTP Version
http://127.0.0.1:10000/devstoreaccount1/mycontainer/myblob HTTP/1.0HTTP/1.0

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 d’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
snapshot facultatif.Optional. Le paramètre instantané est une valeur opaque DateTime qui, lorsqu'il est présent, spécifie l'instantané d'objets blob à récupérer.The snapshot parameter is an opaque DateTime value that, when present, specifies the blob snapshot to retrieve. Pour plus d’informations sur l’utilisation des instantanés d’objets BLOB, consultez création d’un instantané d’un objet BLOB.For more information on working with blob snapshots, see Creating a Snapshot of a Blob.
versionid Facultatif, version 2019-12-12 et ultérieure.Optional, version 2019-12-12 and newer. Le paramètre VersionId est une DateTime valeur opaque qui, lorsqu’elle est présente, spécifie la version de l’objet blob à récupérer.The versionid parameter is an opaque DateTime value that, when present, specifies the Version of the blob to retrieve.
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 requêteRequest Headers

Le tableau suivant décrit les en-têtes de demande obligatoires ou facultatifs.The following table describes required and optional request headers.

En-tête de requêteRequest 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, facultatif pour les demandes anonymes.Required for all authorized requests, optional for anonymous 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.
Range facultatif.Optional. Retournez uniquement les octets de l'objet blob dans la plage spécifiée.Return only the bytes of the blob in the specified range.
x-ms-range facultatif.Optional. Retournez uniquement les octets de l'objet blob dans la plage spécifiée.Return only the bytes of the blob in the specified range. Si Range et x-ms-range sont spécifiés, le service utilise la valeur de x-ms-range.If both Range and x-ms-range are specified, the service uses the value of x-ms-range. Si aucun n'est spécifié, l'intégralité du contenu de l'objet blob est retourné.If neither are specified, the entire blob contents are returned. Pour plus d’informations, consultez spécification de l’en-tête de plage pour les opérations de service BLOB .See Specifying the Range Header for Blob Service Operations for more information.
x-ms-lease-id: <ID> facultatif.Optional. Si cet en-tête est spécifié, l'opération sera exécutée uniquement si les deux conditions suivantes sont remplies :If this header is specified, the operation will be performed only if both of the following conditions are met:

-Le bail de l’objet blob est actuellement actif.- The blob's lease is currently active.
-L’ID de bail spécifié dans la demande correspond à celui de l’objet BLOB.- The lease ID specified in the request matches that of the blob.

Si cet en-tête est spécifié et que ces deux conditions ne sont pas remplies, la demande échoue et l'opération Get Blob échoue avec le code d'état 412 (Échec de la précondition).If this header is specified and both of these conditions are not met, the request will fail and the Get Blob operation will fail with status code 412 (Precondition Failed).
x-ms-range-get-content-md5: true facultatif.Optional. Lorsque cet en-tête a true la valeur et est spécifié avec l' Range en-tête, le service retourne le hachage MD5 pour la plage, tant que la taille de la plage est inférieure ou égale à 4 MIB.When this header is set to true and specified together with the Range header, the service returns the MD5 hash for the range, as long as the range is less than or equal to 4 MiB in size.

Si cet en-tête est spécifié sans l'en-tête Range, le service renvoie le code d'état 400 (Demande incorrecte).If this header is specified without the Range header, the service returns status code 400 (Bad Request).

Si cet en-tête est défini sur true lorsque la taille de la plage dépasse 4 MIB, le service retourne le code d’état 400 (demande incorrecte).If this header is set to true when the range exceeds 4 MiB in size, the service returns status code 400 (Bad Request).
x-ms-range-get-content-crc64: true facultatif.Optional. Lorsque cet en-tête a la valeur true et est spécifié avec l' Range en-tête, le service retourne le hachage CRC64 pour la plage, tant que la taille de la plage est inférieure ou égale à 4 MIB.When this header is set to true and specified together with the Range header, the service returns the CRC64 hash for the range, as long as the range is less than or equal to 4 MiB in size.

Si cet en-tête est spécifié sans l'en-tête Range, le service renvoie le code d'état 400 (Demande incorrecte).If this header is specified without the Range header, the service returns status code 400 (Bad Request).

Si cet en-tête est défini sur true lorsque la taille de la plage dépasse 4 MIB, le service retourne le code d’état 400 (demande incorrecte).If this header is set to true when the range exceeds 4 MiB in size, the service returns status code 400 (Bad Request).

Si les x-ms-range-get-content-md5 deux x-ms-range-get-content-crc64 en-têtes et sont présents, la demande échoue avec un 400 (demande incorrecte).If both x-ms-range-get-content-md5 and x-ms-range-get-content-crc64 headers are present, the request will fail with a 400 (Bad Request).

Cet en-tête est pris en charge dans les versions 2019-02-02 ou ultérieures.This header is supported in versions 2019-02-02 or later.
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 (CORS) dans la réponse.The presence of this header results in cross-origin resource sharing (CORS) headers on the response.
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.

Cette opération prend également en charge l'utilisation d'en-têtes conditionnels pour lire l'objet blob uniquement si une condition donnée est remplie.This operation also supports the use of conditional headers to read the blob 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 (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 de lecture d’un objet BLOB chiffré avec une clé fournie par le client.Beginning with version 2019-02-02, the following headers may be specified on the request to read a blob encrypted 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 terminer l’opération de lecture.If a blob has previously been encrypted with a customer-provided key, then these headers must be included on the request to complete the read 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 facultatif.Optional. 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 comprend un code d'état HTTP, un ensemble d'en-têtes de réponse et le corps de réponse qui contient le contenu de l'objet blob.The response includes an HTTP status code, a set of response headers, and the response body, which contains the contents of the blob.

Code d’étatStatus Code

Une opération ayant réussi pour lire l'objet blob complet retourne le code d'état 200 (OK).A successful operation to read the full blob returns status code 200 (OK).

Une opération ayant réussi pour lire une plage spécifiée retourne le code d'état 206 (Contenu partiel).A successful operation to read a specified range returns status code 206 (Partial Content).

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
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.

Toute opération qui modifie l'objet blob, notamment une mise à jour des métadonnées ou des propriétés de l'objet blob, modifie l'heure de la dernière modification de l'objet blob.Any operation that modifies the blob, including an update of the blob's metadata or properties, changes the last-modified time of the blob.
x-ms-creation-time Version 2017-11-09 et versions ultérieures.Version 2017-11-09 and newer. Date/heure de création de l’objet BLOB.The date/time at which the blob was created. Le format de date est conforme à la RFC 1123.The date format follows RFC 1123.
x-ms-meta-name:value Un ensemble de paires nom-valeur associées à cet objet blob en tant que métadonnées définies par l'utilisateur.A set of name-value pairs associated with this blob as user-defined metadata.
x-ms-tag-count Version 2019-12-12 ou ultérieure.Version 2019-12-12 or newer. Si l’objet BLOB a des balises, retourne le nombre de balises stockées sur l’objet BLOB.If the blob has any tags, returns the number of tags stored on the blob. Cet en-tête n’est pas retourné s’il n’existe aucune balise sur l’objet BLOB.This header is not returned if there are no tags on the blob.
Content-Length Le nombre d'octets présents dans le corps de la réponse.The number of bytes present in the response body.
Content-Type Type de contenu spécifié pour l’objet blob.The content type specified for the blob. Le type de contenu par défaut est application/octet-stream.The default content type is application/octet-stream.
Content-Range Indique la plage d'octets retournés au cas où le client demandait un sous-ensemble de l'objet blob en définissant l'en-tête de demande Range.Indicates the range of bytes returned in the event that the client requested a subset of the blob by setting the Range request header.
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.
Content-MD5 Si l'objet blob a un hachage MD5 et que cette opération Get Blob doit lire l'objet blob dans son entier, cet en-tête de réponse est retourné afin que le client puisse vérifier l'intégrité du contenu du message.If the blob has an MD5 hash and this Get Blob operation is to read the full blob, this response header is returned so that the client can check for message content integrity.

À partir de la version du 12/02/2012, Put Blob définit une valeur de hachage MD5 de l'objet blob de blocs même si la demande Put Blob n'inclut pas d'en-tête MD5.In version 2012-02-12 and newer, Put Blob sets a block blob’s MD5 hash value even when the Put Blob request doesn’t include an MD5 header.

Si la demande doit lire une plage spécifiée et que x-ms-range-get-content-md5 a la valeur true , la requête retourne un hachage MD5 pour la plage, tant que la taille de la plage est inférieure ou égale à 4 MIB.If the request is to read a specified range and the x-ms-range-get-content-md5 is set to true, then the request returns an MD5 hash for the range, as long as the range size is less than or equal to 4 MiB.

Si aucun de ces ensembles de conditions n'est vrai, alors aucune valeur n'est renvoyée pour l'en-tête Content-MD5.If neither of these sets of conditions is true, then no value is returned for the Content-MD5 header.

Si x-ms-range-get-content-md5 est spécifié sans l'en-tête Range, le service retourne le code d'état 400 (Demande incorrecte).If x-ms-range-get-content-md5 is specified without the Range header, the service returns status code 400 (Bad Request).

Si x-ms-range-get-content-md5 a la valeur true lorsque la taille de la plage dépasse 4 MIB, le service retourne le code d’état 400 (demande incorrecte).If x-ms-range-get-content-md5 is set to true when the range exceeds 4 MiB in size, the service returns status code 400 (Bad Request).
x-ms-content-crc64 Si la demande doit lire une plage spécifiée et que x-ms-range-get-content-crc64 a la valeur true , la requête retourne un hachage CRC64 pour la plage, tant que la taille de la plage est inférieure ou égale à 4 MIB.If the request is to read a specified range and the x-ms-range-get-content-crc64 is set to true, then the request returns an CRC64 hash for the range, as long as the range size is less than or equal to 4 MiB.

Si x-ms-range-get-content-crc64 est spécifié sans l'en-tête Range, le service retourne le code d'état 400 (Demande incorrecte).If x-ms-range-get-content-crc64 is specified without the Range header, the service returns status code 400 (Bad Request).

Si x-ms-range-get-content-crc64 a la valeur true lorsque la taille de la plage dépasse 4 MIB, le service retourne le code d’état 400 (demande incorrecte).If x-ms-range-get-content-crc64 is set to true when the range exceeds 4 MiB in size, the service returns status code 400 (Bad Request).
Content-Encoding Cet en-tête renvoie la valeur qui a été spécifiée pour l'en-tête de demande Content-Encoding.This header returns the value that was specified for the Content-Encoding request header.
Content-Language Cet en-tête renvoie la valeur qui a été spécifiée pour l'en-tête de demande Content-Language.This header returns the value that was specified for the Content-Language request header.
Cache-Control Cet en-tête est retourné s'il a été précédemment spécifié pour l'objet blob.This header is returned if it was previously specified for the blob.
Content-Disposition Retourné pour les demandes effectuées avec la version du 15/08/2013 ou les versions ultérieures.Returned for requests against version 2013-08-15 and later. Cet en-tête retourne la valeur qui a été spécifiée pour l'en-tête x-ms-blob-content-disposition.This header returns the value that was specified for the x-ms-blob-content-disposition header.

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.
x-ms-blob-sequence-number Le numéro de séquence actuel d'un objet blob de pages.The current sequence number for a page blob.

Cet en-tête n’est pas retourné pour les objets BLOB de blocs ou d’ajout.This header is not returned for block blobs or append blobs.
x-ms-blob-type: <BlockBlob | PageBlob | AppendBlob> Retourne le type de l'objet blob.Returns the blob's type.
x-ms-copy-completion-time: <datetime> Version du 12.02.12 et ultérieure.Version 2012-02-12 and newer. L'heure de conclusion de la dernière tentative d'opération Copy Blob où cet objet blob était l'objet blob de destination.Conclusion time of the last attempted Copy Blob operation where this blob was the destination blob. Cette valeur peut spécifier l'heure d'une tentative de copie qui s'est terminée, qui a été annulée ou qui a échoué.This value can specify the time of a completed, aborted, or failed copy attempt. Cet en-tête n'apparaît pas si une copie est en attente, si cet objet blob n'a jamais été la destination dans une opération Copy Blob, ou si cet objet blob a été modifié après une opération Copy Blob terminée avec Set Blob Properties, Put Blob ou Put Block List.This header does not appear if a copy is pending, if this blob has never been the destination in a Copy Blob operation, or if this blob has been modified after a concluded Copy Blob operation using Set Blob Properties, Put Blob, or Put Block List.
x-ms-copy-status-description: <error string> Version du 12.02.12 et ultérieure.Version 2012-02-12 and newer. Apparaît uniquement lorsque x-ms-copy-status est failed ou pending.Only appears when x-ms-copy-status is failed or pending. Décrit la cause du dernier échec de l'opération de copie irrécupérable ou non.Describes the cause of the last fatal or non-fatal copy operation failure. Cet en-tête n'apparaît pas si cet objet blob n'a jamais été la destination dans une opération Copy Blob, ou si cet objet blob a été modifié après une opération Copy Blob avec Set Blob Properties, Put Blob ou Put Block List.This header does not appear if this blob has never been the destination in a Copy Blob operation, or if this blob has been modified after a concluded Copy Blob operation using Set Blob Properties, Put Blob, or Put Block List.
x-ms-copy-id: <id> Version du 12.02.12 et ultérieure.Version 2012-02-12 and newer. Identificateur de chaîne pour la dernière tentative de l'opération Copy Blob où cet objet blob était l'objet blob de destination.String identifier for the last attempted Copy Blob operation where this blob was the destination blob. Cet en-tête n'apparaît pas si cet objet blob n'a jamais été la destination dans une opération Copy Blob, ou si cet objet blob a été modifié après une opération Copy Blob avec Set Blob Properties, Put Blob ou Put Block List.This header does not appear if this blob has never been the destination in a Copy Blob operation, or if this blob has been modified after a concluded Copy Blob operation using Set Blob Properties, Put Blob, or Put Block List.
x-ms-copy-progress: <bytes copied/bytes total> Version du 12.02.12 et ultérieure.Version 2012-02-12 and newer. Contient le nombre d'octets copiés et le nombre d'octets total dans la source de la dernière tentative d'opération Copy Blob où cet objet blob était l'objet blob de destination.Contains the number of bytes copied and the total bytes in the source in the last attempted Copy Blob operation where this blob was the destination blob. Peut afficher entre 0 et Content-Length octets copiés.Can show between 0 and Content-Length bytes copied. Cet en-tête n'apparaît pas si cet objet blob n'a jamais été la destination dans une opération Copy Blob, ou si cet objet blob a été modifié après une opération Copy Blob avec Set Blob Properties, Put Blob ou Put Block List.This header does not appear if this blob has never been the destination in a Copy Blob operation, or if this blob has been modified after a concluded Copy Blob operation using Set Blob Properties, Put Blob, or Put Block List.
x-ms-copy-source: url Version du 12.02.12 et ultérieure.Version 2012-02-12 and newer. URL d’une longueur maximale de 2 Kio qui spécifie le fichier ou l’objet BLOB source utilisé lors de la dernière tentative d' Copy Blob opération où cet objet BLOB était l’objet blob de destination.URL up to 2 KiB in length that specifies the source blob or file used in the last attempted Copy Blob operation where this blob was the destination blob. Cet en-tête n'apparaît pas si cet objet blob n'a jamais été la destination dans une opération Copy Blob, ou si cet objet blob a été modifié après une opération Copy Blob avec Set Blob Properties, Put Blob ou Put Block List.This header does not appear if this blob has never been the destination in a Copy Blob operation, or if this blob has been modified after a concluded Copy Blob operation using Set Blob Properties, Put Blob, or Put Block List.

L’URL retournée dans cet en-tête contient tous les paramètres de requête utilisés dans l’opération de copie sur l’objet BLOB source, y compris le jeton SAP utilisé pour accéder à l’objet BLOB source.The URL returned in this header contains any request parameters used in the copy operation on the source blob, including the SAS token used to access the source blob.
x-ms-copy-status: <pending | success | aborted | failed> Version du 12.02.12 et ultérieure.Version 2012-02-12 and newer. L'état de l'opération de copie identifié par x-ms-copy-id, avec les valeurs :State of the copy operation identified by x-ms-copy-id, with these values:

- success: La copie s’est terminée correctement.- success: Copy completed successfully.
- pending: La copie est en cours.- pending: Copy is in progress. Vérifiez si x-ms-copy-status-description est intermittent, les erreurs récupérables ralentissent la progression de la copie mais ne provoquent pas de défaillance.Check x-ms-copy-status-description if intermittent, non-fatal errors slow copy progress but don’t cause failure.
- aborted: La copie a été terminée par Abort Copy Blob .- aborted: Copy was ended by Abort Copy Blob.
- failed: Échec de la copie.- failed: Copy failed. Consultez x-ms-copy-status-description pour les détails de l'échec.See x-ms-copy-status-description for failure details.

Cet en-tête n'apparaît pas si cet objet blob n'a jamais été la destination dans une opération Copy Blob, ou si cet objet blob a été modifié après une opération Copy Blob avec Set Blob Properties, Put Blob ou Put Block List.This header does not appear if this blob has never been the destination in a Copy Blob operation, or if this blob has been modified after a completed Copy Blob operation using Set Blob Properties, Put Blob, or Put Block List.
x-ms-lease-duration: <infinite | fixed> Version du 12.02.12 et ultérieure.Version 2012-02-12 and newer. Quand un objet blob est loué, spécifie si le bail est d'une durée illimitée ou fixe.When a blob is leased, specifies whether the lease is of infinite or fixed duration.
x-ms-lease-state: <available | leased | expired | breaking | broken> Version du 12.02.12 et ultérieure.Version 2012-02-12 and newer. État du bail de l'objet blob.Lease state of the blob.
x-ms-lease-status:<locked | unlocked> L'état de bail actuel de l'objet blob.The current lease status of the blob.
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. Inclus pour les demandes qui utilisent la version du 19.09.09 et les versions ultérieures.Included for requests made using version 2009-09-19 and newer.

Cet en-tête est également retourné pour les demandes anonymes sans version spécifiée si le conteneur était marqué pour un accès public à l'aide de la version du 19/09/2009 du service BLOB.This header is also returned for anonymous requests without a version specified if the container was marked for public access using the 2009-09-19 version of the Blob service.
Accept-Ranges: bytes Indique que le service prend en charge les demandes pour le contenu partiel d'objets blob.Indicates that the service supports requests for partial blob content. Inclus pour les demandes effectuées à l'aide de la version du 18/08/2011 et versions ultérieures et pour le service de stockage local dans le Kit de développement logiciel (SDK) 1.6 ou ultérieur.Included for requests made using version 2011-08-18 and newer, and for the local storage service in SDK version 1.6 or newer.
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.
Vary Retourné avec la valeur de l'en-tête Origin lorsque des règles CORS sont spécifiées.Returned with the value of the Origin header when CORS rules are specified. Pour plus d’informations, consultez prise en charge de cors pour les services de stockage .See CORS Support for the Storage Services for details.
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 doesn’t allow all origins. Cet en-tête doit avoir la valeur True.This header will be set to true.
x-ms-blob-committed-block-count Nombre de blocs validés présents dans l’objet BLOB.The number of committed blocks present in the blob. Cet en-tête est retourné uniquement pour les objets BLOB d’ajout.This header is returned only for append blobs.
x-ms-server-encrypted: true/false Version 2015-12-11 ou ultérieure.Version 2015-12-11 or newer. La valeur de cet en-tête est définie sur true si les données BLOB et les métadonnées d’application sont entièrement chiffrées à l’aide de l’algorithme spécifié.The value of this header is set to true if the blob data and application metadata are completely encrypted using the specified algorithm. Dans le cas contraire, la valeur est définie sur false (lorsque l’objet BLOB n’est pas chiffré, ou si seules les parties des métadonnées de l’objet blob/de l’application sont chiffrées).Otherwise, the value is set to false (when the blob is unencrypted, or if only parts of the blob/application metadata are encrypted).
x-ms-encryption-key-sha256 Version 2019-02-02 ou ultérieure.Version 2019-02-02 or newer. Cet en-tête est retourné si l’objet blob est chiffré avec une clé fournie par le client.This header is returned if the blob is encrypted with a customer-provided key.
x-ms-encryption-scope Version 2019-02-02 ou ultérieure.Version 2019-02-02 or newer. Cet en-tête est retourné si l’objet blob est chiffré avec une étendue de chiffrement.This header is returned if the blob is encrypted with an encryption scope.
x-ms-blob-content-md5 À partir de la version 2016-05-31, si l’objet BLOB a un hachage MD5 et si la requête contient un en-tête de plage (Range ou x-ms-Range), cet en-tête de réponse est retourné avec la valeur de la valeur MD5 de l’objet BLOB entier.Starting from version 2016-05-31, if the blob has a MD5 hash, and if request contains range header (Range or x-ms-range), this response header is returned with the value of the whole blob’s MD5 value. Cette valeur peut ou ne peut pas être égale à la valeur retournée dans l’en-tête Content-MD5, le dernier étant calculé à partir de la plage demandée.This value may or may not be equal to the value returned in Content-MD5 header, with the latter calculated from the requested range.
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.
x-ms-last-access-time Version 2020-02-10 ou ultérieure.Version 2020-02-10 or newer. Indique l’heure de la dernière tentative d’accès aux données de l’objet BLOB en fonction de la stratégie de suivi de la dernière heure d’accès du compte de stockage.Indicates the last time when the blob's data was accessed based on the storage account's last access time tracking policy. L’en-tête ne sera pas retourné si le compte de stockage n’a pas de stratégie de suivi de la dernière heure d’accès ou si la stratégie est désactivée.The header will not be returned if the storage account does not have a last access time tracking policy, or the policy is disabled. Pour plus d’informations sur la définition de la stratégie de suivi de la dernière heure d’accès du compte de stockage, consultez API du service BLOB.For information about setting the storage account's last access time tracking policy, see Blob Service API.

Corps de la réponseResponse Body

Le corps de la réponse contient le contenu de l'objet blob.The response body contains the content of the blob.

Exemple de réponseSample Response

Status Response:  
HTTP/1.1 200 OK  
  
Response Headers:  
x-ms-blob-type: BlockBlob  
x-ms-lease-status: unlocked  
x-ms-lease-state: available  
x-ms-meta-m1: v1  
x-ms-meta-m2: v2  
Content-Length: 11  
Content-Type: text/plain; charset=UTF-8  
Date: <date>  
ETag: "0x8CB171DBEAD6A6B"  
Vary: Origin  
Last-Modified: <date>  
x-ms-version: 2015-02-21  
Server: Windows-Azure-Blob/1.0 Microsoft-HTTPAPI/2.0  
x-ms-copy-id: 36650d67-05c9-4a24-9a7d-a2213e53caf6  
x-ms-copy-source: <url>  
x-ms-copy-status: success  
x-ms-copy-progress: 11/11  
x-ms-copy-completion-time: <date>  
  

AutorisationAuthorization

Si la liste de contrôle d'accès (ACL) du conteneur autorise l'accès anonyme à l'objet blob, n'importe quel client peut appeler cette opération.If the container's access control list (ACL) is set to allow anonymous access to the blob, any client may call this operation. Si le conteneur est privé, cette opération peut être exécutée par le propriétaire du compte et par toute personne qui dispose d'une signature d'accès partagé qui a l'autorisation de lire l'objet blob.If the container is private, this operation can be performed by the account owner and by anyone with a Shared Access Signature that has permission to read the blob.

RemarquesRemarks

Pour un objet blob de pages, une opération Get Blob sur une plage de pages qui n'a pas encore de contenu ou qui a été vidée, retourne des zéros pour ces octets.For a page blob, a Get Blob operation over a range of pages that do not yet have content or that have been cleared returns zeros for those bytes.

Si vous appelez Get Blob sur un objet blob de pages sans plage spécifiée, le service retourne la plage des pages jusqu'à la valeur spécifiée pour l'en-tête x-ms-blob-content-length.If you call Get Blob on a page blob with no range specified, the service returns the range of pages up to the value specified for the x-ms-blob-content-length header. Pour toutes les pages qui n'ont pas de contenu, le service retourne des zéros pour ces octets.For any pages lacking content, the service returns zeros for those bytes.

Pour un objet blob d’ajout, l' Get Blob opération retourne l' x-ms-blob-committed-block-count en-tête.For an append blob, the Get Blob operation returns x-ms-blob-committed-block-count header. Cet en-tête indique le nombre de blocs validés dans l’objet BLOB.This header indicates the number of committed blocks in the blob. L' x-ms-blob-committed-block-count en-tête n’est pas retourné pour les objets BLOB de blocs ou de pages.The x-ms-blob-committed-block-count header is not returned for block blobs or page blobs.

Une Get Blob opération est autorisée 2 minutes par MIB à se terminer.A Get Blob operation is allowed 2 minutes per MiB to complete. Si l’opération prend plus de 2 minutes par MiB en moyenne, l’opération expire.If the operation is taking longer than 2 minutes per MiB on average, the operation will time out.

L'en-tête x-ms-version est requis pour récupérer un objet blob qui appartient à un conteneur privé.The x-ms-version header is required to retrieve a blob that belongs to a private container. Si l'objet blob appartient à un conteneur qui est disponible pour un accès public complet ou partiel, n'importe quel client peut le lire sans spécifier une version ; la version du service n'est pas obligatoire pour récupérer un objet blob qui appartient à un conteneur public.If the blob belongs to a container that is available for full or partial public access, any client can read it without specifying a version; the service version is not required for retrieving a blob that belongs to a public container. Pour plus d’informations, consultez la page Limiter l’accès aux conteneurs et aux objets BLOB .See Restrict Access to Containers and Blobs for more information.

Un Get Blob sur un objet blob de blocs archivé échoue.A Get Blob on an archived block blob will fail.

Opérations de copieCopy operations

Pour déterminer si une opération Copy Blob est terminée, vérifiez que la valeur d'en-tête x-ms-copy-id de l'objet blob de destination correspond à l'ID de copie fournie par l'appel d'origine à Copy Blob.To determine if a Copy Blob operation has completed, first check that the x-ms-copy-id header value of the destination blob matches the copy ID provided by the original call to Copy Blob. Une correspondance garantit qu'une autre application n'a pas annulé la copie et n'a pas démarré une nouvelle opération Copy Blob.A match assures that another application did not abort the copy and start a new Copy Blob operation. Contrôlez ensuite l'en-tête x-ms-copy-status: success.Then check for the x-ms-copy-status: success header. Toutefois, n'oubliez pas que toutes les opérations d'écriture dans un objet blob à l'exception des opérations Lease, Put Page et Put Block suppriment toutes les propriétés x-ms-copy-* de l'objet blob.However, be aware that all write operations on a blob except Lease, Put Page and Put Block operations remove all x-ms-copy-* properties from the blob. Ces propriétés ne sont également pas copiées par les opérations Copy Blob qui utilisent des versions - antérieures au 12/02/2012.These properties are also not copied by Copy Blob operations that use versions before 2012-02-12.

Avertissement

L’URL retournée dans l' x-ms-copy-source en-tête contient tous les paramètres de requête utilisés dans l’opération de copie sur l’objet BLOB source.The URL returned in the x-ms-copy-source header contains any request parameters used in the copy operation on the source blob. Si un jeton SAP est utilisé pour accéder à l’objet BLOB source, ce jeton SAP s’affiche dans l' x-ms-copy-source en-tête lorsque Get Blob est appelé sur l’objet blob de destination.If a SAS token is used to access the source blob, then that SAS token will appear in the the x-ms-copy-source header when Get Blob is called on the destination blob.

Lorsque x-ms-copy-status: failed s'affiche dans la réponse, x-ms-copy-status-description contient plus d'informations sur l'échec Copy Blob.When x-ms-copy-status: failed appears in the response, x-ms-copy-status-description contains more information about the Copy Blob failure.

Le tableau suivant décrit les trois champs de chaque valeur x-ms-copy-status-description.The following table describes the three fields of every x-ms-copy-status-description value.

ComposantComponent DescriptionDescription
Code d'état HTTPHTTP status code Entier de 3chiffres standard indiquant la défaillance.Standard 3-digit integer specifying the failure.
Code d'erreurError code Mot clé décrivant l’erreur fournie par Azure dans l’élément <ErrorCode > .Keyword describing error that is provided by Azure in the <ErrorCode> element. Si aucun <élément ErrorCode n' > apparaît, un mot clé contenant le texte d’erreur standard associé au code d’État http à 3 chiffres dans la spécification http est utilisé.If no <ErrorCode> element appears, a keyword containing standard error text associated with the 3-digit HTTP status code in the HTTP specification is used. Consultez codes d’erreur de l’API REST courantes.See Common REST API Error Codes.
InformationInformation Description détaillée de l'échec, entre guillemets.Detailed description of failure, in quotes.

Le tableau suivant décrit les valeurs x-ms-copy-status et x-ms-copy-status-description des scénarios d'échec courants.The following table describes the x-ms-copy-status and x-ms-copy-status-description values of common failure scenarios.

Important

Le texte de description indiqué ici peut changer sans avertissement, même sans modification de version, il peut donc ne pas être exactement identique.Description text shown here can change without warning, even without a version change, so do not rely on matching this exact text.

ScénarioScenario Valeur x-ms-copy-statusx-ms-copy-status value Valeur x-ms-copy-status-descriptionx-ms-copy-status-description value
L'opération de copie s'est terminée avec succès.Copy operation completed successfully. successsuccess emptyempty
Opération de copie abandonnée par l'utilisateur avant qu'elle se soit terminée.User aborted copy operation before it completed. abortedaborted emptyempty
Une défaillance s'est produite lors de la lecture de l'objet blob source pendant une opération de copie, mais l'opération sera réessayée.A failure occurred when reading from the source blob during a copy operation, but the operation will be retried. en attentepending 502 BadGateway « Erreur autorisant une nouvelle tentative lors de la lecture de la source.502 BadGateway "Encountered a retryable error when reading the source. Nouvelle tentative.Will retry. Heure de la défaillance : <heure > »Time of failure: <time>"
Une défaillance s'est produite lors de la lecture de l'objet blob de destination d'une opération de copie, mais l'opération sera réessayée.A failure occurred when writing to the destination blob of a copy operation, but the operation will be retried. en attentepending 500 InternalServerError « Erreur autorisant une nouvelle tentative.500 InternalServerError "Encountered a retryable error. Nouvelle tentative.Will retry. Heure de la défaillance : <heure > »Time of failure: <time>"
Une défaillance irrécupérable s'est produite lors de la lecture de l'objet blob source d'une opération de copie.An unrecoverable failure occurred when reading from the source blob of a copy operation. échecfailed 404 ResourceNotFound « échec de la copie lors de la lecture de la source. »404 ResourceNotFound "Copy failed when reading the source."

Remarque : Pour signaler cette erreur sous-jacente, Azure retourne ResourceNotFound dans l' ErrorCode élément.Note: When reporting this underlying error, Azure returns ResourceNotFound in the ErrorCode element. Si aucun ErrorCode élément n’apparaît dans la réponse, une représentation sous forme de chaîne standard de l’État http tel que NotFound s’affiche.If no ErrorCode element appeared in the response, a standard string representation of the HTTP status such as NotFound would appear.
Le délai d'expiration limitant toutes les opérations de copie s'est écoulé.The timeout period limiting all copy operations elapsed. (Actuellement le délai d'expiration est de 2 semaines.)(Currently the timeout period is 2 weeks.) échecfailed 500 OperationCancelled « La copie a dépassé le temps maximal alloué. »500 OperationCancelled "The copy exceeded the maximum allowed time."
L'opération de copie a échoué trop souvent lors de la lecture de la source, et n'a pas atteint un ratio minimum de tentatives de succès.The copy operation failed too often when reading from the source, and didn’t meet a minimum ratio of attempts to successes. (Ce délai d'expiration a empêché une nouvelle tentative d'une source de mauvaise qualité pendant 2 semaines avant d'échouer).(This timeout prevents retrying a very poor source over 2 weeks before failing). échecfailed 500 OperationCancelled « La copie a échoué lors de la lecture de la source. »500 OperationCancelled "The copy failed when reading the source."

x-ms-last-access-time effectue le suivi de l’accès aux données de l’objet BLOB en fonction de la stratégie de suivi de la dernière heure d’accès du compte de stockage.x-ms-last-access-time tracks the time when the blob's data was accessed based on the storage account's last access time tracking policy. L’accès aux métadonnées d’un objet BLOB ne modifie pas son dernier temps d’accès.Accessing a blob's metadata does not change its last access time.

Voir aussiSee also

Autoriser les demandes au stockage Azure Authorize requests to Azure Storage
Codes d’État et d’erreur Status and Error Codes
Codes d’erreur du service BLOB Blob Service Error Codes
Définition de délais d'expiration pour les opérations du service BLOBSetting Timeouts for Blob Service Operations