Get 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. Vous pouvez également appeler Get Blob pour lire un instantané.

Requête

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

URI de demande de méthode GET Version HTTP
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.0

HTTP/1.1

URI du service de stockage émulé

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 méthode GET Version HTTP
http://127.0.0.1:10000/devstoreaccount1/mycontainer/myblob HTTP/1.0

HTTP/1.1

pour plus d’informations, consultez utilisation du Emulator stockage Azure pour le développement et le test.

Paramètres d’URI

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

Paramètre Description
snapshot facultatif. 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. Pour plus d’informations sur l’utilisation des instantanés d’objets BLOB, consultez création d’un instantané d’un objet BLOB.
versionid Facultatif, version 2019-12-12 et ultérieure. 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.
timeout Facultatif. Le paramètre timeout est exprimé en secondes. Pour plus d’informations, consultez définition de délais d’attente pour les opérations de service BLOB.

En-têtes de requête

Le tableau suivant décrit les en-têtes de demande obligatoires ou facultatifs.

En-tête de requête Description
Authorization Obligatoire. Spécifie le schéma d’autorisation, le nom de compte et la signature. pour plus d’informations, consultez autoriser les demandes à stockage Azure.
Date ou x-ms-date Obligatoire. Spécifie la date/heure en temps universel coordonné (UTC) pour la requête. pour plus d’informations, consultez autoriser les demandes à stockage Azure.
x-ms-version Obligatoire pour toutes les demandes autorisées, facultatif pour les demandes anonymes. Spécifie la version de l'opération à utiliser pour cette demande. pour plus d’informations, consultez contrôle de version pour les Services stockage Azure.
Range Facultatif. Retournez uniquement les octets de l'objet blob dans la plage spécifiée.
x-ms-range Facultatif. Retournez uniquement les octets de l'objet blob dans la plage spécifiée. Si Range et x-ms-range sont spécifiés, le service utilise la valeur de x-ms-range. Si aucun n'est spécifié, l'intégralité du contenu de l'objet blob est retourné. Pour plus d’informations, consultez spécification de l’en-tête de plage pour les opérations de service BLOB .
x-ms-lease-id: <ID> Facultatif. Si cet en-tête est spécifié, l'opération sera exécutée uniquement si les deux conditions suivantes sont remplies :

-Le bail de l’objet blob est actuellement actif.
-L’ID de bail spécifié dans la demande correspond à celui de l’objet 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).
x-ms-range-get-content-md5: true Facultatif. 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.

Si cet en-tête est spécifié sans l'en-tête Range, le service renvoie le code d'état 400 (Demande incorrecte).

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).
x-ms-range-get-content-crc64: true Facultatif. 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.

Si cet en-tête est spécifié sans l'en-tête Range, le service renvoie le code d'état 400 (Demande incorrecte).

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

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

Cet en-tête est pris en charge dans les versions 2019-02-02 ou ultérieures.
Origin 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 (CORS) dans la réponse.
x-ms-client-request-id Facultatif. 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. 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. 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.

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. Pour plus d’informations, consultez Spécification des en-têtes conditionnels pour les opérations du service Blob.

En-têtes de demande (clés de chiffrement fournies par le client)

À 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. Le chiffrement avec une clé fournie par le client (et le jeu d’en-têtes correspondant) est facultatif. 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.

En-tête de requête Description
x-ms-encryption-key Obligatoire. Clé de chiffrement AES-256 encodée en base64.
x-ms-encryption-key-sha256 Facultatif. Hachage SHA256 encodé en base64 de la clé de chiffrement.
x-ms-encryption-algorithm: AES256 Obligatoire. Spécifie l’algorithme à utiliser pour le chiffrement. La valeur de cet en-tête doit être définie AES256.

Corps de la demande

Aucun.

Réponse

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.

Code d’état

Une opération ayant réussi pour lire l'objet blob complet retourne le code d'état 200 (OK).

Une opération ayant réussi pour lire une plage spécifiée retourne le code d'état 206 (Contenu partiel).

Pour plus d’informations sur les codes d’État, consultez codes d’État et d’erreur.

En-têtes de réponse

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
Last-Modified Date et heure de la dernière modification apportée à l'objet blob. Le format de date est conforme à la 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.
x-ms-creation-time Version 2017-11-09 et versions ultérieures. Date/heure de création de l’objet BLOB. Le format de date est conforme à la 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.
x-ms-tag-count Version 2019-12-12 ou ultérieure. Si l’objet BLOB a des balises, retourne le nombre de balises stockées sur l’objet BLOB. Cet en-tête n’est pas retourné s’il n’existe aucune balise sur l’objet BLOB.
Content-Length Le nombre d'octets présents dans le corps de la réponse.
Content-Type Type de contenu spécifié pour l’objet blob. Le type de contenu par défaut est 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.
ETag L'ETag contient une valeur que vous pouvez utiliser pour exécuter des opérations conditionnellement. Pour plus d’informations, consultez spécification d’en-têtes conditionnels pour les opérations de service BLOB . Si la version de la demande est 18/08/2011 ou plus récente, la valeur de l'ETag sera entre guillemets.
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.

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

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.

Si aucun de ces ensembles de conditions n'est vrai, alors aucune valeur n'est renvoyée pour l'en-tête Content-MD5.

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

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

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

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).
Content-Encoding Cet en-tête renvoie la valeur qui a été spécifiée pour l'en-tête de demande Content-Encoding.
Content-Language Cet en-tête renvoie la valeur qui a été spécifiée pour l'en-tête de demande Content-Language.
Cache-Control Cet en-tête est retourné s'il a été précédemment spécifié pour l'objet blob.
Content-Disposition Retourné pour les demandes effectuées avec la version du 15/08/2013 ou les versions ultérieures. Cet en-tête retourne la valeur qui a été spécifiée pour l'en-tête x-ms-blob-content-disposition.

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

Cet en-tête n’est pas retourné pour les objets BLOB de blocs ou d’ajout.
x-ms-blob-type: <BlockBlob | PageBlob | AppendBlob> Retourne le type de l'objet blob.
x-ms-copy-completion-time: <datetime> Version du 12.02.12 et ultérieure. L'heure de conclusion de la dernière tentative d'opération Copy Blob où cet objet blob était l'objet blob de destination. 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é. 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.
x-ms-copy-status-description: <error string> Version du 12.02.12 et ultérieure. Apparaît uniquement lorsque x-ms-copy-status est failed ou pending. Décrit la cause du dernier échec de l'opération de copie irrécupérable ou non. 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.
x-ms-copy-id: <id> Version du 12.02.12 et ultérieure. 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. 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.
x-ms-copy-progress: <bytes copied/bytes total> Version du 12.02.12 et ultérieure. 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. Peut afficher entre 0 et Content-Length octets copiés. 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.
x-ms-copy-source: url Version du 12.02.12 et ultérieure. 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. 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.

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.
x-ms-copy-status: <pending | success | aborted | failed> Version du 12.02.12 et ultérieure. L'état de l'opération de copie identifié par x-ms-copy-id, avec les valeurs :

- success: La copie s’est terminée correctement.
- pending: La copie est en cours. 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.
- aborted: La copie a été terminée par Abort Copy Blob .
- failed: Échec de la copie. Consultez x-ms-copy-status-description pour les détails de l'échec.

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.
x-ms-lease-duration: <infinite | fixed> Version du 12.02.12 et ultérieure. Quand un objet blob est loué, spécifie si le bail est d'une durée illimitée ou fixe.
x-ms-lease-state: <available | leased | expired | breaking | broken> Version du 12.02.12 et ultérieure. État du bail de l'objet blob.
x-ms-lease-status:<locked | unlocked> L'état de bail actuel de l'objet 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. Pour plus d’informations, consultez Troubleshooting API Operations.
x-ms-version Indique la version du service BLOB utilisée pour exécuter la demande. Inclus pour les demandes qui utilisent la version du 19.09.09 et les versions ultérieures.

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.
Accept-Ranges: bytes Indique que le service prend en charge les demandes pour le contenu partiel d'objets blob. 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.
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.
Vary Retourné avec la valeur de l'en-tête Origin lorsque des règles CORS sont spécifiées. pour plus d’informations, consultez prise en charge de CORS pour les Services Stockage .
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.
x-ms-blob-committed-block-count Nombre de blocs validés présents dans l’objet BLOB. Cet en-tête est retourné uniquement pour les objets BLOB d’ajout.
x-ms-server-encrypted: true/false Version 2015-12-11 ou ultérieure. 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é. 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).
x-ms-encryption-key-sha256 Version 2019-02-02 ou ultérieure. Cet en-tête est retourné si l’objet blob est chiffré avec une clé fournie par le client.
x-ms-encryption-scope Version 2019-02-02 ou ultérieure. Cet en-tête est retourné si l’objet blob est chiffré avec une étendue de chiffrement.
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. 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.
x-ms-client-request-id Cet en-tête peut être utilisé pour dépanner les demandes et les réponses correspondantes. 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. 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.
x-ms-last-access-time Version 2020-02-10 ou ultérieure. 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. 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. 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.
x-ms-blob-sealed Version 2019-12-12 ou ultérieure, retourné uniquement pour les objets BLOB d’ajout. Si l’objet blob d’ajout a été sealed, la valeur est true, consultez sceller ajouter des objets BLOB
x-ms-immutability-policy-until-date Version 2020-06-12 ou ultérieure. Spécifie la date de rétention jusqu’à ce qu’elle soit définie sur l’objet BLOB. Il s’agit de la date jusqu’à laquelle la protection de l’objet BLOB peut être modifiée ou supprimée. Retourné uniquement si une stratégie d’immuabilité est définie sur l’objet BLOB. La valeur de cet en-tête est le format RFC1123.
x-ms-immutability-policy-mode: unlocked/locked Version 2020-06-12 ou ultérieure. Le mode de stratégie d’immuabilité, retourné si une stratégie d’immuabilité est définie sur l’objet BLOB. Les valeurs sont unlocked / locked . unlocked indique que l’utilisateur peut modifier la stratégie en accroissant ou en diminuant la date de rétention jusqu’à la date. locked indique que ces actions sont interdites.
x-ms-legal-hold: true/false Version 2020-06-12 ou ultérieure. Cet en-tête n’est pas renvoyé s’il n’y a pas de conservation légale sur l’objet BLOB. La valeur de cet en-tête est définie sur true si l’objet BLOB contient un holding légal et que sa valeur est true. Dans le cas contraire, la valeur est définie sur false si l’objet BLOB contient un holding légal et sa valeur false.

Corps de la réponse

Le corps de la réponse contient le contenu de l'objet blob.

Exemple de réponse

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>  
  

Autorisation

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

Remarques

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.

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. Pour toutes les pages qui n'ont pas de contenu, le service retourne des zéros pour ces octets.

Pour un objet blob d’ajout, l' Get Blob opération retourne l' x-ms-blob-committed-block-count en-tête. Cet en-tête indique le nombre de blocs validés dans l’objet BLOB. L' x-ms-blob-committed-block-count en-tête n’est pas retourné pour les objets BLOB de blocs ou de pages.

Une Get Blob opération est autorisée 2 minutes par MIB à se terminer. Si l’opération prend plus de 2 minutes par MiB en moyenne, l’opération expire.

L'en-tête x-ms-version est requis pour récupérer un objet blob qui appartient à un conteneur privé. 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. Pour plus d’informations, consultez la page Limiter l’accès aux conteneurs et aux objets BLOB .

Un Get Blob sur un objet blob de blocs archivé échoue.

Opérations de copie

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. 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. Contrôlez ensuite l'en-tête x-ms-copy-status: success. 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. 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.

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

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.

Le tableau suivant décrit les trois champs de chaque valeur x-ms-copy-status-description.

Composant Description
Code d'état HTTP Entier de 3chiffres standard indiquant la défaillance.
Code d'erreur Mot clé décrivant l’erreur fournie par Azure dans l’élément <ErrorCode > . 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é. Consultez codes d’erreur de l’API REST courantes.
Information Description détaillée de l'échec, entre guillemets.

Le tableau suivant décrit les valeurs x-ms-copy-status et x-ms-copy-status-description des scénarios d'échec courants.

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.

Scénario Valeur x-ms-copy-status Valeur x-ms-copy-status-description
L'opération de copie s'est terminée avec succès. success empty
Opération de copie abandonnée par l'utilisateur avant qu'elle se soit terminée. aborted empty
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. en attente 502 BadGateway « Erreur autorisant une nouvelle tentative lors de la lecture de la source. Nouvelle tentative. Heure de la défaillance : <heure > »
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. en attente 500 InternalServerError « Erreur autorisant une nouvelle tentative. Nouvelle tentative. Heure de la défaillance : <heure > »
Une défaillance irrécupérable s'est produite lors de la lecture de l'objet blob source d'une opération de copie. échec 404 ResourceNotFound « échec de la copie lors de la lecture de la source. »

Remarque : Pour signaler cette erreur sous-jacente, Azure retourne ResourceNotFound dans l' ErrorCode élément. 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.
Le délai d'expiration limitant toutes les opérations de copie s'est écoulé. (Actuellement le délai d'expiration est de 2 semaines.) échec 500 OperationCancelled « La copie a dépassé le temps maximal alloué. »
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. (Ce délai d'expiration a empêché une nouvelle tentative d'une source de mauvaise qualité pendant 2 semaines avant d'échouer). échec 500 OperationCancelled « La copie a échoué lors de la lecture de la 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. L’accès aux métadonnées d’un objet BLOB ne modifie pas son dernier temps d’accès.

Voir aussi

autoriser les demandes à stockage Azure
Codes d’État et d’erreur
Codes d’erreur du service BLOB
Définition de délais d'expiration pour les opérations du service BLOB