Lista blobar

  • Artikel

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

Förfrågan

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

Metod URI för förfrågan HTTP-version
GET https://myaccount.blob.core.windows.net/mycontainer?restype=container&comp=list HTTP/1.1

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 URI för förfrågan HTTP-version
GET http://127.0.0.1:10000/devstoreaccount1/mycontainer?restype=container&comp=list HTTP/1.1

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 Valfritt. 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 prefixsökvägen folder1/folder2/readme/readmefile.txt. Ett fel visas om någon undermapp innehåller en fil med namnet readme.
delimiter Valfritt. 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 delsträng, upp till avgränsartecknets utseende. Avgränsaren kan vara ett enskilt tecken eller en sträng.
marker Valfritt. 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 slutfördes. 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 täckande för klienten.
maxresults Valfritt. Anger det maximala antalet blobar som ska returneras, inklusive alla BlobPrefix element. Om begäran inte anger maxresultseller 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 ett värde som är mindre än eller lika med noll returneras felsvarskoden 400 (felaktig begäran).
include={snapshots,metadata,uncommittedblobs,copy,deleted,tags,versions,
deletedwithversions,immutabilitypolicy,legalhold,permissions}		 Valfritt. Anger en eller flera datauppsättningar som ska ingå i svaret:

- snapshots: Anger att ögonblicksbilder ska tas med 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 Placera blockeringslista, 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 taggar för blobindex ska inkluderas 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 inkluderas i svaret. Objekt som du har tagit bort permanent visas i svaret tills de bearbetas av skräpinsamlingen. Använd taggen \<HasVersionsOnly\>och värdet true.
-immutabilitypolicy: Version 2020-06-12 och senare. Anger att uppräkningen ska innehålla oföränderlighetsprincipen fram till datumet och blobarnas oföränderlighetsprincipläge.
-legalhold: Version 2020-06-12 och senare. Anger att uppräkningen ska innehålla det juridiska undantaget för 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} Valfritt. 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 hierarkisk namnrymd. När en begäran innehåller den här parametern innehåller listan endast mjukt borttagna blobar. Observera att POSIX ACL-auktoriseringsåterställning inte stöds för att lista mjukt 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 hierarkisk namnrymd. 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 hierarkisk namnrymd. När en begäran innehåller den här parametern innehåller listan endast kataloger.
timeout Valfritt. Parametern timeout uttrycks i sekunder. Mer information finns i Ställa in 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 Coordinated Universal Time (UTC) 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 Valfritt. Tillhandahåller ett klientgenererat, täckande värde med en teckengräns på 1 kibibyte (KiB) som registreras i loggarna när loggning har konfigurerats. 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 Valfritt. Gäller endast när ett hierarkiskt namnområde är aktiverat för kontot och include=permissions anges i begäran. Om trueomvandlas användaridentitetsvärdena 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

Inga.

Exempelbegäran

En exempelbegäran finns i Räkna upp blobresurser .

Svarsåtgärder

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 även innehålla ytterligare STANDARD HTTP-huvuden. Alla standardhuvuden överensstämmer med http/1.1-protokollspecifikationen.

Svarsrubrik Description
Content-Type Anger i vilket format resultaten returneras. För närvarande är application/xmldet här värdet .
x-ms-request-id Det här huvudet identifierar unikt den begäran som har gjorts och kan användas för att felsöka begäran. Mer information finns i Felsöka 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 datum-/tidsvärde för UTC som anger den tid då svaret initierades. Tjänsten genererar det här värdet.
x-ms-client-request-id Du kan använda det här huvudet 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 rubriken x-ms-client-request-id inte finns i begäran kommer det här huvudet inte att finnas i svaret.

Själva svaret

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

Observera att elementen Prefix, Marker, MaxResultsoch Delimiter endast finns om de har angetts på begärande-URI:n. Elementet NextMarker har bara ett värde om listresultatet inte är slutfört.

Ögonblicksbilder, blobmetadata och ogenomförda blobar ingår bara i svaret om de anges med parametern include 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 blobar 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 Placera blob. Blob Storage beräknar inte detta när du skapar en blob med hjälp av Placera blockeringslista. Du kan uttryckligen Content-MD5 ange värdet när du skapar bloben eller genom att anropa åtgärderna Put Block List (Placera blockeringslista) eller Set Blob Properties (Ange blobegenskaper).

För versioner från 2009-09-19 och senare, men före version 2015-02-21, kan du inte anropa List Blobs på 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 bara i version 2012-02-12 och senare, när den här åtgärden innehåller parametern include={copy} . De här elementen 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 bloben har ändrats efter en avslutad Copy Blob åtgärd med hjälp Set Blob Propertiesav , Put Blobeller Put Block List. Dessa element 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 EnumerationResults ett ServiceEndpoint attribut som anger blobslutpunkten. Det här elementet innehåller också ett ContainerName fält som anger namnet på containern. I tidigare versioner kombinerades dessa två attribut tillsammans i fältet ContainerName . Ä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 returnerar blobar av alla typer (block-, sid- och tilläggsblobar).

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

För version 2016-05-31 och senare List Blobs returnerar 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 returnerar elementet AccessTier om en åtkomstnivå uttryckligen har angetts. En lista över tillåtna premium-sidblobnivåer finns i Högpresterande premiumlagring och hanterade diskar för virtuella datorer. För Blob Storage- eller general-purpose v2-konton är Hotgiltiga värden , Cooloch Archive. Om bloben är i tillståndet rehydrate pending (extrahera väntande) ArchiveStatus returneras elementet med något 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 returnerar elementet AccessTierInferred på Blob Storage- eller general-purpose v2-konton. Om blockbloben inte har åtkomstnivån inställd härleds nivåinformation från lagringskontoegenskaper 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 returnerar elementet AccessTierChangeTime på Blob Storage- eller general-purpose v2-konton. Detta returneras endast om nivån på blockbloben någonsin har angetts. Mer information finns i Representation of date-time values in headers (Representation av datum/tid-värden i rubriker).

För version 2017-07-29 och senare Deletedvisas , DeletedTimeoch RemainingRetentionDays när den här åtgärden innehåller parametern include={deleted} . De här elementen visas inte om den här bloben inte har tagits bort. De här elementen 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 tiden då bloben togs bort. RemainingRetentionDays anger efter hur många dagar en mjukt borttagen blob tas bort permanent.

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

För version 2019-02-02 och senare List Blobs returnerar 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. Om åtgärden innehåller parametern include={metadata} och det finns programmetadata på en blob som krypterats med en nyckel som tillhandahålls av kunden, har elementet Metadata dessutom 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 Hämta blobegenskaper eller Hämta blobmetadata med den nyckel som kunden tillhandahåller.

För version 2019-02-02 och senare List Blobs returnerar elementet EncryptionScope om bloben är krypterad 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 parametern include={metadata} dekrypteras programmetadata på bloben transparent och är tillgängliga i -elementet Metadata .

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

För version 2019-12-12 och senare List Blobs returnerar 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 returnerar elementet TagCount för blobar med eventuella taggar. Elementet Tags visas bara när den här åtgärden innehåller parametern include={tags} . De här elementen 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 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 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 returnerar 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 returnerar elementet LegalHold när den här åtgärden innehåller parametern include={legalhold} .

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

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

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

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

För version 2021-02-12 och senare List Blobs kodas alla BlobName värden eller BlobPrefixName element i procent (per RFC 2396). Mer specifikt kommer den 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 tecknen som är ogiltiga i XML, inte de återstående Name elementen i svaret.

För version 2021-06-08 och senare returneras egenskapselementet Placeholder för konton med ett hierarkiskt namnområde aktiveratList Blobs. Det returnerar det här elementet i -elementet BlobPrefix för platshållarkataloger när borttagna blobar visas 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 returnerar elementet EncryptionContext för konton med ett hierarkiskt namnområde aktiveratList Blobs. Om värdet för krypteringskontextegenskapen anges returneras det angivna värdet.

För version 2020-02-10 och senare returnerar för konton med ett hierarkiskt namnområde aktiverat List Blobs 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örfallodatum har angetts på samma sätt.

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

Auktorisering

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

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, programtjänstens huvudnamn 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 eller tjänstens huvudnamn ska kunna anropa List Blobs åtgärden och den minst privilegierade inbyggda Azure RBAC-rollen som innehåller den här åtgärden:

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

Kommentarer

Blobegenskaper i svaret

Om du har begärt att ogenomförda blobar ska inkluderas i uppräkningen bör du observera att vissa egenskaper inte anges förrän bloben 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 värdet som returneras i elementet Content-Length värdet för blobens x-ms-blob-content-length sidhuvud.

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

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

Lagringstjänsten upprätthåller stark konsekvens mellan en blob och dess taggar, men det sekundära indexet blir så småningom konsekvent. Taggar kan visas 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 parametern include=snapshots har angetts på URI:n. Ögonblicksbilder som anges i svaret innehåller inte elementet LeaseStatus eftersom ögonblicksbilder inte kan ha aktiva lån.

Med tjänstversion 2021-06-08 och senare kan du anropa List Blobs med en avgränsare och ta med ö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).

Ogenomförda blobar i svaret

Ogenomförda blobar visas bara i svaret om parametern include=uncommittedblobs har angetts på URI:n. Ogenomförda blobar 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 parametern include=deleted 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 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 List Blobs gjordes med hjälp av version 2019-12-12 eller senare. I -elementet OrMetadata visas värdet för varje namn/värde-par i ett element som motsvarar parets namn. Namnets format är or-{policy-id}_{rule-id}, där {policy-id} är ett GUID som representerar objektreplikeringsprincipens ID för 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 include=immutabilitypolicy har angetts på URI:n.

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

Elementet LegalHold finns bara om parametern include=legalhold 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 parametern maxresults 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 maxresultsför .

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 NextMarker för ska behandlas som ogenomskinlig.

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 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 BlobPrefix returneras i stället för alla blobar med namn som börjar med samma delsträng, upp till avgränsartecknets utseende. Värdet för elementet BlobPrefix är substring+delimiter, där delsträngen är den gemensamma delsträngen som börjar ett eller flera blobnamn, och avgränsare är värdet för parametern delimiter .

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 prefix på begärande-URI:n.

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 Beskrivning av kopieringsstatus

CopyStatusDescription innehåller mer information om felet Copy Blob .

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

  • När CopyStatus är inställt på failedbeskriver CopyStatusDescription texten det fel som gjorde att kopieringsåtgärden 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, med citattecken.

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

Viktigt

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

Scenario Kopiera statusvärde Kopiera statusbeskrivningsvärde
Kopieringsåtgärden har slutförts. lyckades tomt
Användaren avbröt kopieringsåtgärden innan den slutfördes. Avbröts tomt
Ett fel uppstod vid läsning från källbloben under en kopieringsåtgärd. Det görs ett nytt försök att utföra åtgärden. Väntar 502 BadGateway "Påträffade ett återförsöksbart fel när källan lästes. Försöker igen. Feltid: <tid>"
Ett fel uppstod vid skrivning till målbloben för en kopieringsåtgärd. Det görs ett nytt försök att utföra åtgärden. Väntar 500 InternalServerError "Påträffade ett återförsöksbart fel. Försöker igen. Feltid: <tid>"
Ett oåterkalleligt fel uppstod vid läsning från källbloben för en kopieringsåtgärd. misslyckades 404 ResourceNotFound "Kopiering misslyckades när källan lästes". När tjänsten rapporterar det här underliggande felet returneras ResourceNotFound det <i ErrorCode-elementet> . Om inget <ErrorCode-element> visas 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 det minsta förhållandet mellan försök och 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 REST-API:et för Blob Storage eller från ett Azure Storage-klientbibliotek. Dessa begäranden ackumulerar avgifter per transaktion. Typen av transaktion påverkar hur kontot debiteras. Lästransaktioner till exempel tillfaller en annan faktureringskategori än skrivtransaktioner. I följande tabell visas faktureringskategorin för List Blobs begäranden baserat på lagringskontotypen:

Åtgärd 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 Azure Blob Storage Prissättning.

Se även

Status- och felkoder
Felkoder för Blob Storage