Výpis objektů blob

  • Článek

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

Žádost

Požadavek můžete sestavit List Blobs 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 žádosti Verze PROTOKOLU HTTP
GET https://myaccount.blob.core.windows.net/mycontainer?restype=container&comp=list HTTP/1.1

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

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

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

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

Parametry identifikátoru URI

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

Parametr Popis
prefix Nepovinný parametr. Filtruje výsledky tak, aby vracely pouze objekty blob s názvy, které začínají zadanou předponou. U účtů, 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 s názvem readmefile.txt pomocí cesty folder1/folder2/readme/readmefile.txtpředpony . Pokud některá podsložka obsahuje soubor s názvem readme, zobrazí se chyba.
delimiter Nepovinný parametr. Pokud požadavek obsahuje tento parametr, operace vrátí BlobPrefix prvek v textu odpovědi. Tento element funguje jako zástupný symbol pro všechny objekty blob s názvy, které začínají stejným podřetěžcem až po vzhled oddělovače. Oddělovačem může být jeden znak nebo řetězec.
marker Nepovinný parametr. Řetězcová hodnota, která identifikuje část seznamu, která má být vrácena při další operaci seznamu. Operace vrátí hodnotu značky v těle odpovědi, pokud vrácený seznam nebyl dokončený. Hodnotu značky pak můžete použít v následném volání a vyžádat si další sadu položek seznamu.

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

Pokud maxresults nastavíte hodnotu menší nebo rovnou nule, zobrazí se kód odpovědi na chybu 400 (Chybný požadavek).
include={snapshots,metadata,uncommittedblobs,copy,deleted,tags,versions,
deletedwithversions,immutabilitypolicy,legalhold,permissions}		 Nepovinný parametr. Určuje jednu nebo více datových sad, které se mají zahrnout do odpovědi:

- snapshots: Určuje, že do výčtu by měly být zahrnuty snímky. Snímky jsou v odpovědi uvedené od nejstarších po nejnovější.
- metadata: Určuje, že se v odpovědi vrátí metadata objektu blob.
- uncommittedblobs: Určuje, že se do odpovědi zahrnou objekty blob, pro které se nahrály bloky, ale které nebyly potvrzeny pomocí příkazu Put Block List.
- copy: Verze 2012-02-12 a novější. Určuje, že do odpovědi by měla být zahrnuta metadata týkající se jakékoli aktuální nebo předchozí Copy Blob operace.
-deleted: Verze 2017-07-29 a novější. Určuje, že se do odpovědi mají zahrnout obnovitelně odstraněné objekty blob.
-tags: Verze 2019-12-12 a novější. Určuje, že do odpovědi by měly být zahrnuty uživatelem definované značky indexu objektů blob.
-versions: Verze 2019-12-12 a novější. Určuje, že do výčtu by měly být zahrnuty verze objektů blob.
-deletedwithversions: Verze 2020-10-02 a novější. Určuje, že do odpovědi by měly být zahrnuté odstraněné objekty blob s libovolnou verzí (aktivní nebo odstraněnou). Položky, které jste trvale odstranili, se zobrazí v odpovědi, dokud je nezpracuje uvolňování paměti. Použijte značku \<HasVersionsOnly\>a hodnotu true.
-immutabilitypolicy: Verze 2020-06-12 a novější. Určuje, že výčet by měl zahrnovat zásady 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ší. Podporováno pouze pro účty s povoleným hierarchickým oborem názvů. Pokud požadavek obsahuje tento parametr, bude do výčtu zahrnutý vlastník, skupina, oprávnění a seznam řízení přístupu pro uvedené objekty blob nebo adresáře.

Pokud chcete 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} Nepovinný parametr. Určuje jednu z těchto datových sad, které se mají 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. Upozorňujeme, že náhradní autorizace seznamu ACL posix se nepodporuje pro výpis obnovitelně odstraněných objektů blob. Pokud include=deleted je také zadaný parametr , požadavek selže s chybou Chybný požadavek (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 Nepovinný parametr. Parametr se timeout 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 požadované a volitelné hlavičky požadavků.

Hlavička požadavku Popis
Authorization Povinná hodnota. Určuje schéma autorizace, název účtu a podpis. Další informace najdete v tématu Autorizace požadavků do služby Azure Storage.
Date nebo x-ms-date Povinná hodnota. Určuje formát UTC (Coordinated Universal Time). Další informace najdete v tématu Autorizace požadavků do služby Azure Storage.
x-ms-version Povinné 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 Nepovinný parametr. Poskytuje klientem vygenerovanou neprůselnou hodnotu s limitem počtu 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í Azure Blob Storage.
x-ms-upn Nepovinný parametr. Platí pouze v případě, že je pro účet povolený hierarchický obor názvů a include=permissions je k dispozici v požadavku. Pokud true, hodnoty identity uživatele vrácené v <polích Vlastník>, <Skupina> a <Seznam řízení přístupu> se transformují z ID objektů Microsoft Entra na hlavní názvy uživatelů. Pokud false, vrátí se hodnoty jako Microsoft Entra ID objektů. Výchozí hodnota je false. ID objektů aplikací a skupin se nepřekládají, protože nemají jedinečné popisné názvy.

Text požadavku

Žádné

Ukázkový požadavek

Ukázkový požadavek najdete v tématu Výčet prostředků objektů blob .

Odpověď

Odpověď obsahuje stavový kód HTTP, sadu hlaviček odpovědi 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 najdete v tématu Stavové kódy a kódy chyb.

Hlavičky odpovědi

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

Hlavička odpovědi Description
Content-Type Určuje formát, ve kterém jsou výsledky vráceny. V současné době je application/xmltato hodnota .
x-ms-request-id Tato hlavička jednoznačně identifikuje požadavek, který byl proveden, a lze ji 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 vrátí také pro anonymní požadavky bez zadané verze, pokud byl kontejner označen pro veřejný přístup pomocí verze 2009-09-19 služby Blob Storage.
Date Hodnota data a času UTC, která označuje čas, kdy byla odpověď zahájena. Tato služba vygeneruje tuto hodnotu.
x-ms-client-request-id Tuto hlavičku můžete použít k řešení potíží s požadavky a odpovídajícími odpověďmi. Hodnota této hlavičky se rovná hodnotě x-ms-client-request-id hlavičky, pokud se nachází v požadavku. Hodnota je maximálně 1024 viditelných znaků ASCII. Pokud se hlavička x-ms-client-request-id v požadavku nenachází, nebude tato hlavička v odpovědi.

Text odpovědi

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

Všimněte si, že elementy Prefix, Marker, MaxResultsa Delimiter jsou k dispozici pouze v případě, že byly zadány v identifikátoru URI požadavku. Element NextMarker má hodnotu pouze v případě, že výsledky seznamu nejsou dokončené.

Snímky, metadata objektů blob a nepotvrzené objekty blob jsou součástí odpovědi 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řené v elementu Properties .

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

  • 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í pro objekty blob vytvořené ve verzi 2009-09-19 a novější. Ve verzi 2012-02-12 a novější služba Blob Storage vypočítá Content-MD5 hodnotu při nahrání objektu blob pomocí put blob. Blob Storage to nevypočítá, když vytvoříte objekt blob pomocí seznamu bloků put. Hodnotu můžete explicitně nastavit Content-MD5 při vytváření objektu blob nebo voláním operací Put Block List nebo Set Blob Properties .

Pro verze z 2009-09-19 a novější, ale před verzí 2015-02-21, nemůžete volat List Blobs v kontejneru, 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 zobrazí se pouze ve verzi 2012-02-12 a novější.

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

Ve verzi 2013-08-15 a novější obsahuje ServiceEndpoint element atribut, EnumerationResults který určuje koncový bod objektu blob. Tento element obsahuje ContainerName také pole, které určuje název kontejneru. V předchozích verzích byly tyto dva atributy v poli sloučeny ContainerName . Také ve verzi 2013-08-15 a novějších Url se prvek pod Blob odebral.

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

Pro verzi 2015-12-11 a novější List Blobs vrátí ServerEncrypted element . Pokud jsou metadata objektu blob a aplikace kompletně zašifrovaná, je tento element nastavený na true hodnotu , a false jinak.

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é úložiště Premium a spravované disky pro virtuální počítače. Pro účty Blob Storage nebo účty pro obecné účely verze 2 jsou Hotplatné hodnoty , Coola Archive. Pokud je objekt blob ve stavu čekání na rehydraci, ArchiveStatus vrátí se element s jednou z platných hodnot (rehydrate-pending-to-hot, rehydrate-pending-to-coolnebo rehydrate-pending-to-cold). Podrobné informace o vrstvení objektů blob bloku najdete v tématu Horká, studená a archivní vrstva ú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 úrovni se odvozují z vlastností účtu úložiště a tato hodnota je nastavená na true. Tato hlavička je k dispozici 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 najdete v tématu Znázornění hodnot data a času v záhlavích.

Ve verzi 2017-07-29 a novějších Deletedse zobrazí , DeletedTimea RemainingRetentionDays , pokud tato operace zahrnuje include={deleted} parametr . Pokud se tento objekt blob neodstranil, tyto prvky se nezobrazí. Tyto prvky se zobrazí pro objekty blob nebo snímky, které se odstraní v rámci DELETE operace, když byla povolena funkce obnovitelného odstranění. Pro Deleted objekty blob a snímky, které se obnovitelně odstraní, je element nastavený na true hodnotu . Deleted-Time odpovídá času odstranění objektu blob. RemainingRetentionDays urč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 vytvoření Creation-Time tohoto objektu blob.

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

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

Pro verzi 2019-12-12 a novější List Blobs vrátí RehydratePriority element ve službě 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 pro účet povolená správa verzí.

Pro verzi 2019-12-12 a novější List Blobs vrátí IsCurrentVersion prvek pro aktuální verzi objektu blob. Hodnota je nastavená 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. Prvek Tags se zobrazí pouze v případě, že tato operace obsahuje include={tags} parametr. Pokud objekt blob neobsahuje žádné značky, tyto prvky se nezobrazí.

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

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

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

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

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

Pro verzi 2020-06-12 a novější pro účty 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 pro účty s povoleným List Blobs hierarchickým oborem názvů element pro odstraněné objekty blob. DeletionId je 64bitový identifikátor bez znaménka. Element jedinečně identifikuje obnovitelně odstraněnou cestu, aby se odlišil od ostatních odstraněných objektů blob se stejnou cestou.

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

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

Pro verzi 2021-06-08 a novější vrátí Placeholder pro účty 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 usnadnily navigaci na obnovitelné odstraněné objekty blob.

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

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 vrátí se pro soubor, pokud je vypršení platnosti nastavené na stejné.

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

Ukázkovou odpověď najdete v tématu Výčet prostředků objektů blob .

Autorizace

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

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

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

Oprávnění

Níže jsou uvedené akce RBAC potřebné k volání operace Microsoft Entra uživatele, skupiny nebo instančního List Blobs objektu a předdefinované role Azure RBAC s nejnižšími oprávněními, která zahrnuje tuto akci:

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 se nenastaví, dokud objekt blob není potvrzen. Některé vlastnosti nemusí být v odpovědi vráceny.

Element x-ms-blob-sequence-number se vrátí jenom pro objekty blob stránky.

Element OrMetadata se vrátí jenom pro objekty blob bloku.

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

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

Metadata v odpovědi

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

Upozorňujeme, že metadata požadovaná tímto parametrem musí být uložena v souladu s omezeními pro vytváření názvů, která jsou uložená verzí služby Blob Storage z 19. 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 pár název-hodnota metadat porušuje tato omezení pojmenování, text odpovědi označuje problematický název v elementu x-ms-invalid-name . 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

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

Prvky 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 můžou být viditelné v odpovědi na List Blobs dříve, než se zobrazí 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 element neobsahují LeaseStatus , protože snímky nemohou mít aktivní zapůjčení.

Pomocí služby verze 2021-06-08 a vyšší 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 vrátí požadavek, který zahrnuje obě, chybu InvalidQueryParameter (stavový kód HTTP 400 – Chybný požadavek).

Nepotvrzené objekty blob v odpovědi

Nepotvrzené objekty blob jsou v odpovědi uvedené pouze v případě, že include=uncommittedblobs 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 uvedené 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 Zapůjčení , protože odstraněné objekty blob nemohou mít aktivní zapůjčení.

Odstraněné snímky jsou součástí odpovědi seznamu, pokud include=deleted,snapshot byly zadány v identifikátoru URI.

Metadata replikace objektů v odpovědi

Element OrMetadata je k dispozici, když byly vyhodnoceny zásady replikace objektů v objektu blob a List Blobs volání bylo provedeno pomocí verze 2019-12-12-12 nebo novější. V elementu OrMetadata je hodnota každého páru název-hodnota uvedena v elementu odpovídajícím názvu dvojice. Formát názvu je or-{policy-id}_{rule-id}, kde {policy-id} je identifikátor GUID, který představuje 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 ImmutabilityPolicyUntilDate a ImmutabilityPolicyMode jsou k dispozici pouze v případě, že include=immutabilitypolicy byl parametr zadán v identifikátoru URI.

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

Element 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 objektů blob, které se mají vrátit, překročí tuto hodnotu nebo překročí výchozí hodnotu pro maxresults, tělo odpovědi obsahuje NextMarker prvek. Tento prvek označuje další objekt blob, který se má vrátit při následném 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.

Pokud chcete vrátit další sadu položek, zadejte hodnotu NextMarker jako parametr značky 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ůselnou.

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í uživatelem nakonfigurovaného oddělovače. Tímto způsobem můžete procházet virtuální hierarchii objektů blob, jako by se jednalo o systém souborů. Oddělovačem může být jeden znak nebo řetězec.

Když požadavek obsahuje tento parametr, operace vrátí BlobPrefix element. Element BlobPrefix se vrátí místo všech objektů blob s názvy, které začínají stejným podřetěžcem, až po vzhled oddělovače. Hodnota elementu BlobPrefix je substring+oddělovač, kde podřetěžec je běžný podřetěžec, který začíná jeden nebo více názvů objektů blob, a oddělovač je hodnota parametru delimiter .

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

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

Objekty blob jsou v textu odpovědi uvedené v abecedním pořadí a jako první jsou velká písmena.

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

CopyStatusDescription obsahuje další informace o Copy Blob selhání.

  • Pokud se pokus o kopírování nezdaří, CopyStatus nastaví se na pending hodnotu, pokud se služba Blob Storage stále pokouší operaci zopakovat. Text CopyStatusDescription popisuje selhání, ke kterému mohlo dojít při posledním pokusu o kopírování.

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

Následující tabulka popisuje pole každé CopyStatusDescription hodnoty.

Komponenta Popis
Stavový kód HTTP Standardní třímístné celé číslo určující chybu.
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 přidružený ke třímístnému stavovém kódu 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ý popisný text se může změnit bez upozornění, a to i bez změny verze. Nespoléhejte se na shodu s tímto přesným textem.

Scenario Hodnota stavu kopírování Kopírovat hodnotu popisu stavu
Operace kopírování byla úspěšně dokončena. úspěch empty
Uživatel přerušil operaci kopírování před jejím dokončením. Přerušena empty
Při čtení ze zdrojového objektu blob během operace kopírování došlo k chybě. Operace se bude zkoušet opakovaně. pending 502 BadGateway Při čtení zdroje došlo k chybě, která se dá opakovat. Zkusí to znovu. Čas selhání: <čas>"
Při zápisu do cílového objektu blob operace kopírování došlo k chybě. Operace se bude zkoušet opakovaně. pending 500 InternalServerError "Zjistila se opakovatelná chyba. Zkusí to znovu. Čas selhání: <čas>"
Při čtení ze zdrojového objektu blob operace kopírování došlo k neopravitelné chybě. failed 404 ResourceNotFound Při čtení zdroje se nezdařilo kopírování. Když služba hlásí tuto základní chybu, vrátí ResourceNotFound se v elementu <ErrorCode> . Pokud se v odpovědi nezobrazí žádný <element ErrorCode> , zobrazí se standardní řetězcová reprezentace stavu HTTP, například NotFound.
Časový limit omezující všechny operace kopírování uplynul. (V současné době je časový limit dva týdny.) failed 500 OperaceCancelled "Kopie překročila maximální povolený čas."
Operace kopírování příliš často selhala při čtení ze zdroje a nesplněla minimální poměr pokusů k úspěchům. (Tento časový limit zabraňuje opakování velmi špatného zdroje po dobu dvou týdnů před selháním.) failed 500 OperationCancelled "Kopie selhala při čtení zdroje."

Fakturace

Žádosti o ceny můžou pocházet od klientů, kteří používají rozhraní BLOB Storage API, a to buď přímo prostřednictvím rozhraní REST API služby Blob Storage, nebo z klientské knihovny Služby Azure Storage. Tyto požadavky načítají poplatky za transakci. Typ transakce ovlivňuje způsob účtování poplatku za účet. Například transakce čtení se načítají do jiné kategorie fakturace než transakce zápisu. Následující tabulka ukazuje kategorii fakturace pro List Blobs žádosti založené na 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 v2
Standard pro obecné účely v1		 Operace se seznamem a vytvořením kontejneru

Informace o cenách pro zadanou kategorii fakturace najdete v tématu Azure Blob Storage Ceny.

Viz také

Stavové kódy a kódy chyb
Kódy chyb služby Blob Storage