Dela via

Lista blobar

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

Begäran

Du kan skapa List Blobs begäran enligt följande. HTTPS rekommenderas. Ersätt myaccount- med namnet på ditt lagringskonto.

Metod Begärande-URI HTTP-version
GET https://myaccount.blob.core.windows.net/mycontainer?restype=container&comp=list HTTP/1.1 (på engelska)

Emulerad lagringstjänst-URI

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

Metod Begärande-URI HTTP-version
GET http://127.0.0.1:10000/devstoreaccount1/mycontainer?restype=container&comp=list HTTP/1.1 (på engelska)

Mer information finns i Använda Azurite-emulatorn för lokal Azure Storage-utveckling.

URI-parametrar

Du kan ange följande ytterligare parametrar på URI:n.

Parameter Beskrivning
prefix Valfri. Filtrerar resultatet så att endast blobar returneras med namn som börjar med det angivna prefixet. I konton som har ett hierarkiskt namnområde uppstår ett fel i de fall där namnet på en fil visas mitt i prefixsökvägen. Du kan till exempel försöka hitta blobar som namnges readmefile.txt med hjälp av prefixet path folder1/folder2/readme/readmefile.txt. Ett fel visas om någon undermapp innehåller en fil med namnet readme.
delimiter Valfri. När begäran innehåller den här parametern returnerar åtgärden ett BlobPrefix element i svarstexten. Det här elementet fungerar som platshållare för alla blobar med namn som börjar med samma understräng, upp till avgränsartecknets utseende. Avgränsaren kan vara ett enskilt tecken eller en sträng.
marker Valfri. Ett strängvärde som identifierar den del av listan som ska returneras med nästa liståtgärd. Åtgärden returnerar ett markörvärde i svarstexten om listan som returnerades inte var slutförd. Du kan sedan använda markörvärdet i ett efterföljande anrop för att begära nästa uppsättning listobjekt.

Markörvärdet är ogenomskinlig för klienten.
maxresults Valfri. Anger det maximala antalet blobar som ska returneras, inklusive alla BlobPrefix element. Om begäran inte anger maxresults, eller anger ett värde som är större än 5 000, returnerar servern upp till 5 000 objekt. Om det finns ytterligare resultat att returnera returnerar tjänsten en fortsättningstoken i svarselementet NextMarker . I vissa fall kan tjänsten returnera färre resultat än vad som anges av maxresultsoch även returnera en fortsättningstoken.

Om du anger maxresults till ett värde som är mindre än eller lika med noll resulterar det i felsvarskoden 400 (felaktig begäran).
include={snapshots,metadata,uncommittedblobs,copy,deleted,tags,versions,
deletedwithversions,immutabilitypolicy,legalhold,permissions}		 Valfri. Anger en eller flera datauppsättningar som ska ingå i svaret:

- snapshots: Anger att ögonblicksbilder ska ingå i uppräkningen. Ögonblicksbilder visas från äldsta till nyaste i svaret.
- metadata: Anger att blobmetadata ska returneras i svaret.
- uncommittedblobs: Anger att blobar för vilka block har laddats upp, men som inte har checkats in med hjälp av Put Block List, ska ingå i svaret.
- copy: Version 2012-02-12 och senare. Anger att metadata som är relaterade till en aktuell eller tidigare Copy Blob åtgärd ska inkluderas i svaret.
- deleted: Version 2017-07-29 och senare. Anger att mjukt borttagna blobar ska ingå i svaret.
- tags: Version 2019-12-12 och senare. Anger att användardefinierade blobindextaggar ska ingå i svaret.
- versions: Version 2019-12-12 och senare. Anger att versioner av blobar ska ingå i uppräkningen.
- deletedwithversions: Version 2020-10-02 och senare. Anger att borttagna blobar med alla versioner (aktiva eller borttagna) ska ingå i svaret. Objekt som du har tagit bort permanent visas i svaret tills de bearbetas av skräpinsamling. Använd taggen \<HasVersionsOnly\>och värdet true.
- immutabilitypolicy: Version 2020-06-12 och senare. Anger att uppräkningen ska innehålla principen för oföränderlighet fram till datum och blobbarnas oföränderlighetsprincipläge.
- legalhold: Version 2020-06-12 och senare. Anger att uppräkningen ska innehålla det lagliga bevarandet av blobar.
- permissions: Version 2020-06-12 och senare. Stöds endast för konton med ett hierarkiskt namnområde aktiverat. Om en begäran innehåller den här parametern inkluderas listan ägare, grupp, behörigheter och åtkomstkontroll för de listade blobarna eller katalogerna i uppräkningen.

Om du vill ange fler än ett av dessa alternativ på URI:n måste du avgränsa varje alternativ med ett URL-kodat kommatecken ("%82").
showonly={deleted,files,directories} Valfri. Anger en av dessa datauppsättningar som ska returneras i svaret:

- deleted:Valfri. Version 2020-08-04 och senare. Endast för konton som är aktiverade med hierarkiskt namnområde. När en begäran innehåller den här parametern innehåller listan endast mjuk borttagna blobar. Observera att RESERV FÖR POSIX ACL-auktorisering inte stöds för listning av mjuka borttagna blobar. Om include=deleted anges misslyckas begäran med Felaktig begäran (400).
- files:Valfri. Version 2020-12-06 och senare. Endast för konton som är aktiverade med hierarkiskt namnområde. När en begäran innehåller den här parametern innehåller listan endast filer.
- directories:Valfri. Version 2020-12-06 och senare. Endast för konton som är aktiverade med hierarkiskt namnområde. När en begäran innehåller den här parametern innehåller listan endast kataloger.
timeout Valfri. Parametern timeout uttrycks i sekunder. Mer information finns i Ange tidsgränser för Blob Storage-åtgärder.

Begärandehuvuden

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

Begärandehuvud Beskrivning
Authorization Krävs. Anger auktoriseringsschema, kontonamn och signatur. Mer information finns i Auktorisera begäranden till Azure Storage.
Date eller x-ms-date Krävs. Anger UTC (Coordinated Universal Time) för begäran. Mer information finns i Auktorisera begäranden till Azure Storage.
x-ms-version Krävs för alla auktoriserade begäranden och valfritt för anonyma begäranden. Anger vilken version av åtgärden som ska användas för den här begäran. Mer information finns i Versionshantering för Azure Storage-tjänsterna.
x-ms-client-request-id Valfri. Tillhandahåller ett klientgenererat, täckande värde med en kibibytesteckengräns (KiB) som registreras i loggarna när loggningen konfigureras. Vi rekommenderar starkt att du använder det här huvudet för att korrelera aktiviteter på klientsidan med begäranden som servern tar emot. Mer information finns i Övervaka Azure Blob Storage-.
x-ms-upn Valfri. Giltigt endast när ett hierarkiskt namnområde är aktiverat för kontot och include=permissions anges i begäran. Om trueomvandlas de användaridentitetsvärden som returneras i fälten <Ägare>, <Grupp> och <ACL> från Microsoft Entra-objekt-ID:t till användarens huvudnamn. Om falsereturneras värdena som Microsoft Entra objekt-ID:t. Standardvärdet är false. Observera att grupp- och programobjekt-ID:t inte översätts eftersom de inte har unika egna namn.

Begärandetext

Ingen.

Exempelbegäran

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.

Svarshuvuden

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

Svarsrubrik Beskrivning
Content-Type Anger i vilket format resultatet returneras. För närvarande är det här värdet application/xml.
x-ms-request-id Det här huvudet identifierar unikt den begäran som gjordes och kan användas för att felsöka begäran. Mer information finns i Felsökning av API-åtgärder.
x-ms-version Anger vilken version av Blob Storage som används för att köra begäran. Det här huvudet returneras för begäranden som görs med hjälp av version 2009-09-19 och senare.

Det här huvudet returneras också för anonyma begäranden, utan en angiven version, om containern har markerats för offentlig åtkomst med hjälp av 2009-09-19-versionen av Blob Storage.
Date Ett UTC-datum/tid-värde som anger den tid då svaret initierades. Tjänsten genererar det här värdet.
x-ms-client-request-id Du kan använda den här rubriken för att felsöka begäranden och motsvarande svar. Värdet för det här huvudet är lika med värdet för x-ms-client-request-id-huvudet, om det finns i begäran. Värdet är högst 1 024 synliga ASCII-tecken. Om x-ms-client-request-id-huvudet inte finns i begäran visas inte det här huvudet i svaret.

Svarstext

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

Observera att elementen Prefix, Marker, MaxResultsoch Delimiter endast finns om de har angetts på begärande-URI:n. Om NextMarker är tom är listresultaten klara. Om den NextMarkerinte är tom kan det hända att listresultaten är fullständiga eller inte. Om du vill visa en lista över alla blobar fortsätter du att anropa List Blobs med efterföljande markörvärden tills NextMarker den är tom.

Ögonblicksbilder, blobmetadata och ogenomlästa blobar ingår endast i svaret om de anges med include parametern på begärande-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 List Blobs returneras följande 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 blobbar som skapats med version 2009-09-19 och senare. I version 2012-02-12 och senare beräknar Content-MD5 Blob Storage värdet när du laddar upp en blob med hjälp av Put Blob. Blob Storage beräknar inte detta när du skapar en blob med hjälp av Put Block List. Du kan uttryckligen ange värdet Content-MD5 när du skapar bloben eller genom att anropa åtgärderna Put Block List eller Set Blob Properties .

För versioner från 2009-09-19 och senare, men före version 2015-02-21, kan du inte anropa List Blobs en container som innehåller tilläggsblobar. Tjänsten returnerar statuskod 409 (konflikt) om resultatet av listan innehåller en tilläggsblob.

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

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

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

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

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

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

För version 2017-04-17 och senare List Blobs returneras AccessTier elementet om en åtkomstnivå uttryckligen har angetts. En lista över tillåtna blobnivåer för premiumsidor finns i Premiumlagring med höga prestanda och hanterade diskar för virtuella datorer. För Blob Storage- eller v2-konton för generell användning är Hotgiltiga värden , Cool, och Archive. Om bloben är i väntande tillstånd ArchiveStatus för rehydrering returneras elementet med ett av de giltiga värdena (rehydrate-pending-to-hot, rehydrate-pending-to-cool, eller rehydrate-pending-to-cold). Detaljerad information om blockblobnivåindelning finns i Lagringsnivåer för frekvent, lågfrekvent lagring och arkivlagring.

För version 2017-04-17 och senare List Blobs returneras elementet på Blob Storage eller konton för AccessTierInferred generell användning v2. Om blockbloben inte har åtkomstnivån inställd härleds nivåinformationen från egenskaperna för lagringskontot och det här värdet är inställt på true. Det här huvudet finns bara om nivån härleds från kontoegenskapen.

För version 2017-04-17 och senare List Blobs returneras elementet på Blob Storage eller konton för AccessTierChangeTime generell användning v2. Detta returneras endast om nivån på blockbloben någonsin har angetts. Mer information finns i Representation av datum-tidsvärden i rubriker.

För version 2017-07-29 och senare Deletedvisas , DeletedTimeoch RemainingRetentionDays visas när den här åtgärden innehåller parametern include={deleted} . Dessa element visas inte om den här bloben inte har tagits bort. Dessa element visas för blobar eller ögonblicksbilder som tas bort med DELETE åtgärden när funktionen för mjuk borttagning aktiverades. Elementet Deleted är inställt på true för blobar och ögonblicksbilder som tas bort mjukt. Deleted-Time motsvarar den tid då bloben togs bort. RemainingRetentionDays Anger antalet dagar efter vilka en mjukt borttagen blob tas bort permanent.

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

För version 2019-02-02 och senare List Blobs returneras elementet CustomerProvidedKeySha256 om bloben krypteras med en nyckel som tillhandahålls av kunden. Värdet anges till SHA-256-hashen för nyckeln som används för att kryptera bloben. Dessutom, om åtgärden innehåller include={metadata} parametern och det finns programmetadata på en blob som krypterats med en nyckel som tillhandahålls av kunden Metadata , kommer elementet att ha ett Encrypted="true" attribut. Det här attributet anger att bloben har metadata som inte kan dekrypteras som en del av åtgärden List Blobs . Om du vill komma åt metadata för dessa blobar anropar du Get Blob Properties eller Get Blob Metadata med den nyckel som kunden tillhandahåller.

För version 2019-02-02 och senare List Blobs returneras elementet EncryptionScope om bloben krypteras med ett krypteringsomfång. Värdet anges till namnet på krypteringsomfånget 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 elementet Metadata .

För version 2019-12-12 och senare List Blobs returneras elementet RehydratePriority på Blob Storage- eller v2-konton för generell användning, om objektet är i tillståndet rehydrate pending . Giltiga värden är High och Standard.

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

För version 2019-12-12 och senare List Blobs returneras elementet IsCurrentVersion för den aktuella versionen av bloben. Värdet är inställt på true. Med det här elementet kan du skilja den aktuella versionen från de skrivskyddade, automatiskt genererade versionerna.

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

För version 2019-12-12 och senare List Blobs returneras elementet Sealed för att lägga till blobar. Elementet Sealed visas bara när tilläggsblobben har förseglats. Dessa element visas inte om tilläggsbloben inte är förseglad.

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

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

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

För version 2020-06-12 och senare, för konton med ett hierarkiskt namnområde aktiverat, List Blobs returneras elementen Owner, GroupPermissions, och Acl . Begäran måste innehålla parametern include={permissions} . Observera att Acl elementet är en kombinerad lista över åtkomst- och standardåtkomstkontrollistor som har angetts för filen eller katalogen.

För version 2020-06-12 och senare, för konton med ett hierarkiskt namnområde aktiverat, List Blobs returnerar Properties elementet i elementet med BlobPrefix en avgränsare. Detta motsvarar egenskaperna i katalogen.

För version 2020-08-04 och senare, för konton med ett hierarkiskt namnområde aktiverat, List Blobs returneras elementet DeletionId för borttagna blobar. DeletionId är en osignerad 64-bitars identifierare. Elementet identifierar unikt en mjuk borttagen sökväg för att skilja den från andra borttagna blobbar med samma sökväg.

För version 2020-10-02 och senare, för konton med ett hierarkiskt namnområde aktiverat, List Blobs returneras egenskapselementet ResourceType för sökvägen. Detta kan vara antingen file eller directory.

För version 2021-02-12 och senare kodar du List Blobs procentuellt (enligt RFC 2396) alla BlobName eller BlobPrefixName elementvärden. Mer specifikt kommer det att göra det för de värden som innehåller tecken som inte är giltiga i XML (U+FFFE eller U+FFFF). Om det kodas innehåller elementet Name ett Encoded=true attribut. Observera att detta endast inträffar för de Name elementvärden som innehåller de ogiltiga tecknen i XML, inte de återstående Name elementen i svaret.

För version 2021-06-08 och senare, för konton med ett hierarkiskt namnområde aktiverat, List Blobs returneras elementet Placeholder properties. Den returnerar det här elementet i elementet BlobPrefix för platshållarkataloger när du listar borttagna blobar med en avgränsare. Dessa platshållarkataloger finns för att underlätta navigeringen till mjukt borttagna blobar.

För version 2021-06-08 och senare, för konton med ett hierarkiskt namnområde aktiverat, List Blobs returneras elementet EncryptionContext . Om egenskapsvärdet för krypteringskontexten har angetts returneras det angivna värdet.

För version 2020-02-10 och senare, för konton med ett hierarkiskt namnområde aktiverat, List Blobs returneras elementet Expiry-Time för borttagna blobar. Expiry-Time är den tid då filen upphör att gälla och returneras för filen om förfallodatumet har angetts till samma.

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

Exempelsvar

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

Tillstånd

Auktorisering krävs när du anropar en dataåtkomståtgärd i Azure Storage. Du kan auktorisera åtgärden List Blobs enligt beskrivningen nedan.

Viktig

Microsoft rekommenderar att du använder Microsoft Entra-ID med hanterade identiteter för att auktorisera begäranden till Azure Storage. Microsoft Entra-ID ger överlägsen säkerhet och användarvänlighet jämfört med auktorisering av delad nyckel.

Azure Storage stöder användning av Microsoft Entra-ID för att auktorisera begäranden till blobdata. Med Microsoft Entra-ID kan du använda rollbaserad åtkomstkontroll i Azure (Azure RBAC) för att bevilja behörigheter till ett säkerhetsobjekt. Säkerhetsobjektet kan vara en användare, grupp, huvudnamn för programtjänsten eller en hanterad Azure-identitet. Säkerhetsobjektet autentiseras av Microsoft Entra-ID för att returnera en OAuth 2.0-token. Token kan sedan användas för att auktorisera en begäran mot Blob-tjänsten.

Mer information om auktorisering med Microsoft Entra-ID finns i Auktorisera åtkomst till blobar med hjälp av Microsoft Entra-ID.

Behörigheter

Nedan visas den RBAC-åtgärd som krävs för att en Microsoft Entra-användare, grupp, hanterad identitet eller tjänstens huvudnamn ska anropa den List Blobs åtgärden och den minst privilegierade inbyggda Azure RBAC-rollen som innehåller den här åtgärden:

Om du anger include=tags:

Mer information om hur du tilldelar roller med Hjälp av Azure RBAC finns i Tilldela en Azure-roll för åtkomst till blobdata.

Anmärkningar

Blobegenskaper i svaret

Om du har begärt att icke-bekräftade blobbar ska inkluderas i uppräkningen bör du notera att vissa egenskaper inte har angetts förrän blobben har checkats in. Vissa egenskaper kanske inte returneras i svaret.

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

Elementet OrMetadata returneras endast för blockblobar.

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

Elementet Content-MD5 visas i svarstexten, endast om det har angetts på bloben med hjälp av version 2009-09-19 eller senare. Du kan ange Content-MD5 egenskapen när bloben skapas eller genom att anropa Set Blob Properties. I version 2012-02-12 och senare Put Blob anger en blockblobs MD5-värde, även om Put Blob begäran inte innehåller ett MD5-huvud.

Metadata i svaret

Elementet Metadata finns bara om include=metadata parametern har angetts på URI:n. I elementet Metadata listas 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 de namngivningsbegränsningar som infördes av 2009-09-19-versionen av Blob Storage. 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 dessa namngivningsbegränsningar anger svarstexten det problematiska namnet i ett x-ms-invalid-name element. Följande XML-fragment visar detta:

  
…  
<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 include=tags parametern har angetts på URI:n och om det finns taggar på bloben. I elementet TagSet returneras upp till 10 Tag element, som var och value en innehåller de användardefinierade blobindextaggarnakey. Ordningen på taggar garanteras inte i svaret.

Elementen Tags and TagCount returneras inte om det inte finns några taggar på blobben.

Lagringstjänsten upprätthåller en stark konsekvens mellan en blob och dess taggar, men det sekundära indexet är så småningom konsekvent. Taggar kan vara synliga i ett svar på List Blobs innan de är synliga för Find Blobs by Tags åtgärder.

Ögonblicksbilder i svaret

Ögonblicksbilder visas endast i svaret om include=snapshots parametern har angetts på URI:n. Ögonblicksbilder som anges i svaret innehåller inte elementet LeaseStatus , eftersom ögonblicksbilder inte kan ha aktiva lån.

Med hjälp av tjänstversion 2021-06-08 och senare kan du anropa List Blobs med en avgränsare och inkludera ögonblicksbilder i uppräkningen. För tjänstversioner före 2021-06-08 returnerar en begäran som innehåller båda ett InvalidQueryParameter-fel (HTTP-statuskod 400 – Felaktig begäran).

Icke-utelämnade blobar i svaret

Ogenomlästa blobar visas endast i svaret om include=uncommittedblobs parametern har angetts på URI:n. Blobbar som inte har angetts 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 endast i svaret om include=deleted parametern har angetts på URI:n. Borttagna blobar som anges i svaret innehåller inte låneelementen , eftersom borttagna blobar inte kan ha aktiva lån.

Borttagna ögonblicksbilder ingår i listsvaret om include=deleted,snapshot det har angetts på URI:n.

Metadata för objektreplikering i svaret

Elementet OrMetadata finns när en objektreplikeringsprincip har utvärderats på en blob och anropet gjordes med hjälp av List Blobs version 2019-12-12 eller senare. I elementet OrMetadata listas värdet för varje namn/värde-par i ett element som motsvarar parets namn. Formatet för namnet är or-{policy-id}_{rule-id}, där {policy-id} är ett GUID som representerar identifieraren för objektreplikeringsprincipen på lagringskontot. {rule-id} är ett GUID som representerar regelidentifieraren i lagringscontainern. Giltiga värden är complete eller 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

Elementen ImmutabilityPolicyUntilDate och ImmutabilityPolicyMode finns bara om parametern har angetts include=immutabilitypolicy på URI:n.

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

Elementet LegalHold finns bara om include=legalhold parametern har angetts på URI:n.

<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 maxresults parametern och antalet blobar som ska returneras överskrider det här värdet, eller överskrider standardvärdet för maxresults, innehåller svarstexten ett NextMarker element. Det här elementet anger nästa blob som ska returneras för en efterföljande begäran. I vissa fall kan tjänsten returnera elementet NextMarker även om antalet returnerade resultat är mindre än värdet för maxresults.

Om du vill returnera nästa uppsättning objekt anger du värdet NextMarker för som markörparameter på URI:n för den efterföljande begäran. Observera att värdet för NextMarker ska behandlas som ogenomskinligt.

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

Parametern delimiter gör det möjligt för anroparen att bläddra i blobnamnområdet med hjälp av en användarkonfigurerad avgränsare. På så sätt kan du passera 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 BlobPrefix returneras i stället för alla blobar med namn som börjar med samma delsträng, upp till utseendet på avgränsningstecknet. Elementets BlobPrefix värde är delsträng+avgränsare, där delsträng är den gemensamma delsträngen som börjar ett eller flera blobnamn och avgränsare är parameterns delimiter värde.

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

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

Blobbar visas i alfabetisk ordning i svarstexten, med versaler listade först. Observera att för konton med ett hierarkiskt namnområde aktiverat / behandlas det som den lägsta sorteringsordningen. Den här skillnaden i beteende gäller endast för listning rekursivt.

Kopieringsfel i Beskrivning av kopieringsstatus

CopyStatusDescription innehåller mer information om felet Copy Blob .

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

  • När CopyStatus är inställt failedpå beskriver texten CopyStatusDescription felet som gjorde att kopieringen misslyckades.

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

Komponent Beskrivning
HTTP-statuskod Standard-tresiffrigt heltal som anger felet.
Felkod Nyckelord som beskriver felet. Den tillhandahålls av Azure i ErrorCode-elementet<>. Om inget <ErrorCode-element> visas returnerar tjänsten ett nyckelord som innehåller standardfeltext som är associerad med den tresiffriga HTTP-statuskoden i HTTP-specifikationen. Mer information finns i Vanliga REST API-felkoder.
Information Detaljerad beskrivning av felet, inom citattecken.

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

Viktig

Beskrivningstexten som visas här kan ändras utan förvarning, även utan en versionsändring. Förlita dig inte på att matcha den här exakta texten.

Scenarium Kopieringsstatusvärde Värde för kopieringsstatusbeskrivning
Kopieringsåtgärden har slutförts. framgång tom
Användaren avbröt kopieringsåtgärden innan den slutfördes. Avbröts tom
Ett fel uppstod vid läsning från källbloben under en kopieringsåtgärd. Åtgärden kommer att utföras på nytt. avvaktan 502 BadGateway "Påträffade ett nytt försöksfel när källan lästes. Försöker igen. Tidpunkt för misslyckande: <tid>"
Ett fel uppstod när en kopieringsåtgärd skulle skrivas till målbloben. Åtgärden kommer att utföras på nytt. avvaktan 500 InternalServerError "Påträffade ett nytt försöksfel. Försöker igen. Tidpunkt för misslyckande: <tid>"
Ett oåterkalleligt fel uppstod vid läsning från källbloben för en kopieringsåtgärd. Misslyckades 404 ResourceNotFound "Kopieringen misslyckades vid läsning av källan." När tjänsten rapporterar det här underliggande felet returneras ResourceNotFound det i ErrorCode-elementet><. Om inget <ErrorCode-element> visades i svaret visas en standardsträngrepresentation av HTTP-statusen, till exempel NotFound.
Tidsgränsen som begränsar alla kopieringsåtgärder som har förflutit. (Tidsgränsen är för närvarande två veckor.) Misslyckades 500 OperationCancelled "Kopian överskred den maximala tillåtna tiden."
Kopieringsåtgärden misslyckades för ofta vid läsning från källan och uppfyllde inte ett minsta förhållande mellan försök till lyckade försök. (Den här tidsgränsen förhindrar att en mycket dålig källa försöker igen under två veckor innan den misslyckas). Misslyckades 500 OperationCancelled "Kopian misslyckades när källan lästes".

Fakturering

Prisbegäranden kan komma från klienter som använder Blob Storage-API:er, antingen direkt via BLOB Storage REST API eller från ett Azure Storage-klientbibliotek. Dessa begäranden ackumulerar avgifter per transaktion. Typen av transaktion påverkar hur kontot debiteras. Lästransaktioner ackumuleras till exempel till en annan faktureringskategori än skrivtransaktioner. I följande tabell visas faktureringskategorin för List Blobs begäranden baserat på lagringskontotypen:

Verksamhet Typ av lagringskonto Faktureringskategori
Lista blobar Premium-blockblob
Standard generell användning v2
Standard generell användning v1		 Lista och skapa containeråtgärder

Mer information om priser för den angivna faktureringskategorin finns i Prissättning för Azure Blob Storage.

Se även

Status och felkoder
Blob Storage-felkoder