Get Blob Properties
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 requête de méthode HEAD | Version HTTP |
|---|---|
https://myaccount.blob.core.windows.net/mycontainer/myblobhttps://myaccount.blob.core.windows.net/mycontainer/myblob?snapshot=<DateTime>https://myaccount.blob.core.windows.net/mycontainer/myblob?versionid=<DateTime> |
HTTP/1.1 |
URI du service de stockage émulé
Lorsque vous effectuez une demande auprès du service de stockage émulé, spécifiez le nom d’hôte de l’émulateur et Stockage Blob Azure port en tant que 127.0.0.1:10000, suivis du nom du compte de stockage émulé :
| URI de requête 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’il est présent, spécifie l’objet blob instantané à récupérer. Pour plus d’informations sur l’utilisation des instantanés d’objets blob, consultez Create 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éfinition 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. 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 est effectué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 à 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 l’espace de noms hiérarchique activé. Si la valeur est true, les valeurs d’identité utilisateur retournées dans les x-ms-owneren-têtes de réponse et x-ms-groupx-ms-acl sont transformées des ID d’objet Microsoft Entra en noms d’utilisateur principaux. Si la valeur est false, ils sont retournés 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 de l’analytique de stockage est activée. Nous vous recommandons vivement d’utiliser cet en-tête lorsque vous mettez en corrélation des activités côté client avec des demandes reçues par le serveur. Pour plus d’informations, consultez À propos de la journalisation azure Storage Analytics. |
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)
À compter 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 été précédemment 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 effectué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 codé 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 à cette opération inclut les en-têtes du 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 des 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 des 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 Blobou 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 Blobou 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 Blobou 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 Blobou 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 Blobou 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 Blobou 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, Coldet 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-coolet 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 [r,w,x,-]{3} format. |
x-ms-acl |
Version 2023-11-03 et ultérieures. Uniquement pour les comptes avec un espace de noms hiérarchique activé. Retourne la liste combinée de l’accès et de la liste de contrôle d’accès par défaut qui sont définies pour l’utilisateur, le groupe et autres sur le fichier ou le répertoire. Chaque entrée de contrôle d’accès (ACE) se compose d’une étendue, d’un type, d’un identificateur d’utilisateur ou de groupe et d’autorisations au format [scope]:[type]:[id]:[permissions]. L’étendue default indique que l’ACE appartient à la liste de contrôle d’accès par défaut pour un répertoire ; sinon, l’étendue est implicite et l’ACE appartient à l’ACL d’accès. Chaque autorisation individuelle est au [r,w,x,-]{3} format. |
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.
Important
Microsoft recommande d’utiliser Microsoft Entra ID avec des identités managées pour autoriser les demandes à Stockage Azure. Microsoft Entra ID offre une sécurité et une facilité d’utilisation supérieures par rapport à l’autorisation de clé partagée.
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, une identité managée 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.
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