Répertorier les objets blob

L’opération List Blobs retourne une liste des objets blob sous le conteneur spécifié.

Demander

Vous pouvez construire la requête List Blobs comme suit. HTTPS est recommandé. Remplacez mon compte par le nom de votre compte de stockage.

URI du service de stockage émulé

Lorsque vous effectuez une requête sur le service de stockage émulé, spécifiez le nom d’hôte de l’émulateur et le port stockage Blob Azure comme 127.0.0.1:10000, suivi du nom du compte de stockage émulé.

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

Paramètres d’URI

Vous pouvez spécifier les paramètres supplémentaires suivants sur l’URI.

En-têtes de requête

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

Corps de la demande

Aucun.

Exemple de requête

Consultez énumération des ressources d’objets blob pour obtenir un exemple de requête.

Réponse

La réponse inclut un code d’état HTTP, un ensemble d’en-têtes de réponse et un corps de réponse au format XML.

Code d’état

Une opération réussie retourne le code d’état 200 (OK). 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 supplémentaires et standard. Tous les en-têtes standard sont conformes à la spécification de protocole HTTP/1.1.

Corps de la réponse

Le format de la réponse XML est le suivant.

Notez que les éléments Prefix, Marker, MaxResultset Delimiter sont présents uniquement s’ils ont été spécifiés sur l’URI de la requête. L’élément NextMarker a une valeur uniquement si les résultats de la liste ne sont pas terminés.

Les instantanés, les métadonnées d’objet blob et les objets blob non validés sont inclus dans la réponse uniquement s’ils sont spécifiés avec le paramètre include sur l’URI de requête.

Dans la version 2009-09-19 et ultérieures, les propriétés de l’objet blob sont encapsulées dans un élément Properties.

À compter de la version 2009-09-19, List Blobs retourne les éléments renommés suivants dans le corps de la réponse :

• Last-Modified (précédemment LastModified)

• Content-Length (précédemment Size)

• Content-Type (précédemment ContentType)

• Content-Encoding (précédemment ContentEncoding)

• Content-Language (précédemment ContentLanguage)

L’élément Content-MD5 apparaît pour les objets blob créés avec la version 2009-09-19 et ultérieures. Dans la version 2012-02-12 et ultérieures, Le Stockage Blob calcule la valeur Content-MD5 lorsque vous chargez un objet blob à l’aide de Put Blob. Le stockage d’objets blob ne calcule pas cela lorsque vous créez un objet blob à l’aide de Put Block List. Vous pouvez définir explicitement la valeur Content-MD5 lorsque vous créez l’objet blob, ou en appelant la Put Block List ou Définir les propriétés de l’objet blob opérations.

Pour les versions 2009-09-19 et ultérieures, mais avant la version 2015-02-21, vous ne pouvez pas appeler List Blobs sur un conteneur qui inclut des objets blob d’ajout. Le service retourne le code d’état 409 (conflit) si le résultat de la liste contient un objet blob d’ajout.

LeaseState et LeaseDuration apparaissent uniquement dans la version 2012-02-12 et ultérieures.

CopyId, CopyStatus, CopySource, CopyProgress, CopyCompletionTimeet CopyStatusDescription apparaissent uniquement dans la version 2012-02-12 et ultérieure, lorsque cette opération inclut le paramètre include={copy}. Ces éléments n’apparaissent pas si cet objet blob n’a jamais été la destination dans une opération de Copy Blob. Les éléments n’apparaissent pas si cet objet blob a été modifié après une opération de Copy Blob terminée, en utilisant Set Blob Properties, Put Blobou Put Block List. Ces éléments n’apparaissent pas non plus avec un objet blob créé par Copier un objet blob, avant la version 2012-02-12.

Dans la version 2013-08-15 et ultérieure, l’élément EnumerationResults contient un attribut ServiceEndpoint qui spécifie le point de terminaison d’objet blob. Cet élément contient également un champ ContainerName qui spécifie le nom du conteneur. Dans les versions précédentes, ces deux attributs ont été combinés dans le champ ContainerName. Dans la version 2013-08-15 et ultérieure, l’élément Url sous Blob a été supprimé.

Pour la version 2015-02-21 et ultérieure, List Blobs retourne des objets blob de tous les types (blocs, pages et objets blob d’ajout).

Pour la version 2015-12-11 et ultérieure, List Blobs retourne l’élément ServerEncrypted. Cet élément est défini sur true si les métadonnées de l’objet blob et de l’application sont entièrement chiffrées et false sinon.

Pour la version 2016-05-31 et ultérieure, List Blobs retourne l’élément IncrementalCopy pour les objets blob de copie incrémentielle et les instantanés, avec la valeur définie sur true.

Pour la version 2017-04-17 et ultérieure, List Blobs retourne l’élément AccessTier si un niveau d’accès a été défini explicitement. 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 les comptes Stockage Blob ou v2 universels, les valeurs valides sont Hot, Coolet Archive. Si l’objet blob est dans l’état en attente de réactivation, l’élément ArchiveStatus est retourné avec l’une des valeurs valides (rehydrate-pending-to-hot, rehydrate-pending-to-coolou rehydrate-pending-to-cold). Pour plus d’informations sur la hiérarchisation des objets blob de blocs, consultez niveaux de stockage chaud, froid et archive.

Pour la version 2017-04-17 et ultérieure, List Blobs retourne l’élément AccessTierInferred sur le stockage Blob ou les comptes v2 à usage général. Si l’objet blob de blocs n’a pas le jeu de niveaux d’accès, les informations de niveau sont déduites des propriétés du compte de stockage et cette valeur est définie sur true. Cet en-tête est présent uniquement si le niveau est déduit de la propriété du compte.

Pour la version 2017-04-17 et ultérieure, List Blobs retourne l’élément AccessTierChangeTime sur le stockage Blob ou les comptes v2 à usage général. Cela est retourné uniquement si le niveau sur l’objet blob de blocs a été défini. Pour plus d’informations, consultez Représentation des valeurs date-heure dans les en-têtes.

Pour la version 2017-07-29 et ultérieures, Deleted, DeletedTimeet RemainingRetentionDays apparaissent lorsque cette opération inclut le paramètre include={deleted}. Ces éléments n’apparaissent pas si cet objet blob n’a pas été supprimé. Ces éléments s’affichent pour les objets blob ou les instantanés supprimés avec l’opération de DELETE, lorsque la fonctionnalité de suppression réversible a été activée. L’élément Deleted est défini sur true pour les objets blob et les instantanés supprimés de manière réversible. Deleted-Time correspond à l’heure de suppression de l’objet blob. RemainingRetentionDays indique le nombre de jours après lesquels un objet blob supprimé de manière réversible est définitivement supprimé.

Pour la version 2017-11-09 et ultérieure, Creation-Time retourne l’heure à laquelle cet objet blob a été créé.

Pour la version 2019-02-02 et ultérieure, List Blobs retourne l’élément CustomerProvidedKeySha256 si l’objet blob est chiffré avec une clé fournie par le client. La valeur est définie sur le hachage SHA-256 de la clé utilisée pour chiffrer l’objet blob. En outre, si l’opération inclut le paramètre include={metadata} et qu’il existe des métadonnées d’application sur un objet blob chiffré avec une clé fournie par le client, l’élément Metadata aura un attribut Encrypted="true". Cet attribut indique que l’objet blob a des métadonnées qui ne peuvent pas être déchiffrées dans le cadre de l’opération de List Blobs. Pour accéder aux métadonnées de ces objets blob, appelez Obtenir des propriétés d’objet blob ou obtenir des métadonnées d’objet blob avec la clé fournie par le client.

Pour la version 2019-02-02 et ultérieure, List Blobs retourne l’élément EncryptionScope si l’objet blob est chiffré avec une étendue de chiffrement. La valeur est définie sur le nom de l’étendue de chiffrement utilisée pour chiffrer l’objet blob. Si l’opération inclut le paramètre include={metadata}, les métadonnées de l’application sur l’objet blob sont déchiffrées de manière transparente et disponibles dans l’élément Metadata.

Pour la version 2019-12-12 et ultérieure, List Blobs retourne l’élément RehydratePriority sur les comptes Stockage Blob ou v2 à usage général, si l’objet est dans l’état rehydrate pending. Les valeurs valides sont High et Standard.

Pour la version 2019-12-12 et ultérieure, List Blobs retourne l’élément VersionId pour les objets blob et les versions d’objets blob générées, lorsque le contrôle de version est activé sur le compte.

Pour la version 2019-12-12 et ultérieure, List Blobs retourne l’élément IsCurrentVersion pour la version actuelle de l’objet blob. La valeur est définie sur true. Cet élément vous permet de différencier la version actuelle des versions générées automatiquement en lecture seule.

Pour la version 2019-12-12 et ultérieure, List Blobs retourne l’élément TagCount pour les objets blob avec toutes les balises. L’élément Tags apparaît uniquement lorsque cette opération inclut le paramètre include={tags}. Ces éléments n’apparaissent pas s’il n’y a pas de balises sur l’objet blob.

Pour la version 2019-12-12 et ultérieure, List Blobs retourne l’élément Sealed pour les objets blob d’ajout. L’élément Sealed apparaît uniquement lorsque l’objet blob d’ajout a été scellé. Ces éléments n’apparaissent pas si l’objet blob d’ajout n’est pas scellé.

Pour la version 2020-02-10 et ultérieure, List Blobs retourne l’élément LastAccessTime. L’élément indique quand les données de l’objet blob ont été consultées pour la dernière fois, en fonction de la stratégie de suivi du dernier temps d’accès du compte de stockage. L’élément n’est pas retourné si le compte de stockage n’a pas cette stratégie 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, consultez la 'API du service Blob. L’élément LastAccessTime ne suit pas la dernière fois que les métadonnées de l’objet blob sont accessibles.

Pour la version 2020-06-12 et ultérieure, List Blobs retourne les éléments ImmutabilityPolicyUntilDate et ImmutabilityPolicyMode, lorsque cette opération inclut le paramètre include={immutabilitypolicy}.

Pour la version 2020-06-12 et ultérieure, List Blobs retourne l’élément LegalHold, lorsque cette opération inclut le paramètre include={legalhold}.

Pour la version 2020-06-12 et ultérieure, pour les comptes avec un espace de noms hiérarchique activé, List Blobs retourne les éléments Owner, Group, Permissionset Acl. La requête doit contenir le paramètre include={permissions}. Notez que l’élément Acl est une liste combinée d’accès et de listes de contrôle d’accès par défaut définies sur le fichier ou le répertoire.

Pour la version 2020-06-12 et ultérieure, pour les comptes avec un espace de noms hiérarchique activé, List Blobs avec un délimiteur retourne l’élément Properties dans l’élément BlobPrefix. Cela correspond aux propriétés du répertoire.

Pour la version 2020-08-04 et ultérieure, pour les comptes avec un espace de noms hiérarchique activé, List Blobs retourne l’élément DeletionId pour les objets blob supprimés. DeletionId est un identificateur 64 bits non signé. L’élément identifie de manière unique un chemin supprimé de manière réversible, pour le distinguer d’autres objets blob supprimés avec le même chemin d’accès.

Pour la version 2020-10-02 et ultérieure, pour les comptes avec un espace de noms hiérarchique activé, List Blobs retourne l’élément de propriété ResourceType pour le chemin d’accès. Cela peut être file ou directory.

Pour la version 2021-02-12 et ultérieure, List Blobs encodera en pourcentage (par RFC 2396) toutes les valeurs d’élément BlobName ou BlobPrefixName. Plus précisément, il le fera pour ces valeurs qui contiennent des caractères qui ne sont pas valides en XML (U+FFFE ou U+FFFF). S’il est encodé, l’élément Name inclut un attribut Encoded=true. Notez que cela se produit uniquement pour les valeurs d’élément Name contenant les caractères non valides dans XML, et non les éléments Name restants dans la réponse.

Pour la version 2021-06-08 et ultérieure, pour les comptes avec un espace de noms hiérarchique activé, List Blobs retourne l’élément de propriétés Placeholder. Elle retourne cet élément dans l’élément BlobPrefix pour les répertoires d’espaces réservés, lors de la liste des objets blob supprimés avec un délimiteur. Ces répertoires d’espace réservé existent pour faciliter la navigation vers des objets blob supprimés de manière réversible.

Pour la version 2021-06-08 et ultérieure, pour les comptes avec un espace de noms hiérarchique activé, List Blobs retourne l’élément EncryptionContext. Si la valeur de la propriété de contexte de chiffrement est définie, elle retourne la valeur définie.

Pour la version 2020-02-10 et ultérieure, pour les comptes avec un espace de noms hiérarchique activé, List Blobs retourne l’élément Expiry-Time pour les objets blob supprimés. Expiry-Time est l’heure à laquelle le fichier expire et est retourné pour le fichier si l’expiration est définie sur la même valeur.

<?xml version="1.0" encoding="utf-8"?>  
<EnumerationResults ServiceEndpoint="http://myaccount.blob.core.windows.net/"  ContainerName="mycontainer">  
  <Prefix>string-value</Prefix>  
  <Marker>string-value</Marker>  
  <MaxResults>int-value</MaxResults>  
  <Delimiter>string-value</Delimiter>  
  <Blobs>  
    <Blob>  
      <Name>blob-name</name>  
      <Snapshot>date-time-value</Snapshot>  
      <VersionId>date-time-vlue</VersionId>
      <IsCurrentVersion>true</IsCurrentVersion>
      <Deleted>true</Deleted>
      <Properties> 
        <Creation-Time>date-time-value</Creation-Time>
        <Last-Modified>date-time-value</Last-Modified>  
        <Etag>etag</Etag>
        <Owner>owner user id</Owner>
        <Group>owning group id</Group>
        <Permissions>permission string</Permissions>
        <Acl>access control list</Acl>
        <ResourceType>file | directory</ResourceType>
        <Placeholder>true</Placeholder>
        <Content-Length>size-in-bytes</Content-Length>  
        <Content-Type>blob-content-type</Content-Type>  
        <Content-Encoding />  
        <Content-Language />  
        <Content-MD5 />  
        <Cache-Control />  
        <x-ms-blob-sequence-number>sequence-number</x-ms-blob-sequence-number>  
        <BlobType>BlockBlob|PageBlob|AppendBlob</BlobType>  
        <AccessTier>tier</AccessTier>  
        <LeaseStatus>locked|unlocked</LeaseStatus>  
        <LeaseState>available | leased | expired | breaking | broken</LeaseState>  
        <LeaseDuration>infinite | fixed</LeaseDuration>  
        <CopyId>id</CopyId>  
        <CopyStatus>pending | success | aborted | failed </CopyStatus>  
        <CopySource>source url</CopySource>  
        <CopyProgress>bytes copied/bytes total</CopyProgress>  
        <CopyCompletionTime>datetime</CopyCompletionTime>  
        <CopyStatusDescription>error string</CopyStatusDescription>  
        <ServerEncrypted>true</ServerEncrypted> 
        <CustomerProvidedKeySha256>encryption-key-sha256</CustomerProvidedKeySha256>
        <EncryptionContext>encryption-context<EncryptionContext>
        <EncryptionScope>encryption-scope-name</EncryptionScope>
        <IncrementalCopy>true</IncrementalCopy>
        <AccessTierInferred>true</AccessTierInferred>
        <AccessTierChangeTime>datetime</AccessTierChangeTime>
        <DeletedTime>datetime</DeletedTime>
        <RemainingRetentionDays>no-of-days</RemainingRetentionDays>
        <TagCount>number of tags between 1 to 10</TagCount>
        <RehydratePriority>rehydrate priority</RehydratePriority>
        <Expiry-Time>date-time-value</Expiry-Time>
      </Properties>  
      <Metadata>     
        <Name>value</Name>  
      </Metadata>  
      <Tags>
          <TagSet>
              <Tag>
                  <Key>TagName</Key>
                  <Value>TagValue</Value>
              </Tag>
          </TagSet>
      </Tags>
      <OrMetadata />
    </Blob>  
    <BlobPrefix>  
      <Name>blob-prefix</Name>  
    </BlobPrefix>  
  </Blobs>  
  <NextMarker />  
</EnumerationResults>  

Exemple de réponse

Consultez énumération des ressources d’objets blob pour obtenir un exemple de réponse.

Autorisation

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

Remarques

Propriétés d’objet blob dans la réponse

Si vous avez demandé que les objets blob non validés soient inclus dans l’énumération, notez que certaines propriétés ne sont pas définies tant que l’objet blob n’est pas validé. Certaines propriétés peuvent ne pas être retournées dans la réponse.

L’élément x-ms-blob-sequence-number n’est retourné que pour les objets blob de pages.

L’élément OrMetadata n’est retourné que pour les objets blob de blocs.

Pour les objets blob de pages, la valeur retournée dans l’élément Content-Length correspond à la valeur de l’en-tête x-ms-blob-content-length de l’objet blob.

L’élément Content-MD5 apparaît dans le corps de la réponse, uniquement s’il a été défini sur l’objet blob à l’aide de la version 2009-09-19 ou ultérieure. Vous pouvez définir la propriété Content-MD5 lors de la création de l’objet blob ou en appelant Définir des propriétés d’objet blob. Dans la version 2012-02-12 et ultérieures, Put Blob définit la valeur MD5 d’un objet blob de blocs, même lorsque la demande de Put Blob n’inclut pas d’en-tête MD5.

Métadonnées dans la réponse

L’élément Metadata est présent uniquement si le paramètre include=metadata a été spécifié sur l’URI. Dans l’élément Metadata, la valeur de chaque paire nom-valeur est répertoriée dans un élément correspondant au nom de la paire.

Notez que les métadonnées demandées avec ce paramètre doivent être stockées conformément aux restrictions de nommage imposées par la version 2009-09-19 du Stockage Blob. À compter de cette version, tous les noms de métadonnées doivent respecter les conventions d’affectation de noms pour identificateurs C#.

Si une paire nom-valeur de métadonnées enfreint ces restrictions d’affectation de noms, le corps de la réponse indique le nom problématique dans un élément x-ms-invalid-name. Le fragment XML suivant montre ceci :

  
…  
<Metadata>  
  <MyMetadata1>first value</MyMetadata1>  
  <MyMetadata2>second value</MyMetadata2>  
  <x-ms-invalid-name>invalid-metadata-name</x-ms-invalid-name>  
</Metadata>  
…  
  

Balises dans la réponse

L’élément Tags est présent uniquement si le paramètre include=tags a été spécifié sur l’URI et s’il existe des balises sur l’objet blob. Dans l’élément TagSet, jusqu’à 10 éléments Tag sont retournés, chacun contenant les key et value des balises d’index blob définies par l’utilisateur. L’ordre des balises n’est pas garanti dans la réponse.

Les éléments Tags et TagCount ne sont pas retournés s’il n’y a pas de balises sur l’objet blob.

Le service de stockage maintient une cohérence forte entre un objet blob et ses balises, mais l’index secondaire est finalement cohérent. Les balises peuvent être visibles dans une réponse à List Blobs avant qu’elles ne soient visibles pour Find Blobs by Tags opérations.

Captures instantanées dans la réponse

Les instantanés sont répertoriés dans la réponse uniquement si le paramètre include=snapshots a été spécifié sur l’URI. Les instantanés répertoriés dans la réponse n’incluent pas l’élément LeaseStatus, car les instantanés ne peuvent pas avoir de baux actifs.

À l’aide du service version 2021-06-08 et ultérieure, vous pouvez appeler List Blobs avec un délimiteur et inclure des instantanés dans l’énumération. Pour les versions de service antérieures à 2021-06-08, une requête qui inclut les deux renvoie une erreur InvalidQueryParameter (code d’état HTTP 400 – Requête incorrecte).

Objets blob non validés dans la réponse

Les objets blob non validés sont répertoriés dans la réponse uniquement si le paramètre include=uncommittedblobs a été spécifié sur l’URI. Les objets blob non validés répertoriés dans la réponse n’incluent aucun des éléments suivants :

• Last-Modified

• Etag

• Content-Type

• Content-Encoding

• Content-Language

• Content-MD5

• Cache-Control

• Metadata

Objets blob supprimés dans la réponse

Les objets blob supprimés sont répertoriés dans la réponse uniquement si le paramètre include=deleted a été spécifié sur l’URI. Les objets blob supprimés répertoriés dans la réponse n’incluent pas les éléments Lease, car les objets blob supprimés ne peuvent pas avoir de baux actifs.

Les instantanés supprimés sont inclus dans la réponse de liste si include=deleted,snapshot a été spécifié sur l’URI.

Métadonnées de réplication d’objet dans la réponse

L’élément OrMetadata est présent lorsqu’une stratégie de réplication d’objet a été évaluée sur un objet blob et que l’appel List Blobs a été effectué à l’aide de la version 2019-12-12 ou ultérieure. Dans l’élément OrMetadata, la valeur de chaque paire nom-valeur est répertoriée dans un élément correspondant au nom de la paire. Le format du nom est or-{policy-id}_{rule-id}, où {policy-id} est un GUID qui représente l’identificateur de stratégie de réplication d’objet sur le compte de stockage. {rule-id} est un GUID qui représente l’identificateur de règle sur le conteneur de stockage. Les valeurs valides sont complete ou failed.

  
…  
<OrMetadata>  
  <or-e524bba7-4323-4b93-91f8-d09d5d0b7057_d86c51de-ef02-4264-bdcf-dcd389a6c7ac>complete</or-e524bba7-4323-4b93-91f8-d09d5d0b7057_d86c51de-ef02-4264-bdcf-dcd389a6c7ac>  
  <or-2b302b5d-fcd5-44d6-a5ed-455bf27e17ea_4a398ff5-2a89-4090-879b-10248f23428e>failed</or-2b302b5d-fcd5-44d6-a5ed-455bf27e17ea_4a398ff5-2a89-4090-879b-10248f23428e>  
</OrMetadata>  
…  
  

Stratégie d’immuabilité dans la réponse

Les éléments ImmutabilityPolicyUntilDate et ImmutabilityPolicyMode sont présents uniquement si le paramètre include=immutabilitypolicy a été spécifié sur l’URI.

<Properties> 
   <ImmutabilityPolicyUntilDate>date-time-value</ImmutabilityPolicyUntilDate>   
   <ImmutabilityPolicyMode>unlocked | locked </ImmutabilityPolicyMode>  
</Properties> 

Conservation légale dans la réponse

L’élément LegalHold est présent uniquement si le paramètre include=legalhold a été spécifié sur l’URI.

<Properties> 
  <LegalHold>true | false </LegalHold>  
</Properties> 

Retour de jeux de résultats à l’aide d’une valeur de marqueur

Si vous spécifiez une valeur pour le paramètre maxresults, et que le nombre d’objets blob à retourner dépasse cette valeur ou dépasse la valeur par défaut pour maxresults, le corps de la réponse contient un élément NextMarker. Cet élément indique l’objet blob suivant à retourner sur une requête ultérieure. Dans certains cas, le service peut renvoyer l’élément NextMarker même si le nombre de résultats retournés est inférieur à la valeur de maxresults.

Pour retourner le jeu d’éléments suivant, spécifiez la valeur de NextMarker comme paramètre de marqueur sur l’URI de la requête suivante. Notez que la valeur de NextMarker doit être traitée comme opaque.

Utilisation d’un délimiteur pour parcourir l’espace de noms d’objets blob

Le paramètre delimiter permet à l’appelant de parcourir l’espace de noms d’objets blob à l’aide d’un délimiteur configuré par l’utilisateur. De cette façon, vous pouvez parcourir une hiérarchie virtuelle d’objets blob comme s’il s’agissait d’un système de fichiers. Le délimiteur peut être un caractère unique ou une chaîne.

Lorsque la requête inclut ce paramètre, l’opération retourne un élément BlobPrefix. L’élément BlobPrefix est retourné à la place de tous les objets blob avec des noms commençant par la même sous-chaîne, jusqu’à l’apparence du caractère délimiteur. La valeur de l’élément BlobPrefix est sous-chaîne+délimiteur, où sous-chaîne est la sous-chaîne commune qui commence un ou plusieurs noms d’objets blob, et délimiteur est la valeur du paramètre delimiter.

Vous pouvez utiliser la valeur de BlobPrefix pour effectuer un appel ultérieur pour répertorier les objets blob qui commencent par ce préfixe. Pour ce faire, spécifiez la valeur de BlobPrefix pour le paramètre prefix sur l’URI de requête.

Notez que chaque élément BlobPrefix retourné compte vers le résultat maximal, tout comme chaque élément Blob.

Les objets blob sont répertoriés par ordre alphabétique dans le corps de la réponse, avec des lettres majuscules répertoriées en premier.

Erreurs de copie dans la description de l’état de copie

CopyStatusDescription contient plus d’informations sur l’échec Copy Blob.

• En cas d’échec d’une tentative de copie, CopyStatus est défini sur pending si le Stockage Blob tente toujours l’opération. Le texte CopyStatusDescription décrit l’échec qui a pu se produire lors de la dernière tentative de copie.

• Lorsque CopyStatus est défini sur failed, le texte CopyStatusDescription décrit l’erreur qui a provoqué l’échec de l’opération de copie.

Le tableau suivant décrit les champs de chaque valeur CopyStatusDescription.

Le tableau suivant décrit les valeurs CopyStatus et CopyStatusDescription des scénarios d’échec courants.

Facturation

Les demandes de tarification peuvent provenir de clients qui utilisent des API Stockage Blob, directement via l’API REST Stockage Blob ou à 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 en écriture. Le tableau suivant montre la catégorie de facturation pour les requêtes List Blobs 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 tarification du Stockage Blob Azure.

Voir aussi

l’état et les codes d’erreur
codes d’erreur Stockage Blob