Lijst met blobs

De List Blobs bewerking retourneert een lijst met blobs onder de opgegeven container.

Verzoek

U kunt de List Blobs aanvraag als volgt samenstellen. HTTPS wordt aanbevolen. Vervang myaccount- door de naam van uw opslagaccount.

Methode	Aanvraag-URI	HTTP-versie
GET	https://myaccount.blob.core.windows.net/mycontainer?restype=container&comp=list	HTTP/1.1

Geëmuleerde opslagservice-URI

Wanneer u een aanvraag indient voor de geëmuleerde opslagservice, geeft u de hostnaam van de emulator en de Azure Blob Storage-poort op als 127.0.0.1:10000, gevolgd door de naam van het geëmuleerde opslagaccount.

Methode	Aanvraag-URI	HTTP-versie
GET	http://127.0.0.1:10000/devstoreaccount1/mycontainer?restype=container&comp=list	HTTP/1.1

Zie Azurite-emulator gebruiken voor lokale Azure Storage-ontwikkeling voor meer informatie.

URI-parameters

U kunt de volgende aanvullende parameters voor de URI opgeven.

Kenmerk	Beschrijving
prefix	Facultatief. Hiermee filtert u de resultaten zodat alleen blobs worden geretourneerd met namen die beginnen met het opgegeven voorvoegsel. In accounts met een hiërarchische naamruimte treedt er een fout op in gevallen waarin de naam van een bestand wordt weergegeven in het midden van het pad naar het voorvoegsel. U kunt bijvoorbeeld proberen blobs te vinden die een naam readmefile.txt hebben met behulp van het voorvoegselpad folder1/folder2/readme/readmefile.txt. Er verschijnt een foutmelding als een submap een bestand met de naam readme.
delimiter	Facultatief. Wanneer de aanvraag deze parameter bevat, retourneert de bewerking een BlobPrefix element in de hoofdtekst van het antwoord. Dit element fungeert als tijdelijke aanduiding voor alle blobs met namen die beginnen met dezelfde subtekenreeks, tot het uiterlijk van het scheidingsteken. Het scheidingsteken kan één teken of een tekenreeks zijn.
marker	Facultatief. Een tekenreekswaarde die het deel van de lijst aangeeft dat moet worden geretourneerd met de volgende lijstbewerking. De bewerking retourneert een markeringswaarde in de hoofdtekst van het antwoord als de geretourneerde lijst niet is voltooid. Vervolgens kunt u de markeringswaarde in een volgende aanroep gebruiken om de volgende set lijstitems aan te vragen. De markeringswaarde is ondoorzichtig voor de client.
maxresults	Facultatief. Hiermee geeft u het maximale aantal blobs op dat moet worden geretourneerd, inclusief alle BlobPrefix elementen. Als de aanvraag geen maxresultsopgeeft of een waarde groter dan 5.000 opgeeft, retourneert de server maximaal 5000 items. Als er aanvullende resultaten zijn die moeten worden geretourneerd, retourneert de service een vervolgtoken in het NextMarker antwoordelement. In bepaalde gevallen kan de service minder resultaten retourneren dan gespecificeerd door maxresults, en ook een voortzettingstoken retourneren. Als u maxresults instelt op een waarde die kleiner is dan of gelijk is aan nul, resulteert dit in foutcode 400 (Ongeldige aanvraag).
include={snapshots,metadata,uncommittedblobs,copy,deleted,tags,versions, deletedwithversions,immutabilitypolicy,legalhold,permissions}	Facultatief. Hiermee geeft u een of meer gegevenssets op die moeten worden opgenomen in het antwoord: - snapshots: Geeft aan dat momentopnamen moeten worden opgenomen in de opsomming. Momentopnamen worden weergegeven van oud naar nieuw in het antwoord. - metadata: Geeft aan dat blobmetagegevens moeten worden geretourneerd in het antwoord. - uncommittedblobs: Hiermee geeft u aan dat blobs waarvoor blokken zijn geüpload, maar die niet zijn vastgelegd met behulp van Put Block List, worden opgenomen in het antwoord. - copy: Versie 2012-02-12 en later. Hiermee geeft u aan dat metagegevens met betrekking tot een huidige of eerdere Copy Blob bewerking in het antwoord moeten worden opgenomen. - deleted: Versie 2017-07-29 en later. Hiermee geeft u op dat voorlopig verwijderde blobs moeten worden opgenomen in het antwoord. - tags: Versie 2019-12-12 en later. Hiermee geeft u op dat door de gebruiker gedefinieerde blob-indextags moeten worden opgenomen in het antwoord. - versions: Versie 2019-12-12 en later. Hiermee geeft u op dat versies van blobs moeten worden opgenomen in de opsomming. - deletedwithversions: Versie 2020-10-02 en later. Hiermee geeft u op dat verwijderde blobs met alle versies (actief of verwijderd) moeten worden opgenomen in het antwoord. Items die u definitief hebt verwijderd, worden in het antwoord weergegeven totdat ze worden verwerkt door garbagecollection. Gebruik de tag \<HasVersionsOnly\>en de waarde true. - immutabilitypolicy: Versie 2020-06-12 en later. Hiermee geeft u op dat de opsomming het beleid voor onveranderbaarheid moet bevatten tot datum en de onveranderbaarheidsbeleidsmodus van de blobs. - legalhold: Versie 2020-06-12 en later. Hiermee geeft u op dat de opsomming de juridische bewaring van blobs moet bevatten. - permissions: Versie 2020-06-12 en later. Alleen ondersteund voor accounts waarvoor een hiërarchische naamruimte is ingeschakeld. Als een aanvraag deze parameter bevat, worden de eigenaar, groep, machtigingen en toegangsbeheerlijst voor de vermelde blobs of mappen opgenomen in de opsomming. Als u meer dan één van deze opties op de URI wilt opgeven, moet u elke optie scheiden met een URL-gecodeerde komma ("%82").
showonly={deleted,files,directories}	Facultatief. Hiermee geeft u een van deze gegevenssets die moeten worden geretourneerd in het antwoord: - deleted:Facultatief. Versie 2020-08-04 en hoger. Alleen voor accounts die zijn ingeschakeld met hiërarchische naamruimte. Wanneer een aanvraag deze parameter bevat, bevat de lijst alleen voorlopig verwijderde blobs. Houd er rekening mee dat het terugval van POSIX ACL-autorisatie niet wordt ondersteund voor het weergeven van voorlopig verwijderde blobs. Als include=deleted ook is opgegeven, mislukt de aanvraag met Ongeldige aanvraag (400). - files:Facultatief. Versie 2020-12-06 en hoger. Alleen voor accounts die zijn ingeschakeld met hiërarchische naamruimte. Wanneer een aanvraag deze parameter bevat, bevat de lijst alleen bestanden. - directories:Facultatief. Versie 2020-12-06 en hoger. Alleen voor accounts die zijn ingeschakeld met hiërarchische naamruimte. Wanneer een aanvraag deze parameter bevat, bevat de lijst alleen mappen.
timeout	Facultatief. De parameter timeout wordt uitgedrukt in seconden. Zie Time-outs instellen voor Blob Storage-bewerkingen voor meer informatie.

Aanvraagheaders

In de volgende tabel worden de vereiste en optionele aanvraagheaders beschreven.

Aanvraagheader	Beschrijving
Authorization	Vereist. Hiermee geeft u het autorisatieschema, de accountnaam en de handtekening op. Zie Aanvragen autoriseren voor Azure Storagevoor meer informatie.
Date of x-ms-date	Vereist. Hiermee geeft u de Coordinated Universal Time (UTC) voor de aanvraag. Zie Aanvragen autoriseren voor Azure Storagevoor meer informatie.
x-ms-version	Vereist voor alle geautoriseerde aanvragen en optioneel voor anonieme aanvragen. Hiermee geeft u de versie van de bewerking die moet worden gebruikt voor deze aanvraag. Zie Versiebeheer voor de Azure Storage-servicesvoor meer informatie.
x-ms-client-request-id	Facultatief. Biedt een door de client gegenereerde, ondoorzichtige waarde met een tekenlimiet van 1 kibibyte (KiB) die wordt vastgelegd in de logboeken wanneer logboekregistratie is geconfigureerd. We raden u ten zeerste aan deze header te gebruiken om activiteiten aan de clientzijde te correleren met aanvragen die de server ontvangt. Zie Azure Blob Storage-bewaken voor meer informatie.
x-ms-upn	Facultatief. Alleen geldig als er een hiërarchische naamruimte is ingeschakeld voor het account en include=permissions deze in de aanvraag wordt opgegeven. Als true, worden de waarden voor de gebruikersidentiteit die worden geretourneerd in de <velden Eigenaar>, <Groep> en <Acl,> getransformeerd van Microsoft Entra-object-id's naar gebruikers-principalnamen. Als false, worden de waarden geretourneerd als Microsoft Entra-object-id's. De standaardwaarde is false. Houd er rekening mee dat groeps- en toepassingsobject-id's niet worden vertaald omdat ze geen unieke beschrijvende namen hebben.

Aanvraagbody

Geen.

Voorbeeldaanvraag

Zie Blobresources opsommen voor een voorbeeldaanvraag.

Antwoord

Het antwoord bevat een HTTP-statuscode, een set antwoordheaders en een antwoordtekst in XML-indeling.

Statuscode

Een geslaagde bewerking retourneert statuscode 200 (OK). Zie Status en foutcodesvoor meer informatie over statuscodes.

Antwoordheaders

Het antwoord voor deze bewerking bevat de volgende headers. Het antwoord kan ook aanvullende, standaard HTTP-headers bevatten. Alle standaardheaders voldoen aan de HTTP/1.1-protocolspecificatie.

Antwoordheader	Beschrijving
Content-Type	Hiermee geeft u de indeling op waarin de resultaten worden geretourneerd. Deze waarde is momenteel application/xml.
x-ms-request-id	Deze header identificeert de aanvraag die is gemaakt en kan worden gebruikt voor het oplossen van problemen met de aanvraag. Zie Problemen met API-bewerkingen oplossenvoor meer informatie.
x-ms-version	Geeft de versie van Blob Storage aan die wordt gebruikt om de aanvraag uit te voeren. Deze header wordt geretourneerd voor aanvragen die zijn gedaan met versie 2009-09-19 en hoger. Deze header wordt ook geretourneerd voor anonieme aanvragen, zonder een versie die is opgegeven, als de container is gemarkeerd voor openbare toegang met behulp van de 2009-09-19-versie van Blob Storage.
Date	Een UTC-datum/tijd-waarde die de tijd aangeeft waarop het antwoord is gestart. De service genereert deze waarde.
x-ms-client-request-id	U kunt deze header gebruiken om problemen met aanvragen en bijbehorende antwoorden op te lossen. De waarde van deze header is gelijk aan de waarde van de x-ms-client-request-id-header als deze aanwezig is in de aanvraag. De waarde is maximaal 1024 zichtbare ASCII-tekens. Als de x-ms-client-request-id header niet aanwezig is in de aanvraag, is deze header niet aanwezig in het antwoord.

Hoofdtekst van antwoord

De indeling van het XML-antwoord is als volgt.

Houd er rekening mee dat de Prefix, Marker, MaxResults, en Delimiter elementen alleen aanwezig zijn als ze zijn opgegeven in de aanvraag-URI. Als NextMarker deze leeg is, zijn de resultaten van de lijst compleet. Als de NextMarkerniet leeg is , kunnen de resultaten van de lijst al dan niet compleet zijn. Als u alle blobs wilt weergeven, gaat u door met aanroepen List Blobs met de volgende markeringswaarden totdat NextMarker deze leeg is.

Momentopnamen, blobmetagegevens en niet-vastgelegde blobs worden alleen in het antwoord opgenomen als ze zijn opgegeven met de include parameter op de aanvraag-URI.

In versie 2009-09-19 en hoger zijn de eigenschappen van de blob ingekapseld in een Properties element.

Vanaf versie 2009-09-19 List Blobs worden de volgende hernoemde elementen in de hoofdtekst van het antwoord geretourneerd:

• Last-Modified (voorheen LastModified)

• Content-Length (voorheen Size)

• Content-Type (voorheen ContentType)

• Content-Encoding (voorheen ContentEncoding)

• Content-Language (voorheen ContentLanguage)

Het Content-MD5 element wordt weergegeven voor blobs die zijn gemaakt met versie 2009-09-19 en hoger. In versie 2012-02-12 en hoger berekent Blob Storage de Content-MD5 waarde wanneer u een blob uploadt met behulp van Put Blob. Blob Storage berekent dit niet wanneer u een blob maakt met behulp van Put Block List. U kunt de Content-MD5 waarde expliciet instellen wanneer u de blob maakt of door de bewerkingen Blokkeerlijst plaatsen of Blobeigenschappen instellen aan te roepen.

Voor versies van 2009-09-19 en hoger, maar vóór versie 2015-02-21, kunt u geen container aanroepen List Blobs die toevoeg-blobs bevat. De service retourneert statuscode 409 (Conflict) als het resultaat van de vermelding een toevoeg-blob bevat.

LeaseState en LeaseDuration worden alleen weergegeven in versie 2012-02-12 en hoger.

CopyId, CopyStatus, CopySource, CopyProgress, , CopyCompletionTimeen CopyStatusDescription worden alleen weergegeven in versie 2012-02-12 en hoger, wanneer deze bewerking de include={copy} parameter bevat. Deze elementen worden niet weergegeven als deze blob nooit de bestemming in een Copy Blob bewerking is geweest. De elementen worden niet weergegeven als deze blob is gewijzigd na een voltooide Copy Blob bewerking, met behulp van Set Blob Properties, Put Blob, of Put Block List. Deze elementen worden ook niet weergegeven met een blob die is gemaakt door Copy Blob, vóór versie 2012-02-12.

In versie 2013-08-15 en hoger bevat het EnumerationResults element een ServiceEndpoint kenmerk dat het blob-eindpunt opgeeft. Dit element bevat ook een ContainerName veld dat de naam van de container opgeeft. In eerdere versies werden deze twee attributen in het ContainerName veld gecombineerd. Ook in versie 2013-08-15 en later is het Url element eronder Blob verwijderd.

Voor versie 2015-02-21 en hoger worden List Blobs alle soorten blobs geretourneerd (blobs voor blokken, pagina's en toevoegen).

Voor versie 2015-12-11 en hoger List Blobs geeft u het ServerEncrypted element als resultaat. Dit element is ingesteld op true als de blob en de metagegevens van de toepassing volledig zijn versleuteld en false anderszins.

Voor versie 2016-05-31 en hoger List Blobs wordt het IncrementalCopy element voor incrementele kopieerblobs en momentopnamen geretourneerd, waarbij de waarde is ingesteld op true.

Voor versie 2017-04-17 en hoger List Blobs wordt het element geretourneerd als er AccessTier expliciet een toegangslaag is ingesteld. Zie High-performance Premium-opslag en beheerde schijven voor VM's voor een lijst met toegestane Premium-pagina-bloblagen. Voor Blob Storage- of v2-accounts voor algemeen gebruik zijn Hotde geldige waarden , Cool, en Archive. Als de blob zich in de status rehydrateert in afwachting heeft, ArchiveStatus wordt het element geretourneerd met een van de geldige waarden (rehydrate-pending-to-hot, rehydrate-pending-to-cool, of rehydrate-pending-to-cold). Zie Hot, Cool en archive storage tiers voor gedetailleerde informatie over blokbloblagen.

Voor versie 2017-04-17 en hoger List Blobs wordt het AccessTierInferred element geretourneerd voor Blob Storage of v2-accounts voor algemeen gebruik. Als de toegangslaag niet is ingesteld op de blok-blob, wordt laaginformatie afgeleid uit de eigenschappen van het opslagaccount en wordt deze waarde ingesteld op true. Deze header is alleen aanwezig als de laag wordt afgeleid van de accounteigenschap.

Voor versie 2017-04-17 en hoger List Blobs wordt het AccessTierChangeTime element geretourneerd voor Blob Storage of v2-accounts voor algemeen gebruik. Dit wordt alleen geretourneerd als de laag op blok-blob ooit is ingesteld. Zie Weergave van datum/tijd-waarden in koptekstenvoor meer informatie.

Voor versie 2017-07-29 en hoger, , DeletedDeletedTimeen RemainingRetentionDays verschijnen wanneer deze bewerking de include={deleted} parameter bevat. Deze elementen worden niet weergegeven als deze blob niet is verwijderd. Deze elementen worden weergegeven voor blobs of momentopnamen die worden verwijderd met de DELETE bewerking, wanneer de functie voor voorlopig verwijderen was ingeschakeld. Het Deleted element is ingesteld op true voor blobs en momentopnamen die voorlopig zijn verwijderd. Deleted-Time Komt overeen met het tijdstip waarop de blob is verwijderd. RemainingRetentionDays Geeft het aantal dagen aan waarna een voorlopig verwijderde blob definitief wordt verwijderd.

Voor versie 2017-11-09 en hoger Creation-Time geeft u als resultaat het tijdstip waarop deze blob is gemaakt.

Voor versie 2019-02-02 en hoger List Blobs wordt het CustomerProvidedKeySha256 element geretourneerd als de blob is versleuteld met een door de klant opgegeven sleutel. De waarde wordt ingesteld op de SHA-256-hash van de sleutel die wordt gebruikt om de blob te versleutelen. Als de bewerking de include={metadata} parameter bevat en er metagegevens van de toepassing aanwezig zijn op een blob die is versleuteld met een door de klant opgegeven sleutel, heeft het Metadata element bovendien een Encrypted="true" kenmerk. Dit kenmerk geeft aan dat de blob metagegevens heeft die niet kunnen worden ontcijferd als onderdeel van de List Blobs bewerking. Als u toegang wilt tot de metagegevens voor deze blobs, roept u Blob-eigenschappen ophalen of Blob-metagegevens ophalen aan met de door de klant opgegeven sleutel.

Voor versie 2019-02-02 en hoger List Blobs wordt het EncryptionScope element geretourneerd als de blob is versleuteld met een versleutelingsbereik. De waarde wordt ingesteld op de naam van het versleutelingsbereik dat wordt gebruikt om de blob te versleutelen. Als de bewerking de include={metadata} parameter bevat, worden de metagegevens van de toepassing op de blob transparant gedecodeerd en beschikbaar in het Metadata element.

Voor versie 2019-12-12 en hoger List Blobs wordt het RehydratePriority element op Blob Storage- of v2-accounts voor algemeen gebruik geretourneerd als het object zich in de rehydrate pending status bevindt. Geldige waarden zijn High en Standard.

Voor versie 2019-12-12 en hoger List Blobs retourneert u het VersionId element voor blobs en gegenereerde blobversies, wanneer versiebeheer is ingeschakeld voor het account.

Voor versie 2019-12-12 en hoger List Blobs retourneert u het IsCurrentVersion element voor de huidige versie van de blob. De waarde is ingesteld op true. Met dit element kunt u de huidige versie onderscheiden van de alleen-lezen, automatisch gegenereerde versies.

Voor versie 2019-12-12 en hoger List Blobs retourneert u het TagCount element voor blobs met eventuele tags. Het Tags element verschijnt alleen wanneer deze bewerking de include={tags} parameter bevat. Deze elementen worden niet weergegeven als er geen tags op de blob staan.

Voor versie 2019-12-12 en hoger List Blobs retourneert u het Sealed element voor het toevoegen van blobs. Het Sealed element wordt alleen weergegeven wanneer de toevoegingsblob is verzegeld. Deze elementen worden niet weergegeven als de toevoeg-blob niet is verzegeld.

Voor versie 2020-02-10 en hoger List Blobs retourneert u het LastAccessTime element. Het element laat zien wanneer de gegevens van de blob voor het laatst zijn geopend, volgens het laatste beleid voor het bijhouden van toegangstijd van het opslagaccount. Het element wordt niet geretourneerd als het opslagaccount dit beleid niet heeft of als het beleid is uitgeschakeld. Zie de Blob Service-API voor meer informatie over het instellen van het tijdregistratiebeleid voor laatste toegang van het account. Het LastAccessTime element houdt niet bij wanneer de metagegevens van de blob voor het laatst zijn geopend.

Voor versie 2020-06-12 en hoger List Blobs retourneert u de ImmutabilityPolicyUntilDate en ImmutabilityPolicyMode elementen, wanneer deze bewerking de include={immutabilitypolicy} parameter bevat.

Voor versie 2020-06-12 en hoger List Blobs wordt het LegalHold element geretourneerd wanneer deze bewerking de include={legalhold} parameter bevat.

Voor versie 2020-06-12 en hoger, voor accounts waarvoor een hiërarchische naamruimte is ingeschakeld, List Blobs worden de Owner, Group, Permissions, en Acl elementen geretourneerd. Het verzoek moet de include={permissions} parameter bevatten. Houd er rekening mee dat het Acl element een gecombineerde lijst is van toegangs- en standaardtoegangscontrolelijsten die zijn ingesteld voor het bestand of de map.

Voor versie 2020-06-12 en hoger, voor accounts waarvoor een hiërarchische naamruimte is ingeschakeld, List Blobs retourneert een scheidingsteken met een scheidingsteken het Properties element in het BlobPrefix element. Dit komt overeen met de eigenschappen in de map.

Voor versie 2020-08-04 en hoger, voor accounts waarvoor een hiërarchische naamruimte is ingeschakeld, List Blobs wordt het element voor verwijderde DeletionId blobs geretourneerd. DeletionId is een niet-ondertekende, 64-bits ID. Het element identificeert een voorlopig verwijderd pad om het te onderscheiden van andere verwijderde blobs met hetzelfde pad.

Voor versie 2020-10-02 en hoger, voor accounts waarvoor een hiërarchische naamruimte is ingeschakeld, List Blobs wordt het ResourceType eigenschapselement voor het pad geretourneerd. Dit kan of file zijn directory.

Voor versie 2021-02-12 en hoger List Blobs worden alle BlobPrefixBlobNameName of elementwaarden procentueel gecodeerd (volgens RFC 2396). Dit doet u met name voor waarden die tekens bevatten die niet geldig zijn in XML (U+FFFE of U+FFFF). Als dit is gecodeerd, bevat het Name-element een Encoded=true kenmerk. Houd er rekening mee dat dit alleen gebeurt voor de Name elementwaarden die de tekens bevatten die ongeldig zijn in XML, niet voor de overige Name elementen in het antwoord.

Voor versie 2021-06-08 en hoger, voor accounts waarvoor een hiërarchische naamruimte is ingeschakeld, List Blobs wordt het Placeholder eigenschappenelement geretourneerd. Dit element wordt geretourneerd in het element voor tijdelijke aanduidingenmappen bij het weergeven van verwijderde BlobPrefix blobs met een scheidingsteken. Deze tijdelijke aanduidingen bestaan om navigatie naar voorlopig verwijderde blobs te vergemakkelijken.

Voor versie 2021-06-08 en hoger, voor accounts waarvoor een hiërarchische naamruimte is ingeschakeld, List Blobs wordt het EncryptionContext element geretourneerd. Als de eigenschapswaarde van de versleutelingscontext is ingesteld, wordt de ingestelde waarde geretourneerd.

Voor versie 2020-02-10 en hoger, voor accounts waarvoor een hiërarchische naamruimte is ingeschakeld, List Blobs wordt het element voor verwijderde Expiry-Time blobs geretourneerd. Expiry-Time is het tijdstip waarop het bestand verloopt en wordt geretourneerd voor het bestand als de vervaldatum op hetzelfde is ingesteld.

<?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>  

Voorbeeldantwoord

Zie Blobresources opsommen voor een voorbeeldantwoord.

Machtiging

Autorisatie is vereist bij het aanroepen van een bewerking voor gegevenstoegang in Azure Storage. U kunt de List Blobs bewerking autoriseren zoals hieronder wordt beschreven.

Belangrijk

Microsoft raadt aan om Microsoft Entra ID met beheerde identiteiten te gebruiken om aanvragen voor Azure Storage te autoriseren. Microsoft Entra ID biedt superieure beveiliging en gebruiksgemak in vergelijking met autorisatie van gedeelde sleutels.

Microsoft Entra-id (aanbevolen)

Azure Storage ondersteunt het gebruik van Microsoft Entra ID om aanvragen voor blobgegevens te autoriseren. Met Microsoft Entra ID kunt u op rollen gebaseerd toegangsbeheer van Azure (Azure RBAC) gebruiken om machtigingen te verlenen aan een beveiligingsprincipaal. De beveiligingsprincipaal kan een door een gebruiker, groep, toepassingsservice-principal of door Azure beheerde identiteit zijn. De beveiligingsprincipaal wordt geverifieerd door de Microsoft Entra-id om een OAuth 2.0-token te retourneren. Het token kan vervolgens worden gebruikt om een aanvraag te autoriseren voor de Blob-service.

Zie Toegang tot blobs autoriseren met behulp van Microsoft Entra IDvoor meer informatie over autorisatie met Behulp van Microsoft Entra ID.

Machtigingen

Hieronder vindt u de RBAC-actie die nodig is voor een Microsoft Entra-gebruiker, groep, beheerde identiteit of service-principal om de List Blobs-bewerking aan te roepen, en de minst bevoorrechte ingebouwde Azure RBAC-rol die deze actie omvat:

• Azure RBAC-actie:Microsoft.Storage/storageAccounts/blobServices/containers/blobs/read
• Ingebouwde rol met minste bevoegdheden:Storage Blob Data Reader

Indien gespecificeerd include=tags:

• Azure RBAC-actie:Microsoft.Storage/storageAccounts/blobServices/containers/blobs/tags/read
• ingebouwde rol met minimale bevoegdheden:eigenaar van opslagblobgegevens

Zie Een Azure-rol toewijzen voor toegang tot blobgegevensvoor meer informatie over het toewijzen van rollen met behulp van Azure RBAC.

Een Shared Access Signature (SAS) biedt beveiligde gedelegeerde toegang tot resources in een opslagaccount. Met een SAS hebt u gedetailleerde controle over hoe een client toegang heeft tot gegevens. U kunt opgeven tot welke resource de client toegang heeft, tot welke machtigingen deze resources beschikken en hoe lang de SAS geldig is.

De bewerking ondersteunt drie typen handtekeningen voor gedeelde toegang: SAS-voor gebruikersdelegering, SAS-van service en SAS--account-.

Het is raadzaam om microsoft Entra-referenties te gebruiken in plaats van de sleutel van het opslagaccount, wat gemakkelijker kan worden aangetast. Als voor uw toepassingsontwerp handtekeningen voor gedeelde toegang zijn vereist, gebruikt u Microsoft Entra-referenties om, indien mogelijk, een SAS voor gebruikersdelegatie te maken.

Wanneer toegang tot gedeelde sleutels niet is toegestaan voor het opslagaccount, is een SAS-token van de service of een SAS-accounttoken niet toegestaan bij een aanvraag naar Blob Storage. Zie Begrijpen hoe de toewijzing van gedeelde sleutels van invloed is op SAS-tokensvoor meer informatie.

SAS voor gebruikersdelegering

Een SAS voor gebruikersdelegering wordt beveiligd met Microsoft Entra-referenties en ook met de machtigingen die zijn opgegeven voor de SAS.

Voor het aanroepen van de List Blobs bewerking met behulp van een SAS-token dat is gedelegeerd aan een containerresource, is de machtiging Lijst (l) vereist als onderdeel van het SAS-token voor gebruikersdelegering.

Zie Sas voor gebruikersdelegering makenvoor meer informatie over de SAS voor gebruikersdelegering.

Service-SAS

Een service-SAS wordt beveiligd met de sleutel van het opslagaccount. Een service-SAS delegeert de toegang tot een resource in één Azure Storage-service, zoals blobopslag.

Voor het aanroepen van de List Blobs bewerking met behulp van een SAS-token dat is gedelegeerd aan een containerresource, is de machtiging Lijst (l) vereist als onderdeel van het SAS-token van de service.

Zie Een service-SAS-maken voor meer informatie over de SERVICE-SAS.

Account-SAS

Een account-SAS wordt beveiligd met de sleutel van het opslagaccount. Een account-SAS delegeert toegang tot resources in een of meer van de opslagservices. Alle bewerkingen die beschikbaar zijn via een service of gebruikersdelegering-SAS, zijn ook beschikbaar via een account-SAS.

De volgende tabel geeft het ondertekende resourcetype en de ondertekende machtigingen aan die moeten worden opgegeven bij het delegeren van toegang:

Operatie	Ondertekende service	Ondertekend resourcetype	Ondertekende machtiging
Lijst met blobs	Klodder (b)	Container (c)	Lijst (l)

Zie Een SAS-account makenvoor meer informatie over de ACCOUNT-SAS.

gedeelde sleutel

De List Blobs-bewerking ondersteunt autorisatie van gedeelde sleutels. Autoriseren met accountsleutels wordt niet aanbevolen voor de meeste scenario's, omdat het minder veilig is.

Microsoft raadt u aan de toewijzing van gedeelde sleutelautorisatie voor het opslagaccount indien mogelijk ongedaan te maken. Zie Autorisatie voorkomen met gedeelde sleutel voor meer informatie.

Opmerkingen

Blobeigenschappen in het antwoord

Als u hebt gevraagd dat niet-doorgevoerde blobs worden opgenomen in de opsomming, moet u er rekening mee houden dat sommige eigenschappen pas zijn ingesteld als de blob is doorgevoerd. Sommige eigenschappen worden mogelijk niet geretourneerd in het antwoord.

Het x-ms-blob-sequence-number element wordt alleen geretourneerd voor pagina-blobs.

Het OrMetadata element wordt alleen geretourneerd voor blokblobs.

Voor pagina-blobs komt de waarde die in het Content-Length element wordt geretourneerd overeen met de waarde van de koptekst van de blob x-ms-blob-content-length .

Het Content-MD5 element wordt alleen weergegeven in de hoofdtekst van het antwoord als het op de blob is ingesteld met behulp van versie 2009-09-19 of hoger. U kunt de Content-MD5 eigenschap instellen wanneer de blob wordt gemaakt of door Blobeigenschappen instellen aan te roepen. In versie 2012-02-12 en hoger stelt Put Blob u de MD5-waarde van een blokblob in, zelfs als de Put Blob aanvraag geen MD5-header bevat.

Metagegevens in het antwoord

Het Metadata element is alleen aanwezig als de include=metadata parameter in de URI is opgegeven. Binnen het Metadata element wordt de waarde van elk naam-waardepaar weergegeven in een element dat overeenkomt met de naam van het paar.

Houd er rekening mee dat metagegevens die met deze parameter zijn aangevraagd, moeten worden opgeslagen in overeenstemming met de naamgevingsbeperkingen die zijn opgelegd door de 2009-09-19-versie van Blob Storage. Vanaf deze versie moeten alle metagegevensnamen voldoen aan de naamgevingsconventies voor C#-id's.

Als een naam-waardepaar van metagegevens deze naamgevingsbeperkingen schendt, geeft de hoofdtekst van het antwoord de problematische naam binnen een x-ms-invalid-name element aan. In het volgende XML-fragment ziet u dit:

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

Tags in het antwoord

Het Tags element is alleen aanwezig als de include=tags parameter is opgegeven in de URI en als er tags op de blob staan. Binnen het TagSet element worden maximaal 10 Tag elementen geretourneerd, die elk de key en value van de door de gebruiker gedefinieerde blobindextags bevatten. De volgorde van tags wordt niet gegarandeerd in het antwoord.

De Tags elementen en TagCount worden niet geretourneerd als er geen tags op de blob staan.

De opslagservice behoudt sterke consistentie tussen een blob en de bijbehorende tags, maar de secundaire index is uiteindelijk consistent. Tags kunnen zichtbaar zijn in een reactie op List Blobs voordat ze zichtbaar zijn voor Find Blobs by Tags bewerkingen.

Momentopnamen in het antwoord

Momentopnamen worden alleen in het antwoord weergegeven als de include=snapshots parameter is opgegeven in de URI. Momentopnamen die in het antwoord worden vermeld, bevatten het LeaseStatus element niet, omdat momentopnamen geen actieve leaseovereenkomsten kunnen hebben.

Met serviceversie 2021-06-08 en hoger kunt u bellen List Blobs met een scheidingsteken en momentopnamen opnemen in de opsomming. Voor serviceversies vóór 2021-06-08 retourneert een aanvraag met beide een InvalidQueryParameter-fout (HTTP-statuscode 400 – Ongeldige aanvraag).

Niet-verzonden blobs in het antwoord

Niet-vastgelegde blobs worden alleen in het antwoord vermeld als de include=uncommittedblobs parameter is opgegeven in de URI. Niet-doorgevoerde blobs die in het antwoord worden vermeld, bevatten geen van de volgende elementen:

• Last-Modified

• Etag

• Content-Type

• Content-Encoding

• Content-Language

• Content-MD5

• Cache-Control

• Metadata

Verwijderde blobs in het antwoord

Verwijderde blobs worden alleen in het antwoord vermeld als de include=deleted parameter is opgegeven in de URI. Verwijderde blobs die in het antwoord worden vermeld, bevatten niet de lease-elementen , omdat verwijderde blobs geen actieve leases kunnen hebben.

Verwijderde momentopnamen worden opgenomen in de respons op de lijst als include=deleted,snapshot deze is opgegeven in de URI.

Metagegevens van objectreplicatie in het antwoord

Het OrMetadata element is aanwezig wanneer een objectreplicatiebeleid is geëvalueerd op een blob en de List Blobs aanroep is gedaan met behulp van versie 2019-12-12 of hoger. Binnen het OrMetadata element wordt de waarde van elk naam-waardepaar weergegeven in een element dat overeenkomt met de naam van het paar. De indeling van de naam is or-{policy-id}_{rule-id}, waarbij {policy-id} een GUID is die de id van het objectreplicatiebeleid voor het opslagaccount vertegenwoordigt. {rule-id} is een GUID die de regel-id op de opslagcontainer vertegenwoordigt. Geldige waarden zijn complete of 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>  
…  
  

Beleid voor onveranderbaarheid in het antwoord

De ImmutabilityPolicyUntilDate elementen en ImmutabilityPolicyMode zijn alleen aanwezig als de include=immutabilitypolicy parameter in de URI is opgegeven.

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

Juridische bewaring in het antwoord

Het LegalHold element is alleen aanwezig als de include=legalhold parameter in de URI is opgegeven.

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

Resultaatsets retourneren met behulp van een markeringswaarde

Als u een waarde voor de maxresults parameter opgeeft en het aantal blobs dat moet worden geretourneerd groter is dan deze waarde of de standaardwaarde voor maxresultsoverschrijdt, bevat de hoofdtekst van het antwoord een NextMarker element. Dit element geeft de volgende blob aan die moet worden geretourneerd op een volgende aanvraag. In bepaalde gevallen kan de service het NextMarker element retourneren, ook al is het aantal geretourneerde resultaten kleiner dan de waarde van maxresults.

Als u de volgende set items wilt retourneren, geeft u de waarde van NextMarker op als de markeringsparameter op de URI voor de volgende aanvraag. Merk op dat de waarde van NextMarker als ondoorzichtig moet worden behandeld.

Een scheidingsteken gebruiken om de blobnaamruimte te doorlopen

Met de delimiter parameter kan de aanroeper de blob-naamruimte doorkruisen met behulp van een door de gebruiker geconfigureerd scheidingsteken. Op deze manier kunt u een virtuele hiërarchie van blobs doorlopen alsof het een bestandssysteem was. Het scheidingsteken kan één teken of een tekenreeks zijn.

Wanneer de aanvraag deze parameter bevat, retourneert de bewerking een BlobPrefix element. Het BlobPrefix element wordt geretourneerd in plaats van alle blobs met namen die beginnen met dezelfde subtekenreeks, tot aan de verschijning van het scheidingsteken. De waarde van het BlobPrefix element is subtekenreeks+scheidingsteken, waarbij de subtekenreeks de gemeenschappelijke tekenreeks is waarmee een of meer blobnamen beginnen en het scheidingsteken de waarde van de delimiter parameter is.

U kunt de waarde van BlobPrefix gebruiken om een volgende aanroep te maken om de blobs weer te geven die met dit voorvoegsel beginnen. U doet dit door de waarde van BlobPrefix voor de prefix parameter op de aanvraag-URI op te geven.

Houd er rekening mee dat elk BlobPrefix element dat wordt geretourneerd, telt mee naar het maximumresultaat, net zoals elk Blob element doet.

Blobs worden in alfabetische volgorde weergegeven in de hoofdtekst van het antwoord, met hoofdletters die als eerste worden vermeld. Houd er rekening mee dat voor accounts waarvoor een hiërarchische naamruimte is ingeschakeld, / deze wordt behandeld als de laagste sorteervolgorde. Dit verschil in gedrag is alleen van toepassing op recursief opsommen.

Kopieerfouten in de beschrijving van de kopieerstatus

CopyStatusDescription Bevat meer informatie over de Copy Blob fout.

• Wanneer een kopieerpoging mislukt, CopyStatus is deze ingesteld op pending of Blob Storage de bewerking nog steeds opnieuw probeert. De CopyStatusDescription tekst beschrijft de fout die mogelijk is opgetreden tijdens de laatste kopieerpoging.

• Wanneer CopyStatus is ingesteld op failed, beschrijft de CopyStatusDescription tekst de fout die ervoor heeft gezorgd dat de kopieerbewerking is mislukt.

In de volgende tabel worden de velden van elke CopyStatusDescription waarde beschreven.

Bestanddeel	Beschrijving
HTTP-statuscode	Standaard driecijferig geheel getal dat de fout aangeeft.
Foutcode	Trefwoord dat de fout beschrijft. Het wordt geleverd door Azure in het <element ErrorCode> . Als er geen <ErrorCode-element> wordt weergegeven, retourneert de service een trefwoord dat standaardfouttekst bevat die is gekoppeld aan de driecijferige HTTP-statuscode in de HTTP-specificatie. Zie Algemene REST API-foutcodes voor meer informatie.
Informatie	Gedetailleerde beschrijving van de fout, tussen aanhalingstekens.

In de volgende tabel worden de CopyStatus en CopyStatusDescription waarden van veelvoorkomende foutscenario's beschreven.

Belangrijk

Beschrijvingstekst die hier wordt weergegeven, kan zonder waarschuwing worden gewijzigd, zelfs zonder een versiewijziging. Vertrouw niet op het vergelijken van deze exacte tekst.

Scenariobeschrijving	Waarde status kopiëren	Waarde statusbeschrijving kopiëren
De kopieerbewerking is voltooid.	succes	leeg
Gebruiker heeft de kopieerbewerking afgebroken voordat deze is voltooid.	rudimentair	leeg
Er is een fout opgetreden bij het lezen van de bron-blob tijdens een kopieerbewerking. De bewerking wordt opnieuw geprobeerd.	aanhangig	502 BadGateway 'Er is een fout opgetreden die opnieuw kan worden geprobeerd bij het lezen van de bron. Zal het opnieuw proberen. Tijd van mislukking: <tijd>"
Er is een fout opgetreden bij het schrijven naar de doel-blob van een kopieerbewerking. De bewerking wordt opnieuw geprobeerd.	aanhangig	500 InternalServerError 'Er is een fout opgetreden die opnieuw kan worden geprobeerd. Zal het opnieuw proberen. Tijd van mislukking: <tijd>"
Er is een onherstelbare fout opgetreden bij het lezen van de bron-blob van een kopieerbewerking.	mislukt	404 ResourceNotFound "Kopie mislukt bij het lezen van de bron." Wanneer de service deze onderliggende fout rapporteert, wordt deze geretourneerd ResourceNotFound in het <element Foutcode> . Als er geen <ErrorCode-element> in het antwoord voorkomt, wordt een standaardtekenreeksweergave van de HTTP-status, zoals NotFound, weergegeven.
De time-outperiode voor het beperken van alle kopieerbewerkingen die zijn verstreken. (De time-outperiode is momenteel twee weken.)	mislukt	500 OperationCancelled "De kopie heeft de maximale toegestane tijd overschreden."
De kopieerbewerking is te vaak mislukt bij het lezen van de bron en voldoet niet aan een minimale verhouding van pogingen tot geslaagde pogingen. (Deze time-out voorkomt dat een zeer slechte bron meer dan twee weken opnieuw wordt geprobeerd voordat deze mislukt).	mislukt	500 OperationCancelled "De kopie is mislukt bij het lezen van de bron."

Facturering

Prijsaanvragen kunnen afkomstig zijn van clients die Blob Storage-API's gebruiken, rechtstreeks via de Blob Storage REST API of vanuit een Azure Storage-clientbibliotheek. Deze aanvragen maken kosten per transactie. Het type transactie is van invloed op de manier waarop het account in rekening wordt gebracht. Leestransacties worden bijvoorbeeld opgebouwd tot een andere factureringscategorie dan schrijftransacties. In de volgende tabel ziet u de factureringscategorie voor List Blobs aanvragen op basis van het type opslagaccount:

Operatie	Type opslagaccount	Factureringscategorie
Lijst met blobs	Premium blok-blob Standaard algemeen gebruik v2 Standaard algemeen gebruik v1	Containerbewerkingen weergeven en maken

Zie Prijzen voor Azure Blob Storagevoor meer informatie over prijzen voor de opgegeven factureringscategorie.

Zie ook

status en foutcodes
Blob Storage-foutcodes