Obtenez la disposition des blobs

L’opération Get Blob Layout renvoie toutes les métadonnées définies par l’utilisateur, les propriétés HTTP standard et les propriétés système pour le blob. De plus, il peut éventuellement retourner la disposition de la masse. La disposition d’un blob est une sous-ressource d’un blob qui contient une répartition de toutes les plages du blob, avec un point final (adresse) où cette plage peut être lue, fournissant des indices sur la meilleure façon de paralléliser les lectures.

Grâce à cette API, vous pouvez optimiser une opération de téléchargement en effectuant les deux étapes suivantes :

  1. Découverte de la disposition : Appel Get Blob Layout pour récupérer les propriétés du blob et découvrir sa distribution de données.
  2. Blob Parallel Get : Appelez Get Blob en parallèle pour toutes les plages de blob qui vous intéressent, en utilisant les terminaux retournés par la disposition du blob pour router ces requêtes vers l’emplacement optimal.

Requête

Vous pouvez construire la requête Get Blob Layout comme suit. Nous vous recommandons d’utiliser HTTPS. Remplacez myaccount 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?comp=layout

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

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

https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=layout&versionid=<DateTime>&marker=<ContinuationToken>&maxresults=1000		 HTTP/1.0

HTTP/1.1

Paramètres d’URI

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

Parameter Description
snapshot Optional. Le paramètre snapshot est une valeur opaque DateTime qui, lorsqu’elle est présente, spécifie le snapshot de blob à récupérer. Pour plus d’informations sur le travail avec les instantanés de blob, voir Créer un instantané d’un blob.
versionid Optional. Le versionid paramètre est une valeur opaque DateTime qui, lorsqu’elle est présente, spécifie la version du blob à récupérer.
marker Optional. Un jeton de continuation retourné par une demande précédente Get Blob Layout . Utilisez ce jeton pour récupérer le prochain ensemble de plages. Le marqueur sert à reprendre la pagination lorsque la réponse n’inclut pas toutes les plages pour la masse ou la plage spécifiée. Si un marqueur est utilisé, un If-Match en-tête doit également être inclus avec un Etag de la demande précédente. Pour plus d’informations sur l’utilisation d’un If-Match en-tête, voir Spécifier les en-têtes conditionnels pour les opérations Stockage Blob. De plus, si la requête précédente comprenait un Range en-tête or x-ms-range , cette requête doit également contenir un en-tête identique. Si la dernière requête n’incluait pas d’en-tête de range, cette requête ne doit pas non plus en inclure.
maxresults Optional. Le nombre maximal de plages à retourner dans la réponse. L’API ne retournera jamais plus de plages que la valeur spécifiée par maxresults.
timeout Optional. Le paramètre timeout est exprimé en secondes. Pour plus d’informations, consultez Paramètre des délais d’attente pour les opérations de stockage Blob.

En-têtes de requête

Le tableau suivant décrit les en-têtes de requête obligatoires et facultatifs.

En-tête de requête Description
Authorization Required. Spécifie le schéma d’autorisation, le nom du compte et la signature. Pour plus d’informations, consultez Autoriser les demandes vers le stockage Azure.
Date ou x-ms-date Required. Spécifie le temps universel coordonné (UTC) de la requête. Pour plus d’informations, consultez Autoriser les demandes vers le stockage Azure.
x-ms-version Required. Spécifie la version de l’opération à utiliser pour cette requête. Get Blob Layout n’est pris en charge que dans une version 2026-02-06 ou ultérieure. Pour plus d'informations, consultez la page Contrôle de version pour les services de Stockage Microsoft Azure.
Range ou x-ms-range Optional. Retournez les métadonnées uniquement pour les plages spécifiées. Si et Range sont tous deux x-ms-range spécifiés, le service utilise la valeur de x-ms-range. Si aucune plage n’est spécifiée, les métadonnées sont retournées pour l’ensemble du blob. Pour plus d’informations, voir Spécifier l’en-tête de plage pour les opérations de stockage en blob.
x-ms-lease-id: <ID> Optional. 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 du bloc est actuellement actif.
- L’identifiant de bail spécifié dans la requête correspond à celui du bloc de bail.

Si l’une de ces conditions n’est pas remplie, la requête échoue, et l’opération Get Blob Layout échoue avec le code d’état 412 (Précondition échouée).
x-ms-upn Optional. Valable pour les comptes avec un espace de noms hiérarchique activé. Si c’est vrai, les valeurs d’identité utilisateur retournées dans les x-ms-owneren-têtes , x-ms-group, et x-ms-acl réponse seront transformées des identifiants d’objets Microsoft Entra en noms principaux utilisateur. Si la valeur est fausse, elles sont retournées sous forme d’identifiants d’objets Microsoft Entra. La valeur par défaut est false. Notez que les identifiants des groupes et des objets applicatifs ne sont pas traduits, car ils n’ont pas de noms amicaux uniques.
x-ms-client-request-id Optional. Fournit une valeur opaque générée par le client avec une limite de caractères de 1 kibioctet (KiB), qui est enregistrée dans les journaux analytiques lorsque la journalisation des analyses de stockage est activée. Nous vous recommandons vivement d’utiliser cet en-tête lorsque vous corréléz les activités côté client aux requêtes reçues par le serveur. Pour plus d’informations, voir À propos de la journalisation Azure Storage Analytics.

Cette opération permet également l’utilisation d’en-têtes conditionnels pour retourner la disposition et les propriétés du blob uniquement si une condition spécifiée est remplie. Pour plus d’informations, voir Spécifier les en-têtes conditionnels pour les opérations de stockage en blob. Notez qu’un If-Match en-tête est nécessaire lorsque a marker est utilisé dans les paramètres URI.

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

Vous pouvez spécifier les en-têtes suivants sur la requête pour lire un 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 optionnel. Si un blob a déjà été chiffré avec une clé fournie par le client, vous devez inclure ces en-têtes dans la requête afin que l’opération puisse être menée à bien avec succès.

En-tête de requête Description
x-ms-encryption-key Required. La clé de chiffrement AES-256 codée en Base64.
x-ms-encryption-key-sha256 Optional. Le hachage SHA256 encodé en Base64 de la clé de chiffrement.
x-ms-encryption-algorithm: AES256 Required. Spécifie l’algorithme à utiliser pour le chiffrement. La valeur de cet en-tête doit être AES256.

Corps de la demande

None.

Response

La réponse comprend un code d’état HTTP, un ensemble d’en-têtes de réponse, et éventuellement un corps de réponse contenant la disposition du blob au format XML.

Code de statut

Une opération réussie renvoie l’un des deux codes de statut suivants :

  • HTTP 200 (OK) si la réponse inclut une disposition de blob dans le corps.
  • HTTP 204 (Pas de contenu) si le serveur ne renvoyait pas de disposition dans le corps de la réponse. Dans ce cas, l’API est fonctionnellement équivalente à Get Blob Properties.

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

En-têtes de réponse

La réponse de cette opération inclut les en-têtes suivants. La réponse peut également inclure des en-têtes HTTP standard supplémentaires. Tous les en-têtes standard sont conformes à la spécification de protocole HTTP/1.1.

En-tête de réponse Description
Content-Type Spécifie le format dans lequel les résultats sont retournés dans le corps de la réponse. La valeur est application/xml si le corps est rendu.
Content-Length Indique la taille du corps de la réponse, si elle est retournée.
Last-Modified La date/heure de la dernière modification du blob. Le format de date suit la RFC 1123. Pour plus d’informations, consultez Représenter les valeurs de date/heure dans les en-têtes.

Toute opération modifiant le blob, y compris une mise à jour des métadonnées ou propriétés du blob, modifie le dernier temps de modification du blob.
x-ms-creation-time La date/heure de création de la masse. Le format de date suit 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 Un ensemble de paires nom-valeur correspondant aux métadonnées définies par l’utilisateur associées à ce blob.
x-ms-tag-count Si le blob possède des tags, il retourne le nombre de tags stockés sur le blob. Cet en-tête n’est pas retourné s’il n’y a pas de balises sur le blob.
ETag Contient une valeur que vous pouvez utiliser pour effectuer des opérations sous condition. Pour plus d’informations, voir Spécifier les en-têtes conditionnels pour les opérations de stockage en blob. La valeur ETag est placée entre guillemets.
x-ms-copy-completion-time:<datetime> Heure de conclusion de la dernière opération tentée Copy Blob où cette masse était la masse de destination. Cette valeur peut spécifier l’heure d’une tentative de copie terminée, abandonnée ou ayant échoué. Cet en-tête n’apparaît pas si une copie est en attente, si ce blob n’a jamais été la destination dans une Copy Blob opération, ou si ce blob a été modifié après une opération conclue Copy Blob utilisant Set Blob Properties, Put Blob, ou Put Block List.
x-ms-copy-status-description: <error string> Apparaît uniquement 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 ce blob n’a jamais été la destination dans une Copy Blob opération, ou si ce blob a été modifié après une opération conclue Copy Blob utilisant Set Blob Properties, Put Blob, ou Put Block List.
x-ms-copy-id: <id> L’identifiant de chaîne pour la dernière opération tentée Copy Blob , où ce blob était le blob de destination. Cet en-tête n’apparaît pas si ce blob n’a jamais été la destination dans une Copy Blob opération, ou si ce blob a été modifié après une opération conclue Copy Blob utilisant Set Blob Properties, Put Blob, ou Put Block List.
x-ms-copy-progress: <bytes copied/bytes total> Contient le nombre d’octets copiés et le total d’octets dans la source lors de la dernière opération tentée Copy Blob , où ce blob était le blob de destination. Peut apparaître de 0 à Content-Length octets copiés. Cet en-tête n’apparaît pas si ce blob n’a jamais été la destination dans une Copy Blob opération, ou si ce blob a été modifié après une opération conclue Copy Blob utilisant Set Blob Properties, Put Blob, ou Put Block List.
x-ms-copy-source: url Une URL pouvant atteindre 2 KiB de longueur qui spécifie le blob source utilisé lors de la dernière opération tentée Copy Blob , où ce blob était le blob de destination. Cet en-tête n’apparaît pas si ce blob n’a jamais été la destination dans une Copy Blob opération, ou si ce blob a été modifié après une opération conclue Copy Blob utilisant Set Blob Properties, Put Blob, ou Put Block List.

L’URL renvoyée dans cet en-tête contient tous les paramètres de requête utilisés lors de l’opération de copie sur le blob source. Si l’URL contient un jeton de signature d’accès partagé (SAS), la signature (sig paramètre) ne sera pas incluse.
x-ms-copy-status: <pending \| success \| aborted \| failed> L’état de l’opération de copie identifié par x-ms-copie-id, avec ces valeurs :

- success: Copie terminée avec succès.
- pending: Copie en cours. Vérifiez x-ms-copy-status-description si des erreurs intermittentes et non fatales entravent la progression de la copie sans causer d’échec.
- aborted: La copie a été terminée par Abort Copy Blob.
- failed: Copie échouée. Consultez x-ms-copy-status-description pour plus d’informations sur l’échec.

Cet en-tête n’apparaît pas si ce blob n’a jamais été la destination dans une Copy Blob opération, ou si ce blob a été modifié après une opération achevée Copy Blob utilisant Set Blob Properties, Put Blob, ou Put Block List.
x-ms-incremental-copy: true Inclus si le blob est un blob de copie incrémental.
x-ms-copy-destination-snapshot:<datetime> Inclus si le blob est un blob de copie incrémental ou un instantané de copie incrémental, si x-ms-copy-status est un succès. Heure d’instantané de la dernière capture instantanée de copie incrémentielle réussie pour cet objet blob.
x-ms-lease-duration: <infinite \| fixed> Lorsqu’un objet blob est loué, spécifie si le bail est d’une durée infinie ou fixe.
x-ms-lease-state: <available \| leased \| expired \| breaking \| broken> L’état du bail de la masse.
x-ms-lease-status:<locked\| unlocked> Le statut du bail de la masse.
Cache-Control Si l’en-tête Cache-Control de requête a déjà été défini pour le blob, cette valeur est retournée dans cet en-tête.
x-ms-request-id Cet en-tête identifie de manière unique la requête effectuée, et vous pouvez l’utiliser pour dépanner la requête. Pour plus d’informations, voir Dépannage des opérations API.
x-ms-version Indique la version Stockage Blob utilisée pour exécuter la requête.
Accept-Ranges: bytes Indique que le service prend en charge les demandes de contenu d’objet blob partiel.
x-ms-server-encrypted: true/false La valeur de cet en-tête est fixée à true si les données blobs et les métadonnées de l’application sont entièrement chiffrées à l’aide de l’algorithme spécifié. Sinon, la valeur est fixée à false (lorsque le blob n’est pas chiffré, ou si seules des parties du blob/métadonnées de l’application sont chiffrées).
x-ms-encryption-key-sha256 Cet en-tête est retourné si le blob est chiffré avec une clé fournie par le client.
x-ms-encryption-context Si la valeur de la propriété de contexte de chiffrement est définie, elle retournera la valeur de définition. Valide uniquement lorsque l’espace de noms hiérarchique est activé pour le compte.
x-ms-encryption-scope Cet en-tête est retourné si le blob est chiffré avec une portée de chiffrement.
x-ms-access-tier Le niveau d’un blob de blocs dans un compte Stockage Blob ou un compte v2 général. Les valeurs valides sont Hot, , CoolColdet SmartArchive. Pour des informations détaillées sur le tiélinge standard au niveau des blocs de blocs de blob, voir Niveaux de stockage blob.
x-ms-smart-access-tier Cet en-tête n’est retourné que pour les requêtes faites contre des blobs en Smart paier. Les valeurs valides sont Hot, Coolet Cold. Pour des informations détaillées sur la tiering standard au niveau du blob en compte de blob, voir Niveaux de stockage blob.
x-ms-archive-status Pour le stockage en blob ou les comptes v2 généralistes, les valeurs valides sont rehydrate-pending-to-hot, rehydrate-pending-to-cool, et rehydrate-pending-to-cold. Si le blob est en cours de réhydratation et est incomplet, cet en-tête est retourné, ce qui indique à la fois que la réhydratation est en attente et affiche le tier de destination. Pour des informations détaillées sur le tiélinge standard au niveau du blob block account, voir Niveaux de stockage blob.
x-ms-access-tier-change-time Indique la dernière fois que le niveau a été modifié sur l’objet. Cet en-tête n’est retourné que si un niveau sur le blob de bloc a jamais été défini. Le format de date suit la RFC 1123. Pour plus d’informations, consultez Représenter les valeurs de date/heure dans les en-têtes. Pour plus d’informations sur le tiétiernage standard au niveau des blocs de blocs de blob, voir Niveaux de stockage de blob.
x-ms-rehydrate-priority Si un objet est en état de réhydraté, cet en-tête est retourné avec la priorité de réhydraté. Les valeurs valides sont High/Standard. Pour des informations détaillées sur la tiering standard au niveau du blob en compte de blob, voir Niveaux de stockage blob.
x-ms-or-{policy-id}_{rule-id} Retourné uniquement pour les blocs de blocs. policy-id est une valeur GUID qui représente l’identifiant d’une politique de réplication d’objet sur le compte de stockage. rule-id est une valeur GUID qui représente l’identifiant d’une règle de politique sur le conteneur de blob. Si le compte est ObjectReplicationactivé par -, la valeur de cet en-tête représente l’état de réplication du blob avec les identifiants de politique et de règle donnés, soit complete .failed
x-ms-or-policy-id Retourné uniquement pour les blocs de blocs. Si le compte est ObjectReplicationactivé par -, la valeur de cet en-tête représente la politique qui régit la réplication.
x-ms-last-access-time Indique la dernière fois où les données du blob ont été consultées selon la politique de suivi du 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 politique de suivi du dernier temps d’accès, ou si la politique est désactivée. Pour des informations sur la définition de la politique de suivi du temps d’accès du compte de stockage pour le compte de stockage, voir API de stockage blob.
x-ms-blob-sealed Revenu uniquement pour ajouter des blobs. Si le blob d’ajout a été scellé, la valeur serait vraie. Pour plus d’informations, voir Ajouter le sceau de blob
x-ms-immutability-policy-until-date Précise la date de rétention jusqu’à ce que ce soit fixé sur le blob. C’est la date jusqu’à laquelle le blob peut être protégé contre toute modification ou suppression. Retourné uniquement si une politique d’immuabilité est définie sur le blob. La valeur de cet en-tête est RFC1123 format.
x-ms-immutability-policy-mode: unlocked/locked Le mode politique d’immutabilité, retourné si une politique d’immutabilité est définie sur le blob. Les valeurs sont unlocked/locked. unlocked indique que l’utilisateur peut modifier la politique en augmentant ou diminuant la date de conservation jusqu’à présent. locked indique que ces actions sont interdites.
x-ms-legal-hold: true/false Cet en-tête n’est pas retourné s’il n’y a pas de blocage légal sur le blob. La valeur de cet en-tête est fixée à vraie si le blob contient une conservation légale et que sa valeur est vraie. Sinon, la valeur est fixée à faux si le blob contient une conservation légale et sa valeur fausse.
x-ms-owner Uniquement pour les comptes avec un espace de noms hiérarchique activé. Rend l’utilisateur du fichier ou du répertoire au propriétaire.
x-ms-group Uniquement pour les comptes avec un espace de noms hiérarchique activé. Retourne le groupe propriétaire du fichier ou du répertoire.
x-ms-permissions Uniquement pour les comptes avec un espace de noms hiérarchique activé. Rend les permissions définies pour l’utilisateur, le groupe et autres sur le fichier ou le répertoire. Chaque autorisation individuelle est dans [r,w,x,-]{3} un format.
x-ms-acl Uniquement pour les comptes avec un espace de noms hiérarchique activé. Retourne la liste combinée des accès et des listes de contrôle d’accès par défaut définies pour utilisateur, groupe et autres sur le fichier ou le répertoire. Chaque entrée de contrôle d’accès (ACE) se compose d’un périmètre, d’un type, d’un identifiant utilisateur ou de groupe, et des autorisations dans le format [scope]:[type]:[id]:[permissions]. Le default scope indique que l’ACE appartient à l’ACL par défaut d’un répertoire ; sinon, le scope est implicite et l’ACE appartient à l’ACL d’accès. Chaque autorisation individuelle est dans [r,w,x,-]{3} un format.
x-ms-resource-type Uniquement pour les comptes avec un espace de noms hiérarchique activé. Retourne le type de ressource pour le chemin, qui peut être soit filedirectory.
x-ms-expiry-time Uniquement pour les comptes avec un espace de noms hiérarchique activé. Ça retourne la date d’expiration fixée sur le blob. Est retourné uniquement pour les fichiers dont le délai d’expiration est fixé.

Corps de réponse

Lorsque le code d’état de la réponse est HTTP 200 (OK), le corps de la réponse contient la disposition du blob au format XML. Le format de la réponse est le suivant :

<?xml version="1.0" encoding="utf-8"?>
<BlobLayout>
    <Ranges>
        <Range Start="0" End="1023" EndpointIndex="0" />
        <Range Start="1024" End="4096" EndpointIndex="1" />
    </Ranges>
    <Endpoints>
        <Endpoint Index="0" Value="host1:port" />
        <Endpoint Index="1" Value="host2:port" />
    </Endpoints>
    <NextMarker>marker</NextMarker>
    <MaxResults>2</MaxResults>
</BlobLayout>

La réponse XML contient les éléments suivants :

  • Plages : Contient une liste d’éléments de plage, chacun spécifiant une plage contiguë d’octets dans le blob avec un indice de terminaison associé.

    • Plage : Représente une plage contiguë d’octets dans le blob.
      • Début : le décalage d’octets de départ de la plage (inclus).
      • Fin : le décalage d’octet de fin de la plage (inclus).
      • EndpointIndex : L’index du point de terminaison dans la liste Endpoints à partir duquel cette plage doit être lue.

  • Points de terminaison : Contient une liste d’éléments de terminaison, chacun spécifiant un point de terminaison de service.

    • Extrémité : représente un point de terminaison de service à partir duquel les plages de blobs peuvent être lues.
      • Index : L’index de ce point de terminaison, référencé par les éléments de la plage.
      • Valeur : Le nom d’hôte DNS et le port dans le format hostname:port. C’est le point de terminaison du service que vous devriez consulter ensuite.

  • NextMarker : Un jeton de continuation à utiliser dans une requête ultérieure Get Blob Layout pour récupérer le prochain ensemble de plages. Cet élément n’est présent que s’il y a des plages supplémentaires à récupérer.

  • MaxResults : Le nombre maximal de plages demandées dans l’appel API.

Authorization

L’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 de Get Blob Layout comme décrit ci-dessous.

Important

Microsoft recommande d’utiliser l’ID Microsoft Entra avec des identités managées pour autoriser les demandes adressées au stockage Azure. Microsoft Entra ID offre une sécurité et une facilité d’utilisation supérieures par rapport à l’autorisation de clé partagée.

Le Stockage Azure prend en charge l’utilisation de Microsoft Entra ID pour autoriser les requêtes d’accès aux données d’objets blob. Avec l’ID Microsoft Entra, 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 demande auprès du service Blob.

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

Permissions

Voici l’action RBAC nécessaire pour un utilisateur, un groupe, une identité managée ou un principal de service Microsoft Entra pour appeler l’opération de Get Blob Layout et le rôle RBAC Azure intégré le moins privilégié qui inclut cette action :

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

Remarks

  • Cette API est valable uniquement pour les blobs d’ajout et de blocage.

  • L’API peut réussir avec HTTP 200 (OK) ou HTTP 204 (Sans contenu). Si HTTP 204 est retourné, aucune information de disposition n’est disponible pour le blob, et l’API est fonctionnellement équivalente à Get Blob Properties. Si aucune information de mise en page n’est disponible, les clients doivent utiliser des appels standards Get Blob pour télécharger le blob.

  • Si une disposition est renvoyée, vous pouvez utiliser l’hôte et le port fournis dans chaque Plage pour télécharger le contenu du blob couvert par cette Plage. Il est fortement recommandé de conditionner ces téléchargements à l’ETag retourné de l’appel Get Blob Layout afin d’assurer une forte cohérence des lectures.

  • Les en-têtes x-ms-blob-content-* de réponse font référence au blob lui-même et non à la sous-ressource de mise en page. La Content-Type réponse est toujours application/xml si un corps de réponse a été retourné.

  • L’API accepte un Range en-tête ou.x-ms-range Si l’en-tête de plage est omis, la requête concerne l’ensemble du blob. L’API ne retournera jamais les plages qui dépassent l’en-tête Range.

  • L’API est paginanée. L’API peut ne pas retourner suffisamment de plages pour couvrir l’ensemble du blob, ou, pour les requêtes de plage, suffisamment de plages pour couvrir toute la plage demandée. Si cela arrive, l’API vous retournera un NextMarker objet que vous devriez utiliser pour demander des plages supplémentaires. Si un marqueur est utilisé, vous DEVEZ aussi réussir une If-Match condition correspondant à l’ETag de la requête qui a généré le marqueur. De plus, si la requête générant le marqueur incluait un Range en-tête ou, x-ms-range la requête suivante DOIT inclure un en-tête identique. Si la requête générant le marqueur n’incluait pas d’en-tête de plage, la requête suivante DOIT NON plus inclure d’en-tête de plage.

  • Vous NE DEVEZ PAS supposer que la liste des points de terminaison dans la réponse correspond à la liste des terminaux des requêtes précédentes Get Blob Layout à ce blob. Cela est vrai même si la requête utilise un marqueur – la liste des points de terminaison peut ne pas correspondre à la liste des terminaux de la requête qui a généré le marqueur.

  • Le terminaison retourné pour chaque plage est un nom d’hôte DNS et un port, renvoyés sous la forme hostname:port. C’est le point de terminaison du service qui doit être lu pour cette plage. Vous DEVEZ utiliser à la fois le nom d’hôte et le port spécifiés lors de la construction de votre requête HTTP. Le nom d’hôte ne peut pas inclure le nom du compte, vous DEVEZ donc explicitement ajouter l’en-tête approprié Host lors des appels API ultérieurs Get Blob sur ce point de terminaison.

  • La disposition d’un blob peut évoluer avec le temps, même si le blob n’est pas modifié. La disposition d’un blob donné doit être rafraîchie après cinq minutes, ou chaque fois que le blob est modifié.

Voir aussi

Autoriser les demandes adressées au stockage Azure
l’état et les codes d’erreur
Codes d’erreur Stockage Blob
Définir des délais d’attente pour les opérations de Stockage BlobConcepts de service BlobSpécifier des en-têtes conditionnels pour les opérations de Stockage Blob

  • Dernière mise à jour :