Blobs weergeven

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

Aanvraag

De List Blobs aanvraag kan als volgt worden samengesteld. 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

Emulated storage service URI

Wanneer u een aanvraag indient voor de geëmuleerde opslagservice, geeft u de hostnaam van de emulator en de blobservicepoort 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 De Azure Storage Emulator gebruiken voor ontwikkeling en testen voor meer informatie.

URI-parameters

De volgende aanvullende parameters kunnen worden opgegeven op de URI.

Parameter Beschrijving
prefix Optioneel. Hiermee filtert u de resultaten om alleen blobs te retourneren waarvan de namen beginnen met het opgegeven voorvoegsel.
delimiter Optioneel. Wanneer de aanvraag deze parameter bevat, retourneert de bewerking een BlobPrefix element in de hoofdtekst van het antwoord dat fungeert als tijdelijke aanduiding voor alle blobs waarvan de namen beginnen met dezelfde subtekenreeks tot het uiterlijk van het scheidingsteken. Het scheidingsteken kan één teken of een tekenreeks zijn.
marker Optioneel. Een tekenreekswaarde die het gedeelte van de lijst identificeert 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. De markeringswaarde kan vervolgens worden gebruikt in een volgende aanroep om de volgende set lijstitems aan te vragen.

De markeringswaarde is ondoorzichtig voor de client.
maxresults Optioneel. Hiermee geeft u het maximum aantal blobs op dat moet worden geretourneerd, inclusief alle BlobPrefix elementen. Als de aanvraag geen waarde van meer dan 5.000 opgeeft of opgeeft, retourneert maxresults de server maximaal 5000 items. Als er extra resultaten moeten worden geretourneerd, retourneert de service een vervolgtoken in het NextMarker antwoordelement. In bepaalde gevallen kan de service minder resultaten retourneren dan opgegeven door maxresults en ook een vervolgtoken retourneren.

Als u maxresults een waarde instelt 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}
Optioneel. Hiermee geeft u een of meer gegevenssets op die moeten worden opgenomen in het antwoord:

- snapshots: Hiermee geeft u op dat momentopnamen moeten worden opgenomen in de opsomming. Momentopnamen worden weergegeven van oud naar nieuw in het antwoord.
- metadata: Hiermee geeft u op dat blobmetagegevens worden geretourneerd in het antwoord.
- uncommittedblobs: Hiermee geeft u op dat blobs waarvoor blokken zijn geüpload, maar die niet zijn doorgevoerd met behulp van Put Block List, worden opgenomen in het antwoord.
- copy: Versie 2012-02-12 en hoger. Hiermee geeft u op dat metagegevens met betrekking tot een huidige of vorige Copy Blob bewerking moeten worden opgenomen in het antwoord.
-deleted: Versie 2017-07-29 en hoger. Hiermee geeft u op dat voorlopig verwijderde blobs moeten worden opgenomen in het antwoord.
-tags: Versie 2019-12-12 en hoger. Hiermee geeft u op dat door de gebruiker gedefinieerde Blob Index-tags moeten worden opgenomen in het antwoord.
-versions: Versie 2019-12-12 en hoger. Hiermee geeft u op dat versies van blobs moeten worden opgenomen in de opsomming.
-deletedwithversions: Versie 2020-10-02 en hoger. Hiermee geeft u op dat verwijderde blobs met alle versies (actief of verwijderd) moeten worden opgenomen in het antwoord met een tag <HasVersionsOnly> en waarde waar.
-immutabilitypolicy: versie 2020-06-12 en hoger. Hiermee geeft u op dat beleid voor onveranderbaarheid tot datum en onveranderbaarheid van de blobs moet worden opgenomen in de opsomming.
-legalhold: versie 2020-06-12 en hoger. Hiermee geeft u op dat juridische bewaring van blobs moet worden opgenomen in de opsomming.
-permissions: versie 2020-06-12 en hoger. Alleen ondersteund voor accounts waarvoor een hiërarchische naamruimte is ingeschakeld. Als een aanvraag deze parameter bevat, worden de eigenaar, groep, machtigingen en Access Control lijst voor de vermelde blobs of mappen opgenomen in de opsomming.

Als u meer dan een van deze opties op de URI wilt opgeven, moet u elke optie scheiden met een door URL gecodeerde komma (%82).
showonly={deleted,files,directories} Optioneel. Hiermee geeft u een van deze gegevenssets die moeten worden geretourneerd in het antwoord:

-deleted: Optioneel. Versie 2020-08-04 en hoger. Alleen voor accounts waarvoor hiërarchische naamruimte is ingeschakeld. Wanneer een aanvraag deze parameter bevat, bevat de lijst alleen voorlopig verwijderde blobs. Als include=deleted ook is opgegeven, mislukt de aanvraag met Ongeldige aanvraag (400).
-files: Optioneel. Versie 2020-12-06 en hoger. Alleen voor accounts waarvoor hiërarchische naamruimte is ingeschakeld. Wanneer een aanvraag deze parameter bevat, bevat de lijst alleen bestanden.
-directories: Optioneel. Versie 2020-12-06 en hoger. Alleen voor accounts waarvoor hiërarchische naamruimte is ingeschakeld. Wanneer een aanvraag deze parameter bevat, bevat de lijst alleen mappen.
timeout Optioneel. De timeout parameter wordt uitgedrukt in seconden. Zie Time-outs voor blobservicebewerkingen instellen voor meer informatie.

Aanvraagheaders

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

Aanvraagkoptekst Description
Authorization Vereist. Hiermee geeft u het autorisatieschema, de accountnaam en de handtekening op. Zie Aanvragen autoriseren voor Azure Storage voor meer informatie.
Date of x-ms-date Vereist. Geef de Coordinated Universal Time (UTC) op voor de aanvraag. Zie Aanvragen autoriseren voor Azure Storage voor meer informatie.
x-ms-version Vereist voor alle geautoriseerde aanvragen, optioneel voor anonieme aanvragen. Hiermee geeft u de versie van de bewerking die voor deze aanvraag moet worden gebruikt. Zie Versiebeheer voor de Azure Storage Services voor meer informatie.
x-ms-client-request-id Optioneel. Biedt een door de client gegenereerde, ondoorzichtige waarde met een limiet van 1 KiB-tekens die wordt vastgelegd in de analyselogboeken wanneer logboekregistratie voor opslaganalyse is ingeschakeld. Het gebruik van deze header wordt ten zeerste aanbevolen voor het correleren van activiteiten aan clientzijde met aanvragen die door de server worden ontvangen. Zie Informatie over Opslaganalyse logboekregistratie en Azure-logboekregistratie: logboeken gebruiken om Storage aanvragen bij te houden.
x-ms-upn Optioneel. Alleen geldig wanneer een hiërarchische naamruimte is ingeschakeld voor het account en include=permissions is opgegeven in de aanvraag. Indien waar, worden de waarden van de gebruikersidentiteit die in het <Owner><Group>veld worden geretourneerd, <Acl> getransformeerd van Azure Active Directory object-id's naar principal-namen van gebruikers. Als dit onwaar is, worden de waarden geretourneerd als Azure Active Directory object-id's. De standaardwaarde is onwaar. Houd er rekening mee dat groeps- en toepassingsobject-id's niet worden vertaald omdat ze geen unieke beschrijvende namen hebben.

Aanvraagbody

Geen.

Voorbeeldaanvraag

Zie Blob-resources opsommen voor een voorbeeldaanvraag.

Reactie

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 Foutcodes voor 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 Description
Content-Type Hiermee geeft u de notatie op waarin de resultaten worden geretourneerd. Deze waarde is application/xmlmomenteel .
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 oplossen voor meer informatie.
x-ms-version Geeft de versie van de Blob-service 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 de Blob-service.
Date Een UTC-datum/tijd-waarde die wordt gegenereerd door de service die het tijdstip aangeeft waarop het antwoord is gestart.
x-ms-client-request-id Deze header kan worden gebruikt 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 en de waarde maximaal 1024 zichtbare ASCII-tekens bevat. 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 Prefixelementen , Marker``MaxResultsen Delimiter elementen alleen aanwezig zijn als ze zijn opgegeven op de aanvraag-URI. Het NextMarker element heeft alleen een waarde als de lijstresultaten niet zijn voltooid.

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

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

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

  • Last-Modified (eerder LastModified)

  • Content-Length (eerder Size)

  • Content-Type (eerder ContentType)

  • Content-Encoding (eerder ContentEncoding)

  • Content-Language (eerder 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 de Blob-service de Content-MD5 waarde wanneer u een blob uploadt met put-blob, maar 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 Put Block List aan te roepen of blobeigenschappen in te stellen.

Voor versies van 2009-09-19 en hoger, maar vóór versie 2015-02-21 mislukt het aanroepen List Blobs van een container met toevoeg-blobs met statuscode 409 (FeatureVersionMismatch) 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, , en CopyCompletionTime``CopyStatusDescription wordt 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, of als deze blob is gewijzigd na een afgesloten Copy Blob bewerking met behulp van Set Blob Properties, Put Blobof Put Block List. Deze elementen worden ook niet weergegeven met een blob die is gemaakt door Blob kopiëren vóór versie 2012-02-12.

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

Voor versie 2015-02-21 en hoger List Blobs retourneert u blobs van alle typen (blok-, pagina- en toevoeg-blobs).

Voor versie 2015-12-11 en hoger wordt List Blobs het ServerEncrypted element geretourneerd. Dit element wordt ingesteld true op als de metagegevens van de blob en de toepassing volledig zijn versleuteld, en false anders.

Voor versie 2016-05-31 en hoger List Blobs retourneert u het IncrementalCopy element voor incrementele kopieer-blobs en momentopnamen met de waarde ingesteld op true.

Voor versie 2017-04-17 en hoger List Blobs wordt het AccessTier element geretourneerd als er expliciet een toegangslaag is ingesteld. Zie High Performance Premium Storage en beheerde schijven voor VM's voor een lijst met toegestane Premium-pagina-bloblagen. Voor Blob-Storage- of Algemeen v2-accounts zijn Hot//Cool``Archivegeldige waarden. Als de blob de status Rehydrate in behandeling heeft, ArchiveStatus wordt het element geretourneerd met een van de geldige waarden/rehydrate-pending-to-hot``rehydrate-pending-to-cool. Zie Dynamische, statische en archiefopslaglagen voor gedetailleerde informatie over blok-bloblagen.

Voor versie 2017-04-17 en hoger wordt List Blobs het AccessTierInferred element op Blob-Storage- of Algemeen v2-accounts geretourneerd. Als de blok-blob niet over de toegangslaag beschikt, wordt de laag afgeleid van de eigenschappen van het opslagaccount en is deze waarde ingesteld op true. Deze header is alleen aanwezig als de laag wordt afgeleid van de accounteigenschap. Zie Dynamische, statische en archiefopslaglagen voor gedetailleerde informatie over blok-bloblagen.

Voor versie 2017-04-17 en hoger wordt List Blobs het AccessTierChangeTime element op Blob-Storage- of Algemeen v2-accounts geretourneerd. Dit wordt alleen geretourneerd als de laag op blok-blob ooit is ingesteld. De datumnotatie volgt RFC 1123. Zie Weergave van Date-Time waarden in kopteksten voor meer informatie. Zie Dynamische, statische en archiefopslaglagen voor gedetailleerde informatie over blok-bloblagen.

Voor versie 2017-07-29 en hoger wordt Deleted``DeletedTime RemainingRetentionDays deze weergegeven wanneer deze bewerking de include={deleted} parameter bevat. Deze elementen worden niet weergegeven als deze blob niet is verwijderd. Deze elementen worden weergegeven voor blob of momentopnamen die met de bewerking worden verwijderd DELETE wanneer de functie voor voorlopig verwijderen is ingeschakeld. 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 voorlopig verwijderde blob permanent wordt verwijderd door de blobservice.

Voor versie 2017-11-09 en hoger Creation-Time wordt het tijdstip geretourneerd waarop deze blob is gemaakt.

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

Voor versie 2019-02-02 en hoger wordt List Blobs 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 toepassingsmetagegevens op de blob transparant ontsleuteld en beschikbaar in het Metadata element.

Voor versie 2019-12-12 en hoger retourneert List Blobs u het RehydratePriority element op Blob-Storage- of Algemeen v2-accounts als het object de status Rehydrate in behandeling heeft. Geldige waarden zijn High/Standard. Zie Dynamische, statische en archiefopslaglagen voor gedetailleerde informatie over blok-bloblagen.

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 waarop de waarde is ingesteld trueom deze te onderscheiden van de automatisch gegenereerde alleen-lezenversies.

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

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

Voor versie 2020-02-10 en hoger wordt List Blobs het LastAccessTime element geretourneerd. De elementen laten zien wanneer de gegevens van de blob voor het laatst zijn geopend volgens het beleid voor het bijhouden van de laatste toegangstijd van het opslagaccount. Het element wordt niet geretourneerd als het opslagaccount geen beleid voor het bijhouden van de laatste toegangstijd heeft of als het beleid is uitgeschakeld. Zie de Blob Service-API voor informatie over het instellen van het beleid voor het bijhouden van de laatste toegangstijd van het account. Het LastAccessTime element houdt de laatste keer dat de metagegevens van de blob worden geopend niet bij.

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

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

Voor versie 2020-06-12 en hoger worden accounts waarvoor een hiërarchische naamruimte is ingeschakeld, List Blobs geretourneerd Owneren Acl Group``Permissions element wanneer de aanvraag parameter bevat.include={permissions} Houd er rekening mee dat Acl het element een gecombineerde lijst met Access- en Standaard-ACL's is die zijn ingesteld in het bestand/de map.

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

Voor versie 2020-08-04 en hoger retourneert voor hiërarchische naamruimte ingeschakelde accounts List Blobs het DeletionId element voor verwijderde blobs. DeletionId is een niet-ondertekende 64-bits id die een voorlopig verwijderd pad identificeert om dit te onderscheiden van andere verwijderde blobs met hetzelfde pad.

Voor versie 2020-10-02 en hoger retourneert voor hiërarchische naamruimte ingeschakelde accounts List Blobs het eigenschapselement voor het pad, dat kan zijndirectory``file/.ResourceType

Voor versie 2021-02-12 en hoger List Blobs wordt procentcodering (per RFC 2396) alle Blob Name of BlobPrefix Name elementwaarden die ongeldige tekens bevatten in XML (met name U+FFFE of U+FFFF). Als het element 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 de resterende Name elementen in het antwoord.

Voor versie 2021-06-08 en hoger retourneert voor hiërarchische naamruimte ingeschakelde accounts List Blobs het Placeholder eigenschappenelement in het BlobPrefix element voor tijdelijke aanduidingen bij het weergeven van verwijderde blobs met een scheidingsteken. Deze tijdelijke aanduidingen bestaan alleen om te navigeren naar voorlopig verwijderde blobs.

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

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

Voorbeeldreactie

Zie Blob-resources opsommen voor een voorbeeldantwoord.

Autorisatie

Als de toegangsbeheerlijst (ACL) van de container is ingesteld om anonieme toegang tot de container toe te staan, kan elke client deze bewerking aanroepen. Anders kan deze bewerking worden aangeroepen door de accounteigenaar en door iedereen met een Shared Access Signature die gemachtigd is om blobs in een container weer te geven.

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, zodat sommige eigenschappen mogelijk niet worden geretourneerd in het antwoord.

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

Het OrMetadata element wordt alleen geretourneerd voor blok-blobs.

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 is ingesteld op de blob met 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 u de MD5-waarde van een blok-blob in, Put Blob zelfs wanneer de Put Blob aanvraag geen MD5-header bevat.

Metagegevens in het antwoord

Het Metadata element is alleen aanwezig als de include=metadata parameter is opgegeven op de URI. 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 worden aangevraagd, moeten worden opgeslagen in overeenstemming met de naamgevingsbeperkingen die zijn opgelegd door de versie 2009-09-19 van de Blob-service. Vanaf deze versie moeten alle metagegevensnamen voldoen aan de naamconventies voor C#-id's.

Als een naam-waardepaar voor metagegevens de naamgevingsbeperkingen schendt die worden afgedwongen door de versie 2009-09-19, geeft de antwoordtekst de problematische naam binnen een x-ms-invalid-name element aan, zoals wordt weergegeven in het volgende XML-fragment:

  
…  
<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 op de URI en als er tags in de blob zijn. Binnen het TagSet element worden maximaal 10 Tag elementen geretourneerd, elk met de en value van de door de key gebruiker gedefinieerde blobindextags. De volgorde van tags wordt niet gegarandeerd in het antwoord.

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

De opslagservice behoudt sterke consistentie tussen een blob en de bijbehorende tags, maar de secundaire index is uiteindelijk consistent. Tags zijn mogelijk zichtbaar in een reactie op lijst-blobs voordat ze zichtbaar zijn voor het zoeken van blobs op tags.

Momentopnamen in het antwoord

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

Als u aanroept List Blobs met een scheidingsteken, kunt u geen momentopnamen opnemen in de opsomming. Een aanvraag met beide retourneert een InvalidQueryParameter-fout (HTTP-statuscode 400 – Ongeldige aanvraag).

Niet-doorgevoerde blobs in het antwoord

Niet-gegenereerde blobs worden alleen in het antwoord vermeld als de include=uncommittedblobs parameter is opgegeven op 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 weergegeven in het antwoord als de include=deleted parameter is opgegeven op 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 het lijstantwoord als include=deleted,snapshot deze is opgegeven op de URI.

Metagegevens van objectreplicatie in het antwoord

Het OrMetadata element is aanwezig wanneer een objectreplicatiebeleid is geëvalueerd op een blob en de lijst-blobs-aanroep is uitgevoerd met 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 de id van het objectreplicatiebeleid voor het opslagaccount vertegenwoordigt en {rule-id} een GUID is die de regel-id in de opslagcontainer vertegenwoordigt. Geldige waarden zijn complete/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>  
…  
  

Onveranderbaarheidsbeleid in het antwoord

ImmutabilityPolicyMode De ImmutabilityPolicyUntilDateelementen zijn alleen aanwezig als de include=immutabilitypolicy parameter is opgegeven op de URI.

<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 is opgegeven op de URI.

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

Resultaatsets retourneren met een markeringswaarde

Als u een waarde opgeeft voor de maxresults parameter en het aantal blobs dat moet worden geretourneerd deze waarde overschrijdt of de standaardwaarde maxresultsoverschrijdt, bevat de hoofdtekst van het antwoord een NextMarker element dat aangeeft dat de volgende blob 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 op van NextMarker de markeringsparameter op de URI voor de volgende aanvraag. Houd er rekening mee dat de waarde van NextMarker moet worden behandeld als ondoorzichtig.

Een scheidingsteken gebruiken om de blobnaamruimte te doorlopen

Met delimiter de parameter kan de aanroeper de blobnaamruimte doorlopen 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 waarvan de namen beginnen met dezelfde subtekenreeks tot het uiterlijk van het scheidingsteken. De waarde van het BlobPrefix element is subtekenreeks+scheidingsteken, waarbij subtekenreeks de algemene subtekenreeks is die een of meer blobnamen begint en scheidingsteken de waarde van de parameter scheidingsteken is.

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

Houd er rekening mee dat elk BlobPrefix geretourneerd element meetelt voor het maximumresultaat, net zoals elk Blob element dat doet.

Blobs worden in alfabetische volgorde weergegeven in de hoofdtekst van het antwoord, met hoofdletters die als eerste worden vermeld.

Kopieerfouten in CopyStatusDescription

CopyStatusDescription bevat meer informatie over de Copy Blob fout.

  • Wanneer een kopieerpoging mislukt en de Blob-service de bewerking nog steeds opnieuw probeert uit te voeren, CopyStatus wordt deze ingesteld pendingop en wordt in de CopyStatusDescription tekst de fout beschreven die zich mogelijk heeft voorgedaan tijdens de laatste kopieerpoging.

  • Wanneer CopyStatus deze is ingesteld failedop, wordt in de CopyStatusDescription tekst de fout beschreven waardoor de kopieerbewerking is mislukt.

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

Onderdeel Beschrijving
HTTP-statuscode Standaard 3-cijferig geheel getal dat de fout aangeeft.
Foutcode Trefwoord met een beschrijving van de fout die wordt geleverd door Azure in het element <ErrorCode> . Als er geen <ErrorCode-element> wordt weergegeven, wordt een trefwoord met standaardfouttekst gebruikt die is gekoppeld aan de HTTP-statuscode van 3 cijfers in de HTTP-specificatie. Zie algemene REST API-foutcodes.
Informatie Gedetailleerde beschrijving van 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, dus vertrouw niet op het vergelijken van deze exacte tekst.

Scenario CopyStatus-waarde CopyStatusDescription-waarde
De kopieerbewerking is voltooid. voltooid leeg
De gebruiker heeft de kopieerbewerking afgebroken voordat deze is voltooid. Afgebroken leeg
Er is een fout opgetreden bij het lezen van de bron-blob tijdens een kopieerbewerking, maar de bewerking wordt opnieuw geprobeerd. in behandeling 502 BadGateway 'Er is een fout opgetreden die opnieuw kan worden geprobeerd bij het lezen van de bron. Zal het opnieuw proberen. Tijd van fout: <tijd>"
Er is een fout opgetreden bij het schrijven naar de doel-blob van een kopieerbewerking, maar de bewerking wordt opnieuw geprobeerd. in behandeling 500 InternalServerError :Er is een fout opgetreden die opnieuw kan worden geprobeerd. Zal het opnieuw proberen. Tijd van fout: <tijd>"
Er is een onherstelbare fout opgetreden bij het lezen van de bron-blob van een kopieerbewerking. mislukt 404 ResourceNotFound 'Kopiëren is mislukt bij het lezen van de bron'. Opmerking: Bij het rapporteren van deze onderliggende fout retourneert ResourceNotFound Azure het element <ErrorCode> . Als er geen <ErrorCode-element> in het antwoord wordt weergegeven, wordt er een standaardtekenreeksweergave van de HTTP-status weergegeven, zoals NotFound wordt weergegeven.
De time-outperiode die alle kopieerbewerkingen beperkt. (De time-outperiode is momenteel 2 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 na 2 weken opnieuw wordt geprobeerd voordat deze mislukt). mislukt 500 OperationCancelled 'De kopie is mislukt bij het lezen van de bron'.

Zie ook

Status- en foutcodes
Foutcodes voor blob-services