Sdílet prostřednictvím

Výpis objektů blob

  • Článek

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 HTTP/1.1

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

Když provedete požadavek na emulovanou službu úložiště, zadejte název hostitele emulátoru a port služby Azure Blob Storage jako 127.0.0.1:10000ná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 HTTP/1.1

Další informace najdete v tématu Použití emulátoru Azurite pro místní vývoj služby 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 s názvem readmefile.txt pomocí cesty předpony folder1/folder2/readme/readmefile.txt. Pokud některá podsložka obsahuje soubor s názvem readme, zobrazí se chyba .
delimiter Volitelný. Pokud požadavek obsahuje tento parametr, vrátí operace BlobPrefix prvek v textu 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 se mají vrátit další výsledky, vrátí služba token pro pokračování v elementu odpovědi NextMarker. V některých případech může služba vrátit méně výsledků, než je určeno 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 by měly být zahrnuty do výčtu. Snímky jsou uvedené od nejstarších po nejnovější v odpovědi.
- metadata: Určuje, že se v odpovědi vrátí metadata objektu blob.
- uncommittedblobs: Určuje, že objekty blob, pro které byly nahrány bloky, ale které nebyly potvrzeny pomocí Put Block List, budou zahrnuty do odpovědi.
- copy: Verze 2012-02-12 a novější. Určuje, že do odpovědi by měla být zahrnuta metadata související s jakoukoli aktuální nebo předchozí operací Copy Blob.
- 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 \<HasVersionsOnly\>značky 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.

Pokud chcete pro identifikátor URI zadat více než jednu z těchto možností, musíte každou možnost oddělit čárkou zakódovanou adresou 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 je zadán také include=deleted, 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 Vypršení č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ý. Platné pouze v případě, že je pro účet povolený hierarchický obor názvů a include=permissions je v požadavku k dispozici. Pokud true, hodnoty identity uživatele vrácené v>vlastníka <, <Skupiny>a <seznamu A> CL se transformují z ID objektů Microsoft Entra na hlavní názvy uživatelů. Pokud false, vrátí se hodnoty 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

Ukázkovou žádost najdete v tématu Vytvoření výčtu prostředků objektů blob.

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 prvky Prefix, Marker, MaxResultsa Delimiter jsou přítomné pouze v případě, že byly zadány na identifikátoru URI požadavku. Prvek NextMarker má hodnotu pouze v případě, že výsledky seznamu nejsou dokončeny.

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

Ve verzi 2009-09-19 a novějších se vlastnosti objektu blob zapouzdřují do 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ší vypočítá Blob Storage Content-MD5 hodnotu při nahrávání objektu blob pomocí Put Blob. Blob Storage to nevypočítává při vytváření objektu blob pomocí put block list. Hodnotu Content-MD5 můžete explicitně nastavit při vytváření objektu blob nebo voláním Put Block List nebo Nastavit vlastnosti objektu blob operace.

Pro verze z 9. 9. 2009 a novější verze, 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 se zobrazí jenom ve verzi 2012-02-12 a novější.

CopyId, CopyStatus, CopySource, CopyProgress, CopyCompletionTimea CopyStatusDescription se zobrazí pouze ve verzi 2012-02-02-12 a novější, pokud tato operace zahrnuje parametr include={copy}. Tyto prvky se nezobrazují, pokud tento objekt blob nikdy nebyl cílem operace Copy Blob. Prvky se nezobrazí, pokud byl tento objekt blob změněn po dokončení operace Copy Blob pomocí Set Blob Properties, Put Blobnebo Put Block List. Tyto prvky se také nezobrazují s objektem blob vytvořeným kopírovat objekt blobpřed verzí 2012-02-12.

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

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í prvek ServerEncrypted. Tento prvek je nastaven na true, pokud jsou metadata objektu blob a aplikace zcela šifrovaná a false jinak.

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

Pro verzi 2017-04-17 a novější List Blobs vrátí prvek AccessTier, pokud je 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ě Úrovně Premium a spravované disky pro virtuální počítače. Pro účty Blob Storage nebo účty pro obecné účely verze 2 jsou platné hodnoty Hot, Coola Archive. Pokud je objekt blob ve stavu čekání na dosazování, vrátí se ArchiveStatus prvek 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í úrovně úložiště.

Pro verzi 2017-04-17 a novější vrátí List Blobs prvek AccessTierInferred pro účty Blob Storage nebo účty pro obecné účely verze 2. 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ší vrátí List Blobs prvek AccessTierChangeTime pro účty Blob Storage nebo účty pro obecné účely verze 2. 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ší se Deleted, DeletedTimea RemainingRetentionDays zobrazí, když tato operace obsahuje parametr include={deleted}. Tyto prvky se nezobrazují, pokud tento objekt blob nebyl odstraněn. Tyto prvky se zobrazí pro objekty blob nebo snímky odstraněné pomocí operace DELETE, když byla povolena funkce obnovitelného odstranění. Element Deleted je nastaven na true pro objekty blob a snímky, které jsou obnovitelné odstranění. Deleted-Time odpovídá času odstranění objektu blob. RemainingRetentionDays označuje počet dnů, po kterých se trvale odstraní obnovitelně odstraněný objekt blob.

Pro verzi 2017-11-09 a novější vrátí Creation-Time čas vytvoření tohoto objektu blob.

Pro verzi 2019-02-02 a novější List Blobs vrátí prvek CustomerProvidedKeySha256, 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. Kromě toho platí, že pokud operace obsahuje parametr include={metadata} a v objektu blob se zašifrují metadata aplikace zašifrovaná pomocí klíče poskytnutého zákazníkem, bude mít element Metadata atribut Encrypted="true". Tento atribut označuje, že objekt blob má metadata, která nelze dešifrovat jako součást operace List Blobs. Pokud chcete získat přístup k metadatům těchto objektů blob, zavolejte Získat vlastnosti objektu blob nebo získat metadata objektů blob pomocí klíče poskytnutého zákazníkem.

Pro verzi 2019-02-02 a novější List Blobs vrátí prvek EncryptionScope, pokud je objekt blob š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 se transparentně dešifrují a jsou k dispozici v elementu Metadata.

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

Pro verzi 2019-12-12 a novější List Blobs vrátí prvek VersionId pro objekty blob a vygenerované verze objektů blob při povolení správy verzí v účtu.

Pro verzi 2019-12-12 a novější vrátí List Blobs element IsCurrentVersion 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í prvek TagCount pro objekty blob se všemi značkami. Prvek 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í prvek Sealed pro doplňovací objekty blob. Prvek Sealed se zobrazí pouze v případech, kdy byl objekt blob připojení zapečetěn. Tyto prvky se nezobrazí, pokud objekt blob připojení není zapečetěný.

Pro verzi 2020-02-10 a novější List Blobs vrátí prvek LastAccessTime. 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 účtu najdete v 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ší vrátí List BlobsImmutabilityPolicyUntilDate a ImmutabilityPolicyMode elementy, pokud tato operace obsahuje parametr include={immutabilitypolicy}.

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

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

Pro účty s povoleným hierarchickým oborem názvů List Blobs s oddělovačem Properties vrátí pro účty verze 2020-06-12 a novější element BlobPrefix. To odpovídá vlastnostem v adresáři.

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

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

Pro verzi 2021-02-12 a novější bude List Blobs kódovat procenta (na RFC 2396) všechny BlobName nebo BlobPrefixName hodnoty prvků. 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 jazyce XML, nikoli u zbývajících Name prvků v odpovědi.

Pro účty s povoleným hierarchickým oborem názvů List Blobs vrátí pro účty verze 2021-06-06-08 a novější prvek vlastností Placeholder. 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 účty s povoleným hierarchickým oborem názvů List Blobs vrátí pro účty verze 2021-06-06-08 a novější prvek EncryptionContext. Pokud je nastavena hodnota vlastnosti kontextu šifrování, vrátí nastavenou hodnotu.

Pro účty s povoleným hierarchickým oborem názvů List BlobsExpiry-Time vrátí pro odstraněné objekty blob pro účty verze 2020-020-02-10 a novější. Expiry-Time je čas, kdy vyprší platnost souboru, a je vrácen pro soubor, pokud je vypršení platnosti nastaveno 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 Vytvoření výčtu prostředků objektů blob.

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ává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.

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

Element OrMetadata se vrátí 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.

Prvek Content-MD5 se zobrazí v textu odpovědi, pouze pokud byl v objektu blob nastaven pomocí verze 2009-09-19 nebo novější. Vlastnost Content-MD5 můžete nastavit při vytvář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 blob bloku, i když požadavek Put Blob neobsahuje hlavičku MD5.

Metadata v odpovědi

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

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 pár název-hodnota metadat porušuje tato omezení pojmenování, text odpovědi indikuje problematický název v rámci x-ms-invalid-name elementu. 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 případě, že byl v identifikátoru URI zadán parametr include=tags a pokud objekt blob obsahuje značky. V elementu TagSet se vrátí až 10 Tag prvků, z nichž každý obsahuje key a value značek indexu objektů blob definovaných uživatelem. Pořadí značek není v odpovědi zaručené.

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 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 uvedené v odpovědi pouze v případě, že byl v identifikátoru URI zadán parametr include=snapshots. Snímky uvedené v odpovědi nezahrnují prvek 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 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 uvedené v odpovědi pouze v případě, že byl v identifikátoru URI zadán parametr include=uncommittedblobs. 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 byl v identifikátoru URI zadán parametr include=deleted. Odstraněné objekty blob uvedené v odpovědi nezahrnují prvky Zapůjčení, protože odstraněné objekty blob nemohou mít aktivní zapůjčení.

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

Metadata replikace objektů v odpovědi

Element OrMetadata se nachází, když se v objektu blob vyhodnocuje zásada replikace objektu a List Blobs volání bylo provedeno pomocí verze 2019-12-12 nebo novější. V elementu OrMetadata je hodnota každého páru name-value 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ásady replikace objektu 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

Prvky ImmutabilityPolicyUntilDate a ImmutabilityPolicyMode existují pouze v případě, že byl parametr include=immutabilitypolicy zadán na identifikátoru URI.

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

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

<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, text odpovědi obsahuje prvek 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 prvek NextMarker, 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 na identifikátoru URI pro následující požadavek. Všimněte si, že hodnota NextMarker by měla být považována za neprůhlenou.

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 šlo o systém souborů. Oddělovač může být jeden znak nebo řetězec.

Pokud požadavek obsahuje tento parametr, vrátí operace BlobPrefix prvek. Prvek BlobPrefix se vrátí místo všech objektů blob s názvy, které začínají stejným podřetědcem až do vzhledu znaku oddělovače. Hodnota elementu BlobPrefix je podřetězení+ oddělovač, kde podřetětěce je běžný podřetětěr, 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 pro parametr 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.

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

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

  • Pokud se pokus o kopírování nezdaří, CopyStatus je nastavená na pending, pokud blob Storage stále opakuje operaci. Text CopyStatusDescription popisuje selhání, ke kterému mohlo dojít během posledního pokusu o kopírování.

  • Pokud je CopyStatus nastavena na failed, text CopyStatusDescription 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říciferné celé číslo určující selhání
Kód chyby Klíčové slovo, které popisuje chybu. Azure ho poskytuje v elementu <ErrorCode>. Pokud se nezobrazí žádný <ErrorCode> element, vrátí služba klíčové slovo, které obsahuje standardní text chyby přidružený ke stavovém kódu HTTP se třemi číslicemi ve specifikaci HTTP. Další informace najdete v tématu kódy chyb rozhraní COMMON REST API.
Informace Podrobný popis selhání v uvozovkách.

Následující tabulka popisuje CopyStatus a CopyStatusDescription hodnoty 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 selhání: <č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 selhání: <čas>"
Při čtení ze zdrojového objektu blob operace kopírování došlo k neopravitelné chybě. neúspěšný 404 ResourceNotFound Při čtení zdroje se nezdařilo kopírování. Když služba hlásí tuto základní chybu, vrátí ResourceNotFound v <ErrorCode> elementu. Pokud se v odpovědi nezobrazí žádný <ErrorCode> prvek, 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é

Stav a kódy chyb
kódy chyb Blob Storage