Lista blobar

Åtgärden List Blobs returnerar en lista över blobarna under den angivna containern.

Förfrågan

Begäran List Blobs kan konstrueras på följande sätt. HTTPS rekommenderas. Ersätt myaccount med namnet på ditt lagringskonto:

Emulerad lagringstjänst-URI

När du gör en begäran mot den emulerade lagringstjänsten anger du emulatorns värdnamn och Blob Service-port som följt av namnet på det 127.0.0.1:10000 emulerade lagringskontot:

Mer information finns i Använda Azure Storage Emulator för utveckling och testning.

URI-parametrar

Följande ytterligare parametrar kan anges för URI:en.

Rubriker för begäran

I följande tabell beskrivs obligatoriska och valfria begärandehuvuden.

Begärandetext

Inga.

Exempelförfrågan

Se Räkna upp blobresurser för en exempelbegäran.

Svar

Svaret innehåller en HTTP-statuskod, en uppsättning svarshuvuden och en svarstext i XML-format.

Statuskod

En lyckad åtgärd returnerar statuskod 200 (OK).

Information om statuskoder finns i Status och Felkoder.

Svarsrubriker

Svaret för den här åtgärden innehåller följande huvuden. Svaret kan också innehålla ytterligare HTTP-standardhuvuden. Alla standardhuvuden följer protokollspecifikationen HTTP/1.1.

Svarstext

Formatet för XML-svaret är följande.

Observera att Prefix elementen Marker , , och bara finns om de har MaxResults Delimiter angetts i begärande-URI:t. Elementet NextMarker har bara ett värde om listresultatet inte är klart.

Ögonblicksbilder, blobmetadata och ogenomsagda blobar inkluderas endast i svaret om de har angetts med include parametern på begärans-URI:n.

I version 2009-09-19 och senare kapslas blobens egenskaper in i ett Properties -element.

Från och med version 2009-09-19 returnerar följande List Blobs omdöpta element i svarstexten:

• Last-Modified (tidigare LastModified )

• Content-Length (tidigare Size )

• Content-Type (tidigare ContentType )

• Content-Encoding (tidigare ContentEncoding )

• Content-Language (tidigare ContentLanguage )

Elementet Content-MD5 visas för blobar som skapats med version 2009-09-19 och senare. I version 2012-02-12 och senare beräknar Blob Service värdet när du laddar upp en blob med Put Blob , men beräknar inte detta när du skapar en blob med hjälp av Content-MD5 Placera blocklista. Du kan uttryckligen ange värdet när du skapar bloben eller genom Content-MD5 att anropa åtgärderna Placera blockeringslista eller Ange blobegenskaper.

För versioner från 2009-09-19 och senare men före version 2015-02-21 misslyckas anrop på en container som innehåller tilläggsblobbar med List Blobs statuskod 409 (FeatureVersionMismatch) om resultatet av listan innehåller en tilläggsblobb.

LeaseState och LeaseDuration visas endast i version 2012-02-12 och senare.

CopyId, CopyStatus , , , och visas endast i version CopySource CopyProgress CopyCompletionTime CopyStatusDescription 2012-02-12 include={copy} och senare när den här åtgärden innehåller parametern . De här elementen visas inte om den här bloben aldrig har varit målet i en åtgärd, eller om den här bloben har ändrats efter en slutförd åtgärd med Copy Blob hjälp av , eller Copy Blob Set Blob Properties Put Blob Put Block List . De här elementen visas inte heller med en blob som skapats av Kopiera blob före version 2012-02-12.

I version 2013-08-15 och senare innehåller elementet ett attribut som anger blobslutpunkten och ett fält som anger namnet på EnumerationResults ServiceEndpoint ContainerName containern. I tidigare versioner kombinerades dessa två attribut tillsammans i ContainerName fältet . Även i version 2013-08-15 och senare har Url elementet under Blob tagits bort.

För version 2015-02-21 och senare returneras blobar av alla typer List Blobs (block-, sid- och tilläggsblobar).

För version 2015-12-11 och senare List Blobs returnerar ServerEncrypted elementet . Det här elementet är true inställt på om blob- och programmetadata är helt krypterade och false i annat fall.

För version 2016-05-31 och senare returnerar elementet för inkrementella kopieringsblobar och ögonblicksbilder med List Blobs IncrementalCopy värdet inställt på true .

För version 2017-04-17 och senare returnerar elementet om en List Blobs AccessTier åtkomstnivå uttryckligen har angetts. En lista över tillåtna blobnivåer för Premium-sidor finns i Högpresterande Premium Storage och hanterade diskar för virtuella datorer. För Blob Storage- Generell användning v2-konton är giltiga värden Hot / Cool / Archive . Om bloben är i väntande tillstånd för rehydrate ArchiveStatus returneras elementet med ett av de giltiga värdena rehydrate-pending-to-hot / rehydrate-pending-to-cool . Detaljerad information om blockblobnivåer finns i Lagringsnivåer för hot, cool och arkiv.

För version 2017-04-17 och senare returnerar elementet på List Blobs AccessTierInferred Blob Storage- eller Generell användning v2-konton. Om blockbloben inte har åtkomstnivån inställd härför vi lagringskontots egenskaper och det här värdet är inställt på true . Det här huvudet finns bara om nivån härförs från kontoegenskapen. Detaljerad information om blockblobnivåer finns i Lagringsnivåer för hot, cool och arkiv.

För version 2017-04-17 och senare returnerar elementet på List Blobs AccessTierChangeTime Blob Storage- eller Generell användning v2-konton. Detta returneras bara om nivån på blockbloben någonsin har angetts. Datumformatet följer RFC 1123. Mer information finns i Representation of Date-Time Values in Headers. Detaljerad information om blockblobnivåer finns i Lagringsnivåer för hot, cool och arkiv.

För version 2017-07-29 och senare visas Deleted , och när den här åtgärden innehåller DeletedTime RemainingRetentionDays include={deleted} parametern . De här elementen visas inte om den här bloben inte har tagits bort. De här elementen visas för blob eller ögonblicksbild som tas bort med DELETE åtgärden när funktionen för mjuk borttagning aktiverades. Deleted -elementet är inställt på true för blobar och ögonblicksbilder som är mjukt borttagna. Deleted-Time motsvarar tiden då bloben togs bort. RemainingRetentionDays anger efter hur många dagar bloben med mjuk borttagning tas bort permanent av blobtjänsten.

För version 2017-11-09 och senare returnerar Creation-Time den tid då bloben skapades.

För version 2019-02-02 och senare returnerar elementet om bloben krypteras med en nyckel List Blobs CustomerProvidedKeySha256 som tillhandahålls av kunden. Värdet anges till SHA-256-hashen för nyckeln som används för att kryptera bloben. Om åtgärden dessutom innehåller parametern och det finns programmetadata på en blob som krypterats med en kundtilldelade nyckel, har elementet ett attribut som anger att bloben har metadata som inte include={metadata} Metadata kan dekrypteras som en del av Encrypted="true" List Blobs åtgärden. Anropa Hämta blobegenskaper eller Hämta blobmetadata med den kundtilldelade nyckeln för att få åtkomst till metadata för dessa blobar.

För version 2019-02-02 och senare returnerar elementet om bloben är List Blobs EncryptionScope krypterad med ett krypteringsomfång. Värdet anges till namnet på det krypteringsomfång som används för att kryptera bloben. Om åtgärden innehåller include={metadata} parametern dekrypteras programmetadata på bloben transparent och är tillgängliga i Metadata elementet .

För version 2019-12-12 och senare returnerar elementet på Blob Storage- eller Generell användning v2-konton om objektet är i väntande tillstånd List Blobs RehydratePriority för rehydrera. Giltiga värden är High / Standard . Detaljerad information om blockblobnivåer finns i Lagringsnivåer för hot, cool och arkiv.

För version 2019-12-12 och senare returnerar elementet för blobar och genererade blobversioner när Versionshantering är aktiverat List Blobs VersionId för kontot.

För version 2019-12-12 och senare returnerar elementet för den aktuella versionen av bloben med värdet inställt på , för att skilja det från de skrivskyddade automatiskt genererade List Blobs IsCurrentVersion true versionerna.

För version 2019-12-12 och senare returnerar List Blobs TagCount elementet för blobar med eventuella taggar. Elementet Tags visas bara när den här åtgärden innehåller include={tags} parametern . De här elementen visas inte om det inte finns några taggar på bloben.

För version 2019-12-12 och senare returnerar List Blobs Sealed elementet för tilläggsblobar. Elementet Sealed visas bara när tilläggsbloben har förseglats. De här elementen visas inte om tilläggsbloben inte är förseglad.

För version 2020-02-10 och senare List Blobs returnerar LastAccessTime elementet . Elementen visar när blobens data senast koms åt enligt lagringskontots spårningsprincip för senaste åtkomsttid. Elementet returneras inte om lagringskontot inte har någon spårningsprincip för senaste åtkomst eller om principen är inaktiverad. Information om hur du anger kontots spårningsprincip för senaste åtkomsttid finns i Blob Service API. Elementet LastAccessTime spårar inte den senaste gången blobens metadata används.

För version 2020-06-12 och senare returnerar elementen och när List Blobs den här åtgärden innehåller ImmutabilityPolicyUntilDate ImmutabilityPolicyMode include={immutabilitypolicy} parametern .

För version 2020-06-12 och senare List Blobs returnerar LegalHold elementet när den här åtgärden innehåller include={legalhold} parametern .

För version 2020-06-12 och senare för konton med en hierarkisk namnrymd aktiverad returnerar elementet , och när begäran List Blobs Owner innehåller Group Permissions Acl include={permissions} parametern. Observera att Acl -elementet är en kombinerad lista över åtkomst- och standard-ACL:er som har angetts för filen/katalogen.

För version 2020-08-04 och senare returnerar för konton med hierarkisk namnrymd aktiverat elementet för List Blobs DeletionId borttagna blobar. DeletionId är en osignerad 64-bitars identifierare som unikt identifierar en mjuk borttagna sökväg för att skilja den från andra borttagna blobar med samma sökväg.

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

Exempelsvar

Se Räkna upp blobresurser för ett exempelsvar.

Tillstånd

Om containerns åtkomstkontrollista (ACL) är inställd på att tillåta anonym åtkomst till containern kan alla klienter anropa den här åtgärden. Annars kan den här åtgärden anropas av kontoägaren och av vem som helst med en signatur för delad åtkomst som har behörighet att lista blobar i en container.

Kommentarer

Blobegenskaper i svaret

Om du har begärt att ogenomlästa blobar ska tas med i uppräkningen bör du observera att vissa egenskaper inte anges förrän bloben har utförts, så vissa egenskaper kanske inte returneras i svaret.

Elementet x-ms-blob-sequence-number returneras endast för sidblobar.

Elementet OrMetadata returneras endast för blockblobar.

För sidblobar motsvarar värdet som Content-Length returneras i elementet värdet för blobens x-ms-blob-content-length sidhuvud.

Elementet visas bara i svarstexten om det har angetts på bloben med Content-MD5 version 2009-09-19 eller senare. Du kan ange egenskapen Content-MD5 när bloben skapas eller genom att anropa Ange blobegenskaper. I version 2012-02-12 och senare anger du MD5-värdet för en blockblob även om begäran inte innehåller något Put Blob Put Blob MD5-huvud.

Metadata i svaret

Elementet Metadata finns bara om parametern har include=metadata angetts för URI:en. I Metadata elementet visas värdet för varje namn/värde-par i ett element som motsvarar parets namn.

Observera att metadata som begärs med den här parametern måste lagras i enlighet med namngivningsbegränsningarna som tillämpas av blobtjänstens version 2009-09-19. Från och med den här versionen måste alla metadatanamn följa namngivningskonventionerna för C#-identifierare.

Om ett namn/värde-par för metadata bryter mot namngivningsbegränsningarna som framtvingas av versionen 2009-09-19 anger svarstexten det problematiska namnet i ett element, enligt x-ms-invalid-name följande XML-fragment:

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

Taggar i svaret

Elementet Tags finns bara om parametern har include=tags angetts för URI:en och om det finns taggar på bloben. I elementet returneras upp till 10 element som var och en innehåller och för TagSet Tag de key value användardefinierade blobindextaggarna. Ordningen på taggar garanteras inte i svaret.

Elementen Tags TagCount och returneras inte om det inte finns några taggar på bloben.

Lagringstjänsten har stark konsekvens mellan en blob och dess taggar, men det sekundära indexet blir konsekvent. Taggar kan visas i ett svar på listblobar innan de visas för åtgärderna Find Blobs by Tags (Hitta blobar efter taggar).

Ögonblicksbilder i svaret

Ögonblicksbilder visas bara i svaret om include=snapshots parametern har angetts för URI:en. Ögonblicksbilder som anges i svaret inkluderar inte LeaseStatus elementet eftersom ögonblicksbilder inte kan ha aktiva lån.

Om du List Blobs anropar med en avgränsare kan du inte även inkludera ögonblicksbilder i uppräkningen. En begäran som innehåller båda returnerar ett InvalidQueryParameter-fel (HTTP-statuskod 400 – felaktig begäran).

Ogenomskända blobar i svaret

Ogenomsagda blobar visas bara i svaret om include=uncommittedblobs parametern har angetts för URI:en. Ogenomsagd blobbar som anges i svaret innehåller inte något av följande element:

• Last-Modified

• Etag

• Content-Type

• Content-Encoding

• Content-Language

• Content-MD5

• Cache-Control

• Metadata

Borttagna blobar i svaret

Borttagna blobar visas bara i svaret om include=deleted parametern har angetts för URI:en. Borttagna blobar som anges i svaret inkluderar inte lånelementen eftersom borttagna blobar inte kan ha aktiva lån.

Borttagna ögonblicksbilder ingår i listsvaret om include=deleted,snapshot har angetts för URI:en.

Metadata för objektreplikering i svaret

Elementet finns när en objektreplikeringsprincip har utvärderats på en blob och anropet Lista blobar gjordes med OrMetadata version 2019-12-12 eller senare. I OrMetadata elementet visas värdet för varje namn/värde-par i ett element som motsvarar parets namn. Formatet för namn är , där är ett guid som representerar objektreplikeringsprincipens identifierare på lagringskontot och är ett GUID som representerar regelidentifieraren or-{policy-id}_{rule-id} {policy-id} för {rule-id} lagringscontainern. Giltiga värden är 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>  
…  
  

Oföränderlighetsprincip i svaret

ImmutabilityPolicyUntilDateElementen ImmutabilityPolicyMode finns bara om include=immutabilitypolicy parametern har angetts för URI:en.

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

Kvarkvar av juridiska personer i svaret

Elementet LegalHold finns bara om parametern har include=legalhold angetts för URI:en.

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

Returnera resultatuppsättningar med hjälp av ett markörvärde

Om du anger ett värde för parametern och antalet blobar som ska returneras överskrider det här värdet, eller överskrider standardvärdet för , innehåller svarstexten ett -element som anger att nästa blob ska returneras för en efterföljande maxresults maxresults NextMarker begäran. Om du vill returnera nästa uppsättning objekt anger du värdet för NextMarker som markörparameter på URI:en för efterföljande begäran.

Observera att värdet för NextMarker ska behandlas som täckande.

Använda en avgränsare för att bläddra i blobnamnområdet

Parametern delimiter gör att anroparen kan bläddra i blobnamnområdet med hjälp av en användarkonfigurerad avgränsare. På så sätt kan du bläddra i en virtuell hierarki med blobar som om det vore ett filsystem. Avgränsaren kan vara ett enskilt tecken eller en sträng. När begäran innehåller den här parametern returnerar åtgärden ett BlobPrefix -element. Elementet returneras i stället för alla blobar vars namn börjar med samma delsträng upp till BlobPrefix avgränsartecknets utseende. Värdet för elementet är delsträng+avgränsare , där delsträng är den gemensamma delsträngen som börjar med ett eller flera blobnamn, och avgränsaren är värdet för BlobPrefix avgränsarparametern.

Du kan använda värdet för att göra ett efterföljande anrop för att lista de blobar som börjar med det här prefixet genom att ange värdet för för parametern på BlobPrefix BlobPrefix prefix URI:n för begäran.

Observera att varje BlobPrefix element som returneras räknas mot det maximala resultatet, precis som varje Blob element gör.

Blobar visas i alfabetisk ordning i svarstexten, med versaler listade först.

Kopieringsfel i CopyStatusDescription

CopyStatusDescription innehåller mer information om Copy Blob felet.

• När ett kopieringsförsök misslyckas och Blob Service fortfarande försöker utföra åtgärden igen anges till , och texten beskriver felet som kan ha inträffat under det CopyStatus pending senaste CopyStatusDescription kopieringsförsöket.

• När CopyStatus är failed inställt på CopyStatusDescription , beskriver texten felet som gjorde att kopieringsåtgärden misslyckades.

I följande tabell beskrivs de tre fälten för varje CopyStatusDescription värde.

I följande tabell beskrivs värdena CopyStatus och CopyStatusDescription för vanliga felscenarier.

Se även

Status och felkoder
Felkoder för Blob Service