Získání vlastností objektu blob

  • Článek

Operace Get Blob Properties vrátí všechna uživatelem definovaná metadata, standardní vlastnosti HTTP a systémové vlastnosti objektu blob. Nevrací obsah objektu blob.

Žádost

Požadavek můžete vytvořit Get Blob Properties následujícím způsobem. Doporučujeme použít https. Nahraďte myaccount názvem vašeho účtu úložiště.

Identifikátor URI požadavku metody HEAD Verze PROTOKOLU HTTP
https://myaccount.blob.core.windows.net/mycontainer/myblob

https://myaccount.blob.core.windows.net/mycontainer/myblob?snapshot=<DateTime>

https://myaccount.blob.core.windows.net/mycontainer/myblob?versionid=<DateTime>		 HTTP/1.1

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

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

Identifikátor URI požadavku metody HEAD Verze PROTOKOLU HTTP
http://127.0.0.1:10000/devstoreaccount1/mycontainer/myblob HTTP/1.1

Další informace najdete v tématu Použití emulátoru služby Azure Storage pro vývoj a testování.

Parametry identifikátoru URI

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

Parametr Popis
snapshot Nepovinný parametr. Parametr snapshot je neprůselná DateTime hodnota, která při jeho přítomnosti určuje snímek objektu blob, který se má načíst. Další informace o práci se snímky objektů blob najdete v tématu Create snímek objektu blob.
versionid Nepovinný parametr. Verze 2019-12-12 a novější. Parametr versionid je neprůselná DateTime hodnota, která při výskytu určuje verzi objektu blob, která se má načíst.
timeout Nepovinný parametr. Parametr timeout je vyjádřen 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. Volitelné pro anonymní žádosti. Určuje verzi operace, která se má použít pro tento požadavek. Další informace najdete v tématu Správa verzí pro služby Azure Storage.
x-ms-lease-id: <ID> Nepovinný parametr. Pokud je tato hlavička zadána Get Blob Properties , operace se provede pouze v případě, že jsou splněny obě následující podmínky:

– Zapůjčení objektu blob je aktuálně aktivní.
– ID zapůjčení zadané v požadavku odpovídá ID zapůjčení objektu blob.

Pokud některou z těchto podmínek nesplníte, požadavek selže a operace selže se Get Blob Properties stavovým kódem 412 (Předběžná podmínka selhala).
x-ms-upn Nepovinný parametr. Verze 2020-06-12 a novější. Platí pro účty s povoleným hierarchickým oborem názvů. Pokud ano, hodnoty identity uživatele, které jsou vráceny v x-ms-ownerhlavičce a x-ms-groupx-ms-acl odpovědi, se transformují z ID objektů Microsoft Entra na hlavní názvy uživatelů. Pokud je hodnota false, vrátí se jako Microsoft Entra ID objektů. Výchozí hodnota je false (nepravda). Všimněte si, že ID objektů skupin a aplikací se nepřekládají, protože nemají jedinečné popisné názvy.
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 analytických protokolech, když je povolené protokolování analýzy úložiště. Důrazně doporučujeme použít tuto hlavičku při korelaci aktivit na straně klienta s požadavky přijatými serverem. Další informace najdete v tématu Informace o protokolování azure Analýza úložiště.

Tato operace také podporuje použití podmíněných hlaviček k vrácení vlastností objektů blob a metadat pouze v případě, že je splněna zadaná podmínka. Další informace najdete v tématu Určení podmíněných hlaviček pro operace služby Blob Storage.

Hlavičky požadavků (šifrovací klíče poskytnuté zákazníkem)

Od verze 2019-02-02 můžete v požadavku zadat následující hlavičky na čtení objektu blob, který je šifrovaný pomocí klíče poskytnutého zákazníkem. Šifrování pomocí klíče poskytnutého zákazníkem (a odpovídající sady hlaviček) je volitelné. Pokud byl objekt blob dříve zašifrovaný pomocí klíče poskytnutého zákazníkem, musíte do požadavku zahrnout tyto hlavičky, aby bylo možné úspěšně dokončit operaci čtení.

Hlavička požadavku Popis
x-ms-encryption-key Povinná hodnota. Šifrovací klíč AES-256 s kódováním Base64.
x-ms-encryption-key-sha256 Nepovinný parametr. Hodnota hash SHA256 šifrovacího klíče v kódování Base64.
x-ms-encryption-algorithm: AES256 Povinná hodnota. Určuje algoritmus, který se má použít pro šifrování. Hodnota této hlavičky musí být AES256.

Text požadavku

Žádné

Odpověď

Odpověď obsahuje stavový kód HTTP a sadu hlaviček odpovědi.

Stavový kód

Úspěšná operace vrátí stavový kód 200 (OK).

Další 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 hlavičky v následující tabulce. 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
Last-Modified Datum a čas poslední změny objektu blob. Formát data se řídí dokumentem RFC 1123. Další informace najdete v tématu Reprezentace hodnot data a času v záhlavích.

Každá operace, která upraví objekt blob, včetně aktualizace metadat nebo vlastností objektu blob, změní čas poslední změny objektu blob.
x-ms-creation-time Verze 2017-11-09 a novější. Datum a čas vytvoření objektu blob. Formát data se řídí dokumentem RFC 1123. Další informace najdete v tématu Reprezentace hodnot data a času v záhlavích.
x-ms-meta-name:value Sada párů název-hodnota, které odpovídají metadatům definovaným uživatelem, která jsou přidružená k tomuto objektu blob.
x-ms-tag-count Verze 2019-12-12 a novější. Pokud objekt blob obsahuje nějaké značky, vrátí počet značek uložených v objektu blob. Pokud objekt blob neobsahuje žádné značky, tato hlavička se nevrátí.
x-ms-blob-type:<BlockBlob\|PageBlob\|AppendBlob> Typ objektu blob.
x-ms-copy-completion-time:<datetime> Verze 2012-02-12 a novější. Čas ukončení posledního pokusu o Copy Blob operaci, kdy tento objekt blob byl cílovým objektem blob. Tato hodnota může určovat čas dokončení, přerušení nebo neúspěšného pokusu o kopírování. Tato hlavička se nezobrazí, pokud čeká na kopírování, pokud tento objekt blob nikdy nebyl cílem operace Copy Blob nebo pokud byl tento objekt blob změněn po dokončené Copy Blob operaci, která používá Set Blob Properties, Put Blobnebo Put Block List.
x-ms-copy-status-description: <error string> Verze 2012-02-12 a novější. Zobrazí se pouze v případě, že x-ms-copy-status je failed nebo pending. Popisuje příčinu závažného nebo jiného závažného selhání operace kopírování. Tato hlavička se nezobrazí, pokud tento objekt blob nikdy nebyl cílem operace Copy Blob nebo pokud byl změněn po dokončené Copy Blob operaci, která používá Set Blob Properties, Put Blobnebo Put Block List.
x-ms-copy-id: <id> Verze 2012-02-12 a novější. Identifikátor řetězce pro poslední pokus o Copy Blob operaci, kde tento objekt blob byl cílovým objektem blob. Tato hlavička se nezobrazí, pokud tento objekt blob nikdy nebyl cílem operace Copy Blob nebo pokud byl změněn po dokončené Copy Blob operaci, která používá Set Blob Properties, Put Blobnebo Put Block List.
x-ms-copy-progress: <bytes copied/bytes total> Verze 2012-02-12 a novější. Obsahuje počet zkopírovaných bajtů a celkový počet bajtů ve zdroji při posledním pokusu o Copy Blob operaci, kde tento objekt blob byl cílovým objektem blob. Může zobrazit od 0 po Content-Length zkopírované bajty. Tato hlavička se nezobrazí, pokud tento objekt blob nikdy nebyl cílem operace Copy Blob nebo pokud byl změněn po dokončené Copy Blob operaci, která používá Set Blob Properties, Put Blobnebo Put Block List.
x-ms-copy-source: url Verze 2012-02-12 a novější. Adresa URL o délce až 2 KiB, která určuje zdrojový objekt blob použitý při posledním pokusu Copy Blob o operaci, kde byl tento objekt blob cílovým objektem blob. Tato hlavička se nezobrazí, pokud tento objekt blob nikdy nebyl cílem operace Copy Blob nebo pokud byl změněn po dokončené Copy Blob operaci, která používá Set Blob Properties, Put Blobnebo Put Block List.
x-ms-copy-status: <pending \| success \| aborted \| failed> Verze 2012-02-12 a novější. Stav operace kopírování identifikovaný x-ms-copy-id s těmito hodnotami:

- success: Kopírování bylo úspěšně dokončeno.
- pending: Probíhá kopírování. Zkontrolujte x-ms-copy-status-description , jestli občasné, ne závažné chyby brání průběhu kopírování, ale nezpůsobují selhání.
- aborted: Kopírování bylo ukončeno uživatelem Abort Copy Blob.
- failed: Kopírování se nezdařilo. Podrobnosti o selhání najdete v tématu x-ms-copy-status-description .

Tato hlavička se nezobrazí, pokud tento objekt blob nikdy nebyl cílem operace Copy Blob nebo pokud se tento objekt blob změnil po dokončení Copy Blob operace, která používá Set Blob Properties, Put Blobnebo Put Block List.
x-ms-incremental-copy: true Verze 2016-05-31 a novější. Zahrnuté, pokud je objekt blob přírůstkovým kopírováním.
x-ms-copy-destination-snapshot:<datetime> Verze 2016-05-31 a novější. Zahrnuté, pokud je objekt blob přírůstkového kopírování objektu blob nebo přírůstkového kopírování snímek, pokud x-ms-copy-status je úspěšný. Čas snímku posledního úspěšného přírůstkového kopírování snímku tohoto objektu blob.
x-ms-lease-duration: <infinite \| fixed> Při zapůjčení objektu blob určuje, jestli má zapůjčení neomezenou nebo pevnou dobu trvání. Součástí jsou požadavky, které používají verzi 2012-02-12 a novější.
x-ms-lease-state: <available \| leased \| expired \| breaking \| broken> Stav zapůjčení objektu blob Součástí jsou požadavky, které používají verzi 2012-02-12 a novější.
x-ms-lease-status:<locked\| unlocked> Stav zapůjčení objektu blob
Content-Length Velikost objektu blob v bajtech Pro objekt blob stránky vrátí tato hlavička hodnotu hlavičky x-ms-blob-content-length , která je uložená s objektem blob.
Content-Type Typ obsahu, který je určený pro objekt blob. Pokud není zadán žádný typ obsahu, výchozí typ obsahu je application/octet-stream.
Etag Značka ETag obsahuje hodnotu, kterou můžete použít k podmíněnému provádění operací. Další informace najdete v tématu Určení podmíněných hlaviček pro operace služby Blob Storage. Pokud je verze požadavku 2011-08-18 nebo novější, je hodnota ETag uzavřena v uvozovkách.
Content-MD5 Pokud je Content-MD5 pro objekt blob nastavená hlavička, vrátí se tato hlavička odpovědi, aby klient mohl zkontrolovat integritu obsahu zprávy.

Ve verzi 2012-02-12 a novější nastaví hodnotu MD5 objektu Put Blob blob bloku, Put Blob i když požadavek neobsahuje hlavičku MD5.
Content-Encoding Content-Encoding Pokud byla pro objekt blob dříve nastavena hlavička požadavku, vrátí se tato hodnota v této hlavičce.
Content-Language Content-Language Pokud byla pro objekt blob dříve nastavena hlavička požadavku, vrátí se tato hodnota v této hlavičce.
Content-Disposition Content-Disposition Pokud byla pro objekt blob dříve nastavena hlavička požadavku, vrátí se tato hodnota v této hlavičce pro požadavky na verzi 2013-08-15 a novější.

Pole Content-Disposition hlavičky odpovědi obsahuje další informace o tom, jak zpracovat datovou část odpovědi, a můžete ho také použít k připojení dalších metadat. Pokud je například hlavička nastavená na attachment, znamená to, že by uživatel-agent neměl zobrazit odpověď, ale místo toho zobrazit dialogové okno Uložit jako.
Cache-Control Cache-Control Pokud byla pro objekt blob dříve nastavena hlavička požadavku, vrátí se tato hodnota v této hlavičce.
x-ms-blob-sequence-number Aktuální pořadové číslo objektu blob stránky.

Tato hlavička se nevrací pro objekty blob bloku ani doplňovací objekty blob.

Tato hlavička se nevrací pro objekty blob bloku.
x-ms-request-id Tato hlavička jednoznačně identifikuje požadavek, který byl proveden, a můžete 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, která se používá ke spuštění požadavku. Tato hlavička se vrátí pro požadavky, které jsou provedeny ve verzi 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í služby Blob Storage verze 2009-09-19.
Date Hodnota data a času UTC vygenerovaná službou, která označuje čas, kdy byla odpověď inicializována.
Accept-Ranges: bytes Označuje, že služba podporuje požadavky na částečný obsah objektů blob. Zahrnuté pro žádosti vytvořené pomocí verze 2013-08-15 a novější.
x-ms-blob-committed-block-count Počet potvrzených bloků, které jsou přítomné v objektu blob. Tato hlavička se vrátí jenom pro doplňovací objekty blob.
x-ms-server-encrypted: true/false Verze 2015-12-11 a novější. Hodnota této hlavičky je nastavená na true hodnotu, pokud jsou data objektů blob a metadata aplikace zcela šifrovaná pomocí zadaného algoritmu. V opačném případě je hodnota nastavená na false hodnotu (pokud je objekt blob nešifrovaný nebo pokud jsou zašifrovány jenom části metadat objektu blob nebo aplikace).
x-ms-encryption-key-sha256 Verze 2019-02-02 a novější. Tato hlavička se vrátí, pokud je objekt blob šifrovaný pomocí klíče poskytnutého zákazníkem.
x-ms-encryption-context Verze 2021-08-06 a novější. Pokud je nastavená hodnota vlastnosti kontextu šifrování, vrátí se nastavená hodnota. Platí jenom v případě, že je pro účet povolený hierarchický obor názvů.
x-ms-encryption-scope Verze 2019-02-02 a novější. Tato hlavička se vrátí, pokud je objekt blob šifrovaný s oborem šifrování.
x-ms-access-tier Verze 2017-04-17 a novější. Úroveň objektu blob stránky na Premium Storage účtu nebo vrstvě objektu blob bloku ve službě Blob Storage nebo účtu pro obecné účely v2. Seznam povolených úrovní objektů blob stránky Úrovně Premium najdete v tématu Vysoce výkonné Premium Storage a spravované disky pro virtuální počítače. Pro úložiště objektů blob nebo účet pro obecné účely v2 jsou Hotplatné hodnoty , ColdCool, a Archive. Poznámka:Cold úroveň se podporuje pro verzi 2021-12-02 a novější. Podrobné informace o vrstvení na úrovni objektů blob bloku účtu objektu blob úrovně Standard najdete v tématu Horká, studená a archivní úroveň úložiště.
x-ms-access-tier-inferred: true Verze 2017-04-17 a novější. Pouze pro objekty blob stránky v účtu Premium Storage. Pokud úroveň přístupu není explicitně nastavená v objektu blob, odvodí se na základě její délky obsahu a tato hlavička se vrátí s hodnotou true. Pokud objekt blob bloku ve službě Blob Storage nebo účtu pro obecné účely v2 nemá nastavenou úroveň přístupu, můžete tuto úroveň odvodit z vlastností účtu úložiště. Tato hlavička se nastaví jenom v případě, že se odvodí úroveň objektu blob bloku.
x-ms-archive-status Verze 2017-04-17 a novější. Pro úložiště objektů blob nebo účet pro obecné účely v2 jsou rehydrate-pending-to-hotplatné hodnoty , rehydrate-pending-to-coola rehydrate-pending-to-cold. Pokud se objekt blob rehydruje a je neúplný, vrátí se tato hlavička, která značí, že čeká na dosazování, a zobrazí cílovou úroveň. Podrobné informace o vrstvení na úrovni objektů blob na úrovni bloku účtu objektu blob úrovně Standard najdete v tématu Horká, studená a archivní vrstva úložiště.
x-ms-access-tier-change-time Verze 2017-04-17 a novější. Označuje čas poslední změny vrstvy objektu. Tato hlavička se vrátí jenom v případě, že byla někdy nastavena úroveň objektu blob bloku. Formát data se řídí dokumentem RFC 1123. Další informace najdete v tématu Reprezentace hodnot data a času v záhlavích. Další informace o vrstvení na úrovni objektů blob bloku účtu objektů blob úrovně Standard najdete v tématu Horká, studená a archivní vrstva úložiště.
x-ms-client-request-id Dá se použít k řešení potíží s požadavky a jejich odpovídajícími odpověďmi. Hodnota této hlavičky se rovná hodnotě x-ms-client-request-id hlavičky, pokud je v požadavku, a hodnota je maximálně 1 024 viditelných znaků ASCII. Pokud hlavička x-ms-client-request-id v požadavku není, není tato hlavička v odpovědi.
x-ms-rehydrate-priority Verze 2019-12-12 a novější. Pokud je objekt ve stavu čekání na dosazování, vrátí se tato hlavička s prioritou rehydratace. Platné hodnoty jsou High/Standard. Podrobné informace o vrstvení na úrovni objektů blob bloku účtu objektu blob úrovně Standard najdete v tématu Horká, studená a archivní úroveň úložiště.
x-ms-or-{policy-id}_{rule-id} Verze 2019-12-12 a novější, vrácená pouze pro objekty blob bloku. policy-id je hodnota GUID, která představuje identifikátor zásady replikace objektů v účtu úložiště. rule-id je hodnota GUID, která představuje identifikátor pravidla zásad v kontejneru objektů blob. Pokud je ObjectReplicationúčet povolený, hodnota této hlavičky představuje stav replikace objektu blob s danou zásadou a identifikátory pravidel, buď complete nebo failed.
x-ms-or-policy-id Verze 2019-12-12 a novější, vrácená pouze pro objekty blob bloku. Pokud je ObjectReplicationúčet povolený, hodnota této hlavičky představuje zásadu, která řídí replikaci.
x-ms-last-access-time Verze 2020-02-10 a novější. Označuje čas posledního přístupu k datům objektu blob na základě zásad posledního sledování času přístupu účtu úložiště. Hlavička se nevrátí, pokud účet úložiště nemá zásadu sledování času posledního přístupu nebo pokud je zásada zakázaná. Informace o nastavení zásad posledního sledování času přístupu k účtu úložiště najdete v tématu Rozhraní API služby Blob Storage.
x-ms-blob-sealed Verze 2019-12-12 a novější, vrácená pouze pro doplňovací objekty blob. Pokud je doplňovací objekt blob zapečetěný, hodnota bude true. Další informace najdete v tématu Doplňovací pečeť objektů blob.
x-ms-immutability-policy-until-date Verze 2020-06-12 a novější. Určuje datum uchování do objektu blob nastavené do. Toto je datum, do kterého je možné objekt blob chránit před úpravami nebo odstraněním. Vrátí se jenom v případě, že je v objektu blob nastavená zásada neměnnosti. Hodnota této hlavičky je RFC1123 formátu.
x-ms-immutability-policy-mode: unlocked/locked Verze 2020-06-12 a novější. Režim zásad neměnnosti vrácený v případě, že je v objektu blob nastavená zásada neměnnosti. Hodnoty jsou unlocked/locked. unlocked označuje, že uživatel může zásadu změnit zvýšením nebo snížením data uchovávání. locked označuje, že tyto akce jsou zakázány.
x-ms-legal-hold: true/false Verze 2020-06-12 a novější. Pokud objekt blob nemá blokování z právních důvodů, tato hlavička se nevrátí. Hodnota této hlavičky se nastaví na true , pokud objekt blob obsahuje blokování z právních důvodů a jeho hodnota je true. V opačném případě se hodnota nastaví na false, pokud objekt blob obsahuje blokování z právních důvodů a jeho hodnota false.
x-ms-owner Verze 2020-06-12 a novější. Pouze pro účty s povoleným hierarchickým oborem názvů. Vrátí uživatele vlastníka souboru nebo adresáře.
x-ms-group Verze 2020-06-12 a novější. Pouze pro účty s povoleným hierarchickým oborem názvů. Vrátí skupinu vlastníků souboru nebo adresáře.
x-ms-permissions Verze 2020-06-12 a novější. Pouze pro účty s povoleným hierarchickým oborem názvů. Vrátí oprávnění nastavená pro uživatele, skupinu a další v souboru nebo adresáři. Jednotlivá oprávnění jsou ve [r,w,x,-]{3} formátu.
x-ms-acl Verze 2023-11-03 a novější. Pouze pro účty s povoleným hierarchickým oborem názvů. Vrátí kombinovaný seznam přístupu a výchozí seznam řízení přístupu, které jsou nastaveny pro uživatele, skupiny a další v souboru nebo adresáři. Každá položka řízení přístupu (ACE) se skládá z oboru, typu, identifikátoru uživatele nebo skupiny a oprávnění ve formátu [scope]:[type]:[id]:[permissions]. Obor default označuje, že ACE patří do výchozího seznamu ACL pro adresář. V opačném případě je obor implicitní a ACE patří do seznamu ACL pro přístup. Jednotlivá oprávnění jsou ve [r,w,x,-]{3} formátu.
x-ms-resource-type Verze 2020-10-02 a novější. Pouze pro účty s povoleným hierarchickým oborem názvů. Vrátí typ prostředku pro cestu, která může být buď file nebo directory.
x-ms-expiry-time Verze 2020-02-10 a novější. Pouze pro účty s povoleným hierarchickým oborem názvů. Vrátí čas vypršení platnosti nastavený v objektu blob. Vrátí se pouze pro soubory, které mají nastavený čas vypršení platnosti.

Text odpovědi

Žádné

Ukázková odpověď

Response Status:  
HTTP/1.1 200 OK  
  
Response Headers:  
x-ms-meta-Name: myblob.txt  
x-ms-meta-DateUploaded: <date>  
x-ms-blob-type: AppendBlob  
x-ms-lease-status: unlocked  
x-ms-lease-state: available  
Content-Length: 11  
Content-Type: text/plain; charset=UTF-8  
Date: <date>  
ETag: "0x8CAE97120C1FF22"  
Accept-Ranges: bytes  
x-ms-blob-committed–block-count: 1  
x-ms-version: 2015-02-21  
Last-Modified: <date>  
Server: Windows-Azure-Blob/1.0 Microsoft-HTTPAPI/2.0  
x-ms-copy-id: 36650d67-05c9-4a24-9a7d-a2213e53caf6  
x-ms-copy-source: <url>  
x-ms-copy-status: success  
x-ms-copy-progress: 11/11  
x-ms-copy-completion-time: <date>

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, Get Blob Properties 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 ve srovnání s autorizací sdíleného klíče poskytuje vynikající zabezpečení a snadné použití.

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, spravované identity nebo instančního objektu Get Blob Properties a nejméně privilegované integrované role Azure RBAC, 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

Pokud chcete zjistit, jestli se Copy Blob operace dokončila, nejprve zkontrolujte, jestli x-ms-copy-id hodnota hlavičky odpovídá ID kopie poskytnutému původním voláním Copy Blobnástroje . Shoda zajistí, že jiná aplikace nepřesune kopírování a nezačne novou Copy Blob operaci. Dále zkontrolujte hlavičku x-ms-copy-status: success . Mějte ale na paměti, že všechny operace zápisu do objektu blob s výjimkou Leaseoperací , Put Pagea Put Block odeberou z objektu blob všechny x-ms-copy-* vlastnosti. Tyto vlastnosti také nejsou zkopírovány operacemi Copy Blob , které používají starší verze než 2012-02-12.

x-ms-copy-status-description obsahuje další informace o Copy Blob selhání. Hodnoty x-ms-copy-status-description jsou popsané v následující tabulce:

Komponenta Popis
Stavový kód HTTP Standardní 3místné celé číslo, které určuje chybu.
Kód chyby Klíčové slovo, které popisuje chybu, kterou poskytuje Azure v elementu <ErrorCode> . Pokud se nezobrazí žádný <prvek ErrorCode> , použije se klíčové slovo se standardním textem chyby, které je přidruženo ke 3mí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í, uzavřený v uvozovkách.

Hodnoty x-ms-copy-status a x-ms-copy-status-description běžných scénářů selhání jsou popsané v následující tabulce:

Důležité

Následující popisy chyb se můžou změnit bez upozornění, a to i bez změny verze, takže text nemusí přesně odpovídat.

Scenario hodnota x-ms-copy-status hodnota x-ms-copy-status-description
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ě, ale operace se bude opakovat. 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ě, ale operace se bude opakovat. 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í. Poznámka: 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ři čtení ze zdroje příliš často selhala 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."

x-ms-last-access-time sleduje čas, kdy se k datům objektu blob přistupovalo, a to na základě zásad sledování času posledního přístupu účtu úložiště. Přístup k metadatům objektu blob nezmění jeho čas posledního přístupu.

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 Get Blob Properties žádosti založené na typu účtu úložiště:

Operace Typ účtu úložiště Kategorie fakturace
Získání vlastností objektu blob Objekt blob bloku úrovně Premium
Standard pro obecné účely v2		 Další operace
Získání vlastností objektu blob Standard pro obecné účely v1 Operace čtení

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

Viz také

Autorizace žádostí do Služby Azure Storage
Stavové kódy a kódy chyb
Kódy chyb služby Blob Storage