Get Block List

L'opération Get Block List extrait la liste des blocs qui ont été téléchargés dans le cadre d'un objet blob de blocs.

Deux listes de blocs sont conservées pour un objet blob :

• Liste de blocs validée : liste des blocs qui ont été correctement validés dans un objet blob spécifié à l’aide de Put Block List.

• Liste de blocs non validée : liste des blocs qui ont été chargés pour un objet blob à l’aide de Put Block, mais qui n’ont pas encore été validés. Ces blocs sont stockés dans Azure en association avec un objet blob, mais ne font pas encore partie de l’objet blob.

Vous pouvez appeler Get Block List pour retourner la liste de blocs validée, la liste de blocs non validée ou les deux listes. Vous pouvez également appeler cette opération pour récupérer la liste de blocs validée pour un instantané.

Requête

La demande Get Block List peut être construite comme indiqué ci-dessous. Nous vous recommandons d’utiliser HTTPS. Remplacez moncompte par le nom de votre compte de stockage :

Demande de service de stockage émulée

Lorsque vous élaborez une demande pour le service de stockage émulé, spécifiez le nom d'hôte de l'émulateur et le port de service BLOB sous la forme 127.0.0.1:10000, suivi du nom de compte de stockage émulé :

Pour plus d’informations, consultez Utiliser l’émulateur Azurite à des fins de développement local pour Stockage Azure.

Paramètres URI

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

En-têtes de requête

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

Cette opération prend également en charge l'utilisation d'en-têtes conditionnels pour exécuter l'opération uniquement si une condition est remplie. Pour plus d’informations, consultez Spécifier des en-têtes conditionnels pour les opérations de stockage Blob.

Corps de la demande

Aucun.

Exemple de requête

L’exemple d’URI de requête suivant retourne la liste de blocs validée pour un objet blob nommé MOV1.avi :

GET http://myaccount.blob.core.windows.net/movies/MOV1.avi?comp=blocklist&blocklisttype=committed HTTP/1.1

L’exemple d’URI de requête suivant retourne à la fois la liste de blocs validée et la liste de blocs non validée :

GET http://myaccount.blob.core.windows.net/movies/MOV1.avi?comp=blocklist&blocklisttype=all HTTP/1.1

L’exemple d’URI de requête suivant retourne la liste de blocs validée pour un instantané. Un instantané se compose uniquement de blocs validés. Aucun bloc non validé n’est donc associé.

GET http://myaccount.blob.core.windows.net/mycontainer/myblob?comp=blocklist&snapshot=2009-09-30T20%3a11%3a15.2735974Z

response

La réponse comprend un code de status HTTP, un ensemble d’en-têtes de réponse et un corps de réponse qui contient la liste des blocs.

Code d’état

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

Pour plus d’informations sur les codes status, consultez État et codes 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 également 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.

Cette opération prend également en charge l’utilisation d’en-têtes conditionnels pour obtenir la liste de blocs 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.

Response body

Le format du corps de la réponse pour une demande qui retourne uniquement les blocs validés se présente comme suit :

<?xml version="1.0" encoding="utf-8"?>
<BlockList>
  <CommittedBlocks>
    <Block>
      <Name>base64-encoded-block-id</Name>
      <Size>size-in-bytes</Size>
    </Block>
  <CommittedBlocks>
</BlockList>

Le format du corps de la réponse pour une demande qui retourne les blocs validés et non validés se présente comme suit :

<?xml version="1.0" encoding="utf-8"?>
<BlockList>
  <CommittedBlocks>
     <Block>
        <Name>base64-encoded-block-id</Name>
        <Size>size-in-bytes</Size>
     </Block>
  </CommittedBlocks>
  <UncommittedBlocks>
    <Block>
      <Name>base64-encoded-block-id</Name>
      <Size>size-in-bytes</Size>
    </Block>
  </UncommittedBlocks>
 </BlockList>

Exemple de réponse

Dans l'exemple suivant, le paramètre blocklisttype a été défini à committed, afin que seuls les blocs validés de l'objet blob soient retournés dans la réponse.

HTTP/1.1 200 OK
Transfer-Encoding: chunked
Content-Type: application/xml
Server: Windows-Azure-Blob/1.0 Microsoft-HTTPAPI/2.0
x-ms-request-id: 42da571d-34f4-4d3e-b53e-59a66cb36f23
Date: Sun, 25 Sep 2011 00:33:19 GMT

<?xml version="1.0" encoding="utf-8"?>
<BlockList>
  <CommittedBlocks>
    <Block>
      <Name>BlockId001</Name>
      <Size>4194304</Size>
    </Block>
    <Block>
      <Name>BlockId002</Name>
      <Size>4194304</Size>
    </Block>
  </CommittedBlocks>
</BlockList>

Dans cet exemple, le paramètre blocklisttype a été défini à all, et les blocs validés et non validés de l'objet blob sont retournés dans la réponse.

HTTP/1.1 200 OK
Transfer-Encoding: chunked
Content-Type: application/xml
Server: Windows-Azure-Blob/1.0 Microsoft-HTTPAPI/2.0
x-ms-request-id: 42da571d-34f4-4d3e-b53e-59a66cb36f23
Date: Sun, 25 Sep 2011 00:35:56 GMT

<?xml version="1.0" encoding="utf-8"?>
<BlockList>
  <CommittedBlocks>
    <Block>
      <Name>BlockId001</Name>
      <Size>4194304</Size>
    </Block>
    <Block>
      <Name>BlockId002</Name>
      <Size>4194304</Size>
    </Block>
  </CommittedBlocks>
  <UncommittedBlocks>
    <Block>
      <Name>BlockId003</Name>
      <Size>4194304</Size>
    </Block>
    <Block>
      <Name>BlockId004</Name>
      <Size>1024000</Size>
    </Block>
  </UncommittedBlocks>
</BlockList>

Dans cet exemple suivant, le blocklisttype paramètre a été défini sur all, mais l’objet blob n’a pas encore été validé, de sorte que l’élément CommittedBlocks est vide.

HTTP/1.1 200 OK
Transfer-Encoding: chunked
Content-Type: application/xml
Server: Windows-Azure-Blob/1.0 Microsoft-HTTPAPI/2.0
x-ms-request-id: 42da571d-34f4-4d3e-b53e-59a66cb36f23
Date: Wed, 14 Sep 2011 00:40:22 GMT

<?xml version="1.0" encoding="utf-8"?>
<BlockList>
  <CommittedBlocks />
  <UncommittedBlocks>
    <Block>
      <Name>BlockId001</Name>
      <Size>1024</Size>
    </Block>
    <Block>
      <Name>BlockId002</Name>
      <Size>1024</Size>
    </Block>
    <Block>
      <Name>BlockId003</Name>
      <Size>1024</Size>
    </Block>
    <Block>
      <Name>BlockId004</Name>
      <Size>1024</Size>
    </Block>
  </UncommittedBlocks>
</BlockList>

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 Block List comme décrit ci-dessous.

Remarques

Appelez Get Block List pour retourner la liste des blocs qui ont été validés sur un objet blob de blocs, la liste des blocs qui n’ont pas encore été validés ou les deux listes. Utilisez le paramètre blocklisttype pour indiquer la liste des blocs à retourner. La liste des blocs approuvés est retournée dans l’ordre de leur validation par l’opération Put Block List .

Vous pouvez utiliser la liste de blocs non validée pour déterminer les blocs manquants dans l’objet blob dans les cas où les appels à Put Block ou Put Block List ont échoué. La liste des blocs non validés est retournée par ordre alphabétique. Si un ID de bloc a été téléchargé plusieurs fois, seul le bloc le plus récent s'affiche dans la liste.

Get Block List ne prend pas en charge l’accès concurrentiel lorsqu’il lit la liste des blocs non validés. Les appels à où blocklisttype=uncommitted ou blocklisttype=all ont un taux de requête maximal inférieur à Get Block List celui des autres opérations de lecture. Pour plus d’informations sur le débit cible pour les opérations de lecture, consultez Objectifs de scalabilité et de performances du Stockage Azure.

À partir de la version 2019-12-12, un objet blob de blocs peut contenir des blocs allant jusqu’à 4 000 mebioctets (Mio). Pour protéger les applications qui utilisent un entier 32 bits signé pour représenter la taille du bloc, l’appel Get Block List sur un objet blob de blocs qui contient un bloc supérieur à 100 Mio avec une version REST antérieure au 12-12-2019 entraîne status code 409 (Conflit).

Get Block List s'applique uniquement aux objets blob de blocs. L'appel de Get Block List sur un objet blob de pages produit un code d'état 400 (Demande incorrecte).

Get Block List sur un objet blob de blocs archivé échoue.

Facturation

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

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

Voir aussi

Autoriser les demandes à l’état du stockage Azureet les codes d’erreur Codes d’erreur Stockage BlobDéfinir des délais d’attente pour les opérations de stockage Blob