Delen via

Lijst met blobs

  • Artikel

De List Blobs-bewerking retourneert een lijst met de 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 op basis van 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 geëmuleerde naam van het opslagaccount.

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

Zie Azure Storage-emulator gebruiken voor lokale Azure Storage-ontwikkelingvoor meer informatie.

URI-parameters

U kunt de volgende aanvullende parameters voor de URI opgeven.

Parameter 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 om blobs te vinden met de naam readmefile.txt met behulp van het voorvoegselpad folder1/folder2/readme/readmefile.txt. Er wordt een fout weergegeven als een submap een bestand met de naam readmebevat.
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 maximum aantal blobs 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 extra resultaten moeten worden geretourneerd, retourneert de service een vervolgtoken in het NextMarker antwoordelement. In bepaalde gevallen retourneert de service mogelijk minder resultaten dan is opgegeven door maxresultsen wordt ook een vervolgtoken geretourneerd.

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: 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-indextags 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. 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 hoger. 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 hoger. Hiermee geeft u op dat de opsomming de juridische bewaring van blobs moet bevatten.
- 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 toegangsbeheerlijst 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} Facultatief. 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 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: optioneel. 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: optioneel. 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-bewerkingenvoor 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 wanneer een hiërarchische naamruimte is ingeschakeld voor het account en include=permissions is opgegeven in de aanvraag. Als true, worden de waarden van de gebruikersidentiteit die worden geretourneerd in de <Owner>, <Group>en <Acl> velden omgezet van Microsoft Entra-object-id's naar principal-namen van gebruikers. Als false, worden de waarden geretourneerd als Object-id's van Microsoft Entra. 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 Blob-resources 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, MaxResultsen Delimiter elementen alleen aanwezig zijn als ze zijn opgegeven op de aanvraag-URI. Het element NextMarker heeft alleen een waarde als de lijstresultaten niet zijn voltooid.

Momentopnamen, blobmetagegevens en niet-verzonden blobs worden alleen opgenomen in het antwoord als ze zijn opgegeven met de parameter include 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 retourneert List Blobs de volgende hernoemde elementen in de hoofdtekst van het antwoord:

  • Last-Modified (eerder LastModified)

  • Content-Length (eerder Size)

  • Content-Type (eerder ContentType)

  • Content-Encoding (eerder ContentEncoding)

  • Content-Language (eerder ContentLanguage)

Het element Content-MD5 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 put block list of blobeigenschappen instellen bewerkingen aan te roepen.

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

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

CopyId, CopyStatus, CopySource, CopyProgress, CopyCompletionTimeen CopyStatusDescription alleen weergegeven in versie 2012-02-12 en hoger, wanneer deze bewerking de parameter include={copy} bevat. Deze elementen worden niet weergegeven als deze blob nooit de bestemming is geweest in een Copy Blob bewerking. De elementen worden niet weergegeven als deze blob is gewijzigd na een voltooide 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ërenvóór versie 2012-02-12.

In versie 2013-08-15 en hoger bevat het EnumerationResults element een ServiceEndpoint kenmerk waarmee het blob-eindpunt wordt opgegeven. Dit element bevat ook 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 onder Blob verwijderd.

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

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

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

Voor versie 2017-04-17 en hoger retourneert List Blobs het AccessTier element als een toegangslaag expliciet is ingesteld. Zie Premium-opslag en beheerde schijven voor VM'svoor een lijst met toegestane premium-pagina-bloblagen. Voor Blob Storage- of v2-accounts voor algemeen gebruik zijn geldige waarden Hot, Coolen Archive. Als de blob de status Rehydrate in behandeling heeft, wordt ArchiveStatus element geretourneerd met een van de geldige waarden (rehydrate-pending-to-hot, rehydrate-pending-to-coolof rehydrate-pending-to-cold). Zie dynamische, statische en archiefopslaglagenvoor gedetailleerde informatie over blok-bloblagen.

Voor versie 2017-04-17 en hoger retourneert List Blobs het element AccessTierInferred in Blob Storage- of v2-accounts voor algemeen gebruik. Als de blok-blob niet over de toegangslaag beschikt, wordt de laaggegevens afgeleid van 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 retourneert List Blobs het element AccessTierChangeTime in 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 worden Deleted, DeletedTimeen RemainingRetentionDays weergegeven wanneer deze bewerking de parameter include={deleted} bevat. Deze elementen worden niet weergegeven als deze blob niet is verwijderd. Deze elementen worden weergegeven voor blobs of momentopnamen die zijn verwijderd met de DELETE bewerking, wanneer de functie voor voorlopig verwijderen is ingeschakeld. Het element Deleted is ingesteld op true voor blobs en momentopnamen die voorlopig worden 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 retourneert Creation-Time het tijdstip waarop deze blob is gemaakt.

Voor versie 2019-02-02 en hoger retourneert List Blobs het CustomerProvidedKeySha256 element als de blob is versleuteld met een door de klant geleverde 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 parameter include={metadata} bevat en er toepassingsmetagegevens aanwezig zijn op een blob die is versleuteld met een door de klant geleverde sleutel, heeft het Metadata element een Encrypted="true" kenmerk. Dit kenmerk geeft aan dat de blob metagegevens bevat die niet kunnen worden ontsleuteld als onderdeel van de List Blobs-bewerking. Als u toegang wilt krijgen tot de metagegevens voor deze blobs, roept u Blob-eigenschappen ophalen aan of blobmetagegevens ophalen met de door de klant geleverde sleutel.

Voor versie 2019-02-02 en hoger retourneert List Blobs het EncryptionScope element 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 parameter include={metadata} bevat, worden toepassingsmetagegevens op de blob transparant ontsleuteld en beschikbaar in het Metadata-element.

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

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

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

Voor versie 2019-12-12 en hoger retourneert List Blobs het Sealed element voor toevoeg-blobs. Het element Sealed 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 retourneert List Blobs 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-APIvoor meer informatie over het instellen van het beleid voor het bijhouden van de laatste toegangstijd van het account. Het element LastAccessTime houdt niet de laatste keer bij wanneer de metagegevens van de blob worden geopend.

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

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

Voor versie 2020-06-12 en hoger, voor accounts waarvoor een hiërarchische naamruimte is ingeschakeld, retourneert List Blobs de elementen Owner, Group, Permissionsen Acl. De aanvraag moet de parameter include={permissions} bevatten. Het element Acl is een gecombineerde lijst met toegangs- en standaardtoegangsbeheerlijsten die zijn ingesteld in het bestand of de map.

Voor versie 2020-06-12 en hoger, voor accounts met een hiërarchische naamruimte ingeschakeld, retourneert List Blobs 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, retourneert List Blobs het DeletionId-element voor verwijderde blobs. 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, retourneert List Blobs het ResourceType eigenschapselement voor het pad. Dit kan file of directoryzijn.

Voor versie 2021-02-12 en hoger worden alle BlobName of BlobPrefixName elementwaarden door List Blobs procentcode (per 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 de resterende Name elementen in het antwoord.

Voor versie 2021-06-08 en hoger, voor accounts waarvoor een hiërarchische naamruimte is ingeschakeld, retourneert List Blobs het element Placeholder eigenschappen. Het retourneert dit element in het BlobPrefix-element voor tijdelijke aanduidingen, bij het weergeven van verwijderde 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, retourneert List Blobs het EncryptionContext element. 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, retourneert 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>
        <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 blob-resources 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.

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:

Als u include=tagsopgeeft:

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

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 blok-blobs.

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

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

Metagegevens in het antwoord

Het Metadata element is alleen aanwezig als de parameter include=metadata is opgegeven op de URI. Binnen het Metadata element wordt de waarde van elk paar naam-waarde 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 namen van metagegevens voldoen aan de naamconventies voor C#-id's.

Als een paar metagegevensnaam-waarde deze naamgevingsbeperkingen schendt, geeft de hoofdtekst van het antwoord de problematische naam aan binnen een x-ms-invalid-name element. 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 parameter include=tags is opgegeven op de URI en als er tags in de blob zijn. 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- en TagCount-elementen worden niet geretourneerd als de blob geen tags bevat.

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 antwoord op List Blobs voordat ze zichtbaar zijn voor Find Blobs by Tags bewerkingen.

Momentopnamen in het antwoord

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

Met serviceversie 2021-06-08 en hoger kunt u List Blobs aanroepen 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-doorgevoerde blobs worden alleen in het antwoord vermeld als de parameter include=uncommittedblobs 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 in het antwoord vermeld als de parameter include=deleted 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 een lijstantwoord als include=deleted,snapshot is opgegeven op de URI.

Metagegevens van objectreplicatie in het antwoord

Het element OrMetadata aanwezig is wanneer een objectreplicatiebeleid is geëvalueerd op een blob en de List Blobs aanroep is uitgevoerd met versie 2019-12-12 of hoger. Binnen het OrMetadata element wordt de waarde van elk paar naam-waarde 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 in 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- en ImmutabilityPolicyMode-elementen zijn alleen aanwezig als de parameter include=immutabilitypolicy is opgegeven op de URI.

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

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

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

Resultaatsets retourneren met behulp van een markeringswaarde

Als u een waarde opgeeft voor de parameter maxresults en het aantal blobs dat moet worden geretourneerd deze waarde overschrijdt 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. Houd er rekening mee dat de waarde van NextMarker moet worden behandeld als ondoorzichtig.

Een scheidingsteken gebruiken om de blobnaamruimte te doorlopen

Met de parameter delimiter 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 met namen die 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 waarmee een of meer blobnamen worden gestart en scheidingsteken de waarde van de parameter delimiter is.

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

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.

Kopieerfouten in de beschrijving van de kopieerstatus

CopyStatusDescription bevat meer informatie over de Copy Blob fout.

  • Wanneer een kopieerpoging mislukt, wordt CopyStatus ingesteld op pending als Blob Storage de bewerking nog steeds opnieuw probeert uit te voeren. In de CopyStatusDescription tekst wordt de fout beschreven die mogelijk is opgetreden tijdens de laatste kopieerpoging.

  • Wanneer CopyStatus is ingesteld op failed, beschrijft de CopyStatusDescription tekst de fout waardoor 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 HTTP-statuscode van drie cijfers in de HTTP-specificatie. Zie Algemene REST API-foutcodesvoor 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.

Scenario 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 fout: <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 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'. Wanneer de service deze onderliggende fout rapporteert, wordt ResourceNotFound geretourneerd in het <ErrorCode> element. Als er geen <ErrorCode> element in het antwoord wordt weergegeven, 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