Get Blob

Article
03/16/2023

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

Vous pouvez construire la Get Blob requête comme suit. Nous vous recommandons d’utiliser HTTPS. 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 de service de stockage émulé

Lorsque vous effectuez une requête auprès du service de stockage émulé, spécifiez le nom d’hôte de l’émulateur et Stockage Blob Azure port comme 127.0.0.1:10000, suivi du nom du 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 Utiliser l’émulateur de stockage Azure pour le développement et le test.

Paramètres URI

Les paramètres supplémentaires suivants peuvent être spécifiés sur l’URI de demande :

Paramètre	Description
`snapshot`	facultatif. Le paramètre instantané est une valeur opaque `DateTime` qui, lorsqu’elle est présente, spécifie le instantané d’objet blob à récupérer. Pour plus d’informations sur l’utilisation des instantanés d’objets blob, consultez Créer un instantané d’un objet blob.
`versionid`	Facultatif, version 2019-12-12 et ultérieures. Le `versionid` paramètre est une valeur opaque `DateTime` 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éfinir des délais d’expiration pour les opérations de stockage 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 du compte et la signature. Pour plus d’informations, consultez Autoriser les requêtes auprès du 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 requêtes auprès du 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. Si cet en-tête est omis pour une requête anonyme, le service exécute la demande avec la version 2009-09-19. Pour plus d'informations, consultez la page Contrôle de version pour les services de Stockage Microsoft Azure.
`Range`	facultatif. Retourne les octets de l’objet blob uniquement dans la plage spécifiée.
`x-ms-range`	facultatif. Retourne les octets de l’objet blob uniquement 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 aucune plage n’est spécifiée, le contenu de l’objet blob entier est retourné. Pour plus d’informations, consultez Spécifier l’en-tête de plage pour les opérations stockage Blob.
`x-ms-lease-id: <ID>`	facultatif. Si cet en-tête est spécifié, l’opération n’est effectuée que 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 à l’ID de bail de l’objet blob. Si cet en-tête est spécifié mais que l’une de ces conditions n’est pas remplie, la demande échoue et l’opération `Get Blob` échoue avec status code 412 (Échec de la condition préalable).
`x-ms-range-get-content-md5: true`	facultatif. Lorsque cet en-tête est défini `true` sur et spécifié avec l’en-tête `Range` , le service retourne le hachage MD5 pour la plage, tant que la plage est inférieure ou égale à 4 mebioctets (Mio) en taille. Si l’en-tête est spécifié sans l’en-tête`Range`, le service retourne status code 400 (requête incorrecte). Si l’en-tête est défini sur `true` lorsque la plage dépasse 4 Mio, le service retourne status code 400 (requête incorrecte).
`x-ms-range-get-content-crc64: true`	facultatif. Lorsque cet en-tête est défini `true` sur et spécifié avec l’en-tête `Range` , le service retourne le hachage CRC64 pour la plage, tant que la plage est inférieure ou égale à 4 Mio. Si l’en-tête est spécifié sans l’en-tête`Range`, le service retourne status code 400 (requête incorrecte). Si l’en-tête est défini sur `true` lorsque la plage dépasse 4 Mio, le service retourne status code 400 (requête incorrecte). Si les `x-ms-range-get-content-md5` en-têtes et `x-ms-range-get-content-crc64` sont présents, la demande échoue avec un 400 (requête incorrecte). Cet en-tête est pris en charge dans les versions 2019-02-02 et 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 caractères de 1 kibioctet (Kio), qui est enregistrée dans les journaux d’analyse lorsque la journalisation des analyses de stockage est activée. Nous vous recommandons vivement d’utiliser cet en-tête lorsque vous associez des activités côté client aux demandes reçues par le serveur. Pour plus d’informations, consultez À propos d’Azure Storage Analytics journalisation.

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écifier des en-têtes conditionnels pour les opérations de stockage Blob.

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

À partir de la version 2019-02-02, vous pouvez spécifier les en-têtes suivants 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 l’ensemble d’en-têtes correspondant) est facultatif. Si un objet blob a déjà été chiffré avec une clé fournie par le client, vous devez inclure ces en-têtes 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.

response

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 status, 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/heure de la dernière modification de 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 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`	Ensemble de paires nom-valeur qui est associé à cet objet blob en tant que métadonnées définies par l’utilisateur.
`x-ms-tag-count`	Version 2019-12-12 et ultérieures. Si l’objet blob a des balises, cet en-tête retourne le nombre de balises stockées sur l’objet blob. L’en-tête n’est pas retourné s’il n’y a pas de balises 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ée dans le cas où le client a demandé un sous-ensemble de l’objet blob en définissant l’en-tête de requête `Range` .
`ETag`	Contient une valeur que vous pouvez utiliser pour effectuer des opérations de manière conditionnelle. Pour plus d’informations, consultez Spécifier des en-têtes conditionnels pour les opérations de stockage Blob. Si la version de la demande est 2011-08-18 ou version ultérieure, la valeur ETag est placée 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. Dans les versions 2012-02-12 et ultérieures, définit la `Put Blob` valeur de hachage MD5 d’un objet blob de blocs, même lorsque la `Put Blob` requête n’inclut pas d’en-tête MD5. Si la demande est de lire une plage spécifiée et que est `x-ms-range-get-content-md5` défini sur `true`, la requête retourne un hachage MD5 pour la plage, tant que la taille de la plage est inférieure ou égale à 4 Mio. Si aucun de ces ensembles de conditions n’est `true`, aucune valeur n’est retourné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` est défini sur `true` lorsque la plage dépasse 4 Mio, le service retourne status code 400 (requête incorrecte).
`x-ms-content-crc64`	Si la demande est de lire une plage spécifiée et que est `x-ms-range-get-content-crc64` défini sur `true`, la requête retourne un hachage CRC64 pour la plage, tant que la taille de la plage est inférieure ou égale à 4 Mio. 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` est défini sur `true` lorsque la plage dépasse 4 Mio, le service retourne status code 400 (requête incorrecte).
`Content-Encoding`	Retourne la valeur qui a été spécifiée pour l’en-tête de `Content-Encoding` requête.
`Content-Language`	Retourne la valeur qui a été spécifiée pour l’en-tête de `Content-Language` requête.
`Cache-Control`	Retourné si l’en-tête a été spécifié précédemment 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 `Content-Disposition` champ d’en-tête de réponse transmet des informations supplémentaires sur la façon de traiter la charge utile de la réponse, et il peut être utilisé pour joindre des métadonnées supplémentaires. Par exemple, si l’en-tête est défini sur `attachment`, cela indique que l’agent utilisateur ne doit pas afficher la réponse. Au lieu de cela, il affiche une boîte de dialogue Enregistrer sous avec un nom de fichier autre que le 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 les objets blob d’ajout.
`x-ms-blob-type: <BlockBlob \| PageBlob \| AppendBlob>`	Retourne le type de l'objet blob.
`x-ms-copy-completion-time: <datetime>`	Version 2012-02-12 et versions ultérieures. Heure de conclusion de la dernière opération tentée `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 d’une `Copy Blob` opération, ou si cet objet blob a été modifié après une opération terminée `Copy Blob` qui a utilisé `Set Blob Properties`, `Put Blob`ou `Put Block List`.
`x-ms-copy-status-description: <error string>`	Version 2012-02-12 et versions ultérieures. N’apparaît que 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 d’une `Copy Blob` opération, ou si cet objet blob a été modifié après une opération terminée `Copy Blob` qui a utilisé `Set Blob Properties`, `Put Blob`ou `Put Block List`.
`x-ms-copy-id: <id>`	Version 2012-02-12 et versions ultérieures. Identificateur de chaîne pour la dernière opération tentée `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 d’une `Copy Blob` opération, ou si cet objet blob a été modifié après une opération terminée `Copy Blob` qui a utilisé `Set Blob Properties`, `Put Blob`ou `Put Block List`.
`x-ms-copy-progress: <bytes copied/bytes total>`	Version 2012-02-12 et versions ultérieures. Contient le nombre d’octets qui ont été copiés et le nombre total d’octets dans la source lors de la dernière tentative d’opération `Copy Blob` où cet objet blob était l’objet blob de destination. Il peut afficher entre 0 et `Content-Length` 0 octets copiés. Cet en-tête n’apparaît pas si cet objet blob n’a jamais été la destination d’une `Copy Blob` opération, ou si cet objet blob a été modifié après une opération terminée `Copy Blob` qui a utilisé `Set Blob Properties`, `Put Blob`ou `Put Block List`.
`x-ms-copy-source: url`	Version 2012-02-12 et versions ultérieures. URL d’une longueur maximale de 2 Kio qui spécifie l’objet blob ou le fichier source utilisé dans la dernière tentative d’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 d’une `Copy Blob` opération, ou si cet objet blob a été modifié après une opération terminée `Copy Blob` qui a utilisé `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 qui ont été utilisés dans l’opération de copie sur l’objet blob source, y compris le jeton de signature d’accès partagé (SAP) qui a été utilisé pour accéder à l’objet blob source.
`x-ms-copy-status: <pending \| success \| aborted \| failed>`	Version 2012-02-12 et versions ultérieures. État de l’opération de copie identifiée par x-ms-copy-id, avec les valeurs suivantes : - `success`: Copie terminée avec succès. - `pending`: la copie est en cours. Vérifiez `x-ms-copy-status-description` si les erreurs intermittentes et non irrécupérables ralentissent la progression de la copie, mais ne provoquent pas d’échec. - `aborted`: la copie a été terminée par `Abort Copy Blob`. - `failed`: Échec de la copie. Pour plus d’informations sur l’échec, consultez x-ms-copy-status-description. Cet en-tête n’apparaît pas si cet objet blob n’a jamais été la destination d’une `Copy Blob` opération, ou si cet objet blob a été modifié après une opération terminée `Copy Blob` qui a utilisé `Set Blob Properties`, `Put Blob`ou `Put Block List`.
`x-ms-lease-duration: <infinite \| fixed>`	Version 2012-02-12 et versions ultérieures. 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 2012-02-12 et versions ultérieures. État de bail de l’objet blob.
`x-ms-lease-status:<locked \| unlocked>`	L'état de bail actuel de l'objet blob.
`x-ms-request-id`	Identifie de manière unique la demande qui a été effectuée et peut être utilisée pour résoudre la demande. Pour plus d’informations, consultez Résoudre les problèmes liés aux opérations d’API.
`x-ms-version`	Indique la version de Stockage Blob qui a été utilisée pour exécuter la demande. Inclus pour les demandes effectuées à l’aide de la version 2009-09-19 et ultérieures. Cet en-tête est également retourné pour les requêtes anonymes sans version spécifiée si le conteneur a été marqué pour un accès public à l’aide de la version 2009-09-19 du Stockage 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 2011-08-18 et ultérieures, et pour le service de stockage local dans le SDK version 1.6 et ultérieure.
`Date`	Valeur de date/heure UTC générée par le service, qui indique l’heure à laquelle la réponse a été lancé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 de stockage Azure .
`Access-Control-Allow-Credentials`	Retourné si la requête inclut un `Origin` en-tête et que CORS est activé avec une règle de correspondance qui n’autorise pas toutes les origines. Cet en-tête est défini sur `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 et ultérieures. La valeur de cet en-tête est définie `true` sur si les données d’objet blob et les métadonnées d’application sont entièrement chiffrées à l’aide de l’algorithme spécifié. Sinon, la valeur est définie sur `false` (lorsque l’objet blob n’est pas chiffré, ou si seules certaines parties des métadonnées de l’objet blob ou de l’application sont chiffrées).
`x-ms-encryption-key-sha256`	Version 2019-02-02 et ultérieures. Cet en-tête est retourné si l’objet blob est chiffré avec une clé fournie par le client.
`x-ms-encryption-context`	Version 2021-08-06 et ultérieures. Si la valeur de la propriété de contexte de chiffrement est définie, elle retourne la valeur définie. Valide uniquement lorsque l’espace de noms hiérarchique est activé pour le compte.
`x-ms-encryption-scope`	Version 2019-02-02 et ultérieures. Cet en-tête est retourné si l’objet blob est chiffré avec une étendue de chiffrement.
`x-ms-blob-content-md5`	Version 2016-05-31 et ultérieures. Si l’objet blob a un hachage MD5 et si la demande 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 être égale ou non à la valeur retournée dans l’en-tête Content-MD5, cette dernière étant calculée à partir de la plage demandée.
`x-ms-client-request-id`	Peut être utilisé pour résoudre les demandes et les réponses correspondantes. La valeur de cet en-tête est égale à la valeur de l’en-tête `x-ms-client-request-id` s’il est présent dans la requête et que la valeur ne contient pas plus de 1 024 caractères ASCII visibles. Si l’en-tête `x-ms-client-request-id` n’est pas présent dans la demande, cet en-tête n’est pas présent dans la réponse.
`x-ms-last-access-time`	Version 2020-02-10 et ultérieures. Indique la dernière fois où les données de l’objet blob ont été consultées en fonction de la stratégie de suivi du dernier temps d’accès du compte de stockage. L’en-tête n’est pas retourné si le compte de stockage n’a pas de stratégie de suivi de l’heure de dernier 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 du dernier temps d’accès du compte de stockage, consultez API du service Blob.
`x-ms-blob-sealed`	Version 2019-12-12 et ultérieures. Retourné uniquement pour les objets blob d’ajout. Si l’objet blob d’ajout a été scellé, la valeur est `true`. Pour plus d’informations, consultez Ajouter un sceau d’objet blob.
`x-ms-immutability-policy-until-date`	Version 2020-06-12 et ultérieures. Spécifie la rétention jusqu’à la date définie sur l’objet blob. Il s’agit de la date jusqu’à laquelle l’objet blob peut être protégé contre la modification ou la suppression. Retourné uniquement si une stratégie d’immuabilité est définie sur l’objet blob. La valeur de cet en-tête est au format RFC1123.
`x-ms-immutability-policy-mode: unlocked/locked`	Version 2020-06-12 et ultérieures. Retourné si une stratégie d’immuabilité est définie sur l’objet blob. Les valeurs sont `unlocked` et `locked`. `unlocked` indique que l’utilisateur peut modifier la stratégie en augmentant ou en diminuant la rétention jusqu’à la date. `locked` indique que ces actions sont interdites.
`x-ms-legal-hold: true/false`	Version 2020-06-12 et ultérieures. Cet en-tête n’est pas retourné s’il n’existe aucune conservation légale sur l’objet blob. La valeur de cet en-tête est définie sur `true` si l’objet blob contient une conservation légale et si sa valeur est `true`. Sinon, la valeur est définie `false` sur si l’objet blob contient une conservation légale et si sa valeur est `false`.
`x-ms-owner`	Version 2020-06-12 et ultérieure, uniquement pour les comptes avec l’espace de noms hiérarchique activé. Retourne le propriétaire-utilisateur du fichier ou du répertoire.
`x-ms-group`	Version 2020-06-12 et ultérieure, uniquement pour les comptes avec l’espace de noms hiérarchique activé. Retourne le groupe propriétaire du fichier ou du répertoire.
`x-ms-permissions`	Version 2020-06-12 et ultérieure, uniquement pour les comptes avec l’espace de noms hiérarchique activé. Retourne les autorisations définies pour « utilisateur », « groupe » et « autre » sur le fichier ou le répertoire. Chaque autorisation individuelle est au format [r,w,x,-].{3}
`x-ms-resource-type`	Version 2020-10-02 et ultérieure, uniquement pour les comptes avec l’espace de noms hiérarchique activé. Retourne le type de ressource pour le chemin d’accès, qui peut être ou `filedirectory`.

Response body

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

Une autorisation est requise lors de l’appel d’une opération d’accès aux données dans Stockage Azure. Vous pouvez autoriser l’opération Get Blob comme décrit ci-dessous.

Stockage Azure prend en charge l’utilisation de Microsoft Entra ID pour autoriser les demandes de données blob. Avec Microsoft Entra ID, vous pouvez utiliser le contrôle d’accès en fonction du rôle Azure (Azure RBAC) pour accorder des autorisations à un principal de sécurité. Le principal de sécurité peut être un utilisateur, un groupe, un principal de service d’application ou une identité managée Azure. Le principal de sécurité est authentifié par Microsoft Entra ID pour retourner un jeton OAuth 2.0. Le jeton peut ensuite être utilisé pour autoriser une requête auprès du service BLOB.

Pour en savoir plus sur l’autorisation à l’aide de Microsoft Entra ID, consultez Autoriser l’accès aux objets blob à l’aide de Microsoft Entra ID.

Autorisations

Vous trouverez ci-dessous l’action RBAC nécessaire pour qu’un utilisateur, un groupe ou un principal de service Microsoft Entra appelle l’opérationGet Blob, ainsi que le rôle RBAC Azure intégré le moins privilégié qui inclut cette action :

Action RBAC Azure :Microsoft.Storage/storageAccounts/blobServices/containers/blobs/read
Rôle intégré le moins privilégié :Lecteur de données blob de stockage

Pour en savoir plus sur l’attribution de rôles à l’aide d’Azure RBAC, consultez Attribuer un rôle Azure pour l’accès aux données d’objets blob.

Une signature d’accès partagé (SAP) fournit un accès délégué sécurisé aux ressources d’un compte de stockage. Avec une SAP, vous disposez d’un contrôle granulaire sur la façon dont un client peut accéder aux données. Vous pouvez spécifier la ressource à laquelle le client peut accéder, les autorisations dont il dispose sur ces ressources et la durée de validité de la SAP.

L’opération Get Blob prend en charge trois types de signatures d’accès partagé : sas de délégation d’utilisateur, SAP de service et SAP de compte.

Comme meilleure pratique de sécurité, nous vous recommandons d’utiliser Microsoft Entra informations d’identification plutôt que la clé de compte de stockage, qui peut être plus facilement compromise. Si la conception de votre application nécessite des signatures d’accès partagé, utilisez Microsoft Entra informations d’identification pour créer une sap de délégation d’utilisateur, si possible.

Lorsque l’accès à la clé partagée est interdit pour le compte de stockage, un jeton SAP de service ou un jeton SAP de compte ne sont pas autorisés lors d’une demande adressée au stockage Blob. Pour plus d’informations, consultez Comprendre comment l’interdiction de la clé partagée affecte les jetons SAP.

SAP de délégation d’utilisateur

Une sap de délégation d’utilisateur est sécurisée avec des informations d’identification Microsoft Entra ainsi que par les autorisations spécifiées pour la sap.

L’appel de l’opération à l’aide Get Blob d’un jeton SAP délégué à un conteneur ou à une ressource blob nécessite l’autorisation Lecture (r) dans le cadre du jeton SAP de délégation utilisateur.

Pour en savoir plus sur la sap de délégation d’utilisateur, consultez Créer une sap de délégation d’utilisateur.

SAP de service

Une SAP de service est sécurisée à l’aide de la clé de compte de stockage. Une sap de service délègue l’accès à une ressource dans un seul service Stockage Azure, tel que le stockage blob.

L’appel de l’opération à l’aide Get Blob d’un jeton SAP délégué à un conteneur ou à une ressource blob nécessite l’autorisation Lecture (r) dans le cadre du jeton SAP de service.

Pour en savoir plus sur la SAP de service, consultez Créer une SAP de service.

SAP de compte

Une SAP de compte est sécurisée à l’aide de la clé de compte de stockage. Une SAP de compte délègue l’accès aux ressources d’un ou plusieurs des services de stockage. Toutes les opérations disponibles via une SAP de service ou de délégation d’utilisateur sont également disponibles via une SAP de compte.

Le tableau suivant indique le type de ressource signé et les autorisations signées à spécifier lors de la délégation de l’accès :

Opération	Service signé	Type de ressource signé	Autorisation signée
Get Blob	Objet blob (b)	Objet (o)	Lecture (r)

Pour en savoir plus sur la SAP de compte, consultez Créer une SAP de compte.

L’opération Get Blob prend en charge l’autorisation de clé partagée. L’autorisation avec des clés de compte n’est pas recommandée dans la plupart des scénarios, car elle est moins sécurisée.

Microsoft recommande d’interdire l’autorisation de clé partagée pour le compte de stockage lorsque cela est possible. Pour plus d’informations, consultez Empêcher l’autorisation avec une clé partagée.

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 de pages jusqu’à la valeur spécifiée pour l’en-tête x-ms-blob-content-length . Pour toutes les pages qui manquent de contenu, le service retourne des zéros pour ces octets.

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

Une Get Blob opération est autorisée à deux minutes par Mio. Si l’opération prend plus de deux minutes par Mio 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, tout client peut le lire sans spécifier de version ; la version du service n’est pas requise 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.

Une Get Blob opération sur un objet blob de blocs archivé échoue.

Opérations de copie

Pour déterminer si une Copy Blob opération a été effectuée, case activée d’abord pour vérifier que la x-ms-copy-id valeur d’en-tête de l’objet blob de destination correspond à l’ID de copie fourni par l’appel d’origine à Copy Blob. Une correspondance garantit qu’une autre application n’a pas abandonné la copie et démarre une nouvelle Copy Blob opération. Ensuite, case activée pour l’en-têtex-ms-copy-status: success. Toutefois, n’oubliez pas que toutes les opérations d’écriture sur un objet blob à l’exception Leasedes opérations , Put Pageet Put Block suppriment toutes les x-ms-copy-* propriétés de l’objet blob. Ces propriétés ne sont pas non plus copiées par Copy Blob les opérations qui utilisent des versions de Stockage Blob antérieures à 2012-02-12.

Avertissement

L’URL retournée dans l’en-tête contient tous les x-ms-copy-source paramètres de requête qui ont été utilisés dans l’opération de copie sur l’objet blob source. Si vous utilisez un jeton SAS pour accéder à l’objet blob source, ce jeton SAP apparaît dans l’en-tête x-ms-copy-source quand 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.

Les trois champs de chaque x-ms-copy-status-description valeur sont décrits dans le tableau suivant :

Composant	Description
Code d’état HTTP	Entier standard à 3 chiffres qui spécifie l’échec.
Code d'erreur	Un mot clé qui décrit l’erreur, fournie par Azure dans l’élément <ErrorCode>. Si aucun élément ErrorCode> n’apparaît<, un mot clé qui contient le texte d’erreur standard associé au code de status HTTP à 3 chiffres dans la spécification HTTP est utilisé. Consultez Codes d’erreur courants de l’API REST.
Information	Description détaillée de l’échec, entre guillemets.

Les x-ms-copy-status valeurs et x-ms-copy-status-description des scénarios d’échec courants sont décrites dans le tableau suivant :

Important

Les descriptions d’erreurs dans ce tableau peuvent changer sans avertissement, même sans modification de version, de sorte qu’elles peuvent ne pas correspondre exactement à votre texte.

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 l’échec : <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 l’échec : <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. » Note: Lorsque le service signale cette erreur sous-jacente, il retourne `ResourceNotFound` dans l’élément `ErrorCode` . Si aucun élément n’est `ErrorCode` apparu dans la réponse, une représentation sous forme de chaîne standard de l’status HTTP, telle 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 à partir de la source et n’a pas satisfait à un rapport minimal entre tentatives et réussites. (Ce délai d’expiration empêche la nouvelle tentative d’une source très médiocre pendant deux semaines avant l’échec).	échec	500 OperationCancelled « La copie a échoué lors de la lecture de la source. »

x-ms-last-access-time effectue le suivi de l’heure d’accès aux données de l’objet blob en fonction de la stratégie de suivi de l’heure du dernier accès du compte de stockage. L’accès aux métadonnées d’un objet blob ne modifie pas son heure de dernier accès.

Facturation

Les demandes de tarification peuvent provenir de clients qui utilisent les API Stockage Blob, soit directement via l’API REST Stockage Blob, soit à partir d’une bibliothèque cliente stockage Azure. Ces demandes accumulent des frais par transaction. Le type de transaction affecte la façon dont le compte est facturé. Par exemple, les transactions de lecture s’accumulent dans une catégorie de facturation différente de celle des transactions d’écriture. Le tableau suivant montre la catégorie de facturation pour Get Blob les demandes en fonction du type de compte de stockage :

Opération	Type de compte de stockage	Catégorie de facturation
Get Blob	Objet blob de blocs Premium Usage général v2 Standard Usage général v1 standard	Lire les opérations

Pour en savoir plus sur la tarification de la catégorie de facturation spécifiée, consultez tarification Stockage Blob Azure.

Voir aussi

Autoriser les demandes dans le Stockage Azure
Codes d’état et d’erreur
Codes d’erreur stockage Blob
Définir des délais d’expiration pour les opérations de stockage Blob