Blobs opslijst

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:

Geëmuleerde opslagservice-URI

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

Zie Using the Azure Storage Emulator for Development and Testing (De Azure Storage Emulator voor ontwikkeling en testen) voor meer informatie.

URI-parameters

De volgende aanvullende parameters kunnen worden opgegeven op de URI.

Aanvraagheaders

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

Aanvraagbody

Geen.

Voorbeeldaanvraag

Zie Blob-resources opsnoemen 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.

Antwoord body

De indeling van het XML-antwoord is als volgt.

Houd er rekening mee dat de elementen , , en alleen aanwezig zijn als Prefix ze zijn opgegeven op de Marker MaxResults Delimiter aanvraag-URI. Het NextMarker element heeft alleen een waarde als de lijstresultaten niet zijn voltooid.

Momentopnamen, blobmetagegevens en niet-vastgelegde 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 in een Properties -element.

Vanaf versie 2009-09-19 retourneert de volgende List Blobs hernoemde elementen in de antwoord body:

• Last-Modified``LastModified(voorheen )

• Content-Length``Size(voorheen )

• Content-Type``ContentType(voorheen )

• Content-Encoding``ContentEncoding(voorheen )

• Content-Language``ContentLanguage(voorheen )

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 waarde wanneer u een blob uploadt met Content-MD5 Put Blob,maar berekent dit niet wanneer u een blob maakt met Put Block List. U kunt de waarde expliciet instellen wanneer u de blob maakt of door de bewerkingen Content-MD5 Put Block List of Set Blob Properties aan te roepen.

Voor versies van 2009-09-19 en hoger, maar vóór versie 2015-02-21, mislukt het aanroepen op een container die toevoegende blobs bevat, met List Blobs statuscode 409 (FeatureVersionMismatch) als het resultaat van de vermelding een toegevoegd blob bevat.

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

CopyId, , , , en worden CopyStatus alleen weergegeven in versie CopySource CopyProgress CopyCompletionTime CopyStatusDescription 2012-02-12 en hoger, include={copy} wanneer deze bewerking de parameter bevat. Deze elementen worden niet weergegeven als deze blob nooit het doel is geweest in een bewerking, of als deze blob is gewijzigd na een afgeronde bewerking met behulp van Copy Blob Copy Blob , of Set Blob Properties Put Blob 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 element een kenmerk dat het blob-eindpunt opgeeft en een veld waarin de naam van de container wordt EnumerationResults ServiceEndpoint ContainerName opgegeven. In eerdere versies werden deze twee kenmerken gecombineerd in het ContainerName veld . Ook in versie 2013-08-15 en hoger is Url het element onder Blob verwijderd.

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

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

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

Voor versie 2017-04-17 en hoger retourneert het element als een List Blobs toegangslaag AccessTier expliciet is ingesteld. Zie High Performance Premium Storage managed disks for VMs(Hoge prestaties en beheerde schijven voor VM's) voor een lijst met toegestane premium-pagina-bloblagen. Voor Blob Storage- of Algemeen v2-accounts zijn geldige Hot / Cool / Archive waarden. Als de blob de status Rehydrate Pending heeft, wordt ArchiveStatus het element geretourneerd met een van de geldige waarden rehydrate-pending-to-hot / rehydrate-pending-to-cool . Zie Opslaglagen voor hot, cool en archief voor gedetailleerde informatie over blok-bloblagen.

Voor versie 2017-04-17 en hoger retourneert het element op Blob Storage of List Blobs AccessTierInferred Algemeen v2-accounts. Als voor de blok-blob de toegangslaag niet is ingesteld, afleiden we de laag 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 eigenschap account. Zie Opslaglagen voor hot, cool en archief voor gedetailleerde informatie over blok-bloblagen.

Voor versie 2017-04-17 en hoger retourneert het element op Blob Storage of List Blobs AccessTierChangeTime Algemeen v2-accounts. Dit wordt alleen geretourneerd als de laag op blok-blob ooit is ingesteld. De datumnotatie volgt RFC 1123. Zie Representation of Date-Time Values in Headers (Weergave van Date-Time waarden in headers) voor meer informatie. Zie Opslaglagen voor hot, cool en archief voor gedetailleerde informatie over blok-bloblagen.

Voor versie 2017-07-29 en hoger, en wordt weergegeven wanneer deze Deleted DeletedTime bewerking de parameter RemainingRetentionDays include={deleted} bevat. Deze elementen worden niet weergegeven als deze blob niet is verwijderd. Deze elementen worden weergegeven voor blobs of momentopnamen die met bewerking zijn verwijderd toen de functie voor het verwijderen van de functie DELETE voor zacht verwijderen werd ingeschakeld. Deleted het element is ingesteld op true voor blobs en momentopnamen die soft zijn verwijderd. Deleted-Time komt overeen met het tijdstip waarop de blob is verwijderd. RemainingRetentionDays geeft het aantal dagen aan waarna de tijdelijke verwijderde blob permanent wordt verwijderd door de blobservice.

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

Voor versie 2019-02-02 en hoger retourneert het element als de blob is versleuteld met een door List Blobs CustomerProvidedKeySha256 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 parameter bevat en er toepassingsmetagegevens aanwezig zijn op een blob die is versleuteld met een door de klant geleverde sleutel, heeft het element een kenmerk om aan te geven dat de blob metagegevens heeft die niet kunnen worden ontsleuteld als onderdeel van de include={metadata} Metadata Encrypted="true" List Blobs bewerking. Roep Eigenschappen van blobs op halen aan of Haal blobmetagegevens op met de door de klant verstrekte sleutel voor toegang tot de metagegevens voor deze blobs.

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

Voor versie 2019-12-12 en hoger retourneert het element op Blob Storage- of Algemeen v2-accounts als het object de status In behandeling List Blobs RehydratePriority rehydrateren heeft. Geldige waarden zijn High / Standard . Zie Opslaglagen voor hot, cool en archief voor gedetailleerde informatie over blok-bloblagen.

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

Voor versie 2019-12-12 en hoger retourneert het element voor de huidige versie van de blob met de waarde ingesteld op , om deze te onderscheiden van de automatisch gegenereerde List Blobs IsCurrentVersion true alleen-lezen versies.

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

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

Voor versie 2020-02-10 en hoger retourneert List Blobs het LastAccessTime element . De elementen laten zien wanneer de gegevens van de blob voor het laatst zijn gebruikt 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 Blob Service API voor meer informatie over het instellen van het beleid voor het bijhouden van de laatste toegangstijd van het account. Het element houdt niet bij wanneer de metagegevens van de blob voor het laatst LastAccessTime worden gebruikt.

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

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

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

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

<?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>
        <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>
      </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 opsnoemen voor een voorbeeldreactie.

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 machtigingen heeft om blobs in een container weer te geven.

Opmerkingen

Blobeigenschappen in het antwoord

Als u hebt aangevraagd dat niet-toegezegde blobs worden opgenomen in de -enumeratie, moet u er rekening mee dat sommige eigenschappen pas worden ingesteld als de blob is vastgelegd, 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 wordt geretourneerd in het element overeen met de waarde van de Content-Length header van de x-ms-blob-content-length blob.

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

Metagegevens in het antwoord

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

Houd er rekening mee dat metagegevens die zijn aangevraagd met deze parameter 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 namen van metagegevens voldoen aan de naamconventaties voor C#-id's.

Als een naam-waardepaar met metagegevens de naamgevingsbeperkingen schendt die zijn afgedwongen door de versie 2009-09-19, geeft de antwoord-body de problematische naam binnen een element aan, zoals wordt weergegeven in het volgende x-ms-invalid-name 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 element is alleen aanwezig als de parameter is opgegeven op de URI en Tags als er tags in de blob include=tags zijn. Binnen het -element worden maximaal 10 elementen geretourneerd, die elk de en van de door de gebruiker gedefinieerde TagSet Tag Blob key value Index-tags bevatten. De volgorde van tags wordt niet gegarandeerd in het antwoord.

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

De opslagservice behoudt een sterke consistentie tussen een blob en de tags, maar de secundaire index is uiteindelijk consistent. Tags zijn mogelijk zichtbaar in een antwoord op Lijst-blobs voordat ze zichtbaar zijn voor bewerkingen 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 List Blobs aanroept met een scheidingsteken, kunt u geen momentopnamen opnemen in de -enumeratie. Een aanvraag die beide bevat, retourneert een InvalidQueryParameter-fout (HTTP-statuscode 400 – Ongeldige aanvraag).

Niet-opgenomen blobs in het antwoord

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

Metagegevens van objectreplicatie in het antwoord

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

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

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

Juridische hold in het antwoord

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

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

Resultatensets retourneren met behulp van een markeringswaarde

Als u een waarde opgeeft voor de parameter en het aantal te retourneren blobs deze waarde overschrijdt of de standaardwaarde voor overschrijdt, bevat de antwoord-body een element dat de volgende blob aangeeft die bij een volgende aanvraag moet worden maxresults retourneert. maxresults NextMarker Als u de volgende set items wilt retourneren, geeft u de waarde van op als de NextMarker markeringsparameter op de URI voor de volgende aanvraag.

Houd er rekening mee dat NextMarker de waarde van moet worden behandeld als ondoorzichtig.

Een scheidingsteken gebruiken om door de Blob-naamruimte te gaan

Met delimiter de parameter kan de aanroeper de blob-naamruimte 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 is. Het scheidingsteken kan één teken of een tekenreeks zijn. Wanneer de aanvraag deze parameter bevat, retourneert de bewerking een BlobPrefix -element. Het element wordt geretourneerd in plaats van alle blobs waarvan de namen beginnen met dezelfde subtekenreeks tot het uiterlijk BlobPrefix van het scheidingsteken. De waarde van het element is subtekenreeks + scheidingsteken , waarbij subtekenreeks de algemene subtekenreeks is die begint met een of meer blobnamen en scheidingsteken de waarde is van BlobPrefix de scheidingstekenparameter.

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

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

Blobs worden in alfabetische volgorde weergegeven in de hoofdletter van het antwoord, met hoofdletters als eerste 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 probeert, wordt ingesteld op en wordt de fout beschreven die mogelijk is opgetreden tijdens de laatste CopyStatus pending CopyStatusDescription kopieerpoging.

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

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

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

Zie ook

Status- en foutcodes
Foutcodes voor blob-services