Sdílet prostřednictvím

Výpis objektů blob

Operace List Blobs vrátí seznam objektů blob v zadaném kontejneru.

Prosba

Požadavek List Blobs můžete vytvořit následujícím způsobem. Doporučuje se HTTPS. Nahraďte myaccount názvem vašeho účtu úložiště.

Metoda Identifikátor URI požadavku Verze HTTP
GET https://myaccount.blob.core.windows.net/mycontainer?restype=container&comp=list Protokol HTTP/1.1

Identifikátor URI emulované služby úložiště

Když vytvoříte požadavek na emulovanou službu úložiště, zadejte název hostitele emulátoru a port Azure Blob Storage jako 127.0.0.1:10000, následovaný názvem emulovaného účtu úložiště.

Metoda Identifikátor URI požadavku Verze HTTP
GET http://127.0.0.1:10000/devstoreaccount1/mycontainer?restype=container&comp=list Protokol HTTP/1.1

Další informace najdete v tématu Použití emulátoru Azurite pro místní vývoj Azure Storage.

Parametry identifikátoru URI

Pro identifikátor URI můžete zadat následující další parametry.

Parametr Popis
prefix Volitelný. Filtruje výsledky tak, aby vracely pouze objekty blob s názvy, které začínají zadanou předponou. V účtech, které mají hierarchický obor názvů, dojde k chybě v případech, kdy se název souboru zobrazí uprostřed cesty předpony. Můžete se například pokusit najít objekty blob, které jsou pojmenovány readmefile.txt pomocí cesty folder1/folder2/readme/readmefile.txtpředpony . Pokud některá podsložka obsahuje soubor s názvem readme.
delimiter Volitelný. Pokud požadavek obsahuje tento parametr, operace vrátí BlobPrefix prvek v těle odpovědi. Tento prvek funguje jako zástupný symbol pro všechny objekty blob s názvy, které začínají stejným podřetězencem až do vzhledu znaku oddělovače. Oddělovač může být jeden znak nebo řetězec.
marker Volitelný. Řetězcová hodnota, která identifikuje část seznamu, která se má vrátit pomocí další operace seznamu. Operace vrátí hodnotu značky v textu odpovědi, pokud vrácený seznam nebyl dokončen. Hodnotu značky pak můžete použít v následném volání a požádat o další sadu položek seznamu.

Hodnota značky je pro klienta neprůhelní.
maxresults Volitelný. Určuje maximální počet objektů blob, které se mají vrátit, včetně všech BlobPrefix prvků. Pokud požadavek nezadá maxresultsnebo zadá hodnotu větší než 5 000, server vrátí až 5 000 položek. Pokud jsou k dispozici další výsledky, které je třeba vrátit, služba vrátí token pro pokračování v elementu NextMarker response. V některých případech může služba vrátit méně výsledků, než je určeno parametrem maxresults, a také vrátit token pro pokračování.

Nastavení maxresults na hodnotu menší nebo rovno nule způsobí chybu s kódem odpovědi 400 (Chybný požadavek).
include={snapshots,metadata,uncommittedblobs,copy,deleted,tags,versions,
deletedwithversions,immutabilitypolicy,legalhold,permissions}		 Volitelný. Určuje jednu nebo více datových sad, které se mají zahrnout do odpovědi:

- snapshots: Určuje, že snímky mají být zahrnuty do výčtu. Snímky jsou uvedené od nejstarších po nejnovější v odpovědi.
- metadata: Určuje, že v odpovědi budou vrácena metadata objektů blob.
- uncommittedblobs: Určuje, že do odpovědi budou zahrnuty objekty blob, pro které byly nahrány bloky, ale které nebyly potvrzeny pomocí příkazu Vložit seznam bloků.
- copy: Verze 2012-02-12 a novější. Určuje, že do odpovědi mají být zahrnuta metadata související s jakoukoli aktuální nebo předchozí Copy Blob operací.
- deleted: Verze 2017-07-29 a novější. Určuje, že do odpovědi by se měly zahrnout obnovitelné odstraněné objekty blob.
- tags: Verze 2019-12-12 a novější. Určuje, že uživatelsky definované značky indexu objektů blob by měly být zahrnuty do odpovědi.
- versions: Verze 2019-12-12 a novější. Určuje, že verze objektů blob by měly být zahrnuty do výčtu.
- deletedwithversions: Verze 2020-10-02 a novější. Určuje, že odstraněné objekty blob s libovolnými verzemi (aktivními nebo odstraněnými) by se měly zahrnout do odpovědi. Položky, které jste trvale odstranili, se zobrazí v odpovědi, dokud se nezpracují uvolňováním paměti. Použijte tag \<HasVersionsOnly\>a hodnotu true.
- immutabilitypolicy: Verze 2020-06-12 a novější. Určuje, že výčet by měl zahrnovat zásadu neměnnosti do data a režim zásad neměnnosti objektů blob.
- legalhold: Verze 2020-06-12 a novější. Určuje, že výčet by měl zahrnovat blokování objektů blob z právních důvodů.
- permissions: Verze 2020-06-12 a novější. Podporuje se jenom pro účty s povoleným hierarchickým oborem názvů. Pokud požadavek obsahuje tento parametr, zahrne se do výčtu seznam vlastníka, skupiny, oprávnění a seznamu řízení přístupu pro uvedené objekty blob nebo adresáře.

Chcete-li v identifikátoru URI zadat více než jednu z těchto možností, musíte každou možnost oddělit čárkou zakódovanou v adrese URL ("%82").
showonly={deleted,files,directories} Volitelný. Určuje jednu z těchto datových sad, která se má vrátit v odpovědi:

- deleted:Volitelný. Verze 2020-08-04 a novější. Pouze pro účty povolené s hierarchickým oborem názvů. Pokud požadavek obsahuje tento parametr, seznam obsahuje pouze obnovitelné odstraněné objekty blob. Všimněte si, že pro výpis obnovitelně odstraněných objektů blob se nepodporuje záložní autorizace seznamu ACL pro POSIX. Pokud include=deleted je také zadáno, požadavek selže s chybným požadavkem (400).
- files:Volitelný. Verze 2020-12-06 a novější. Pouze pro účty povolené s hierarchickým oborem názvů. Pokud požadavek obsahuje tento parametr, seznam obsahuje pouze soubory.
- directories:Volitelný. Verze 2020-12-06 a novější. Pouze pro účty povolené s hierarchickým oborem názvů. Pokud požadavek obsahuje tento parametr, seznam obsahuje pouze adresáře.
timeout Volitelný. Parametr timeout se vyjadřuje v sekundách. Další informace najdete v tématu Nastavení časových limitů pro operace služby Blob Storage.

Hlavičky požadavku

Následující tabulka popisuje povinné a volitelné hlavičky požadavků.

Hlavička požadavku Popis
Authorization Požadovaný. Určuje schéma autorizace, název účtu a podpis. Další informace najdete v tématu Autorizace požadavků na službu Azure Storage.
Date nebo x-ms-date Požadovaný. Určuje standard UTC (Coordinated Universal Time) pro požadavek. Další informace najdete v tématu Autorizace požadavků na službu Azure Storage.
x-ms-version Požadováno pro všechny autorizované žádosti a volitelné pro anonymní žádosti. Určuje verzi operace, která se má pro tento požadavek použít. Další informace najdete v tématu Správa verzí pro služby Azure Storage.
x-ms-client-request-id Volitelný. Poskytuje hodnotu vygenerovanou klientem, neprůshlenou hodnotou s limitem znaků 1 kibibajtů (KiB), který je zaznamenán v protokolech při konfiguraci protokolování. Důrazně doporučujeme použít tuto hlavičku ke korelaci aktivit na straně klienta s požadavky, které server přijímá. Další informace najdete v tématu Monitorování služby Azure Blob Storage.
x-ms-upn Volitelný. Platí pouze v případě, že je pro účet povolen hierarchický obor názvů a include=permissions je uveden v žádosti. Pokud true, hodnoty identity uživatele vrácené v polích <Vlastník>, <Skupina> a <Acl> se transformují z ID objektů Microsoft Entra na hlavní názvy uživatelů. Pokud false, hodnoty jsou vráceny jako ID objektů Microsoft Entra. Výchozí hodnota je false. Všimněte si, že ID objektů skupin a aplikací se nepřekládají, protože nemají jedinečné popisné názvy.

Text požadavku

Žádný.

Ukázkový požadavek

Viz Výčet prostředků objektů blob pro ukázkový požadavek.

Odpověď

Odpověď obsahuje stavový kód HTTP, sadu hlaviček odpovědí a text odpovědi ve formátu XML.

Stavový kód

Úspěšná operace vrátí stavový kód 200 (OK). Informace o stavových kódech naleznete v tématu Stav a kódy chyb.

Hlavičky odpovědi

Odpověď pro tuto operaci obsahuje následující hlavičky. Odpověď může obsahovat také další standardní hlavičky HTTP. Všechny standardní hlavičky odpovídají specifikaci protokolu HTTP/1.1.

Hlavička odpovědi Popis
Content-Type Určuje formát, ve kterém se vrátí výsledky. V současné době je tato hodnota application/xml.
x-ms-request-id Tato hlavička jednoznačně identifikuje požadavek, který byl proveden, a lze ho použít k řešení potíží s požadavkem. Další informace najdete v tématu řešení potíží s operacemi rozhraní API.
x-ms-version Označuje verzi služby Blob Storage použitou ke spuštění požadavku. Tato hlavička se vrátí pro požadavky provedené pomocí verze 2009-09-19 a novější.

Tato hlavička se také vrátí pro anonymní požadavky bez zadané verze, pokud byl kontejner označen pro veřejný přístup pomocí verze 2009-09-19 Blob Storage.
Date Hodnota data a času UTC, která označuje čas, kdy byla odpověď zahájena. Služba vygeneruje tuto hodnotu.
x-ms-client-request-id Tato hlavička slouží k řešení potíží s požadavky a odpovídajícími odpověďmi. Hodnota této hlavičky se rovná hodnotě hlavičky x-ms-client-request-id, pokud se nachází v požadavku. Hodnota je maximálně 1024 viditelných znaků ASCII. Pokud v požadavku není hlavička x-ms-client-request-id, nebude tato hlavička v odpovědi k dispozici.

Text odpovědi

Formát odpovědi XML je následující.

Všimněte si, že Prefixprvky , Marker, MaxResults, a Delimiter jsou k dispozici pouze v případě, že byly zadány v identifikátoru URI požadavku. Pokud NextMarker je prázdné, pak jsou výsledky seznamu úplné. Pokud není NextMarker prázdné, výsledky seznamu mohou nebo nemusí být úplné. Pokud chcete vypsat všechny objekty blob, pokračujte ve volání List Blobs s následnými hodnotami značek, dokud NextMarker nebude prázdná.

Snímky, metadata objektů blob a nepotvrzené objekty blob jsou do odpovědi zahrnuty pouze v případě, že jsou zadány pomocí parametru include v identifikátoru URI požadavku.

Ve verzi 2009-09-19 a novější jsou vlastnosti objektu blob zapouzdřeny v Properties prvku.

Počínaje verzí 2009-09-19 List Blobs vrátí v těle odpovědi následující přejmenované prvky:

  • Last-Modified (dříve LastModified)

  • Content-Length (dříve Size)

  • Content-Type (dříve ContentType)

  • Content-Encoding (dříve ContentEncoding)

  • Content-Language (dříve ContentLanguage)

Element Content-MD5 se zobrazí u objektů blob vytvořených ve verzi 2009-09-19 a novější. Ve verzi 2012-02-12 a novější vypočítá služba Blob Storage hodnotu Content-MD5 při nahrání objektu blob pomocí příkazu Put Blob. Služba Blob Storage to nevypočítá při vytváření objektu blob pomocí funkce Odeslat seznam blokovaných. Hodnotu můžete explicitně Content-MD5 nastavit při vytváření objektu blob nebo voláním operací Vložit seznam blokovaných položek nebo Nastavit vlastnosti objektu blob .

U verzí od 2009-09-19 a novějších, ale před verzí 2015-02-21, nemůžete volat List Blobs kontejner, který obsahuje doplňovací objekty blob. Služba vrátí stavový kód 409 (Konflikt), pokud výsledek výpisu obsahuje doplňovací objekt blob.

LeaseState a LeaseDuration objeví se pouze ve verzi 2012-02-12 a novější.

CopyId, CopyStatus, CopySource, CopyProgress, , CopyCompletionTimea CopyStatusDescription zobrazí se pouze ve verzi 2012-02-12 a novější, pokud tato operace obsahuje parametr.include={copy} Tyto prvky se nezobrazí, pokud tento objekt blob nikdy nebyl cílem Copy Blob operace. Prvky se nezobrazí, pokud byl tento objekt blob změněn po ukončené Copy Blob operaci pomocí Set Blob Properties, Put Blobnebo Put Block List. Tyto prvky se také nezobrazují u objektu blob vytvořeného nástrojem Copy Blob před verzí 2012-02-12.

Ve verzi 2013-08-15 a novější element obsahuje atribut, EnumerationResultsServiceEndpoint který určuje koncový bod objektu blob. Tento prvek obsahuje ContainerName také pole, které určuje název kontejneru. V předchozích verzích byly tyto dva atributy ContainerName v poli kombinovány dohromady. Také ve verzi 2013-08-15 a novějších Url byl odstraněn prvek under Blob .

Pro verzi 2015-02-21 a novější List Blobs vrátí objekty blob všech typů (blokové, stránkové a doplňovací objekty blob).

Pro verzi 2015-12-11 a novější vrátí ServerEncrypted element. List Blobs Tento prvek je nastaven na hodnotu v true případě, že jsou metadata objektů blob a aplikace zcela zašifrována, a false v opačném případě.

Pro verzi 2016-05-31 a novější List Blobs vrátí IncrementalCopy element pro přírůstkové kopírování objektů blob a snímků s hodnotou nastavenou na true.

Pro verzi 2017-04-17 a novější vrátí AccessTier element, List Blobs pokud byla explicitně nastavena úroveň přístupu. Seznam povolených úrovní objektů blob stránky úrovně Premium najdete v tématu Vysoce výkonné služby Premium Storage a spravované disky pro virtuální počítače. Pro účty Blob Storage nebo účty pro obecné účely v2 jsou Hotplatné hodnoty , Coola Archive. Pokud je objekt blob ve stavu čekání na dosazování, ArchiveStatus je prvek vrácen s jednou z platných hodnot (rehydrate-pending-to-hot, rehydrate-pending-to-cool, nebo rehydrate-pending-to-cold). Podrobné informace o vrstvení objektů blob bloku najdete v tématu Horká, studená a archivní úroveň úložiště.

Pro verzi 2017-04-17 a novější List Blobs vrátí AccessTierInferred element v účtech Blob Storage nebo účtech pro obecné účely v2. Pokud objekt blob bloku nemá nastavenou úroveň přístupu, informace o vrstvě se odvozují z vlastností účtu úložiště a tato hodnota je nastavená na true. Tato hlavička se nachází pouze v případě, že je úroveň odvozena z vlastnosti účtu.

Pro verzi 2017-04-17 a novější List Blobs vrátí AccessTierChangeTime element v účtech Blob Storage nebo účtech pro obecné účely v2. Tato hodnota se vrátí jenom v případě, že byla někdy nastavena úroveň objektu blob bloku. Další informace naleznete v tématu Reprezentace hodnot data a času v záhlavích.

Pro verzi 2017-07-29 a novější , a RemainingRetentionDays zobrazí se, DeletedDeletedTimepokud tato operace obsahuje parametr.include={deleted} Tyto prvky se nezobrazují, pokud tento objekt blob nebyl odstraněn. Tyto prvky se zobrazí u objektů blob nebo snímků, které jsou odstraněny během DELETE operace, když byla povolena funkce obnovitelného odstranění. Element Deleted je nastavený na true hodnotu pro objekty blob a snímky, které jsou obnovitelně odstraněny. Deleted-Time Odpovídá času, kdy byl objekt blob odstraněn. RemainingRetentionDays Označuje počet dní, po jejichž uplynutí se obnovitelně odstraněný objekt blob trvale odstraní.

Pro verzi 2017-11-09 a novější vrátí čas, Creation-Time kdy byl tento objekt blob vytvořen.

Pro verzi 2019-02-02 a novější vrátí CustomerProvidedKeySha256 element, List Blobs pokud je objekt blob zašifrovaný pomocí klíče poskytnutého zákazníkem. Hodnota se nastaví na hodnotu hash SHA-256 klíče použitého k šifrování objektu blob. Pokud navíc operace obsahuje include={metadata} parametr a v objektu blob zašifrovaném pomocí klíče poskytnutého zákazníkem jsou přítomna metadata aplikace, Metadata bude mít prvek atribut.Encrypted="true" Tento atribut označuje, že objekt blob obsahuje metadata, která nelze v rámci List Blobs operace dešifrovat. Pokud chcete získat přístup k metadatům pro tyto objekty blob, zavolejte Get Blob Properties nebo Get Blob Metadata pomocí klíče poskytnutého zákazníkem.

Pro verzi 2019-02-02 a novější vrátí EncryptionScope element, List Blobs pokud je objekt blob zašifrovaný pomocí oboru šifrování. Hodnota se nastaví na název oboru šifrování použitého k šifrování objektu blob. Pokud operace obsahuje parametr, include={metadata} metadata aplikace v objektu blob jsou transparentně dešifrována a jsou k dispozici v elementu Metadata .

Pro verzi 2019-12-12 a novější List Blobs vrátí RehydratePriority element v účtech Blob Storage nebo účtech pro obecné účely v2, pokud je objekt ve rehydrate pending stavu. Platné hodnoty jsou High a Standard.

Pro verzi 2019-12-12 a novější List Blobs vrátí VersionId element pro objekty blob a vygenerované verze objektů blob, pokud je v účtu povolená správa verzí.

Pro verzi 2019-12-12 a novější List Blobs vrátí IsCurrentVersion element pro aktuální verzi objektu blob. Hodnota je nastavena na true. Tento prvek umožňuje odlišit aktuální verzi od automaticky generovaných verzí jen pro čtení.

Pro verzi 2019-12-12 a novější List Blobs vrátí TagCount element pro objekty blob s libovolnými značkami. Element Tags se zobrazí pouze v případě, že tato operace obsahuje parametr.include={tags} Tyto prvky se nezobrazují, pokud objekt blob neobsahuje žádné značky.

Pro verzi 2019-12-12 a novější List Blobs vrátí Sealed element pro doplňovací objekty blob. Element Sealed se zobrazí pouze v případě, že byl doplňovací objekt blob zapečetěn. Tyto prvky se nezobrazí, pokud objekt blob připojení není zapečetěný.

Pro verzi 2020-02-10 a novější vrátí LastAccessTime element. List Blobs Element ukazuje, kdy byla data objektu blob naposledy přístupná, podle zásad sledování času posledního přístupu účtu úložiště. Prvek se nevrátí, pokud účet úložiště tuto zásadu nemá nebo je zásada zakázaná. Informace o nastavení zásad sledování času posledního přístupu k účtu najdete v rozhraní API služby Blob Service. Prvek LastAccessTime nesleduje, kdy se naposledy přistupovalo k metadatům objektu blob.

Pro verzi 2020-06-12 a novější List Blobs vrátí ImmutabilityPolicyUntilDate prvky aImmutabilityPolicyMode, pokud tato operace obsahuje parametr.include={immutabilitypolicy}

Pro verzi 2020-06-12 a novější vrátí LegalHold element, List Blobs pokud tato operace obsahuje include={legalhold} parametr.

Pro verzi 2020-06-12 a novější vrátí Ownerpro účty s povoleným List Blobs hierarchickým oborem názvů prvky , Group, Permissions, a Acl . Požadavek musí obsahovat parametr.include={permissions} Všimněte si, že tento Acl prvek je kombinovaný seznam seznamů řízení přístupu a výchozích seznamů řízení přístupu, které byly nastaveny v souboru nebo adresáři.

Pro verzi 2020-06-12 a novější platí, že u účtů s povoleným List Blobs hierarchickým oborem názvů vrátí Properties oddělovač element v elementu BlobPrefix . To odpovídá vlastnostem v adresáři.

Pro verzi 2020-08-04 a novější vrátí DeletionId u účtů s povoleným List Blobs hierarchickým oborem názvů element pro odstraněné objekty blob. DeletionId je 64bitový identifikátor bez znaménka. Prvek jednoznačně identifikuje obnovitelně odstraněnou cestu, aby ji odlišil od ostatních odstraněných objektů blob se stejnou cestou.

Pro verzi 2020-10-02 a novější vrátí ResourceType u účtů s povoleným List Blobs hierarchickým oborem názvů element vlastnosti pro cestu. To může být buď file nebo directory.

Pro verzi 2021-02-12 a novější List Blobs bude procentuálně kódovat (podle RFC 2396) všechny BlobName hodnoty nebo BlobPrefixName hodnoty elementů. Konkrétně se to provede u hodnot obsahujících znaky, které nejsou platné ve formátu XML (U+FFFE nebo U+FFFF). Pokud je kódován, element Name bude obsahovat atribut Encoded=true. Všimněte si, že k tomu dochází pouze u hodnot elementů Name obsahujících znaky neplatné v XML, nikoli u zbývajících Name elementů v odpovědi.

Pro verzi 2021-06-08 a novější vrátí Placeholder u účtů s povoleným List Blobs hierarchickým oborem názvů element properties. Vrátí tento prvek v elementu BlobPrefix pro zástupné adresáře při výpisu odstraněných objektů blob s oddělovačem. Tyto zástupné adresáře existují, aby se usnadnila navigace na obnovitelné odstraněné objekty blob.

Pro verzi 2021-06-08 a novější vrátí pro účty s povoleným List Blobs hierarchickým oborem názvů element.EncryptionContext Pokud je nastavena hodnota vlastnosti kontextu šifrování, vrátí nastavenou hodnotu.

Pro verzi 2020-02-10 a novější vrátí Expiry-Time pro účty s povoleným List Blobs hierarchickým oborem názvů element pro odstraněné objekty blob. Expiry-Time je čas, kdy vyprší platnost souboru, a je vrácen pro soubor, pokud je vypršení platnosti nastaveno na stejnou hodnotu.

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

Ukázková odpověď

Viz Výčet prostředků objektů blob pro ukázkovou odpověď.

Oprávnění

Autorizace se vyžaduje při volání jakékoli operace přístupu k datům ve službě Azure Storage. Operaci List Blobs můžete autorizovat, jak je popsáno níže.

Důležitý

Microsoft doporučuje používat Microsoft Entra ID se spravovanými identitami k autorizaci požadavků do služby Azure Storage. Microsoft Entra ID poskytuje vynikající zabezpečení a snadné použití v porovnání s autorizací sdíleného klíče.

Azure Storage podporuje použití Microsoft Entra ID k autorizaci požadavků na data objektů blob. S ID Microsoft Entra můžete pomocí řízení přístupu na základě role v Azure (Azure RBAC) udělit oprávnění k objektu zabezpečení. Objekt zabezpečení může být uživatel, skupina, instanční objekt aplikace nebo spravovaná identita Azure. Instanční objekt zabezpečení je ověřený pomocí ID Microsoft Entra pro vrácení tokenu OAuth 2.0. Token se pak dá použít k autorizaci požadavku ve službě Blob Service.

Další informace o autorizaci pomocí ID Microsoft Entra najdete v tématu Autorizace přístupu k objektům blob pomocíMicrosoft Entra ID .

Dovolení

Níže je uvedena akce RBAC potřebná pro uživatele, skupinu, spravovanou identitu nebo instanční objekt Microsoftu pro volání operace List Blobs a nejméně privilegované předdefinované role Azure RBAC, která zahrnuje tuto akci:

Pokud zadáte:include=tags

Další informace o přiřazování rolí pomocí Azure RBAC najdete v tématu Přiřazení role Azure pro přístup k datům objektů blob.

Poznámky

Vlastnosti objektu blob v odpovědi

Pokud jste požádali o zahrnutí nepotvrzených objektů blob do výčtu, mějte na paměti, že některé vlastnosti nejsou nastavené, dokud nebude objekt blob potvrzen. Některé vlastnosti nemusí být v odpovědi vráceny.

Element x-ms-blob-sequence-number je vrácen pouze pro objekty blob stránky.

Element OrMetadata je vrácen pouze pro objekty blob bloku.

U objektů blob stránky odpovídá hodnota vrácená v elementu Content-Length hodnotě hlavičky x-ms-blob-content-length objektu blob.

Element Content-MD5 se zobrazí v textu odpovědi pouze v případě, že byl nastaven na objekt blob pomocí verze 2009-09-19 nebo novější. Vlastnost můžete nastavit Content-MD5 při vytvoření objektu blob nebo voláním příkazu Set Blob Properties. Ve verzi 2012-02-12 a novější Put Blob nastaví hodnotu MD5 objektu blob bloku, a to i v případě, že Put Blob požadavek neobsahuje hlavičku MD5.

Metadata v odpovědi

Prvek Metadata je k dispozici pouze v případě, že include=metadata byl parametr zadán v identifikátoru URI. V rámci elementu Metadata je hodnota každého páru název-hodnota uvedena v elementu odpovídajícím názvu páru.

Všimněte si, že metadata požadovaná tímto parametrem musí být uložena v souladu s omezeními pojmenování, která jsou stanovena verzí služby Blob Storage z 9. 9. 2009. Počínaje touto verzí musí všechny názvy metadat dodržovat zásady vytváření názvů pro identifikátory jazyka C#.

Pokud dvojice název-hodnota metadat porušuje tato omezení pojmenování, tělo odpovědi označuje problematický název v x-ms-invalid-name prvku. Následující fragment XML ukazuje toto:

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

Značky v odpovědi

Prvek Tags je k dispozici pouze v případě, že include=tags byl parametr zadán v identifikátoru URI a pokud objekt blob obsahuje značky. V rámci elementu TagSet je vráceno až 10 Tag elementů, z nichž každý obsahuje keyvalue a uživatelem definované značky blob index. Pořadí značek není v odpovědi zaručené.

Elementy Tags a TagCount se nevrátí, pokud objekt blob neobsahuje žádné značky.

Služba úložiště udržuje silnou konzistenci mezi objektem blob a jeho značkami, ale sekundární index je nakonec konzistentní. Značky mohou být viditelné v reakci na List Blobs předtím, než budou viditelné pro Find Blobs by Tags operace.

Snímky v odpovědi

Snímky jsou v odpovědi uvedeny pouze v případě, že include=snapshots byl parametr zadán v identifikátoru URI. Snímky uvedené v odpovědi tento LeaseStatus prvek neobsahují, protože snímky nemohou mít aktivní zapůjčení.

Pomocí služby verze 2021-06-08 a novější můžete volat List Blobs s oddělovačem a zahrnout snímky do výčtu. U verzí služby starších než 2021-06-08 požadavek, který zahrnuje obě verze, vrátí chybu InvalidQueryParameter (stavový kód HTTP 400 – chybný požadavek).

Nepotvrzené objekty blob v odpovědi

Nepotvrzené objekty blob jsou v odpovědi uvedeny pouze v případě, include=uncommittedblobs že byl parametr zadán v identifikátoru URI. Nepotvrzené objekty blob uvedené v odpovědi neobsahují žádný z následujících prvků:

  • Last-Modified

  • Etag

  • Content-Type

  • Content-Encoding

  • Content-Language

  • Content-MD5

  • Cache-Control

  • Metadata

Odstraněné objekty blob v odpovědi

Odstraněné objekty blob jsou uvedeny v odpovědi pouze v případě, že include=deleted byl parametr zadán v identifikátoru URI. Odstraněné objekty blob uvedené v odpovědi neobsahují prvky Lease , protože odstraněné objekty blob nemohou mít aktivní zapůjčení.

Odstraněné snímky jsou zahrnuty do odpovědi seznamu, pokud include=deleted,snapshot bylo v identifikátoru URI uvedeno.

Metadata replikace objektů v odpovědi

Prvek OrMetadata je k dispozici, když byly zásady replikace objektů vyhodnoceny u objektu blob a List Blobs volání bylo provedeno pomocí verze 2019-12-12 nebo novější. V rámci elementu OrMetadata je hodnota každého páru název-hodnota uvedena v elementu odpovídajícím názvu páru. Formát názvu je or-{policy-id}_{rule-id}, kde {policy-id} je identifikátor GUID představující identifikátor zásad replikace objektů v účtu úložiště. {rule-id} je identifikátor GUID, který představuje identifikátor pravidla v kontejneru úložiště. Platné hodnoty jsou complete nebo 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>  
…

Zásady neměnnosti v odpovědi

Elementy and ImmutabilityPolicyMode jsou k dispozici pouze v případě, ImmutabilityPolicyUntilDate že include=immutabilitypolicy byl parametr zadán v identifikátoru URI.

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

Prvek LegalHold je k dispozici pouze v případě, že include=legalhold byl parametr zadán v identifikátoru URI.

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

Vrácení sad výsledků pomocí hodnoty značky

Pokud zadáte hodnotu parametru maxresults a počet vrácených objektů blob překročí tuto hodnotu nebo překročí výchozí hodnotu pro maxresults, bude text odpovědi obsahovat element.NextMarker Tento prvek označuje další objekt blob, který se má vrátit k následnému požadavku. V některých případech může služba vrátit NextMarker prvek, i když je počet vrácených výsledků menší než hodnota .maxresults

Chcete-li vrátit další sadu položek, zadejte hodnotu NextMarker jako parametr marker v identifikátoru URI pro následující požadavek. Všimněte si, že hodnota by NextMarker měla být považována za neprůhlednou.

Použití oddělovače k procházení oboru názvů objektů blob

Parametr delimiter umožňuje volajícímu procházet obor názvů objektů blob pomocí oddělovače nakonfigurovaného uživatelem. Tímto způsobem můžete procházet virtuální hierarchii objektů blob, jako by šlo o systém souborů. Oddělovač může být jeden znak nebo řetězec.

Pokud požadavek obsahuje tento parametr, operace vrátí element.BlobPrefix Element BlobPrefix je vrácen místo všech objektů blob s názvy, které začínají stejným podřetězcem, až do výskytu znaku oddělovače. Hodnota elementu BlobPrefix je substring+delimiter, kde substring je společný podřetězec, který začíná jeden nebo více názvů objektů blob, a delimiter je hodnota parametru delimiter .

Hodnotu of BlobPrefix můžete použít k následnému volání seznamu objektů blob, které začínají touto předponou. To lze provést zadáním hodnoty parametru BlobPrefix for v prefix identifikátoru URI požadavku.

Všimněte si, že každý vrácený prvek BlobPrefix počítá do maximálního výsledku stejně jako každý prvek Blob.

Objekty blob jsou uvedené v abecedním pořadí v textu odpovědi s velkými písmeny. Všimněte si, / že u účtů s povoleným hierarchickým jmenným prostorem je považováno za nejnižší pořadí řazení. Tento rozdíl v chování se vztahuje pouze na rekurzivní výpis.

Chyby kopírování v popisu stavu kopírování

CopyStatusDescription obsahuje další informace o Copy Blob chybě.

  • Pokud se pokus o kopírování nezdaří, CopyStatus je nastavena na pending možnost Pokud se služba Blob Storage stále pokouší o operaci. Text CopyStatusDescription popisuje chybu, ke které mohlo dojít při posledním pokusu o kopírování.

  • Pokud CopyStatus je nastavena CopyStatusDescription na failed, text popisuje chybu, která způsobila selhání operace kopírování.

Následující tabulka popisuje pole jednotlivých CopyStatusDescription hodnot.

Komponenta Popis
Stavový kód HTTP Standardní tříciferné celé číslo určující selhání
Kód chyby Klíčové slovo, které popisuje chybu. Poskytuje ho Azure v elementu <ErrorCode> . Pokud se nezobrazí žádný <prvek ErrorCode> , služba vrátí klíčové slovo, které obsahuje standardní text chyby spojený s třímístným stavovým kódem HTTP ve specifikaci HTTP. Další informace najdete v tématu Běžné kódy chyb rozhraní REST API.
Informace Podrobný popis selhání v uvozovkách.

Následující tabulka popisuje CopyStatus hodnoty a CopyStatusDescription běžných scénářů selhání.

Důležitý

Zde zobrazený text popisu se může změnit bez upozornění, a to i bez změny verze. Nespoléhejte na porovnávání tohoto přesného textu.

Scénář Hodnota stavu kopírování Hodnota kopírovat popis stavu
Operace kopírování byla úspěšně dokončena. úspěch prázdný
Uživatel před dokončením operace kopírování přerušil. Přerušena prázdný
Při čtení ze zdrojového objektu blob během operace kopírování došlo k chybě. Operace se bude opakovat. zahájený 502 BadGateway "Došlo k chybě opakovatelné při čtení zdroje. Zkusí to znovu. Čas poruchy: <čas>"
Při zápisu do cílového objektu blob operace kopírování došlo k chybě. Operace se bude opakovat. zahájený 500 InternalServerError "Došlo k chybě opakovatelné. Zkusí to znovu. Čas poruchy: <čas>"
Při čtení ze zdrojového objektu blob operace kopírování došlo k neopravitelné chybě. neúspěšný 404 ResourceNotFound "Kopírování se nezdařilo při čtení zdroje." Když služba ohlásí tuto základní chybu, vrátí se ResourceNotFound v elementu <ErrorCode> . Pokud se v odpovědi neobjevil žádný <prvek ErrorCode> , zobrazí se standardní řetězcová reprezentace stavu HTTP, například NotFound, .
Vypršel časový limit pro všechny operace kopírování. (V současné době je časový limit dva týdny.) neúspěšný 500 OperationCancelled "Kopie překročila maximální povolenou dobu.".
Operace kopírování se při čtení ze zdroje příliš často nezdařila a nesplněla minimální poměr pokusů o úspěch. (Tento časový limit zabraňuje opakování velmi špatného zdroje během dvou týdnů před selháním). neúspěšný 500 OperationCancelled "Kopie selhala při čtení zdroje"

Fakturování

Žádosti o ceny můžou pocházet z klientů, kteří používají rozhraní API služby Blob Storage, a to buď přímo prostřednictvím rozhraní REST API služby Blob Storage, nebo z klientské knihovny služby Azure Storage. Tyto žádosti nabíhají poplatky za transakci. Typ transakce ovlivňuje způsob účtování účtu. Například transakce čtení nabíhají do jiné fakturační kategorie než transakce zápisu. Následující tabulka uvádí kategorii fakturace pro požadavky List Blobs na základě typu účtu úložiště:

Operace Typ účtu úložiště Kategorie fakturace
Výpis objektů blob Objekt blob bloku Úrovně Premium
Standard pro obecné účely verze 2
Standard pro obecné účely verze 1		 Výpis a vytvoření operací kontejneru

Další informace o cenách pro zadanou fakturační kategorii najdete v tématu ceny služby Azure Blob Storage.

Viz také

Kódy stavu a chyb
kódy chyb Blob Storage