Get Blob Properties

Article
03/16/2023

L'opération Get Blob Properties retourne toutes les métadonnées définies par l'utilisateur, les propriétés HTTP standard et les propriétés système pour l'objet blob. Il ne retourne pas le contenu de l’objet blob.

Requête

Vous pouvez construire la Get Blob Properties requête comme suit. Nous vous recommandons d’utiliser HTTPS. Remplacez myaccount par le nom de votre compte de stockage.

URI de demande de méthode HEAD	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.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 HEAD	Version HTTP
`http://127.0.0.1:10000/devstoreaccount1/mycontainer/myblob`	HTTP/1.1

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

Paramètres URI

Vous pouvez spécifier les paramètres supplémentaires suivants dans l’URI de requête :

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’il est présent, 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’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. Pour plus d'informations, consultez la page Contrôle de version pour les services de Stockage Microsoft Azure.
`x-ms-lease-id: <ID>`	facultatif. Si cet en-tête est spécifié, l’opération `Get Blob Properties` 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 l’une de ces conditions n’est pas remplie, la demande échoue et l’opération `Get Blob Properties` échoue avec status code 412 (Échec de la condition préalable).
`x-ms-upn`	facultatif. Version 2020-06-12 et ultérieures. Valide pour les comptes avec un espace de noms hiérarchique activé. Si les valeurs d’identité utilisateur retournées dans sont `x-ms-owner`true, elles sont transformées d’ID d’objet Microsoft Entra en noms d’utilisateur principal. Si les valeurs sont false, elles sont retournées en tant qu’ID d’objet Microsoft Entra. La valeur par défaut est false. Notez que les ID d’objet de groupe et d’application ne sont pas traduits, car ils n’ont pas de noms conviviaux uniques.
`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 des en-têtes conditionnels pour retourner les propriétés et les métadonnées d'objet blob uniquement si une condition spécifié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 afin que l’opération de lecture puisse être terminée avec succès.

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 inclut un code d'état HTTP et un ensemble d'en-têtes de réponse.

Code d’état

Une opération réussie envoie le code d'état 200 (OK).

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

En-têtes de réponse

La réponse pour cette opération inclut les en-têtes dans le tableau suivant. 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.

En-tête de réponse	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. Pour plus d’informations, consultez Représenter les valeurs de date/heure dans les en-têtes. 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. Pour plus d’informations, consultez Représenter les valeurs de date/heure dans les en-têtes.
`x-ms-meta-name:value`	Ensemble de paires nom-valeur qui correspondent aux métadonnées définies par l’utilisateur associées à cet objet blob.
`x-ms-tag-count`	Version 2019-12-12 et ultérieures. 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’y a pas de balises sur l’objet blob.
`x-ms-blob-type:<BlockBlob\\|PageBlob\\|AppendBlob>`	Le type de l'objet blob.
`x-ms-copy-completion-time:<datetime>`	Version 2012-02-12 et versions ultérieures. 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 d’une `Copy Blob` opération, ou si cet objet blob a été modifié après une opération terminée `Copy Blob` qui utilise `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 d’un échec d’opération de copie irrécupérable ou non irrécupérable. 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 utilise `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 utilise `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 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. Peut afficher entre 0 et `Content-Length` les 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 utilise `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 source utilisé lors de 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 utilise `Set Blob Properties`, `Put Blob`ou `Put Block List`.
`x-ms-copy-status: <pending \\| success \\| aborted \\| failed>`	Version 2012-02-12 et versions ultérieures. État de l’opération de copie identifié par x-ms-copy-id, avec les valeurs suivantes : - `success`: Copie terminée avec succès. - `pending`: la copie est en cours. Vérifiez si `x-ms-copy-status-description` est intermittent, les erreurs récupérables empêchent 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. Pour des informations sur les défaillances, 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 utilise `Set Blob Properties`, `Put Blob`ou `Put Block List`.
`x-ms-incremental-copy: true`	Version 2016-05-31 et ultérieures. Inclus si l’objet blob est un objet blob de copie incrémentielle.
`x-ms-copy-destination-snapshot:<datetime>`	Version 2016-05-31 et ultérieures. Inclus si l’objet blob est un objet blob de copie incrémentielle ou une copie incrémentielle instantané, si `x-ms-copy-status` est réussi. Heure de l’instantané de la dernière copie incrémentielle réussie instantané pour cet objet blob.
`x-ms-lease-duration: <infinite \\| fixed>`	Quand un objet blob est loué, spécifie si le bail est d'une durée illimitée ou fixe. Inclus pour les demandes qui utilisent la version 2012-02-12 et les versions ultérieures.
`x-ms-lease-state: <available \\| leased \\| expired \\| breaking \\| broken>`	État de bail de l’objet blob. Inclus pour les demandes qui utilisent la version 2012-02-12 et les versions ultérieures.
`x-ms-lease-status:<locked\\| unlocked>`	L'état du bail de l'objet blob.
`Content-Length`	Taille de l’objet blob en octets. Pour un objet blob de pages, cet en-tête retourne la valeur de l’en-tête `x-ms-blob-content-length` stocké avec l’objet blob.
`Content-Type`	Type de contenu spécifié pour l’objet blob. Si aucun type de contenu n’est spécifié, le type de contenu par défaut est `application/octet-stream`.
`Etag`	L'ETag contient une valeur que vous pouvez utiliser pour exécuter des opérations conditionnellement. 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'en-tête `Content-MD5` a été défini pour l'objet blob, cet en-tête de réponse est retourné afin que le client puisse vérifier l'intégrité de contenu du message. Dans les versions 2012-02-12 et ultérieures, `Put Blob` définit la valeur MD5 d’un objet blob de blocs, même lorsque la `Put Blob` requête n’inclut pas d’en-tête MD5.
`Content-Encoding`	Si l'en-tête de demande `Content-Encoding` a été préalablement défini pour l'objet blob, cette valeur est retournée dans cet en-tête.
`Content-Language`	Si l'en-tête de demande `Content-Language` a été préalablement défini pour l'objet blob, cette valeur est retournée dans cet en-tête.
`Content-Disposition`	Si l'en-tête de demande `Content-Disposition` a été préalablement défini pour l'objet blob, cette valeur est retournée dans cet en-tête (pour les demandes effectuées avec la version 2013-08-15 ou une version ultérieure). 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. 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, mais afficher à la place une boîte de dialogue Enregistrer sous.
`Cache-Control`	Si l'en-tête de demande `Cache-Control` a été préalablement défini pour l'objet blob, cette valeur est retournée dans cet en-tête.
`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. Cet en-tête n’est pas retourné pour les objets blob de blocs.
`x-ms-request-id`	Cet en-tête identifie de manière unique la requête qui a été effectuée, et vous pouvez l’utiliser 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 utilisée pour exécuter la demande. Cet en-tête est retourné pour les demandes effectuées sur la version 2009-09-19 et ultérieure. 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.
`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.
`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 2013-08-15 et ultérieures.
`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 sur si les données d’objet blob et les métadonnées d’application sont entièrement chiffrées à `true` 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/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-access-tier`	Version 2017-04-17 et ultérieures. Niveau de l’objet blob de pages sur un compte Stockage Premium ou niveau d’un objet blob de blocs dans un compte Stockage Blob ou v2 à usage général. Pour obtenir la liste des niveaux d’objets blob de pages Premium autorisés, consultez Stockage Premium hautes performances et disques managés pour les machines virtuelles. Pour le stockage d’objets blob ou le compte v2 à usage général, les valeurs valides sont `Hot`, `Cool`, `Cold`et `Archive`. Note:`Cold` le niveau est pris en charge pour la version 2021-12-02 et ultérieure. Pour plus d’informations sur la hiérarchisation au niveau des objets blob de blocs de compte d’objets blob standard , consultez Niveaux de stockage chaud, froid et archive.
`x-ms-access-tier-inferred: true`	Version 2017-04-17 et ultérieures. Pour les objets blob de pages sur un compte Stockage Premium uniquement. Si le niveau d’accès n’est pas défini explicitement sur l’objet blob, le niveau est déduit en fonction de sa longueur de contenu, et cet en-tête est retourné avec la valeur `true`. Pour les objets blob de blocs sur stockage Blob ou un compte v2 à usage général, si l’objet blob n’a pas le niveau d’accès défini, vous pouvez déduire le niveau à partir des propriétés du compte de stockage. Cet en-tête est défini uniquement si le niveau de l’objet blob de blocs est déduit.
`x-ms-archive-status`	Version 2017-04-17 et ultérieures. Pour le stockage d’objets blob ou le compte v2 à usage général, les valeurs valides sont `rehydrate-pending-to-hot`, `rehydrate-pending-to-cool`et `rehydrate-pending-to-cold`. Si l’objet blob est réalimenté et est incomplet, cet en-tête est retourné, ce qui indique que la réactivation est en attente et affiche le niveau de destination. Pour plus d’informations sur la hiérarchisation au niveau de l’objet blob de blocs de compte d’objets blob standard, consultez Niveaux de stockage chaud, froid et archive.
`x-ms-access-tier-change-time`	Version 2017-04-17 et ultérieures. Indique l’heure à laquelle le niveau a été modifié pour la dernière fois sur l’objet . Cet en-tête est retourné uniquement si un niveau sur l’objet blob de blocs a été défini. Le format de date est conforme à la RFC 1123. Pour plus d’informations, consultez Représenter des valeurs de date/heure dans les en-têtes. Pour plus d’informations sur la hiérarchisation au niveau des objets blob de blocs de compte d’objets blob standard, consultez Niveaux de stockage chaud, froid et archive.
`x-ms-client-request-id`	Peut être utilisé pour résoudre les demandes et leurs 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 la valeur est au maximum 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-rehydrate-priority`	Version 2019-12-12 et ultérieures. Si un objet est à l’état en attente de réalimentation, cet en-tête est retourné avec la priorité de réhydrater. Les valeurs valides sont `High`/`Standard`. Pour plus d’informations sur la hiérarchisation au niveau des objets blob de blocs de compte d’objets blob standard , consultez Niveaux de stockage chaud, froid et archive.
`x-ms-or-{policy-id}_{rule-id}`	Version 2019-12-12 et ultérieure, retournée uniquement pour les objets blob de blocs. `policy-id` est une valeur GUID qui représente l’identificateur d’une stratégie de réplication d’objet sur le compte de stockage. `rule-id` est une valeur GUID qui représente l’identificateur d’une règle de stratégie sur le conteneur d’objets blob. Si le compte est `ObjectReplication`-enabled, la valeur de cet en-tête représente le status de réplication de l’objet blob avec les identificateurs de stratégie et de règle donnés, `complete` ou `failed`.
`x-ms-or-policy-id`	Version 2019-12-12 et ultérieure, retournée uniquement pour les objets blob de blocs. Si le compte est `ObjectReplication`-enabled, la valeur de cet en-tête représente la stratégie qui régit la réplication.
`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 Stockage Blob.
`x-ms-blob-sealed`	Version 2019-12-12 et ultérieure, retournée 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 date de « rétention jusqu’à » 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 RFC1123 format.
`x-ms-immutability-policy-mode: unlocked/locked`	Version 2020-06-12 et ultérieures. 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 augmentant ou en diminuant la date de rétention jusqu’à. `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 sa valeur est true. Sinon, la valeur est définie sur false si l’objet blob contient une conservation légale et sa valeur false.
`x-ms-owner`	Version 2020-06-12 et ultérieures. Uniquement pour les comptes avec un espace de noms hiérarchique activé. Retourne l’utilisateur propriétaire du fichier ou du répertoire.
`x-ms-group`	Version 2020-06-12 et ultérieures. Uniquement pour les comptes avec un espace de noms hiérarchique activé. Retourne le groupe de propriétaires du fichier ou du répertoire.
`x-ms-permissions`	Version 2020-06-12 et ultérieures. Uniquement pour les comptes avec un espace de noms hiérarchique activé. Retourne les autorisations définies pour l’utilisateur, le groupe et autres 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érieures. Uniquement pour les comptes avec un espace de noms hiérarchique activé. Retourne le type de ressource pour le chemin d’accès, qui peut être ou `filedirectory`.
`x-ms-expiry-time`	Version 2020-02-10 et ultérieures. Uniquement pour les comptes avec un espace de noms hiérarchique activé. Retourne l’heure d’expiration définie sur l’objet blob. Est retourné uniquement pour les fichiers dont le délai d’expiration est défini.

Response body

Aucun.

Exemple de réponse

Response Status:  
HTTP/1.1 200 OK  
  
Response Headers:  
x-ms-meta-Name: myblob.txt  
x-ms-meta-DateUploaded: <date>  
x-ms-blob-type: AppendBlob  
x-ms-lease-status: unlocked  
x-ms-lease-state: available  
Content-Length: 11  
Content-Type: text/plain; charset=UTF-8  
Date: <date>  
ETag: "0x8CAE97120C1FF22"  
Accept-Ranges: bytes  
x-ms-blob-committed–block-count: 1  
x-ms-version: 2015-02-21  
Last-Modified: <date>  
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 Properties 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 Properties, 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 Properties 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 Properties 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 Properties 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 Properties	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 Properties prend en charge l’autorisation de clé partagée. L’autorisation avec des clés de compte n’est pas recommandée pour 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 déterminer si une Copy Blob opération est terminée, commencez par case activée pour vérifier que la x-ms-copy-id valeur d’en-tête 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 antérieures à 2012-02-12.

x-ms-copy-status-description contient des informations supplémentaires sur l'échec Copy Blob. Les x-ms-copy-status-description valeurs sont décrites 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é avec le texte d’erreur standard associé au code de status HTTP à 3 chiffres dans la spécification HTTP est utilisé. Pour plus d’informations, consultez les code 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’erreur suivantes peuvent changer sans avertissement, même sans modification de version, de sorte que le texte peut ne pas correspondre exactement.

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 ». Remarque : lorsque le service signale cette erreur sous-jacente, il retourne `ResourceNotFound` dans l’élément <ErrorCode> . Si aucun élément ErrorCode> n’apparaît <dans la réponse, une représentation sous forme de chaîne standard de l’status HTTP, telle que `NotFound`, apparaît.
Le délai d'expiration limitant toutes les opérations de copie s'est écoulé. (Actuellement, le délai d’expiration est de deux 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 elle n’a pas satisfait à un ratio minimal de tentatives/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 Properties les demandes en fonction du type de compte de stockage :

Opération	Type de compte de stockage	Catégorie de facturation
Get Blob Properties	Objet blob de blocs Premium Usage général v2 Standard	Autres opérations
Get Blob Properties	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